podCatcher

Cute little script to parse podcasts rss feeds and download them for offline use.

Requirements:

needs aria2 to download podcasts, you can get it from here

needs pandas library for quick filtering pip install pandas

needs feedparser to actually read and parse rss feeds pip install feedparser

Usage:

Please run podcatcher --update-cache the first time you use podcatcher to get a local version of the rss feeds

PodCatcher [-h] [--list | --download | --update-cache]
                  [--all | --latest] [--regex REGEX] [--after AFTER]
                  [--before BEFORE] [--exact-episode EXACT_EPISODE]
                  [--after-episode AFTER_EPISODE]
                  [--before-episode BEFORE_EPISODE] [--config CONFIG]
                  [podcast_names [podcast_names ...]]

List and download podcasts

positional arguments:
  podcast_names         Put here names of podcasts -as defined in your config
                        file- to apply actions to them

optional arguments:
  -h, --help            show this help message and exit
  --list
  --download
  --update-cache
  --all
  --latest
  --regex REGEX         filter episodes using a regex
  --after AFTER         Episodes after a certain date only format:d-m-Y
  --before BEFORE       Episodes before a certain date only format:d-m-Y
  --exact-episode EXACT_EPISODE
                        episode number you would like to download
  --after-episode AFTER_EPISODE
                        only download episodes carrying a number larger than
                        the provided
  --before-episode BEFORE_EPISODE
                        only download episodes carrying a number smaller than
                        the provided
  --config CONFIG       path to config file, by default config are read from
                        ~/.config/podcatcher/urls

Examples:
    # update local versions of remote feeds
    podcatcher --update-cache

    # list the latest episode for all podcasts
    podcatcher --latest

    # list the latest episode for podcast1 and podcast2
    podcatcher --latest podcast1 podcast2

    # list episodes from all podcasts after 01-01-2019
    podcatcher --after 01-01-2019

    # download episodes published after 01-01-2019 from podcast1 and podcast2
    podcatcher --download --after 01-01-2019 podcast1 podcast2

    # download episode 5 from podcast3
    podcatcher --download --exact-episode 5 podcast3

    # download the first ten episodes from podcast4
    podcatcher --download --before-episode 10 podcast4

    # list all episodes from all podcasts matching the regex '.*apple.*'
    podcatcher --list --regex '.*apple.*'