cpod - cron(8) friendly podcatcher

cpod [-h] [-p number] [-r number] [-v]

cpod is a small cron(8) friendly podcatcher which is only responsible for downloading podcast episodes. It doesn't play them, it doesn't enqueue them and it doesn't track the episodes you already listend to. It simply fetches them no more, no less.

If you don't pass any command line flags to cpod it will automatically update all feeds and download all (new) episodes. Since cpod supports continuous downloads you can also interrupted it at any point and the next time you invoke it will automatically resume unfinished downloads unless those unfinished downloads are no longer part of your episode scope.

cpod is using a plain text file to store your podcast subscriptions. You need to manually create this file before starting cpod. Open the file with your favorite text editor and add your desired URLs (one per line). The file path is documented in the FILES section below.

For OPML import and export two separated optional binaries are provided. If you installed them take a look at cpod-import(1) and cpod-export(1) in case your are seeking more information.

-h

Display help/defaults and exit.

-p number

Number of maximal parallel downloads.

-r number

Number of most recent episodes to download.

-v

Display version number and exit.

CPOD_DOWNLOAD_DIR

The download directory (default: ~/podcasts).

XDG_CONFIG_HOME

Base directory with configuration files (default: ~/.config).

~/podcasts

Default podcast download directory.

~/.config/cpod/urls

Plain text file containing all subscribed feeds.

Update all feeds and download new episodes:

cpod

Download the most recent episodes of each feed:

cpod -r 1

Subscribe to a new podcast:

echo "URL" >> "${XDG_CONFIG_HOME:-$HOME/.config}/cpod/urls"

cpod-export(1), cpod-import(1), cron(8)