Skip to main content

A simple command-line podcatcher.

Project description

A simple command-line podcatcher.

GitHub Project: (

Supports Python 3.6+. Please report any issues on the GitHub project or reach out over email.

You’ll need setuptools ( to run this in its current
state. Go get it, clone this repo, and you can run the below commands. Should work on OSX and
Linux, from the command line. You’ll want a default config file, name it config.yaml and look at
example_config.yaml to see how it should be structured.

Directory for config file:

  • OSX: /Users/[USERNAME]/Application Support/puckfetcher/config.yaml

  • Linux: /home/[USERNAME]/.config/puckfetcher/config.yaml

Build + Install:

python3 install


python3 test


  • Download any podcast with an RSS URL.

  • Download newest episodes on demand.

  • Download any episode from a podcast’s backlog.

  • Respects podcast authors’ websites - rate limits, checks when feed was last updated when trying to refresh.

  • Provides progress on downloads.

  • Provides summary of recently-downloaded podcasts per-session, as well as summary of recently-downloaded episodes per-podcast.

  • Add MP3 tag support to clean up tags based on feed information if it’s messy.

Ideas for Future Releases

  • Text-based progress for other time-consuming actions.

  • Support PyPy (when it supports 3.6+).

  • Allow parallel downloading.

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

puckfetcher-1.5.0-py3-none-any.whl (27.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page