This distribution contains the following files:

  README
     This file
     
  COPYING
     GNU copyleft

  podcatch
     An slsh script that downloads podcasts

  podcatch.conf
     A sample configuration file. 
     downloaded.

The configuration file, podcatch.conf, contains the list of feeds to
be downloaded.  It must exist in the same directory as the script.
Change the value of the Config_File variable in the script if you want
to use a different directory.

Running the podcatch script without any options gives the usage:

Usage: podcatch [options] [RSS feeds...]
Options:
 -d|--download           Download podcasts (normal mode)
 -f|--fullscreen         Use SLsmg to display progress
 -v|--verbose            Verbose mode
 -t|--test               Show URLs that would be downloaded
 -c|--catchup            Update the history file but do not download
 -o|--output-dir DIR     Use DIR for the output root directory
    (defaults to ./podcasts if unspecified)

Note that the output directory is the root directory where podcasts
are saved.

The first time the script has run, it will create a file called
podcatch.log that contains a history of the podcasts that were
downloaded.  DO NOT DELETE THIS FILE.  It will be used upon subsequent
runs so that podcasts that were previously downloaded will not be
downloaded again.

I recommend that the first time you run the script, run it using the
--catchup option:

   # ./podcatch --catchup

Then look through podcatch.log and remove any entries that you really
want to download.  Otherwise you may end up downloading gigabytes of
files.  Once you have edited podcatch.log, run it with the -d option
to download the podcasts:

   # ./podcatch -f -d

Enjoy.
--John
