Provided by: podget_0.5.8-1_all bug

NAME

       Podget

SYNOPSIS

       podget <options> [command]
       podget -h | --help

DESCRIPTION

OPTIONS

       -c, --config <FILE>
              Name of configuration file.

       -C, --cleanup
              Skip downloading and only run cleanup loop.

       --cleanup_days <NUMBER>
              Cleanup files older than <NUMBER> days.

       --cleanup_simulate
              Simulate cleanup loop to see what files would be deleted.

       -d, --dir_config <DIRECTORY>
              Directory that configuration files are stored in.

       -f, --force
              Force  download  of items from each feed even if they’ve already
              been downloaded.

       --import_opml <FILE or URL>
              Import servers from OPML file or HTTP/FTP URL.

       --import_pcast <FILE or URL>
              Import server from iTunes PCAST file or HTTP/FTP URL.

       -l, --library <DIRECTORY>
              Directory to store downloaded files in.

       -p, --playlist-asx
              In addition to M3U playlists, create ASX playlists.

       -r, --recent <COUNT>
              Download only the <COUNT> newest items from each feed.

       --serverlist <FILE>
              Use <FILE> as serverlist instead of default.

       -s, --silent
              Run silently (for cron jobs).

       -v     Set verbosity to level 1.

       --verbosity <LEVEL>
              Set verbosity level (0-3).

       -h, --help
              Display help.

EXAMPLE CRON JOB

       Once podget is running acceptably, its most useful if you run it from a
       cron  job  so  that  the new songs are available to play or load onto a
       portable player and you dont have to wait for them to download.

       To edit your crontab, do:

         $ crontab -e

       Then insert one line (i for insert mode), like the following:

         15 04 * * * /usr/bin/podget -s

       This will run podget at 4:15 AM every day.

AUTOMATIC CLEANUP

       You can enabled automatic cleanup with every run by configuring  it  in
       your $HOME/.podget/podgetrc file. Simply set the following options:

         # Autocleanup.
         # 0 == disabled
         # 1 == delete any old content
         cleanup=1

         # Number of days to keep files.   Cleanup will remove anything
         # older than this.
         cleanup_days=7

       However,  some people prefer to run cleanup as a seperate cron session.
       To do that, set the options in .podgetrc to:

         # Autocleanup.
         # 0 == disabled
         # 1 == delete any old content
         cleanup=0

         # Number of days to keep files.   Cleanup will remove anything
         # older than this.
         cleanup_days=7

       And add a cron job to run cleanup, like one of these examples:

         # Once a week on Sunday at 04:15AM
         15 04 * * Sun /usr/bin/podget -C

SESSION CONTROL

       Podget checks for already running sessions when it starts and exits  if
       any are found.
              Each session requires its own core configuration  file,  so  for
              multiple sessions simply provide a unique -c <configfile> option
              for each.

EXAMPLE SERVER LIST

       By default, Podget uses $HOME/.podget/serverlist for the  default  list
       of servers

       to contact.
              However  you  can  configure the name with the config_serverlist
              variable in your $HOME/.podget/podgetrc file.

       The default format is: <url> <category> <name>

       Note: Category must be one word.

       Example:

         # Default Server List for podget
         # FORMAT:    <url> <category> <name>
         # NOTE: Category must be one word
         http://www.distortedview.com/show/index.xml Humor Distorted View
         http://www.podcastingnews.com/forum/links.php?func=show&id=214 IT In the Trenches
         http://www.lugradio.org/episodes.rss Linux LUG Radio
         http://thelinuxlink.net/tllts/tllts.rss Linux The Linux Link
         http://www.bbc.co.uk/radio4/history/inourtime/mp3/podcast.xml Philosophy BBC: In Our Time
         http://www.privacyfreaks.org/podcast.php privacy Privacy Freaks
         http://www.rsasecurity.com/blog/rssfeed.asp security Speaking of Security
         http://dl.chickencat.com/podcast.php privacy Digital Liberties
         http://feeds.feedburner.com/LiveAmmo security LiveAmmo

       HANDLING UTF-16 FEEDS

       Some servers provide their feeds in UTF-16 format rather than the  more
       common UTF-8.

       To automatically convert these files, create a secondary serverlist at:

               $HOME/.podget/serverlist.utf16

       Remember to change the name of the serverlist to match what you set  it
       to with config_serverlist if you changed it.

AUTHORS

       Dave Vehrs