# 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 Kodi without manually writing ytdl-sub commands. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3496/ytdl-sub-gui

## Description

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.

## Health score

72/100 (Good), based on 3 of 4 factors.
- Maintained: 91 (last commit 19 days ago)
- Popular: 70 (2,994 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/jmbannon/ytdl-sub
- Unraid: https://ca.unraid.net/apps/ytdl-sub-gui-0c8mdov1bl96vv?q=ytdl-sub-gui
- Documentation: https://ytdl-sub.readthedocs.io/en/latest/index.html

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/3496/ytdl-sub-gui), the self-hosted and open-source app directory.
