ydl-podcast
A simple tool to generate Podcast-like RSS feeds from youtube (or other
youtube-dl supported services) channels, using
youtube-dl.
Setup
Install package with requirements:
Youtube-dl:
pip install ydl-podcast[youtube-dl]
yt-dlp:
pip install ydl-podcast[yt-dlp]
Configuration
Edit the config.yaml file to list your podcast sources and configure them, as well as edit general configuration.
The available settings are the following.
General settings
output_dir: local directory where the downloaded media will be stored, and the podcast xml files generated.url_root: root url for the static files (used in the generation of the XML to point to the media files.subscriptions: a list of feeds to subscribe to.youtube-dl-module: Alternative youtube-dl python module. By default, this uses youtube-dl, but can leverage forks such as yt-dlp.
Feed settings
Mandatory
name NAME: Name of the podcast source. Used as the podcast title, and media directory name.url URL: source url for the youtube (or other) channel.
Optional
audio_only True/False: ifTrue, audio will be extracted from downloaded videos to create an audio podcast.retention_days N: only download elements newer thanNdays, and automatically delete elements older.download_last N: only download the latestNvideos.initialize True/False: ifTrue, then downloads everything on the first run, no matter thedownload_lastorretention_daysspecified.output_dir: local directory where the downloaded media will be stored, and the podcast xml files generated.url_root: root url for the static files (used in the generation of the XML to point to the media files.format: file format to force youtube-dl to use (eg mp4, webm, mp3 for audio only…)best: force best quality (only useful when specifying a format).ydl_options: list of raw youtube-dl options to use. For experienced users, since this will likely yield issues if not understood.nfo_files: generates nfo files for subscriptions and downloaded episodes (simulates a "tvshow" nfo for the subscription and "tvshow episode" for each video). This helps plex, kodi, jellyfin import correct metadata. Does NOT supportaudio_onlyfeeds at this point.skip_download: Don't perform download, just generate the Atom feed from the existing files. Mandatoryurlparameter can be skipped ifskip_downloadis set totruedownload_as_playlist: Pass the url to the downloader directly, without processing the metadata of each item in the playlist. This is helpful with generic urls, and a few specific extractors.
Usage
Using cron or your favorite scheduler, run:
ydl-podcast [-c configfile.yaml]
You can then use your favorite web server to serve the files (a good idea is to
exclude the *.json and *.part files from being served as the first might
leak information, and the second is unnecessary.
eg with nginx:
root /var/www/static/podcasts/;
location ~ (\.json$|\.part$) {
return 403;
}
Command line arguments
usage: ydl-podcast [-h] [-v] [-c CONFIG] [-j JSON_CONFIG] [-f FILTER] [-e EXCLUDE]
options:
-h, --help show this help message and exit
-v, --version Show version and exit
-c CONFIG, --config CONFIG
Configuration file
-j JSON_CONFIG, --json-config JSON_CONFIG
Configuration string in JSON format
-f FILTER, --filter FILTER
Filter subscriptions
-e EXCLUDE, --exclude EXCLUDE
Exclude subscriptions
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ydl_podcast-1.20.0.tar.gz.
File metadata
- Download URL: ydl_podcast-1.20.0.tar.gz
- Upload date:
- Size: 10.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Alpine Linux","version":"3.23.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b256f0f826130c3925270132e353161ffd0c8de4602237f09057610adb3c128f
|
|
| MD5 |
01bdb1313f0a7857f4b33dfec440bd68
|
|
| BLAKE2b-256 |
c64923ab775f689c34c90933e401f19bc98e97dbd9e60510d5f8034bd64bce5a
|
File details
Details for the file ydl_podcast-1.20.0-py3-none-any.whl.
File metadata
- Download URL: ydl_podcast-1.20.0-py3-none-any.whl
- Upload date:
- Size: 12.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Alpine Linux","version":"3.23.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e6cc6558aecc5ce4251e92abdf63b45df84e832d112f8973d498a3f6be4aa9e1
|
|
| MD5 |
a266d1dfe16921d6fb50dfb7be306356
|
|
| BLAKE2b-256 |
578b0e31857ae776a98a4175e73a54e79ced1058182e5681ed337034454acccd
|
