yt-dlp Befehlsgenerator für X (Twitter)

Stelle einen yt-dlp-Befehl für ein Video auf X zusammen — mit vorhersehbaren Dateinamen und den Optionen, die sensible Inhalte verlangen.

URL von Video, Playlist oder Kanal

Optional. Lässt du es leer, endet der Befehl mit URL, das du selbst einsetzt.

Dein Befehl

yt-dlp --merge-output-format mp4 --no-playlist -o '%(uploader_id)s - %(id)s.%(ext)s' https://x.com/user/status/1234567890

Grundlagen

Was möchtest du

Video Nur Audio

Nur Audio extrahiert die Tonspur und verwirft das Video.

Video und Qualität

Maximale Qualität -f

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

Container --merge-output-format braucht ffmpeg

Der Dateityp, in den getrennte Video- und Audiospuren zusammengeführt werden.

Erweiterte Optionen (3)

Eigener format selector -f

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

Remux nach --remux-video braucht ffmpeg

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

Neu kodieren nach --recode-video braucht ffmpeg

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

Audio

Audioformat --audio-format braucht ffmpeg

Die Datei, in die das Audio konvertiert wird.

Audioqualität --audio-quality braucht ffmpeg

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

Untertitel

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

Untertitelsprachen --sub-langs

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

Automatisch erzeugte Untertitel --write-auto-subs 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.

Welche Einträge -I

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

Erweiterte Optionen (1)

Protokolldatei --download-archive

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

Abschnitte und Kapitel

Erweiterte Optionen (2)

Nur einen Abschnitt laden --download-sections braucht ffmpeg

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

In Kapitel aufteilen --split-chapters braucht ffmpeg Schreibt eine Datei pro Kapitel statt einer langen.

Metadaten und Cover

Thumbnail einbetten --embed-thumbnail braucht ffmpeg Nimmt das Video-Thumbnail als Cover.

Metadaten einbetten --embed-metadata braucht ffmpeg Schreibt Titel, Uploader und Datum in die Datei selbst.

Kapitel einbetten --embed-chapters braucht ffmpeg Fügt Kapitelmarken hinzu, zwischen denen dein Player springen kann.

Erweiterte Optionen (3)

Thumbnail als Datei speichern --write-thumbnail Schreibt das Coverbild neben das Video.

Beschreibung speichern --write-description Schreibt die Beschreibung in eine .description-Datei.

Metadaten als JSON speichern --write-info-json Schreibt alles, was yt-dlp über das Video weiß, in eine .info.json-Datei.

SponsorBlock

Abschnitte entfernen --sponsorblock-remove braucht ffmpeg

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

Erweiterte Optionen (1)

Abschnitte als Kapitel markieren --sponsorblock-mark

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

Dateien und Ordner

Vorlage für den Dateinamen -o

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

Sichere Dateinamen (nur ASCII) --restrict-filenames Entfernt Akzente, Leerzeichen und alles, was ein eigenwilliges Dateisystem ablehnen könnte.

Vorhandene Dateien überschreiben --force-overwrites Ersetzt Dateien, die schon da sind.

Abgebrochene Downloads fortsetzen -c Macht dort weiter, wo der Download abgebrochen ist.

Erweiterte Optionen (4)

Zielordner -P

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

Windows-taugliche Namen --windows-filenames Entfernt Zeichen, die Windows ablehnt, auch wenn du auf einem anderen System arbeitest.

Namen kürzen auf --trim-filenames

Maximale Länge des Dateinamens in Zeichen.

Nie überschreiben -w Überspringt alles, was bereits heruntergeladen ist.

Filter

Erweiterte Optionen (5)

Hochgeladen nach --dateafter

JJJJMMTT oder ein relatives Datum wie now-1month.

Hochgeladen vor --datebefore

JJJJMMTT oder ein relatives Datum.

Mindestgröße --min-filesize

Überspringt alles Kleinere. Akzeptiert 5M, 500K und Ähnliches.

Maximalgröße --max-filesize

Überspringt alles Größere.

Aufhören nach --max-downloads

Anzahl der Dateien, die geladen werden, bevor Schluss ist.

Netzwerk

Geschwindigkeitsbegrenzung -r

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

Erweiterte Optionen (5)

Parallele fragments -N

Beschleunigt fragmentierte Streams. Vier ist ein sinnvoller Startwert.

Wiederholungen -R

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

Proxy --proxy

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

Ländersperre umgehen --geo-bypass Täuscht die Herkunft der Anfrage vor. Funktioniert bei manchen Seiten, nicht bei allen.

Als Browser ausgeben --impersonate

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

Anmeldung und cookies

Cookies aus dem Browser --cookies-from-browser

Liest deine angemeldete Sitzung direkt. Nötig für private, altersbeschränkte oder Mitglieder-Inhalte.

Erweiterte Optionen (1)

Cookies-Datei --cookies

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

Livestreams

Erweiterte Optionen (2)

Von Anfang an aufnehmen --live-from-start Beginnt einen Livestream am Anfang statt beim aktuellen Moment.

Auf den Stream warten --wait-for-video

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

Behelfslösungen

Erweiterte Optionen (3)

User agent --user-agent veraltet

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

Referer --referer veraltet

Veraltet, ersetzt durch --add-headers.

Extractor-Argumente --extractor-args

Seitenspezifische Schalter, zum Beispiel youtube:player_client=web.

Ausgabe und Debugging

Nur Formate auflisten -F Gibt die verfügbaren Formate aus und beendet sich ohne Download.

Erweiterte Optionen (2)

Bei Fehlern weitermachen -i Überspringt fehlgeschlagene Einträge statt abzubrechen. Bei großen Playlists unverzichtbar.

Simulieren -s Macht alles außer die Datei zu schreiben.

Zurücksetzen

Die Optionen, auf die es hier ankommt

Maximale Qualität -f Begrenzt die Höhe. yt-dlp wählt trotzdem die beste Spur auf oder unter dieser Grenze.
Cookies aus dem Browser --cookies-from-browser Liest deine angemeldete Sitzung direkt. Nötig für private, altersbeschränkte oder Mitglieder-Inhalte.
Vorlage für den Dateinamen -o Feldnamen stehen in %(...)s. Schrägstriche erzeugen Ordner.

Hinweise zu X

Sowohl x.com- als auch twitter.com-Adressen funktionieren. Was auf X GIF heißt, sind tatsächlich kurze MP4-Videos, sie laden also wie jedes andere Video; wandle danach um, wenn du ein echtes GIF brauchst.

Beiträge mit sensiblen Inhalten brauchen eine angemeldete Sitzung mit der entsprechenden Einstellung. Die Standardvorlage benennt Dateien nach Autor und Beitrags-id, sodass ein Ordner voll davon noch überschaubar bleibt.

Häufig gestellte Fragen

› Warum scheitert ein altersbeschränkter Beitrag auf X?

Sensible Inhalte brauchen eine angemeldete Sitzung. Nutze --cookies-from-browser mit einem Konto, bei dem die entsprechende Einstellung aktiv ist.

› Wie lade ich ein GIF von X?

Es sind MP4-Videos, keine GIFs, und sie laden wie jedes andere Video. Wandle danach um, wenn du ein echtes GIF brauchst.

› Kann ich auf X die Videoqualität wählen?

Ja. X veröffentlicht mehrere Fassungen: begrenze die Höhe über die Qualitätsauswahl oder lass sie dir zuerst mit -F auflisten.