dialmaster/youtarr repository overview

⁠Youtarr

Youtarr is a self-hosted YouTube downloader. Subscribe to channels and playlists, and it downloads new videos on a schedule, organizes them by channel, and writes the metadata media servers need. Playlists sync into Plex, Jellyfin, and Emby as native playlists, and Plex libraries refresh automatically after downloads. It also works standalone: you can browse and play everything from the web UI without any media server. Learn more at youtarr.com⁠.

⁠Features

• Channel subscriptions with per-tab control over videos, Shorts, and streams
• Playlist subscriptions that sync to Plex, Jellyfin, and Emby as native playlists, plus a universal .m3u file for any other player
• Watch status sync that pulls watched state from Plex, Jellyfin, and Emby, so you can filter your library by watched or unwatched
• Scheduled downloads with global and per-channel quality settings (360p to 4K)
• NFO files, poster images, and embedded MP4 metadata for Plex, Jellyfin, Emby, and Kodi
• SponsorBlock integration to remove sponsored segments
• YouTube search inside the app, showing which results you already have
• In-browser playback of downloaded videos
• Channel subfolders for separate media server libraries (kids, music, news)
• Age and space-based auto-cleanup with dry-run previews
• Notifications for completed downloads (Discord webhooks or any Apprise service)
• Responsive web UI, built-in authentication, and a REST API with Swagger docs
• Uses yt-dlp under the hood for all downloads

⁠Getting started

The recommended install clones the repo and uses the helper scripts:

git clone https://github.com/DialmasterOrg/Youtarr.git
cd Youtarr
./start.sh

Then open http://localhost:3087⁠. See the Installation Guide⁠ for prerequisites and details.

You can also run Youtarr without cloning the repo (Portainer, TrueNAS, and similar Docker-native setups): you only need docker-compose.yml and a .env file. Follow Manual Setup Without Git Clone⁠ carefully. In particular, don't mount or auto-create an empty ./migrations directory; it breaks the database bootstrap in a way that's hard to diagnose.

⁠Tags

• latest: the newest stable release
• vX.Y.Z (for example v1.74.0): pinned release versions
• dev-latest and dev-rc.<sha>: release candidates built from the dev branch; expect rough edges

Images are published for amd64 and arm64 (Raspberry Pi, Apple Silicon, most NAS devices).

⁠Links

• youtarr.com⁠ - project website
• GitHub repository⁠ - source, issues, and releases
• Docker Guide⁠ and Environment Variables⁠
• Troubleshooting⁠
• Unraid: install through Community Applications (notes⁠)
• Prefer managed hosting? Youtarr is available on ElfHosted⁠
• Support the project on Patreon⁠