Skip to main content

A Podcast downloader

Project description

Podd: a CLI podcatcher

Code style: black

If you're anything like me, you listen to a lot of podcasts. I like to archive all of my favorites on my home server, where I serve them to all my various devices via Plex. I looked around for a podcatcher that would manage my podcasts and could be run as a cron job, but I didn't find anything that really met my needs. So I decided to write my own.

Podd uses feedparser to parse RSS feeds, a sqlite3 database to store subscription info, and mutagen for basic tagging functionality, plus it sends you an email letting you know which episodes were downloaded, along with a summary of each episode.



pip install podd


  1. git clone
  2. cd Podd
  3. pip3 install -r requirements.txt to install dependencies.
  4. Configure
    • I use a spare Gmail account to send the notification email messages, if you plan on doing the same, the host and port values are fine. Using app-specific passwords like I'm doing here is a bit of a security risk, which is why I recommend not using your main Gmail account. If you want to go this route, you'll need to enable app-specific passwords. Note: the password is stored in the OS keyring.
    • By default, database setting places the sqlite database in the same directory as If you want to put it someplace else, just change that line to where you want it to be.


  • Python 3.6+ (F-strings are the bomb!)
  • Some *nix flavor. It runs on the latest version of MacOS and Ubuntu with no problems, but I lack a working windows installation to test. If you want to port it, go nuts.


In your terminal of choice, enter podd followed by one of the following switches:

Argument Description
--help Print help menu
v Prints version number
dl Run download routine
email Run email credential storage routine. Password is stored in OS keyring.
ls Print list of subscriptions
add [--all] [--file] $FEED Subscribe to podcast with an rss feed url.
--all If set, then all available episodes will be downloaded when download command is run.
--file If set, $FEED will be treated as a file with a single RSS feed URL per line and podd will attempt to add each line as a separate RSS feed URL.
rm Display the deletion menu
dir $DIR Set download directory. The default download directory is $HOME/Podcasts
opt Prints currently set options

Adding Protected Feeds

When adding a new feed protected by http basic authentication, podd will ask for your username and password, and store the credentials in your OS keyring.


GPL v2.0, see LICENSE.txt

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Podd-0.1.19.tar.gz (20.8 kB view hashes)

Uploaded source

Built Distribution

Podd-0.1.19-py3-none-any.whl (32.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page