Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status
Coverage Status
'Stories in Ready'

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.