~ubuntu-branches/ubuntu/trusty/podget/trusty

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