    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:
    ------------
    - Type "make plugins" at VDR directory level (or DEBUG=1 make plugins)
    - Edit the keymacros.conf file:
      cd "VDR_CONFIG_DIR"
      vi keymacros.conf

      ---- sample keymacros.conf ----
      Blue      Timers
      Yellow    @prefermenu
      ---- sample keymacros.conf ----

      Please check VDR manual (man 5 vdr) for more informations on keymacros.conf

    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:
    -----
    Add 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

    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!

    History
    -------
    2006-05-06: Version 0.6.6 - C.Y.M.
    - Fix some colors on the OSD

    2006-05-04: Version 0.6.5 - Ronny Kornexl
    - Maintenance release for VDR 1.4.0

    2005-01-23: Version 0.6.4
    - Using the yellow and blue keys you can move channels up and down
      PreferMenu's channel list. Thanks to Alex Stansfield.

    2005-01-12: Version 0.6.3 - Olivier Jacques, DOm and Ralf Klueber
    - Fixed sorting under new VDR versions (>=1.3.17). Thanks to Mark Watson.
    - Fixed some cString issues.

    2004-05-18: Version 0.6.2 - Olivier Jacques, DOm and Ralf Klueber
    - Transition Release to vdr-1.3.7, use cOsd insted of cOsdBase and chanches
      like that. The Whole OSD handlink is now more straighforward.
    - Changed some method names to reflect the real use.

    2004-01-09: Version 0.6.1 - Olivier Jacques, DOm and Ralf Klueber
    - Added 'last channel' functionality, now you can tune to the
      last visited channel (last with prefermenu, not VDR)
      pressing the 0 key.
    - Reintroduced symbols and borders.

    2004-01-06: Version 0.6.0 - Olivier Jacques, DOm and Ralf Klueber
    - Code cleanup to be ready for eventual new vdr features: removed
      duplicated code in favour of native vdr methods
    - Fixed a bug: the plugin crashed if using a prefermenu.conf with
      more than 255 entries
    - Simplified prefermenu aspect using native vdr color definitions
    - Others many little changes

    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.