Youtarr selbst hosten: Der ultimative YouTube DVR für dein Homelab

Du willst YouTube-Videos automatisch archivieren und in deine bestehende Medienserver-Infrastruktur integrieren? Mit Youtarr selbst hosten ist das kinderleicht – und du behältst die vollständige Kontrolle über deine Videobibliothek. In diesem Tutorial zeige ich dir, wie du Youtarr mit Docker aufsetzt, welche Features es bietet und wie es im Vergleich zu Alternativen wie TubeArchivist abschneidet.

Was ist Youtarr und warum selbst hosten?

Youtarr ist eine selbst gehostete Webanwendung, die auf yt-dlp basiert und das automatische Herunterladen, Organisieren und Planen von YouTube-Kanal-Inhalten ermöglicht. Im Gegensatz zu Cloud-Diensten oder simplen Downloader-Skripten bietet Youtarr eine vollwertige Web-Oberfläche mit Kanal-Abonnements, Zeitplanung und nahtloser Integration in bekannte Medienserver.

Die Vorteile gegenüber kommerziellen Lösungen liegen auf der Hand:

• Volle Datenkontrolle: Deine Videos bleiben auf deinem Server – kein Cloud-Abo, kein Tracking
• Automatisierung: Neue Videos abonnierter Kanäle werden automatisch heruntergeladen
• Medienserver-Integration: Nahtlose Anbindung an Plex, Jellyfin, Kodi und Emby
• Kostenlos und Open Source: Keine laufenden Kosten außer dem eigenen Server
• ARM-kompatibel: Läuft auch auf Raspberry Pi und ähnlicher Hardware

Youtarr installieren: Schritt-für-Schritt mit Docker

Youtarr läuft ausschließlich über Docker – direkte Node.js-Installationen werden vom Entwickler nicht unterstützt. Das macht die Installation zum Glück sehr einfach.

Voraussetzungen

• Docker und Docker Compose installiert
• Mindestens 2 GB RAM (empfohlen: 4 GB)
• Ausreichend Speicherplatz für deine Videobibliothek
• Linux-Server, NAS (z.B. Synology) oder Raspberry Pi 4/5

Installation Schritt für Schritt

1. Repository klonen und konfigurieren:

git clone https://github.com/DialmasterOrg/Youtarr.git
cd Youtarr
cp .env.example .env

2. Die .env-Datei anpassen:

# Pfad zu deiner Video-Bibliothek
MEDIA_PATH=/mnt/daten/youtube

# Plex-Token (optional, für automatische Bibliotheks-Aktualisierung)
PLEX_TOKEN=dein_plex_token

# Port für die Web-Oberfläche (Standard: 3087)
PORT=3087

3. Container starten:

docker compose up -d

Die Installation erstellt automatisch eine MariaDB-Datenbank und startet beide Container. Nach wenigen Sekunden ist die Web-Oberfläche unter http://localhost:3087 (oder deiner Server-IP) erreichbar.

ARM-Setup (Raspberry Pi / Synology)

Für ARM-Systeme gibt es eine eigene Compose-Datei:

docker compose -f docker-compose.arm.yml up -d

Youtarr einrichten: Kanäle, Qualität und Automatisierung

Nach dem Start öffnest du die Web-Oberfläche und kannst sofort loslegen:

1. Kanal hinzufügen: Gib die YouTube-Kanal-URL ein – Youtarr abonniert ihn automatisch
2. Download-Einstellungen konfigurieren: Pro Kanal lassen sich Qualität, maximale Videodauer und Datumsfilter setzen
3. Automatisierung aktivieren: Neue Videos werden automatisch heruntergeladen, sobald sie erscheinen
4. SponsorBlock aktivieren: Werbepausen und Sponsor-Segmente werden beim Download automatisch entfernt

Besonders praktisch: Du kannst einzelne Videos mit einem „Ignorieren“-Flag versehen, damit sie beim automatischen Download übersprungen werden – ein Feature, das seit Version 1.48 verfügbar ist.

