yarrtube
Self-hosted YouTube playlist & channel synchronizer for your NAS, built on yt-dlp. No ads, no algorithm.
Automatically checked · GitHub checked 2026-11-17

Overview
Self-hosted YouTube synchronizer for your media server, built on top of yt-dlp.
No ads, no algorithm.
About
·
Quick start
·
Installation
·
Plex
·
Categories
·
AI
·
Architecture
·
Development
·
License
About
Yarrtube is a self-hosted service that watches tracked YouTube playlists and channels and automatically downloads new videos as they're published.
Yarrtube is designed to run on your NAS via Docker alongside the rest of your media stack (Plex, Jellyfin, etc.), but it runs on any laptop too.
Main Features
Track & download
- Track public YouTube playlists, or whole channels and get new videos as they're published.
- Pick the video quality and how many videos to keep, and how often each channel and playlist is checked.
- Subtitles and chapters come with every video.
Watch
- Watch everything from the browser, on desktop and mobile, in light or dark mode.
- Pick up where you left off: Continue watching, "Play next" and an "Up next" queue.
- Group channels and playlists into categories ("Science", "Kids", ...) and watch each one as a single feed. See Categories.
Plex, Kodi and Jellyfin
- Each channel and playlist is a TV show, with episodes, metadata, subtitles and chapters.
- Plex: watched state and resume position sync both ways, and every category becomes an auto-updating smart playlist. See the Plex guide.
AI (optional)
- A short AI summary of every video, instead of the YouTube description.
- Give a category a prompt and AI adds the videos that fit it, from any channel or playlist.
- Runs on your own Ollama server, or on Anthropic with your API key. See AI.
Quick start
You need Docker and a YouTube Data API v3 key. Save this as compose.yaml, fill in the key and paths, and run docker compose up -d:
services:
yarrtube:
container_name: yarrtube
image: ghcr.io/sergigp/yarrtube:latest
restart: always
ports:
- 8080:8080
environment:
- YOUTUBE_API_KEY=your-youtube-data-api-v3-key
- PUID=1000
- PGID=1000
- TZ=Europe/Madrid
volumes:
- /path/on/host/config:/config
- /path/on/host/videos:/videos
Then open http://localhost:8080. Every option is in Installation.
Motivation
This is a personal project. I'm an experienced software engineer coming back from a sabbatical, and I wanted a real project to get my hands dirty again, both with writing code and with AI-assisted coding. I wanted to build something that I would actually use, and that would be useful to others too. Yarrtube is the result. If you are a recruiter/dev you can take a look at the architecture.
It also solves an actual problem at home: I wanted a reliable, ad-free and no-algorithm way to watch specific channels and playlists in Plex, especially for my kids. Yarrtube keeps the playlists and channels I care about mirrored to disk, so they just show up in Plex. No ads and no algorithm.