Zum Inhalt springen
yt-dlp

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.

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

Nur Audio extrahiert die Tonspur und verwirft das Video.

Video und Qualität

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

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

Erweiterte Optionen (3)

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

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

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

Audio

Die Datei, in die das Audio konvertiert wird.

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.

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

Playlists und Kanäle

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

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

Erweiterte Optionen (1)

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)

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

Metadaten und Cover
Erweiterte Optionen (3)
SponsorBlock

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

Erweiterte Optionen (1)

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

Dateien und Ordner

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

Erweiterte Optionen (4)

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

Maximale Länge des Dateinamens in Zeichen.

Filter
Erweiterte Optionen (5)

JJJJMMTT oder ein relatives Datum wie now-1month.

JJJJMMTT oder ein relatives Datum.

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

Überspringt alles Größere.

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

Netzwerk

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

Erweiterte Optionen (5)

Beschleunigt fragmentierte Streams. Vier ist ein sinnvoller Startwert.

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

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

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

Anmeldung und cookies

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

Erweiterte Optionen (1)

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

Livestreams
Erweiterte Optionen (2)

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

Behelfslösungen
Erweiterte Optionen (3)

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

Veraltet, ersetzt durch --add-headers.

Seitenspezifische Schalter, zum Beispiel youtube:player_client=web.

Ausgabe und Debugging
Erweiterte Optionen (2)
Zurücksetzen

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.

SoundCloud liefert die meisten Streams mit 128 kbit/s Opus, die "Go+"-Tracks mit 256 — aber nur an Sitzungen, die es für berechtigt hält. Spielt ein Track auf der Seite in höherer Qualität, als yt-dlp holt, sind cookies aus einem angemeldeten Browser meist der Unterschied: Die Staffel, die deine Sitzung sieht, ist die Staffel, die yt-dlp bekommt. Die -F-Auflistung zeigt, welche Formate es für den Track gibt, auf dem du gerade bist.

Die Download-Adresse ist nicht immer dort, wo das Audio wohnt: SoundCloud liefert Medien aus einem CDN hinter kurzlebigen signierten Links, eine aus einem Browser-Tab kopierte Medien-Adresse funktioniert also einmal und danach nie wieder — gib yt-dlp immer die Track-Seite und lass es auflösen. Reposts sind ein eigener Eintrag, der auf dasselbe Audio zeigt; die Archivdatei verhindert, dass ein Set-Download sie zweimal holt.

Sets (der SoundCloud-Name für Playlists) sind dort, wo der eigentliche Wert liegt. Ein Set mit zweihundert Tracks kommt seitenweise, und der Lauf dauert; die Archivdatei macht aus dem zweiten Lauf ein Delta aus nur den neu hinzugekommenen Tracks. "Bei Fehlern weitermachen" zählt, weil Sets gelöschte Tracks ansammeln — ein Produzent zieht ein Sample zurück, und ohne den Schalter bricht ein einziger 404 die anderen achtzig Tracks ab.

Zum Benennen: SoundCloud-Titel sind lang und tragen den Interpreten im Titel, deshalb macht die Standardvorlage Interpret-dann-Titel Duplikate sichtbar statt lautlos — zwei Dateien mit demselben Namen sind meist zwei Uploads desselben Tracks mit unterschiedlicher bitrate. Das Cover kommt aus der Artwork-Adresse und lädt in seiner größten Größe; wirkt das Cover falsch, war es auch auf der Plattform falsch.

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.