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

Written by:                  Tobias Grimm <tg@e-tobi.net>

Project's homepage:          http://www.e-tobi.net/blog/pages/podcatcher

Latest version available at: http://www.e-tobi.net/blog/pages/podcatcher

See the file COPYING for license information.


Description:
-----------

With the Podcatcher plugin you can subscribe to podcasts. It allows you
to browse through the podcasts, download and play them.

Currently only RSS podcasts with mp3 enclosures are supported.


Requirements:
------------

The plugin requires vdr 1.3.47 or above.

The plugin uses these libraries:

 - libcurl (tested with )
 - libmad0-dev (tested with )
 - libxml++2.6-dev (tested with )
 - libxml2-dev (tested with )

Other versions may run, but I can't guarantee it.


Configuration:
--------------

The following parameters are available:

    --cache=<DIR>    Specify the cache dir, where the xml feeds and mp3's get
                     cached. This defaults to /var/cache/podcatcher
                     
You can subscribe to a podcast, by adding it's feed-URL to the config file
podcatchersources.conf. This file must be located in VDR's plugin config dir.
e.g.:
    
    # The Daily Source Code
    FEED_URL=http://radio.weblogs.com/0001014/categories/dailySourceCode/rss.xml
    # The Word Nerds
    FEED_URL=http://thewordnerds.org/rss

Lines starting with '#' are comments and will be completely ignored.

Usage:
------

[Podcatcher Main Menu]

Opening the podcatcher entry from VDR's main menu will show you the list of
podcasts you have subscibed to. If an entry contains only question marks,
the feed could not be downloaded and you should check the URL in the
podcatchersources.conf.

Normally the podcasts are updated every two hours. To force an update,
press the RED key.

[Item Menu]

To view the contents of a podcast, select it from the list and press OK.
A list with the available feed items will be shown. 

Depending on whether an item is a podcast or a normal text entry, you
can download the MP3 file with the RED key. The text on the RED key then
shows download progress information. If the ddownload is finished, press
GREEN to play the entry.

Whether a podcast is queued for downloading or currently downloads is displayd
as the help text for the red button with ">queued<" or the current download
progress in percent.

The YELLOW key toggles, whether only podcasts or all items should be shown in
the list.

[Item View]

From the item menu you can press OK on an item, to read it's text. Just
like in the item menu, the RED and GREEN key allow you to download and
play the podcast MP3, if available.

[Playback Control]

The playback control can be shown by pressing the OK key outside of any menu.
With the DOWN or PAUSE keys, you can then pause and resume the playback.
