This plug-in provides an alternative to the favourites channellist in the firmware.

Its main advanteges
==================
- Allows to switch channels in PiP or live mode (and filters channels which cannot be opened in PiP mode).
  So it can also be used as alternative to the Sub channel list.
- Current epg is shown next to the channelname (if available)
- Sorts your favourites groups as defined in PCEditor

Key Mapping
===========
Up/Down		-> figure it out yourselves :)
Left/Right	-> jump 5 entries in list
Red/Green	-> change Favourites group
Blue		-> switch live/Pip mode
Yellow		-> show channel number before name
Info		-> changes footer mode
Epg			-> shows and disable current audition next to channel name
Folder		-> Shows and hide hidden channels, only when parental control is on
Bookmark	-> Changes background. Two values solid and transparent.
Volume		-> Scrolls epg info and epg list.
Ok			-> Selects channel
Digits		-> Used to choose channel by it's id.

Jumping to a channel directly:
  1. Put channel order number, with digits buttons.
     What is input will be shown on the bottom/right with '*' asterisk character as a marker.
  2. Press 'OK' button to switch to channel or 'Exit' to cancel.

Licence
=======
GPL

DEBUGING & REPORTING
=====================
In case of problems the following scenario will help solving problem.
1. add to config file folowing line
	debug.level=DEBUG
2. Run plugin and perform actions to reproduce bug.
3. Download via FTP file /tmp/favpip.plugin.log. This can be done in most cases even if PANIC is on LCD.
4. Compose mail to author and attach log file.

RELEASE 0.5
===========
- initial release

RELEASE 0.5.1
=============
- fixed panic when /var/theme folder is not present
- automatically jump to currently active group and channel on startup

RELEASE 0.5.2 (Mod by COoLoSER)
=============
- added information about current and total fav groups, it is shown in left upper corner, before group name
- yellow button shows/hides order numer of channel
- added information about current channel order number, it is shown in right bottom corner. Numbering is exactly like in DGS soft.
- PgUp/PgDown works like Left/Right button
- added ability to jump to channel by giving its order number.
- checking of current channel, to not switch when there is no need for it.

RELEASE 0.6
=============
- show epg next to channel names

RELEASE 0.6.1 (Mod by COoLoSER)
=============
- missing features added in 0.5.2

RELEASE 0.6.2 (Mod by COoLoSER)
=============
- features of all previous versions
- added EPG bar which presents relation between passed time of current program to duration of that program
- LEFT/RIGHT buttons don't roll the list
- PgUp/PgDown switch whole page, don't roll the list

RELEASE 0.6.3 (Mod by COoLoSER)
=============
- added option to close plugin with second press of OK on the same channel

RELEASE 0.7
===========
- added basic skin support
- increased timeout when leaving with ok button
- reordered icons in legend, increased font size

RELELASE 0.9
===========
- configuration support, see favpip.config for details. Config file must always finish with empty line.
- saves state on exit and restore on open. Temporary settings do not survive box restart
- Brand new keys support
- FILE key show/hide hidden channels
- EPG key show/hide epg informations
- for hidden channels new HIDE icon is displayed at the right side, before SCRAMBLE icon
- Transparent background with BOOKMARK key.

RELELASE 0.9.1
===========
- configuration files can have line end in both formats 'LF' or 'CRLF'
- favpip.config is looked for in plugin folder, which is defined by sbox. Should work on DGS and ABCOM firmware.
- header shows positions of SCRAMBLE and HIDE icons.
- HIDE icon in header represents state of hidden channels visibility.

RELELASE 1.0.0
===========
- fixed bug which caused start/stop recording hanged up osd for a while
- new configuration option 'show_format_icon' which is used to show or hide channel format icon. Icons are 'mp2' or 'mp4'
- separation of RADIO and TV channels. What is shown depends on current TV/RADIO mode
- new configuration option 'hide_empty_groups' which is used to show or hide empty groups
- parental control -> hide channels settings is respected by plugin. If it is enabled then hidden channels are hide all the time
	and cannot be show. If it is disabled then FILE key controls showing and hiding of that channels

