Wer Videos offline verfügbar machen möchte – ob für Zugfahrten, Archivierungszwecke oder die eigene Mediathek –, kommt an yt-dlp kaum vorbei. Das Kommandozeilenwerkzeug ist der direkte Nachfolger von youtube-dl, übertrifft diesen in Geschwindigkeit und Funktionsumfang jedoch bei weitem. Über 1.000 Webseiten werden unterstützt, darunter YouTube, Vimeo, Twitch, SoundCloud und viele mehr.
Was ist yt-dlp – und warum nicht youtube-dl?
youtube-dl war jahrelang der Standard-Downloader für Videoplattformen, verlor ab 2021 jedoch an Fahrt: Updates kamen selten, und YouTube-Änderungen brachen die Software regelmäßig. yt-dlp entstand als Fork mit dem Ziel, schneller auf API-Änderungen zu reagieren, mehr Formate zu unterstützen und neue Funktionen wie SponsorBlock-Integration und Fragment-Downloads zu integrieren. Heute ist yt-dlp das aktiv gepflegte Projekt, während youtube-dl praktisch eingeschlafen ist.
Installation unter Windows, Linux und macOS
yt-dlp ist eine einzelne ausführbare Datei ohne Installer. Für die Audioextraktion wird zusätzlich FFmpeg benötigt.
Windows
Laden Sie yt-dlp.exe von der GitHub-Releases-Seite herunter und legen Sie die Datei in einen Ordner, der in der PATH-Umgebungsvariable eingetragen ist (z. B. C:\Windows\System32 oder einen eigenen Ordner wie C:\Tools). Alternativ installieren Sie yt-dlp bequem über den Paketmanager:
winget install yt-dlpLinux
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlpmacOS
brew install yt-dlpFFmpeg erhalten Sie unter Windows ebenfalls über winget install ffmpeg, unter macOS über brew install ffmpeg und unter Debian/Ubuntu über sudo apt install ffmpeg.
Grundlegende Befehle im Überblick
Die folgende Tabelle zeigt die häufigsten Anwendungsfälle und den jeweils passenden Befehl:
| Funktion | Befehl |
|---|---|
| Video in bester Qualität herunterladen | yt-dlp URL |
| Verfügbare Formate anzeigen | yt-dlp -F URL |
| Bestimmtes Format wählen (z. B. 1080p) | yt-dlp -f "bestvideo[height=1080]+bestaudio" URL |
| Nur Audio als MP3 extrahieren | yt-dlp -x --audio-format mp3 URL |
| Playlist herunterladen | yt-dlp --yes-playlist URL |
| Untertitel mitladen (Deutsch) | yt-dlp --write-sub --sub-lang de URL |
| Thumbnail einbetten | yt-dlp --embed-thumbnail URL |
| Ausgabepfad und Dateinamen festlegen | yt-dlp -o "%(title)s.%(ext)s" URL |
| Bereits heruntergeladene überspringen | yt-dlp --download-archive archiv.txt URL |
| Update auf neueste Version | yt-dlp -U |
Formate auswählen: -f bestvideo+bestaudio
YouTube liefert seit einigen Jahren Video und Audio als separate Streams. Der Befehl -f bestvideo+bestaudio lädt beide herunter und lässt FFmpeg sie zu einer MKV- oder MP4-Datei zusammenführen. Möchten Sie gezielt 4K mit Opus-Audio:
yt-dlp -f "bestvideo[ext=webm][height=2160]+bestaudio[ext=webm]" --merge-output-format mkv URLMit yt-dlp -F URL sehen Sie alle verfügbaren Format-IDs – so können Sie auch gezielt eine bestimmte Bitrate oder einen Codec auswählen.
MP3 und Audio extrahieren
Für Podcasts, Musikvideos oder Vorträge reicht oft die Audiospur. yt-dlp delegiert die Konvertierung an FFmpeg:
yt-dlp -x --audio-format mp3 --audio-quality 0 URLDie Option --audio-quality 0 steht für die höchste verfügbare Qualität (VBR). Alternativ können Sie --audio-format aac, opus oder flac verwenden. Mit --embed-thumbnail --add-metadata werden Cover-Bild und ID3-Tags direkt in die MP3-Datei eingebettet.
Playlists und Kanäle herunterladen
Playlist-Downloads funktionieren genau wie Einzel-Videos – yt-dlp erkennt Playlist-URLs automatisch. Mit --playlist-start 5 --playlist-end 20 laden Sie nur bestimmte Einträge. Für ganze YouTube-Kanäle übergeben Sie die Kanal-URL; kombiniert mit --download-archive archiv.txt werden bereits gespeicherte Dateien übersprungen, sodass Sie den Befehl regelmäßig als Synchronisation ausführen können.
~/.config/yt-dlp/config unter Linux/macOS bzw. %APPDATA%\yt-dlp\config.txt unter Windows), um Standardoptionen wie Ausgabepfad und Formatpräferenz dauerhaft zu speichern.SponsorBlock-Integration
Eine der beliebtesten Erweiterungen gegenüber youtube-dl ist die native SponsorBlock-Unterstützung. Damit werden Werbesegmente, Intros und Outros, die die Community markiert hat, beim Download automatisch herausgeschnitten:
yt-dlp --sponsorblock-remove sponsor,intro,outro URLDie verfügbaren Kategorien sind sponsor, intro, outro, selfpromo, preview, filler und music_offtopic. Mehr dazu erklärt die offizielle Dokumentation.
Cookie-Authentifizierung für Premium-Inhalte
Einige Inhalte sind nur für eingeloggte Nutzer zugänglich – etwa altersgeschützte Videos oder Inhalte auf Patreon. yt-dlp kann Cookies aus dem Browser nutzen:
yt-dlp --cookies-from-browser firefox URLUnterstützte Browser sind Firefox, Chrome, Chromium, Brave, Opera und Edge. Alternativ können Sie Cookies manuell als Netscape-Datei exportieren und mit --cookies cookies.txt übergeben.
Rechtliches
yt-dlp ist ein neutrales Werkzeug. Die Rechtmäßigkeit eines Downloads hängt ausschließlich davon ab, was Sie herunterladen. Folgende Grundregeln sollten Sie beachten:
- Das Herunterladen urheberrechtlich geschützter Inhalte ohne Erlaubnis des Rechteinhabers ist in Deutschland und den meisten Ländern illegal.
- Das Speichern von frei lizenzierten Inhalten (Creative Commons, Public Domain) ist problemlos möglich.
- Eigene Inhalte und Backups von Plattformen, auf denen Sie die Inhalte legal erworben haben, sind im persönlichen Rahmen in der Regel zulässig.
- Das Umgehen technischer Schutzmaßnahmen ist gesondert verboten, auch wenn der Inhalt selbst legal wäre.
Weitere Informationen bietet die Seite der Verbraucherzentrale.
Häufige Fragen (FAQ)
- yt-dlp gibt einen Fehler aus – was tun?
- Führen Sie zunächst
yt-dlp -Uaus, um auf die neueste Version zu aktualisieren. Viele Fehler entstehen, weil YouTube seine API geändert hat und eine ältere yt-dlp-Version noch keine Unterstützung dafür enthält. - Wie lade ich nur die beste Audioqualität ohne Video herunter?
- Mit
yt-dlp -f bestaudio --extract-audio --audio-format opus URLerhalten Sie die verlustfreiste mögliche Audiospur. Opus bietet bei kleiner Dateigröße eine exzellente Klangqualität. - Kann ich yt-dlp für automatische Backups meines Kanals nutzen?
- Ja. Legen Sie ein Skript an, das
yt-dlp --download-archive archiv.txt KANAL-URLtäglich via Aufgabenplanung (Windows) oder Cron (Linux) ausführt. Nur neue Videos werden dann heruntergeladen. - Unterstützt yt-dlp auch Instagram oder TikTok?
- Ja, beide Plattformen werden unterstützt. Für private Inhalte oder Stories benötigen Sie die Cookie-Authentifizierung. Beachten Sie die Nutzungsbedingungen der jeweiligen Plattform.