yt-dlp Befehlsgenerator für SoundCloud

Stelle einen yt-dlp-Befehl für SoundCloud-Tracks und -Sets zusammen — getaggt und fertig für die Musikbibliothek.

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 --embed-thumbnail --embed-metadata -o '%(uploader)s - %(title)s.%(ext)s' https://soundcloud.com/artist/track

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.

Das Audioformat wählen

SoundCloud liefert meist MP3 mit 128 kbit/s, manchmal Opus. Eine 128er-Quelle auf 320 zu wandeln ergibt eine größere Datei, die nicht besser klingt — "beste verfügbare" behält das Original und ist die richtige Voreinstellung.

Cover und Metadaten lohnen sich: ohne sie kommt ein geladenes Set als Ordner titelloser Dateien an. Sets und Playlists funktionieren im Modus ganze Playlist.

Häufig gestellte Fragen

› Welche Audioqualität liefert SoundCloud?

Meist MP3 mit 128 kbit/s, manchmal Opus. Eine 128er-Quelle in MP3 mit 320 kbit/s zu wandeln macht die Datei größer, aber nicht besser — wähle "beste verfügbare", um das Original zu behalten.

› Kann ich eine SoundCloud-Playlist laden?

Ja. Nimm die Set- oder Playlist-URL im Modus ganze Playlist, plus eine Protokolldatei für wiederholte Läufe.

› Funktionieren private oder nicht gelistete Tracks?

Tracks mit geheimem Link funktionieren meist, wenn du die vollständige URL übergibst. Wirklich private brauchen cookies eines Kontos mit Zugang.