This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Maxime GUILBOT

Updated by:                  Olivier JACQUES and an Anonymous Italian :)
Project's homepage:          http://m.guilbot.online.fr/prefermenu

Latest version available at: http://www.olivierjacques.com/vdr/prefermenu/

See the file COPYING for license information.

Description:
-----------
PreferMenu is a plugin that implements a preferred channel menu.
It makes it easy to recall (switch to) your favorite channels.

Installation:
------------
- Create prefermenu.conf file: 
  cd "VDR_CONFIG_DIR"/plugins/
  echo 1>prefermenu.conf
- Type "make plugins" at VDR directory level
- Edit the keymacros.conf file:
  cd "VDR_CONFIG_DIR"
  vi keymacros.conf
----------------keymacros.conf
Blue      Timers
Yellow    @prefermenu
----------------
  Please check VDR manual (man 5 vdr) for more informations on keymacros.conf

---> As of 0.5.0, there is no need to patch VDR anymore  <---
---> Do not use prefmenu.diff file in the archive, it is <---
---> outdated.                                           <---

Customization:
-------------
Prefer channel menu plugin can be tuned to your own preferences.
Go in Configuration/Plugins/prefermenu/ to access the setup menu.
Origin X   : X coordinate of the menu
Origin Y   : Y coordinate of the menu
Width      : Width of the menu (to tune with the biggest channel name you have)
Red        : Change this to change appearance of the menu (default is blue menu)
Green      :
Blue       :
Background opacity      : Opacity of the selected channel
                          (usually less than "selected channel opacity").
Selected channel opacity: Opacity of selected channel
Border opacity          : Opacity of menu borders
Sort by                 : Way to sort channels in the menu.
                          "None": same order as channels.conf
	                  "Name": sort by alphabetic order
Close on switch         : Close the menu when switching to a channel.
                          This allow to display channel information

Usage:
-----
Choose a prefered channel by pressing Green button.
Remove a prefered channel by pressing Red button.

Files:
-----
Prefered Channel List is in prefermenu.conf
Configuration settings (color) are stored in VDR's setup.conf

VDR Plugin 'prefermenu' Revision History
----------------------------------------
2004-01-20: Version 0.5.4 - Olivier Jacques, A. Share
- vdr-1.2.x and vdr-1.3.x compliant (thanks to A. Share who
  provided the 1.3.x patch) using VDRVERSNUM define in vdr/config.h
- Added missing languages in i18n.h (vdr-1.3.2): to be filled!

2003-04-30: Version 0.5.3 - Olivier Jacques, DOm and Ralf Klueber
- Added setup entry to either keep the preferred menu opened
  when pressing OK or close it (and get the channel info).
  Default is set to "yes" / close the preferred menu
- Added a border around +/- buttons (thanks to DOm)
- Possibility to sort by channel name, original VDR order or 
  "as entered" (default).
- Added setup entry which specifies the number of channels
  to be displayed in the menu (3, 5 or 7). Contributed by 
  Ralf Klueber.

2003-04-13: Version 0.5.2 - Olivier Jacques and DOm
- Added Alpha Border customization (thanks to DOm)
- Added help buttons to add and remove channel
- Fixed a crash when prefermenu is opened and one of the prefered 
  channels has been removed in VDR's channels.conf (thanks to 
  Manuel Hartl for reporting this one).

2003-02-20: Version 0.5.1 - Olivier Jacques and DOm
- Changed from channel number to unique channel IDs (thanks to DOm) 
  Unfortunately, this broke the "closest channel" auto-selection. We 
  are working on it :)
- Added support for right and left keys (page jump)
- Added support for repeated keys
- re-Added color customization (R/G/B and alpha)

2003-02-10: Version 0.5.0 - Never released / by DOm
- Adapted for VDR 1.1.2x (cOsd class use)
- Patch not needed anymore (use keymacros)
- Code Reorganization in Multiple files for an easier mantainance
- Changed the color for RemoveChannel ( Red is better )
- Changed the default menu aspect, it'a now more readable.
- Sorry for my english :)

2002-11-17: Version 0.4.0 - Olivier Jacques
- Adapted to changes in 1.1.14 and 1.1.15 related to channel switch
- At opening, selected channel is the closest to the current one

2002-09-07: Version 0.3.0 - Maxime Guilbot
- Now you can choose Prefered Channel pressing Green button (to add), 
yellow button (to remove)
- You can choose the color you want, and transparency !
- Now patched VDR can work without loading the plugin (before pressing 
red button crashes)

2002-09-05: Version 0.2.0 - Maxime Guilbot
- Many bugfixes !

2002-09-02: Version 0.1.0 - Maxime Guilbot
- Initial revision.

Known issues:
------------
- 0.5.2: You should always keep at least one prefered channel. You 
  have been warned :)

To do:
-----
- Being able to re-order the prefered channels. They are currently 
  listed "as entered".
  Done 0.5.3
- Re-introduce the closest channel selection when prefered menu is 
  opened
- Intelligent/dynamic preferred channels detection (by number of hours 
  spent on channels)
  Started in 0.5.3
- Colored buttons to re-call "Green: add channel, Red: remove channel"
  Done 0.5.2

Contact:
-------
I am watching VDR's mailing list 
(http://www.linuxtv.org/mailinglists/vdr/), so you can always contact 
me there. I also try to look at http://www.vdrportal.de on a regular 
basis and understand the german posts :) But I'll answer in english!


