https://github.com/yousufinternet/podcatcher
Cute little script to parse podcasts rss feeds and download them for offline use
https://github.com/yousufinternet/podcatcher
Last synced: about 1 month ago
JSON representation
Cute little script to parse podcasts rss feeds and download them for offline use
- Host: GitHub
- URL: https://github.com/yousufinternet/podcatcher
- Owner: yousufinternet
- License: agpl-3.0
- Created: 2019-09-06T17:29:40.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-08-17T19:18:23.000Z (almost 4 years ago)
- Last Synced: 2025-04-18T16:16:12.883Z (about 2 months ago)
- Language: Python
- Size: 35.2 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://aria2.github.io/)
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.*'
```