Zum Inhalt springen
yt-dlp
Sprache wechseln

yt-dlp Optionsreferenz

Geschrieben für yt-dlp 2026.07.21. Zwischen den Versionen werden Optionen hinzugefügt und umbenannt, prüfe deine also mit yt-dlp --version.

Grundlagen

Was möchtest du

Nur Audio extrahiert die Tonspur und verwirft das Video.

Video und Qualität

-f FORMAT --format

Maximale Qualität

Begrenzt die Höhe. yt-dlp wählt trotzdem die beste Spur auf oder unter dieser Grenze.

-f FORMAT --format

Eigener format selector

Ersetzt die Qualitätsauswahl. Für Leute, die die Format-Syntax schon kennen.

Beispiele

  • -f "bv*[vcodec^=av01]+ba"
  • -f "b[filesize<50M]"
--remux-video FORMAT braucht ffmpeg

Remux nach

Packt die Spuren neu, ohne neu zu kodieren. Schnell und verlustfrei.

--recode-video FORMAT braucht ffmpeg

Neu kodieren nach

Kodiert das Video neu. Langsam und verlustbehaftet — nur wenn remux nicht ausreicht.

Audio

--audio-quality QUALITY braucht ffmpeg

Audioqualität

VBR liefert das beste Verhältnis von Größe zu Qualität; feste bitrates sind besser vorhersehbar.

Untertitel

Untertitel

Einbetten legt sie in das Video; Speichern schreibt eine eigene .srt-Datei daneben.

--sub-langs LANGS

Untertitelsprachen

Mit Komma getrennt. Für alle verfügbaren Sprachen schreibe all.

Beispiele

  • --sub-langs "en,vi"
  • --sub-langs "en.*,ja"
  • --sub-langs all
--write-auto-subs

Automatisch erzeugte Untertitel

Nimmt maschinell erzeugte Untertitel mit, wenn keine von Menschen existieren.

Playlists und Kanäle

Playlist-Verhalten

Was passieren soll, wenn die URL gleichzeitig zu einem Video und einer Playlist gehört.

-I ITEM_SPEC --playlist-items

Welche Einträge

Bereiche und Listen funktionieren beide, etwa 1-10,15 oder -5::2 für jeden zweiten Eintrag von hinten.

Beispiele

  • -I 1:5
  • -I "1,3,7-10"
  • -I "-5::2"
--download-archive FILE

Protokolldatei

Hält fest, was schon geladen wurde, damit ein erneuter Lauf es überspringt. So hält man einen Kanal synchron.

Abschnitte und Kapitel

--download-sections REGEX braucht ffmpeg

Nur einen Abschnitt laden

Ein Zeitbereich wie *00:01:30-00:03:00 oder ein Kapitelname. Der Stern davor bedeutet, dass es ein Zeitstempel ist.

Beispiele

  • --download-sections "*00:01:30-00:03:00"
  • --download-sections "intro"
--split-chapters braucht ffmpeg

In Kapitel aufteilen

Schreibt eine Datei pro Kapitel statt einer langen.

Metadaten und Cover

--embed-metadata braucht ffmpeg

Metadaten einbetten

Schreibt Titel, Uploader und Datum in die Datei selbst.

--embed-chapters braucht ffmpeg

Kapitel einbetten

Fügt Kapitelmarken hinzu, zwischen denen dein Player springen kann.

--write-info-json

Metadaten als JSON speichern

Schreibt alles, was yt-dlp über das Video weiß, in eine .info.json-Datei.

SponsorBlock

--sponsorblock-remove CATS braucht ffmpeg

Abschnitte entfernen

Schneidet die von der Community markierten Abschnitte anhand der SponsorBlock-Daten aus der Datei heraus.

--sponsorblock-mark CATS

Abschnitte als Kapitel markieren

Behält die Abschnitte, markiert sie aber, damit du selbst überspringen kannst.

Dateien und Ordner

-o [TYPES:]TEMPLATE --output

Vorlage für den Dateinamen

Feldnamen stehen in %(...)s. Schrägstriche erzeugen Ordner.

Beispiele

  • -o "%(title)s.%(ext)s"
  • -o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH --paths

Zielordner

Wohin die Dateien geschrieben werden. Kombiniert mit der Vorlage oben entstehen Unterordner.

--restrict-filenames

Sichere Dateinamen (nur ASCII)

Entfernt Akzente, Leerzeichen und alles, was ein eigenwilliges Dateisystem ablehnen könnte.

--windows-filenames

Windows-taugliche Namen

Entfernt Zeichen, die Windows ablehnt, auch wenn du auf einem anderen System arbeitest.

-w --no-overwrites

Nie überschreiben

Überspringt alles, was bereits heruntergeladen ist.

-c --continue

Abgebrochene Downloads fortsetzen

Macht dort weiter, wo der Download abgebrochen ist.

Filter

--dateafter DATE

Hochgeladen nach

JJJJMMTT oder ein relatives Datum wie now-1month.

Beispiele

  • --dateafter 20240101
  • --dateafter now-1month

Netzwerk

-r RATE --limit-rate

Geschwindigkeitsbegrenzung

Zum Beispiel 2M oder 500K. Nützlich, wenn du die restliche Bandbreite brauchst.

-N N --concurrent-fragments

Parallele fragments

Beschleunigt fragmentierte Streams. Vier ist ein sinnvoller Startwert.

-R RETRIES --retries

Wiederholungen

Wie oft ein fehlgeschlagener Teil erneut versucht wird. infinite ist erlaubt.

--proxy URL

Proxy

Adresse eines HTTP-, HTTPS- oder SOCKS-Proxy.

--geo-bypass

Ländersperre umgehen

Täuscht die Herkunft der Anfrage vor. Funktioniert bei manchen Seiten, nicht bei allen.

--impersonate CLIENT[:OS]

Als Browser ausgeben

Lässt Anfragen wie von einem echten Browser aussehen. Die übliche Lösung, wenn plötzlich 403 kommt.

Anmeldung und cookies

--cookies FILE

Cookies-Datei

Eine cookies.txt im Netscape-Format, exportiert aus deinem Browser.

Livestreams

--live-from-start

Von Anfang an aufnehmen

Beginnt einen Livestream am Anfang statt beim aktuellen Moment.

--wait-for-video MIN[-MAX]

Auf den Stream warten

Fragt nach, bis ein geplanter Stream beginnt. MIN-MAX sind die Sekunden zwischen den Prüfungen.

Behelfslösungen

--user-agent UA veraltet — --add-headers

User agent

Veraltet, ersetzt durch --add-headers. Bleibt drin, weil viele ältere Anleitungen es noch verwenden.

--referer URL veraltet — --add-headers

Referer

Veraltet, ersetzt durch --add-headers.

--extractor-args IE_KEY:ARGS

Extractor-Argumente

Seitenspezifische Schalter, zum Beispiel youtube:player_client=web.

Beispiele

  • --extractor-args "youtube:player_client=web,android"

Ausgabe und Debugging

-i --ignore-errors

Bei Fehlern weitermachen

Überspringt fehlgeschlagene Einträge statt abzubrechen. Bei großen Playlists unverzichtbar.

-F --list-formats

Nur Formate auflisten

Gibt die verfügbaren Formate aus und beendet sich ohne Download.

-s --simulate

Simulieren

Macht alles außer die Datei zu schreiben.