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

Written by:                  Christian Alexander Moser <cm_vdr@wahnadium.org>

Project's homepage:          http://www.wahnadium.org

Latest version available at: http://www.wahnadium.org

See the file COPYING for license information.

--------------------------------------------------------------------------------

Description:

The "cdda" plugin is an audio cd player with cd-text and cddb support. You can
play your favorite music cd's as like as you do it with your standalone cd
player.

Installation and Requirements:

* vdr 1.3.29, other versions >= 1.3.29 should also work
* libcdio >= 0.74
  OR: When you dont want (or just be to lazy) to install a new version of
      libcdio, then you can remove to "_const" from the reported function
      calls. But a new version will be the better solution. ;-)

As you can read this file, you have already successfully extraced the archive.
To install this plugin, you only have to copy the directory to your plugins
source tree and install/compile a recent version of libcdio.

You can get the latest package at http://www.gnu.org/software/libcdio .
Just compile and install the library with ./configure && make && make install.

This will suffice to get this plugin compiling.

CDDB support:

To use the cddb support, you just have to set the "CDDB Priority" option to
another value than "off". Maybe you also want to alter the CDDB Server / Port
options.

Proxy support isn't implemented, so you have to make sure your vdr can directly
access the internet with your configured CDDB FQDN/Port.

To use the cddb cache, just enable the corresponding option in the setup menu.
All downloaded cddb entries will be saved in the directory structure below the
configured directory. Please make sure that it is writable by the vdr user. All
needed genre directories are automatically created.
The used data format is the one described by the faq from the freedb project.

Commandline options:

  --device  | -d   - set the cdrom device (default: /dev/cdrom)
  --cddbDir | -c   - set the base directory to the cddb cache (no default
                     argument). When no directory is set, then the local cache
                     is automatically disabled.

Configuration options (in setup menu):

  Mainmenu entry   - switch menu entry on/off
  Information view - set default information view track/all
  Skip length      - set jump range in seconds (green/yellow key in player mode)
  Skip back margin - range of seconds between "skip back" jumps to the
                     beginning of the current or previous track
  Background       - set background when playing to "live"-signal or "black"
  Autostart replay - directly start music replay (without mainmenu)
  CDDB Priority    - switch between different priorities
                     > off - no cddb will be queried
                     > cache only - only query the cddb cache
                     > no cd-text - only query cddb when no cd-text is available
                     > always - query cddb even when cd-text is available
  CDDB Server FQDN - hostname of cddb server
  CDDB Server Port - port of cddb service
  CDDB Cache       - switch local cache on/off

Usage:

  Player mode:

    up       - play
    down     - pause
    left     - skip back one track
    right    - skip one track ahead
    back     - stop cd player
    red      - toggle play time view between track and disc mode
    green    - jump X seconds backward
    yellow   - jump X seconds forward
    blue     - show playlist menu
    [1...9]* - jump to track no XX

  Mainmenu:

    red      - view command menu
    green    - toggle between "single" and "all" play mode
               > single  - play only the selected track
               > all     - play the whole disc
               > program - play tracks in self defined order
    yellow   - eject disc/refresh menu after disc change
    blue     - show playlist menu
    [1...9]* - start replay at track no XX
    ok       - start replay at current track

  Command Menu:

    Add to playlist      - add track to program playlist
    Remove from playlist - remove track from program playlist
    Next disc/track tag  - switch to the next available disc tag
                           (aka cddb/cdtext entry)
    Delete current tag   - deletes the current tag (aka cddb entry). This command
                           is only available when you have supplied a valid path
                           and enabled the cache setup option.

Thanks to:

Some ideas are borrowed from the:
  * mp3 plugin written by Stefan Hülswitt (http://www.muempf.de)
  * muggle plugin written by Andi Kellner,
                             Lars von Wedel <vonwedel@web.de>,
                             Ralf Klueber <r@lf-klueber.de>,
                             Wolfgang Rohdewald <wolfgang@rohdewald.de>
                             (http://www.htpc-tech.de/htpc/muggle.htm)
  * dvbplayer.c code from vdr itself written by Klaus Schmidinger
                             (http://www.cadsoft.de/vdr)
