# youtube-dl-nas

> Self-hosted download queue wrapping yt-dlp with an authenticated dashboard, real-time progress, restart-safe downloads, mobile sharing, and MCP for AI clients.

- **Category:** Download Management
- **Licence:** MIT
- **Latest version:** 26.1026
- **Open source:** oss
- **Languages:** JavaScript, Python
- **Platforms:** Docker, Docker Compose
- **Tags:** Android, iOS, Mcp, REST API, Synology, Pwa, Youtube, Homelab, Media Management, Yt Dlp, Subtitles, Nas, Download Manager, Video Downloader, Docker, Python, Self Hosted, Youtube Downloader, Youtube Dl, Ai integration, Mobile Sharing, Subtitle Analysis, Audio Downloader, Playlist Guard, Restart Safe, Awesome Selfhosted

## Description

A compact self-hosted download manager for NAS devices that wraps yt-dlp with a password-protected web interface. Users paste video, audio, or subtitle links into a queue that survives container restarts and avoids duplicate work. The dashboard shows live progress, lets you stop active transfers while keeping partial data, and can serve files already on disk. Mobile users send links straight from their phone share sheet via a PWA, an Android shortcut, or an iOS shortcut. Playlists and channels require an explicit scope choice before anything is queued. Subtitles can be checked against a reference transcript using nlptutti metrics. An MCP endpoint lets AI assistants propose batches of URLs for approval. Everything runs in one Docker image with nginx, the web app, and the MCP service sharing a single port; two bind mounts keep downloads and queue state persistent. The UI speaks English, Korean, Chinese, and Polish.

## Links

- [Homepage](https://github.com/hyeonsangjeon/youtube-dl-nas)
- [Website](https://hyeonsangjeon.github.io/youtube-dl-nas/)
- [Docker](modenaf360/youtube-dl-nas)
- [GitHub Repository](https://github.com/hyeonsangjeon/youtube-dl-nas)
- [Docker Hub](https://hub.docker.com/r/modenaf360/youtube-dl-nas/)
- [GitHub Container Registry](https://github.com/hyeonsangjeon/youtube-dl-nas/pkgs/container/youtube-dl-nas)
- [Mobile Sharing Guide](https://hyeonsangjeon.github.io/youtube-dl-nas/mobile/)
- [MCP Setup Guide](https://hyeonsangjeon.github.io/youtube-dl-nas/mcp/)
- [Operations Guide](https://hyeonsangjeon.github.io/youtube-dl-nas/operations/)
- [Dashboard Guide](https://hyeonsangjeon.github.io/youtube-dl-nas/dashboard/)

---
Source: https://selfhost.directory/project/youtube-dl-nas