YouTube zu MP3 mit yt-dlp

Stelle den yt-dlp-Befehl zusammen, der ein YouTube-Video in eine getaggte MP3 mit Cover verwandelt.

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 -x --audio-format mp3 --audio-quality 0 --no-playlist --embed-thumbnail --embed-metadata -o '%(artist,uploader)s - %(title)s.%(ext)s' 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

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

Audioformat --audio-format Die Datei, in die das Audio konvertiert wird.
Audioqualität --audio-quality VBR liefert das beste Verhältnis von Größe zu Qualität; feste bitrates sind besser vorhersehbar.
Thumbnail einbetten --embed-thumbnail Nimmt das Video-Thumbnail als Cover.
Metadaten einbetten --embed-metadata Schreibt Titel, Uploader und Datum in die Datei selbst.

So bekommst du eine brauchbare MP3

Audio zu extrahieren ist eine Konvertierung, also ist ffmpeg zwingend — genau daran scheitert der Befehl auf einer frischen Installation. Beste (VBR) ist die richtige Voreinstellung: das Verhältnis von Größe zu Qualität ist am besten, und eine höhere feste bitrate kann keine Qualität hinzufügen, die die Quelle nie hatte.

Cover und Metadaten machen aus einem Ordner namenloser Dateien etwas, das ein Musikplayer sortieren kann. Die Vorlage hier stellt den Interpreten voran und nimmt den Uploader, wenn kein Interpret getaggt ist.

Häufig gestellte Fragen

› Welche MP3-Qualität soll ich wählen?

In den meisten Fällen beste (VBR) — das Verhältnis von Größe zu Qualität ist dort am besten. 320 kbit/s lohnt nur, wenn etwas weiter hinten eine feste bitrate verlangt. Beides fügt keine Qualität hinzu, die die Quelle nie hatte.

› Warum scheitert die MP3-Extraktion?

Audio zu konvertieren braucht ffmpeg. Installiere es und prüfe mit ffmpeg -version.

› VBR oder feste bitrate?

VBR verteilt die Bits dorthin, wo sie zählen, und ist bei gleichem Hörergebnis kleiner. Eine feste bitrate nur, wenn ein Gerät oder Programm darauf besteht.

› Kann ich eine ganze Playlist in MP3 wandeln?

Ja — Audio-Ausgabe plus Modus ganze Playlist. Ergänze eine Protokolldatei, damit ein erneuter Lauf die Konvertierungen nicht wiederholt.