RELELASE 1.9.0 - RC for 2.0.0
===========
- whole code was rewritten and now is using widget libraries.
- no more global variables
- navigation is now 5 times faster then in previous ones.
- new configuration options for fonts setting added. They still need to be fixed to check border values.

RELELASE 1.9.2 - RC for 2.0.0
===========
- plugin sets default colors if it cannot read it from current skin, it happens on sifteam image
- new configuration options to set colors
	general.background.color=0x0d0e0f
	general.normal.color=0xffffff
	general.focus.color=0x000000

RELELASE 1.9.3 - RC for 2.0.0
===========
- transponder is now set correctly in live channels, so pip filter works good.
- switching to second empty group when empty groups are shown was not possible, not it is fixed.

RELELASE 1.9.4 - RC for 2.0.0
===========
- plugin now reads skin colors and images on SIFTEAM image
- Normal spaces between rows for those who uses 'CRASH Polish fonts'. Fonts have too big paddings, plugin fixes that.
- plugin version is shown in the bottom right corner

RELELASE 1.9.5 - RC for 2.0.0
===========
- new configuration options to set colors of bar of current program from epg
	general.epg_bar.future=0x00df00
	general.epg_bar.past=0x0d0d00
- new special values of configuration options
	window_x=-1 - if equals -1 then window is positioned on center of the screen, horizontally
	window_y=-1 - if equals -1 then window is positioned on center of the screen, vertically

RELELASE 1.9.6 - RC for 2.0.0 (for Crash)
===========
- new configuration options to enable/disable epg progress bar
	general.epg_bar.enable=true	 	- enable (default)
	general.epg_bar.enable=false	- disable
- During plugin work plugin name is displayed on receiver LCD

RELELASE 1.9.7 - RC for 2.0.0
===========
- new configuration options to force plugin close after every OK button press.
	single_ok_close=false	- disable (default)
	single_ok_close=true	- enable
- Starting plugin while recording shows available channels like in PIP mode. This version is mostly usable
  for those who have only one tuner. Having 2 recordings on boxes with 2 tuners will show full list, this
  will be fixed in next release.

RELELASE 2.0.0
===========
- new feature to show epg info of current audition
- new feature to show list of current and next auditions from epg
- key "i" (info) changes footer mode, possible values are:
	legend		- shows simple key legend (default)
	epg info 	- shows epg info of current audition
	epg list	- shows list of auditions from epg
- support for volume buttons, different meaning dependent on 'footer mode'"
	FOOTER MODE	- MEANING
	legend		- changes audio volume
	epg info 	- scrolls epg info up and down
	epg list	- scrolls epg list up and down
- new configuration values for new 'footer modes':
	For 'epg info' mode
		epg_info.elements_number	- page size of channel list in that mode. Bigger means smaller footer (default=7)
		epg_info.font				- font size used to display epg info (default=15)
	For 'epg list' mode
		epg_list.elements_number	- page size of channel list in that mode. Bigger means smaller footer (default=7)
		epg_list.font				- font size used to display epg list (default=15)
		epg_list.max_auditions		- number of auditions to get and display (default=3)
		epg_list.hide_current_audition	- if true hides current audition in epg list
	General
	epg_list.first=true				- decides if 'epg list' mode should be before 'epg info' mode (default=false)
	footer.restore_mode=true		- if set to true then plugin remember 'footer mode' on exit and restore it
									  on plugin open (default=false)
- fixed bug which caused PANIC when config file did not have empty line at the end.

RELELASE 2.1.0
===========
- fix for bad label next to green button in legend
- debug logs disabled by default, see DEBUGING & REPORTING on the beginning of README file.
- New feature of 'epg info' footer mode
	- Shows all auditions info not only current one. Number of auditions is limited to epg_list.max_auditions
	- Switching between auditions info is made with LEFT and RIGHT buttons
	- First row of epg info contains name, time, duration and number of audition.
- default value of 'show_channels_id' is now 1 as stated in config example file.

RELELASE 2.1.1
===========
- fix for segmentation fault on some platforms, thx to Pacco
- fix for not showing epg list for the first time on current channel.

Enjoy it,
pacco & COoLoSER