Download-Qualität gezielt steuern

Youtarr erlaubt dir, die Download-Qualität pro Kanal individuell festzulegen. Für Tech-Tutorials, bei denen Bildschärfe wichtig ist, empfiehlt sich 1080p oder 4K. Für Podcasts oder reine Audio-Inhalte reicht 720p völlig aus und spart deutlich Speicherplatz.

Über die neue API-Key-Unterstützung (ab v1.56) lässt sich Youtarr außerdem in Automationstools einbinden: Mit n8n oder Home Assistant kannst du beispielsweise Webhooks einrichten, die einen Download auslösen, sobald ein bestimmter Kanal ein neues Video veröffentlicht – vollautomatisch und ohne manuelle Eingriffe.

Troubleshooting: Häufige Fehler und Lösungen

Beim Einrichten von Youtarr können einige typische Probleme auftreten. Hier die häufigsten Fehler und ihre Lösungen:

• Port-Konflikt auf 3087: Ein anderer Dienst belegt bereits den Port. Lösung: In der .env-Datei PORT=3088 (oder einen anderen freien Port) setzen und den Container neu starten mit docker compose down && docker compose up -d.
• Berechtigungsfehler auf MEDIA_PATH: Der Docker-Container kann nicht in das Verzeichnis schreiben. Lösung: Stelle sicher, dass der Pfad existiert und die korrekten Berechtigungen gesetzt sind: sudo chown -R 1000:1000 /mnt/daten/youtube.
• MariaDB-Verbindungsfehler beim Start: Der Datenbank-Container startet langsamer als der App-Container. Lösung: Warte 30 Sekunden und starte dann erneut: docker compose restart youtarr. Alternativ hilft es, in der docker-compose.yml einen depends_on-Healthcheck zu ergänzen.
• yt-dlp-Fehler „Video unavailable“: YouTube hat die Video-URL geändert oder das Video ist in deiner Region gesperrt. Lösung: Youtarr lässt sich mit einem Proxy oder Cookie-Datei betreiben – Details dazu findest du in der offiziellen Dokumentation auf GitHub.

Medienserver-Integration: Plex und Jellyfin einrichten

Youtarr legt heruntergeladene Videos direkt in dem Verzeichnis ab, das du als MEDIA_PATH konfiguriert hast. So bindest du es in deine Medienserver ein:

• Plex: Erstelle in Plex eine neue Bibliothek vom Typ „Heimvideos“ und zeige sie auf deinen MEDIA_PATH. Mit einem gültigen PLEX_TOKEN in der .env-Datei aktualisiert Youtarr die Plex-Bibliothek automatisch nach jedem Download – kein manuelles Scannen nötig.
• Jellyfin: Füge das Verzeichnis in Jellyfin als neue Bibliothek vom Typ „Videos“ hinzu. Da Jellyfin keine direkte Token-Integration bietet, aktiviere dort die automatische Bibliotheksaktualisierung unter Einstellungen → Bibliotheken → Automatisch aktualisieren.

Youtarr benennt die Dateien im Format Kanalname/Video-Titel (Jahr).mp4, was von beiden Medienservern problemlos erkannt wird.

Neue Features der aktuellen Version (v1.56)

Die aktuelle Version 1.56.0 (Stand: Januar 2026) bringt einige interessante Neuerungen:

• API-Key-Authentifizierung: Youtarr kann jetzt per API-Key angesprochen werden – perfekt für die Integration in Automationstools wie n8n oder Home Assistant
• Download-Endpoint: Neue REST-API zum direkten Auslösen von Downloads per Script
• Dev-Flag: Mit --dev beim Start lassen sich Bleeding-Edge-Builds testen
• Verbesserte Stabilität: Verschiedene Bug-Fixes und Performance-Verbesserungen

Youtarr vs. TubeArchivist vs. yt-dlp – der große Vergleich

