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…

  • Downloaders
  • Media Applications
  • Tools & Utilities
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 Kodi without manually writing ytdl-sub commands.

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

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