Einfache Downloads
Ganz ohne Optionen wählt yt-dlp die beste Kombination, die es zusammenführen kann, und benennt die Datei nach dem Titel. Erstaunlich oft ist das genau der richtige Befehl.
yt-dlp URL
Bevor du etwas Großes herunterlädst, lohnt sich ein Blick darauf, was tatsächlich angeboten wird. Das gibt die Formattabelle aus und beendet sich, ohne etwas zu laden.
yt-dlp -F URL
Die linke Spalte dieser Tabelle ist die Format-ID, die du danach direkt anfordern kannst. Zwei mit + verbundene IDs bedeuten „beide laden und zusammenführen“.
yt-dlp -f 137+140 URL
Qualität und Formatauswahl
Fest eingetragene Format-IDs brechen, sobald eine Seite ihre Encoding-Stufen ändert. Ein Selektor-Ausdruck ist die haltbare Variante: Frag nach den Eigenschaften, die du willst, und lass yt-dlp die beste Übereinstimmung finden.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
Zu lesen als: der beste Videostream nicht höher als 1080 plus das beste Audio, und falls es dieses Paar nicht gibt, die beste Einzeldatei nicht höher als 1080. Genau dieser Rückfall nach dem Schrägstrich verhindert, dass der Befehl auf Seiten scheitert, die nur progressive Streams anbieten.
Beim Zusammenführen zweier Streams muss yt-dlp einen Container wählen. MP4 läuft überall; MKV nimmt alles, was du hineinwirfst, und das zählt, sobald Untertitel und Kapitel im Spiel sind.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Wenn du eine Präferenz statt einer harten Grenze ausdrücken willst, sortiere statt zu filtern. Das bevorzugt 1080p und MP4, lädt aber trotzdem etwas, wenn keins von beidem verfügbar ist.
yt-dlp -S "res:1080,ext:mp4" URL
Audio und MP3
Audio zu extrahieren braucht ffmpeg — das ist mit Abstand der häufigste Grund, warum der Befehl unten auf einer frischen Installation scheitert.
yt-dlp -x --audio-format mp3 URL
Cover und Tags kosten zwei weitere Flags und machen aus dem Ergebnis etwas, das in einer Musikbibliothek brauchbar ist, statt eines Ordners namenloser Dateien.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
--audio-quality 0 bedeutet variable Bitrate in der besten Einstellung, nicht „Qualität null“. Wenn du eine feste Bitrate brauchst, gib sie an: --audio-quality 320K.
Wenn die Quelle bereits AAC oder Opus ist, kodiert die Umwandlung nach MP3 neu und verliert Qualität ohne Gegenwert. Das Original zu behalten ist schneller und besser.
yt-dlp -x --audio-format best URL
Untertitel
Eingebettete Untertitel reisen mit der Datei; separate .srt-Dateien lassen sich leichter bearbeiten und weitergeben.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Automatisch erzeugte Untertitel sind ein eigener Schalter. Ohne ihn liefert ein Video ohne menschliche Untertitel überhaupt nichts — und keine Fehlermeldung.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Playlists und Kanäle
Eine YouTube-URL gehört oft gleichzeitig zu einem Video und zu einer Playlist, und yt-dlp muss raten, was gemeint war. Sag es ausdrücklich.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Für alles Längere zählt die Archivdatei mehr als jede andere Option hier: Sie hält fest, was bereits geladen wurde, sodass ein erneuter Lauf dort weitermacht, wo er aufgehört hat, statt von vorn zu beginnen.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
Zusammen mit -i bricht ein regionsgesperrtes oder gelöschtes Video nicht mehr die anderen zweihundert ab. Um nur einen Ausschnitt zu holen, nimmt -I Bereiche und Listen: -I 1:10, -I "1,3,7-10".
Ausschnitte, Kapitel und Sponsoren
Du kannst einen Teil eines Videos statt des ganzen laden. Das führende Sternchen markiert einen Zeitstempel statt eines Kapitelnamens, und die Anführungszeichen sind Pflicht — bash expandiert ein nacktes * gegen deine Dateinamen.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
SponsorBlock nutzt von der Community eingereichte Marker, um Abschnitte ganz herauszuschneiden oder sie als Kapitel stehen zu lassen, die du selbst überspringen kannst.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Dateinamen und Ordner
Das Ausgabe-Template steuert beides. Ein Schrägstrich legt ein Verzeichnis an, sodass ein einziges Template ein ganzes Archiv strukturieren kann.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Titel enthalten regelmäßig Zeichen, die manche Dateisysteme ablehnen. --restrict-filenames reduziert alles auf reines ASCII, was sich für alles lohnt, das zwischen Rechnern bewegt wird.
In einer Windows-.bat-Datei muss jedes % verdoppelt werden — %%(title)s — sonst frisst der Batch-Interpreter das Template, bevor yt-dlp es sieht. Der Generator erledigt das für dich, wenn du eine .bat herunterlädst.
Fehler, die dir wirklich begegnen
ffmpeg not found
Alles, was zusammenführt, konvertiert, einbettet oder schneidet, braucht ffmpeg im PATH. Installiere es und bestätige mit ffmpeg -version.
Sign in to confirm you are not a bot
Probiere zuerst --impersonate chrome, dann --cookies-from-browser. Wenn beides scheitert, aktualisiere yt-dlp — genau diese Prüfung ändert sich oft, und die Lösung kommt meist innerhalb weniger Tage in einem Release.
Unable to extract player response
Fast immer ein veraltetes yt-dlp. Aktualisiere es, bevor du irgendetwas anderes änderst: yt-dlp -U, oder über deinen Paketmanager, falls du es so installiert hast.
Requested format is not available
Dein Selektor hat auf nichts gepasst. Führe -F aus, um zu sehen, was es gibt, und nimm lieber eine Sortierung (-S) als einen harten Filter, damit es immer einen Rückfall gibt.
HTTP Error 403
Die URL war für eine andere Sitzung oder Region signiert. Führe es mit frischen Cookies erneut aus, ergänze --impersonate chrome oder probiere --geo-bypass.
yt-dlp aktuell halten
Mehr gemeldete Fehler werden durch ein Update behoben als durch irgendein Flag. Wenn du die eigenständige Binärdatei installiert hast:
yt-dlp -U
Über einen Paketmanager installiert, aktualisiere es auf demselben Weg — -U verweigert sich, und das zu Recht.