# Ytdl-sub

Ytdl-sub is a headless command-line tool that automates downloading and metadata generation for self-hosted media libraries. It is open source and self-hosted, installable on Unraid.

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

## Description

ytdl-sub is a headless command-line tool that automates downloading and metadata generation for self-hosted media libraries. It fetches video and audio through yt-dlp and organises the output with ready-to-use file names and metadata for players such as Jellyfin, Plex, Emby, and Kodi. It suits homelab users who want fully automated, server-side downloads without a web interface. No extra plugins or external scrapers are required, which keeps setup simpler than managing downloads by hand.

## Platform availability

Available on 2 of 10 platforms: Unraid, Any server.

## Health score

79/100 (Good), based on 4 of 5 factors.
- Maintained: 93 (last commit 5 days ago)
- Popular: 70 (3,041 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

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

## Common questions

### Do I need to build every download rule from scratch?

No. Subscriptions are YAML files that import presets, and ytdl-sub includes many prebuilt presets that handle config-building for media handling and output.

### What should I set in configuration.yaml to reduce failed or overlapping runs?

Set working_directory and lock_directory to writable folders you will not delete. If the system does not find ffmpeg or ffprobe, set ffmpeg_path or ffprobe_path to their locations.

### Why might the downloaded ytdl-sub Linux binary fail to run?

It may need to be marked executable with chmod +x ytdl-sub. Skipping this can cause a permission error.

### What command can I use to test a subscription?

Navigate to the directory containing your subscriptions.yaml file, then run ytdl-sub --dry-run sub.

### How can I replace a file that ytdl-sub has already archived?

Force ytdl-sub to re-download the file to replace an archived file that is lower resolution, missing subtitles, or corrupt.

## Alternatives

- tube archivist: Subscribe, download, and organize YouTube videos in a searchable library with playback, viewing history tracking, batch downloads, and chan…

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