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

Written by:                  Christian A. 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:

This plugin enhances the vdr with a DAAP client. DAAP (Digital Audio Access
Protocol) is commonly used by the Apple iTunes (TM) software to share your music
on a local network.
The plugin discovers automatically all local DAAP servers (via libopendaap) and
lets you browse,search and play your shared music files. Nice eh?

Installation and Requirements:

To compile this plugin, you have to install the libopendaap for the daap
connection/data management and the libmad for mp3 decoding. The vdr version
must be 1.3.29 or above.

Note: Some libraries may require the payment of patent royalties.
      YOU ARE SOLELY RESPONSIBLE FOR YOUR OWN ACTIONS!

  * libopendaap (required)
    Download and extract the library to your desired directory. Then just use
    the common ./configure && make && make install to compile and install the
    needed files.

    I have added a patch for the library to eliminate two memleaks. Apply it
    via patch and recompile your sources. It is not mandatory for the use of
    the plugin, but ...

    Version: 0.4.0
    URL: http://craz.net/programs/itunes/libopendaap.html

  * libmad (required)
    Download and extract the library to your desired directory. Then just use
    the common ./configure && make && make install to compile and install the
    needed files.

    Version: 0.15.1b
    URL: http://www.underbit.com/products/mad

  * faad2 (optional)
    Download and extract the library to your desired directory. Then compile
    and install the libraries.

    Version: latest cvs (currently from february of 2005)
    URL: http://www.audiocoding.com

Then you only have to extract the archive to your plugin source directory and
call make plugins in your base vdr directory. When you want to include the faad2
support, change the compile switch DECODER_FAAD= to =1.

Note: You need an DAAP server like mt-daapd or the Apple iTunes software to play
      music. This version of the plugin dont support any other source (more will
      follow).

      URL: http://www.mt-daapd.org
      or
      URL: http://www.apple.com

Commandline options:

  none

Configuration options (in setup menu):

  Mainmenu entry        - switch menu entry on/off
  Background            - set background when playing to "live"-signal or "black"
  Skip length (s)       - amount of seconds to skip when pressing green/yellow
                          in player mode
  Skip back margin (s)  - range of seconds between "skip back" jumps to the
                          beginning of the current or previous title
  Instant playlist name - your personal name of the playlist

Usage:

  * Mainmenu (host list)
    ok      - select the current host to view stored databases and playlists
    yellow  - refresh list of hosts
    blue    - set password for current selected host

  * Databases and Playlists Menu
    ok      - select current database / playlist
    yellow  - clear selected playlist (remove all titles)

  * Database Menu
    ok      - play selected title (clears instant playlist and
              adds current title)
    up/down/left/right - navigate through list of titles
    Red     - open commands menu
    Green   - switch first column between Artist/Album/Genre, the fields will
              automatically be sorted
    yellow  - filter items by current selected title (the first column will be
              the key) and open new database view
    blue    - open menu to show details of current title
    0 ... 9 - jump to the first title beginning with the char:
              1 = 0 ; 2 = a ; 3 = d;
              4 = g ; 5 = j ; 6 = m;
              7 = p ; 8 = t ; 9 = w
              0 = first title

  * Playlist menu
    ok/red  - play list beginning with selected item
    green   - move current item to new position, accept with Ok
    yellow  - delete current title from list
    blue    - open menu to show details of current title

    Note: the '#' sign marks the current/last played track.

    Note: The green/yellow keys will be disabled, when playlist is readonly.
          Many server provided lists are always readonly.

  * Commands menu
    1       - add current track to instant playlist
    2       - add all tracks, from current menu, to instant playlist

  * Player
    up      - play
    down    - pause
    left    - skip back one title
    right   - skip one title ahead
    green   - skip back n seconds
    yellow  - skip forward n seconds
    blue    - show playlist menu
    0...9+  - jump to title number X+

Credits/Thanks to:

* Klaus Schmidinger for the VDR 
  URL: http://www.cadsoft.de/vdr
* Bertrand Petit for the mad api demo/tutorial
  URL: http://www.bsd-dk.dk/%7Eelrond/audio/madlld
* Apple for the iPod
  URL: http://www.apple.com
  Copyright: Apple, iTunes and iPod are registered trademarks of
             Apple Computer, Inc.