YTDL-Sub GUI
YTDL-Sub GUI is a containerized web interface for ytdl-sub that helps homelab users automate media downloads and generate metadata for Jellyfin, Plex, and…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
72/100 Good
- Maintained
- 91last commit 19 days ago
- Popular
- 702,994 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 16 days ago
- GitHub stars
- 2,994
- Open issues
- 126
- Last commit
- 2026-11-01
- Latest release
- 2026.11.01
- License
- GPL-3.0
- Activity
- rising
Checked 17 days ago - source: GitHub (jmbannon/ytdl-sub)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set where videos and music get saved Open subscriptions.yaml and set tv_show_directory, music_directory, and music_video_directory to real folders you want to keep. These tell the app where to put your downloads, so wrong paths can cause failed jobs or files ending up in unexpected places. source
- Point to the video tools and work folder Set ffmpeg_path and ffprobe_path to the full file locations of ffmpeg and ffprobe, and choose a working_directory you can keep or clear later. ffmpeg is a background tool that processes video; if the app cannot find it, downloads may fail or not finish properly. source
- Keep the YouTube cookie file private If you need a YouTube cookie file, point ytdl_options.cookiefile at cookie.txt and keep that file private. A cookie file is a saved login token for YouTube, and if someone else uses it they can download or act on your account. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives (2)
- Pinchflat - Pinchflat is a lightweight, self-contained YouTube media manager for homelab users that automatically downloads and organizes video content…
- Tubesync - TubeSync is a personal video recorder for YouTube that automatically downloads channels and playlists to local directories and updates your…
Checked 54 days ago - source: AlternativeTo
Common questions
Where do I configure the folders for TV shows, music, and music videos?
Set tv_show_directory, music_directory, and music_video_directory in subscriptions.yaml to real folders you want to keep. Wrong paths can cause failed jobs or files ending up in unexpected places.
Do I need to point ytdl-sub at ffmpeg and ffprobe?
Set ffmpeg_path and ffprobe_path to the full file locations of ffmpeg and ffprobe, and choose a working_directory you can keep or clear later. If the app cannot find ffmpeg, downloads may fail or not finish properly.
How should I store a YouTube cookie file for ytdl-sub?
If you need one, point ytdl_options.cookiefile at cookie.txt and keep that file private. A cookie file is a saved login token for YouTube, and if someone else uses it they can download or act on your account.
Can I test a subscription before it downloads anything?
Navigate to the directory containing your subscriptions.yaml file and run ytdl-sub --dry-run sub.
Can one TV show subscription include multiple YouTube URLs?
Yes, TV show subscriptions can support multiple URLs and store them in the same TV Show.
When might I force ytdl-sub to re-download a file?
You may want to replace a file already in the archive if the current file is lower resolution than desired, missing subtitles, or corrupt.
Answers sourced from github.com, github.com, github.com, www.reddit.com, ytdl-sub.readthedocs.io
Community
Collected 49 days ago - public community threads