youtube-dl-nas

youtube-dl-nas is a small NAS-friendly download queue for videos, audio, and subtitles. It wraps yt-dlp with an authenticated web dashboard, real-time progress updates, download history, file actions, and a REST API for automation.

From your phone. Saved on your NAS. Watch the 25-second Android sharing demo.

Docker Hub: https://hub.docker.com/r/modenaf360/youtube-dl-nas/

Current release: 26.1105 (2026-11-05)

This release: a wider, quieter library with on-demand details, local subtitle search with playable timestamps, and read-only AI connections that can be limited to a collection. No LLM API key, database, or new container is required. Keep both existing volumes; mobile sharing and existing tokens continue to work. Changelog

Start Here

Goal	Go to
Install the app for the first time	Docker Compose Quick Start
Choose a NAS or Docker deployment path	Deployment paths
Upgrade an existing container or diagnose a problem	Operations guide
Send links from Android, iPhone, or iPad	Mobile sharing guide
Organize researched URLs and connect an AI client	MCP Collections guide
Find a phrase in saved subtitles	Content search · 한국어 사용법
Review the newest changes	Latest release
Report a reproducible problem	Issue form

Need automatic full-channel backups instead? youtube-dl-nas remains the small URL download queue. For scheduled channel backups, existing archive.txt and NAS-folder import, missing-only downloads, and disk-first recovery, see Channel Vault NAS.

Choose	Best fit
youtube-dl-nas	Paste individual video/playlist URLs into a compact authenticated queue
Channel Vault NAS	Register channels once and keep only missing/new videos backed up automatically

This is the beginning of the README. Read the rest at the original. Read the full README ↗