Welches Tool passt zu dir? Hier ein direkter Vergleich der drei populärsten Lösungen:

Feature	Youtarr	TubeArchivist	yt-dlp (CLI)
Web-Oberfläche	✅ Ja	✅ Ja	❌ Nein
Automatische Downloads	✅ Ja	✅ Ja	❌ Manuell
Plex/Jellyfin-Integration	✅ Nativ	⚠️ Eingeschränkt	❌ Nein
Eigener Medienserver	❌ Nein	✅ Ja	❌ Nein
RAM-Bedarf	Gering (~500 MB)	Hoch (~2 GB)	Minimal
SponsorBlock	✅ Ja	✅ Ja	✅ Plugin
ARM-Support	✅ Ja	⚠️ Experimentell	✅ Ja

• Youtarr ist ideal, wenn du bereits Plex, Jellyfin oder einen anderen Medienserver betreibst und dort YouTube-Videos automatisch einpflegen möchtest
• TubeArchivist eignet sich, wenn du einen vollständigen, eigenständigen YouTube-Archivserver mit Suchfunktion möchtest – benötigt aber deutlich mehr Ressourcen (ElasticSearch)
• yt-dlp ist die flexibelste, aber auch technischste Lösung für Nutzer, die volle Skript-Kontrolle bevorzugen

YouTube Videos herunterladen – was ist in Deutschland legal?

Eine wichtige Frage, die viele Homelab-Enthusiasten beschäftigt: Darf ich YouTube-Videos für den privaten Gebrauch herunterladen?

• Privatkopie erlaubt (§ 53 UrhG): Das deutsche Urheberrecht erlaubt die Anfertigung einzelner Kopien urheberrechtlich geschützter Werke zum ausschließlich privaten Gebrauch
• Kein Kopierschutz umgehen: Die Kopie muss aus einer legalen Quelle stammen, und es dürfen keine technischen Schutzmaßnahmen umgangen werden
• Kein kommerzieller Einsatz: Die heruntergeladenen Videos dürfen nicht verkauft oder kommerziell genutzt werden
• Nutzungsbedingungen beachten: YouTubes AGB verbieten Downloads ohne ausdrückliche Genehmigung – dies ist eine rechtliche Grauzone

Wer auf der sicheren Seite sein möchte, sollte ausschließlich eigene Inhalte oder CC-lizenzierte Videos archivieren.

Ergänzend dazu regelt § 44a UrhG flüchtige und begleitende Vervielfältigungen, die technisch notwendig sind – etwa beim Streaming. Das aktive Herunterladen und dauerhafte Speichern fällt jedoch nicht darunter. Praktisch bedeutet das: Solange du Youtarr für den rein privaten Gebrauch einsetzt, öffentlich zugängliche (nicht DRM-geschützte) Inhalte archivierst und die Dateien nicht weitergibst, bewegst du dich im Rahmen des rechtlich Tolerierten. Eine Rechtsberatung ersetzt diese Einschätzung jedoch nicht.

Fazit: Youtarr selbst hosten lohnt sich!

Youtarr ist ein ausgereiftes, ressourcenschonendes Tool für alle, die YouTube-Inhalte automatisch in ihre bestehende Homelab-Infrastruktur einpflegen möchten. Die nahtlose Integration in Plex, Jellyfin und Co. macht es zur idealen Ergänzung für jeden selbst gehosteten Medienserver.

Besonders für Nutzer mit einem Synology-NAS oder einem günstigen Mini-PC (z.B. ein Intel N100-System für ~150€) ist Youtarr eine attraktive, wartungsarme Lösung. Die Docker-Installation ist in wenigen Minuten erledigt, und die API-Key-Unterstützung in Version 1.56 öffnet spannende Möglichkeiten zur Automatisierung.

Hast du Youtarr bereits ausprobiert? Welchen Medienserver nutzt du in deinem Homelab? Schreib es in die Kommentare!