Was ist yt-dlp?
yt-dlp ist ein Kommandozeilen-Downloader für Audio und Video, der weit über tausend Seiten unterstützt. Es begann als Fork von youtube-dl (über das inzwischen inaktive youtube-dlc) und ist seitdem das aktiv gepflegte Projekt der beiden — mit einer weitaus mächtigeren Formatauswahl, SponsorBlock-Integration, nativer Unterstützung zum Einbetten von Untertiteln, Kapiteln und Metadaten sowie einem Plugin-System für eigene Extraktoren.
⚡ Hauptfunktionen von yt-dlp
🌐 Tausende von Seiten
Über 1.700 Extraktoren für Videoplattformen, Sender, Podcast-Hoster und Nachrichtenseiten, dazu ein generischer Extraktor, der Medien auch auf Seiten findet, für die niemand einen Extraktor geschrieben hat.
🎚️ Präzise Formatauswahl
-f und -S bieten eine vollständige Ausdruckssprache über Auflösung, Codec, Bitrate und Container — du bekommst genau den Stream, den du willst, statt des Standards.
🎧 Audio extrahieren
-x --audio-format mp3 zieht die Tonspur heraus und kodiert sie neu; mit --embed-thumbnail und --embed-metadata entstehen getaggte Dateien, die jeder Musikplayer versteht.
💬 Untertitel & Kapitel
Untertitel in jeder verfügbaren Sprache herunterladen oder einbetten, automatische Untertitel behalten und Kapitelmarken direkt in die Ausgabedatei schreiben — oder daran aufteilen.
⏭️ SponsorBlock
Sponsorensegmente, Intros und Eigenwerbung schon beim Herunterladen markieren oder entfernen, dank der SponsorBlock-Datenbank — ganz ohne nachträglichen Schnitt.
🍪 Cookies & Sitzungen
--cookies-from-browser liest eine angemeldete Sitzung direkt aus Firefox oder Chromium, damit private, altersbeschränkte und mitgliederexklusive Inhalte funktionieren.
apt upgrade hält dich auf der neuesten Version.
📦 Installation aus deb.griffo.io
Schritt 1: Repository hinzufügen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updateSchritt 2: yt-dlp installieren
# Neuestes yt-dlp installieren
sudo apt install yt-dlp
# Installation überprüfen
yt-dlp --version# Neuestes yt-dlp installieren
apt install yt-dlp
# Installation überprüfen
yt-dlp --versionSchritt 3: ffmpeg installieren (dringend empfohlen)
# yt-dlp braucht ffmpeg, um getrennte Video- und Audiostreams zusammenzuführen,
# Audio zu extrahieren und Untertitel oder Vorschaubilder einzubetten
sudo apt install ffmpeg
# Vervollständigungen für bash, zsh und fish liegen dem Paket bei —
# nichts zu konfigurieren. Öffne eine neue Shell und drücke Tab:
yt-dlp --embed-<Tab>
# Die Handbuchseite wird ebenfalls installiert
man yt-dlp# yt-dlp braucht ffmpeg, um getrennte Video- und Audiostreams zusammenzuführen,
# Audio zu extrahieren und Untertitel oder Vorschaubilder einzubetten
apt install ffmpeg
# Vervollständigungen für bash, zsh und fish liegen dem Paket bei —
# nichts zu konfigurieren. Öffne eine neue Shell und drücke Tab:
yt-dlp --embed-<Tab>
# Die Handbuchseite wird ebenfalls installiert
man yt-dlp🎯 Grundlegende Verwendungsbeispiele
Alltägliches Herunterladen:
# Ein Video in der besten verfügbaren Qualität herunterladen
yt-dlp 'https://example.com/watch?v=...'
# Bestes MP4 bis 1080p
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# Nur Audio, als getaggtes MP3
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# Vor der Auswahl alle angebotenen Formate ansehen
yt-dlp -F 'URL'Untertitel, Kapitel und Sponsoren:
# Englische Untertitel einbetten, inklusive automatischer Untertitel
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# Kapitelmarken in die Datei schreiben
yt-dlp --embed-chapters 'URL'
# Sponsorensegmente und Intros schon beim Herunterladen entfernen
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# Nur einen Abschnitt statt des ganzen Videos holen
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'Playlists, Archive und Automatisierung:
# Eine ganze Playlist, in saubere Ordner pro Uploader
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# Einen Kanal synchron halten, ohne Altes erneut zu laden
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# Private oder altersbeschränkte Inhalte über eine angemeldete Browser-Sitzung
yt-dlp --cookies-from-browser firefox 'URL'
# Schnellere Downloads über aria2c
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 Tool-Integrationen
yt-dlp ist das Download-Backend, das viele andere Programme erwarten:
- ffmpeg: Zusammenführen, Remuxen, Audioextraktion und Einbetten rufen es auf
- mpv: spielt eine URL direkt ab, indem es sie im Hintergrund an yt-dlp übergibt
- aria2: optionaler externer Downloader für parallele, segmentierte Übertragungen
- Medienserver: Bibliotheken von Jellyfin, Kodi und Navidrome werden häufig aus yt-dlp-Ausgabevorlagen befüllt
- Konfigurationsdateien: lege deine üblichen Optionen in
~/.config/yt-dlp/configab und tippe sie nie wieder
🚀 Warum deb.griffo.io?
- Offizielles Ubuntu: verfügbar, aber eingefroren auf der Version, mit der das Release erschien — Monate an Extraktor-Korrekturen hinterher
- pip / pipx: aktuell, aber außerhalb von apt, und PEP 668 macht ein systemweites
pip installunter Ubuntu umständlich - deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Funktionierende Extraktoren: das neueste Release — genau das, woran Downloads gelingen oder scheitern
- ✅ Keine manuelle Einrichtung: kein pip, kein virtualenv, kein Self-Update, das nach
/usr/local/binschreibt - ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach Upstream-Releases aktualisiert
- ✅ Vollständiges Paket: der offizielle Upstream-Build, die Handbuchseite
yt-dlp.1und Vervollständigungen für bash, zsh und fish - ✅ Jede Architektur: ausgeliefert als
Architecture: all— amd64, arm64, armhf, riscv64 und der Rest installieren dasselbe Paket - ✅ Multi-Distribution: läuft auf Ubuntu 22.04, 24.04, 25.10 und 26.04
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Paket-Build-Repository
Die Ubuntu-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 📺 yt-dlp-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls verfügbar über deb.griffo.io:
- termusic - Terminal-Musikplayer für alles, was du herunterlädst
- lowfi - Minimalistischer Lofi-Radioplayer
- viu - Vorschaubilder und Bilder im Terminal ansehen
- Yazi - Terminal-Dateimanager zum Durchstöbern deiner Sammlung