spotDL

Spotify-Downloader

spotDL ist ein kostenloser, quelloffener Spotify-Downloader, der Titel, Alben, Playlists und Künstler in organisierte lokale Audiodateien verwandelt - mit eingebauten Metadaten, Album-Cover und Songtexten.

Terminal
pip install spotdl
Kostenlos & quelloffen Läuft zu 100 % lokal MIT-lizenziert Windows · macOS · Linux

Spotify liefert die Titel- und Playlist-Informationen. Das Audio stammt von YouTube Music, YouTube oder einem anderen konfigurierten Anbieter - nicht von Spotify.

Spotify-Links rein. Sauber organisierte Dateien raus.

Streaming ist großartig, um Musik zu entdecken und zu organisieren, liefert aber keine gewöhnlichen Audiodateien, die Sie selbst verwalten können. spotDL verbindet diese beiden Workflows.

Ein Spotify-Link liefert strukturierte Details - Songtitel, Künstler, Album, Erscheinungsdatum, Titelnummer und Cover. spotDL sucht bei einem unterstützten Anbieter nach einer passenden Übereinstimmung, lädt das Audio herunter, konvertiert es bei Bedarf und bettet die Metadaten ein. Das Ergebnis ist eine portable Musiksammlung und kein Ordner voller nicht identifizierter Downloads.

So funktioniert spotDL

Drei Schritte von einem Spotify-Link zu einer getaggten, abspielbereiten Musikdatei.

1

Spotify-Link oder Suchbegriff hinzufügen

Fügen Sie einen Link zu einem Titel, Album, einer Playlist oder einem Künstler ein - oder finden Sie einen Song per einfacher Textsuche. Mehrere Links und Suchanfragen können im selben Befehl stehen.

Terminal
spotdl download "The Weeknd - Blinding Lights"
2

spotDL findet das Audio

spotDL liest die Spotify-Metadaten und durchsucht standardmäßig YouTube Music. Abgleich und Filterung trennen die gewünschte Aufnahme von Coverversionen, Remixen, Live-Versionen und nicht verwandten Ergebnissen.

Terminal
spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b
3

Eine vollständige Musikdatei speichern

Das Audio wird mit FFmpeg verarbeitet, anschließend werden Metadaten, Cover und verfügbare Songtexte automatisch eingebettet - wobei Format, Ordner, Dateinamen und Überschreibverhalten vollständig konfigurierbar sind.

Terminal
spotdl download [URL] --output "{artist}/{album}/{track-number} - {title}.{output-ext}"

Mehr als ein einfacher Downloader

Eine fokussierte Anwendung, um Spotify-Links in eine strukturierte, pflegbare Musikbibliothek zu verwandeln.

Titel, Alben, Playlists & Künstler

Akzeptiert Spotify-URLs für einzelne Titel, ganze Alben, Playlists und Künstlerseiten - dazu Textsuchen und gemischte Stapel.

Automatischer Titelabgleich

Die Spotify-Metadaten erstellen und filtern die Suche, um eine passende Aufnahme zu finden, statt das erste vage verwandte Video.

Eingebettete Metadaten

Titel, Künstler, Album, Album-Künstler, Cover, Titel- und CD-Nummern, Jahr, Genre, Label, ISRC, Spotify-ID und Songtexte.

Songtexte & synchronisierte .lrc-Dateien

Sammeln Sie Songtexte von Genius, Musixmatch oder AZLyrics und erzeugen Sie separate synchronisierte .lrc-Dateien für kompatible Player.

Sechs Ausgabeformate

MP3, M4A, Opus, OGG, FLAC und WAV - wählen Sie, was Ihr Player oder Workflow benötigt.

Konfigurierbare Dateinamen & Ordner

Ausgabevorlagen erstellen eine vorhersehbare {artist}/{album}-Bibliothek statt eines einzigen Ordners mit uneinheitlichen Namen.

M3U-Playlist-Erstellung

Erstellen Sie M3U- oder M3U8-Playlist-Dateien zusammen mit dem Audio, einschließlich einer separaten Datei pro Liste bei einem Auftrag mit mehreren Listen.

Duplikat- & Überschreibsteuerung

Überspringen, Metadaten aktualisieren, einen erneuten Download erzwingen, nach vorhandenen Songs suchen oder ein Archiv abgeschlossener Downloads führen.

Mehrere Audioanbieter

YouTube Music standardmäßig, mit YouTube, SoundCloud, Bandcamp, Piped und slider.kz als Alternativen oder Ausweichoptionen.

Playlist-Synchronisierung

Eine .spotdl-Synchronisierungsdatei hält einen lokalen Ordner im Einklang mit einer sich ändernden Spotify-Playlist oder einem Album.

Wiederverwendbare Konfiguration

Speichern Sie bevorzugte Formate, Vorlagen, Anbieter, Threads und Regeln einmal - sie werden bei jedem Lauf automatisch geladen.

Lokale Web-Oberfläche

Eine einfache Browser-Oberfläche für einzelne Downloads, gehostet auf Ihrem eigenen Rechner - kein entfernter Konvertierungsdienst.

spotDL herunterladen

Windows

Ausführbare 64-Bit-Datei (.exe)

Herunterladen

macOS

Natives Binary

Herunterladen

Linux

x86-64-Binary

Herunterladen

Vorgefertigte App: Wird sie ohne Argumente geöffnet, startet die lokale Web-Oberfläche für einfache Einzeltitel-Downloads. Playlist-Sync, Stapelaufträge und erweiterte Steuerung befinden sich in der Befehlszeile. FFmpeg ist weiterhin erforderlich (spotdl --download-ffmpeg) und Deno wird empfohlen (spotdl --download-deno).

Mit Python installieren

Die Installation über Python wird für regelmäßige Nutzung, Updates, Automatisierung und den vollständigen Funktionsumfang der Befehlszeile empfohlen. Voraussetzungen: Python 3.10-3.14, FFmpeg 4.2+, Deno empfohlen und das Visual C++ Redistributable unter Windows.

Terminal
pip install spotdl

# eine bestehende Installation aktualisieren
pip install --upgrade spotdl

Docker

Ein gepflegtes Image eignet sich für Server, NAS-Systeme und reproduzierbare Umgebungen. Das eingebundene Musikverzeichnis muss für den Container-Benutzer beschreibbar sein.

Terminal
docker pull spotdl/spotify-downloader

docker run --rm -v $(pwd):/music \
  spotdl/spotify-downloader download [Spotify URL]

Termux, Arch & Quellcode-Builds

spotDL lässt sich auch unter Android via Termux, über das Arch User Repository oder durch das Bauen der ausführbaren Datei aus dem Quellcode mit uv installieren.

Terminal
# Termux (Android)
curl -L https://raw.githubusercontent.com/spotDL/spotify-downloader/master/scripts/termux.sh | sh

# Aus dem Quellcode bauen
git clone https://github.com/spotDL/spotify-downloader
cd spotify-downloader
pip install uv
uv sync
uv run scripts/build.py

Erforderliche Komponenten

FFmpeg

FFmpeg wird benötigt, um Audio zu verarbeiten, zu konvertieren und zu kennzeichnen. Installieren Sie es direkt in das spotDL-Verzeichnis oder systemweit über Ihren Paketmanager.

Terminal
spotdl --download-ffmpeg

# oder systemweit
brew install ffmpeg            # macOS
sudo apt install ffmpeg        # Debian / Ubuntu

Deno

Deno wird dringend empfohlen: Aktuelle YouTube-Downloads über yt-dlp erfordern möglicherweise eine JavaScript-Laufzeitumgebung. Ohne sie können einige Titel fehlschlagen, darunter bestimmte als für Kinder gedacht markierte Videos.

Terminal
spotdl --download-deno

Spotify-Authentifizierung

Öffentliche Links funktionieren für die Standard-Workflows von Titeln, Alben, Playlists, Künstlern und Suchen. Der Zugriff auf private Kontodaten - Lieblingssongs, persönliche Playlists, gefolgte Künstler, gespeicherte Alben - erfordert eine Spotify-Authentifizierung, und einige Verknüpfungen benötigen zudem die Option der offiziellen Spotify-API mit gültigen Anmeldedaten.

Beginnen Sie mit einem einzigen Befehl

Der Standardvorgang ist download. Die Dateien werden in dem Ordner gespeichert, in dem Sie spotDL ausführen, sofern kein --output-Pfad festgelegt ist.

Terminal
# ein einzelner Titel
spotdl download [track URL]

# ein ganzes Album
spotdl download [album URL]

# eine Playlist
spotdl download [playlist URL]

# der Katalog eines Künstlers
spotdl download [artist URL]

# nach Namen suchen
spotdl download "Artist - Song Title"

# mehrere Elemente auf einmal
spotdl download [track URL] [album URL] "Artist - Song Title"

Wenn der Befehl spotdl nicht verfügbar ist, das Paket aber installiert wurde, führen Sie ihn als Modul mit python -m spotdl [query] aus (oder python3 -m spotdl unter macOS / Linux).

Eine bestimmte YouTube-Übereinstimmung wählen

Der automatische Abgleich zielt auf die gewünschte Aufnahme ab, aber Sie können eine bestimmte YouTube-Quelle mit Spotify-Metadaten verknüpfen, wenn Sie exakte Kontrolle über das verwendete Audio möchten.

Terminal
spotdl download "https://www.youtube.com/watch?v=XXYlFuWEuKI|https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b"

Eine persönliche Spotify-Bibliothek herunterladen

Authentifizierte Verknüpfungen können Lieblingssongs, alle Ihre Playlists, gespeicherte Playlists, gefolgte Künstler und gespeicherte Alben verarbeiten. Diese erfordern eine Spotify-Authentifizierung; der aktuelle Workflow mit der offiziellen API ist für Spotify-Premium-Konten gedacht.

Terminal
spotdl download saved --user-auth --use-official-api
spotdl download all-user-playlists --user-auth --use-official-api
spotdl download all-saved-playlists --user-auth --use-official-api
spotdl download all-user-followed-artists --user-auth --use-official-api
spotdl download all-user-saved-albums --user-auth --use-official-api

Zu den Authentifizierungs-Flags gehören --user-auth, --use-official-api, --client-id, --client-secret, --auth-token, --cache-path, --no-cache, --headless und --max-retries. Behandeln Sie Anmeldedaten und Tokens als privat - committen Sie sie niemals in ein öffentliches Repository.

Sechs Kernvorgänge

download

Lädt das Audio herunter und bettet verfügbare Metadaten ein.

Terminal
spotdl download [query]

save

Sammelt Spotify-Metadaten in einer .spotdl-Datei, ohne Audio herunterzuladen.

Terminal
spotdl save [query] --save-file songs.spotdl

sync

Hält einen lokalen Ordner im Einklang mit einer Spotify-Playlist oder einem Album.

Terminal
spotdl sync [query] --save-file list.spotdl

meta

Aktualisiert Metadaten, Cover und Tags vorhandener Audiodateien.

Terminal
spotdl meta [audio files]

url

Löst die Songs einer Anfrage in ihre passenden Audio-URLs auf.

Terminal
spotdl url [query]

web

Startet die lokale Web-Oberfläche im Browser.

Terminal
spotdl web

Lokale Playlists synchron halten

Eine heruntergeladene Playlist muss kein veralteter Schnappschuss bleiben. Der Vorgang sync vergleicht Ihren lokalen Ordner mit der aktuellen Spotify-Quelle: neue Titel werden heruntergeladen, und aus der Quelle entfernte Titel können lokal entfernt werden.

Terminal
# eine Sync-Datei erstellen
spotdl sync [playlist URL] --save-file playlist.spotdl

# die Sammlung später aktualisieren
spotdl sync playlist.spotdl

# neue Titel hinzufügen, ohne lokale Dateien zu löschen
spotdl sync playlist.spotdl --sync-without-deleting

Standardmäßig spiegelt sync die Quelle wider und kann aus Spotify entfernte Titel löschen. Verwenden Sie --sync-without-deleting, um lokale Dateien zu behalten, oder --sync-remove-lrc, um auch passende .lrc-Dateien zu entfernen, wenn Songs entfernt werden. Ideal für Playlists, die sich wöchentlich ändern, und für automatisierte Bibliotheksaktualisierungen.

So funktioniert der Titelabgleich

spotDL erstellt eine Suche aus den Spotify-Details - Titel, Künstler, Album, Dauer, Veröffentlichungstyp - und bewertet die Kandidatenergebnisse, indem es abwägt, ob ein Ergebnis verifiziert ist, und auf Begriffe achtet, die mit Live-Versionen, Remixen, Coverversionen und alternativen Aufnahmen verbunden sind. Das verringert das Risiko, einen nicht verwandten Upload zu erwischen, aber kein Abgleichsystem ist perfekt.

Steuern Sie den Abgleich mit --search-query (eigene Vorlage), --dont-filter-results, --only-verified-results, --album-type oder einer manuellen YouTubeURL|SpotifyURL-Verknüpfung für eine exakte Quelle.

Audioanbieter

YouTube Music ist die Standardeinstellung. Konfigurieren Sie mehrere Anbieter in Ausweichreihenfolge - wenn der erste kein passendes Ergebnis liefern kann, versucht spotDL den nächsten.

YouTube Music (Standard)YouTubeSoundCloudBandcampPipedslider.kz
Terminal
spotdl download [query] --audio youtube-music youtube soundcloud bandcamp

Verfügbarkeit der Anbieter, regionaler Zugriff, Authentifizierung, Audioqualität und Suchgenauigkeit variieren. Es ist nicht garantiert, dass ein Titel auf Spotify bei einem bestimmten Audioanbieter verfügbar ist.

Sechs Ausgabeformate

Wählen Sie das Format, das Ihr Zielplayer oder Workflow benötigt. Legen Sie es mit --format fest.

MP3

Die Standardeinstellung. Breite Kompatibilität mit Playern, Autos, Smartphones, Medienservern und älterer Hardware.

M4A

Nützlich, wenn die Quelle bereits kompatibel ist und unnötiges Transcodieren vermieden werden soll.

Opus

Effiziente Komprimierung, die die Quelle ohne erneute Konvertierung bewahren kann, wenn die Einstellungen es zulassen.

OGG

Für Player und Workflows, die ein offenes Containerformat erfordern.

FLAC

Für Tagging und Bibliotheksvereinheitlichung. Die Konvertierung einer verlustbehafteten Quelle in FLAC stellt verlorenes Audio nicht wieder her.

WAV

Unkomprimiertes PCM für Anwendungen, die es erfordern. Größere Dateien, kein Qualitätsgewinn gegenüber einer verlustbehafteten Quelle.

Audioqualität, ohne irreführende Behauptungen

spotDL lädt das beim ausgewählten Anbieter verfügbare Audio herunter. Es lädt nicht die eigenen Streams von Spotify herunter und kann keine Qualität erzeugen, die in der Quelle fehlt. Standard-YouTube-Quellen liefern in der Regel bis zu 128 kbps; YouTube-Music-Premium-Nutzer können mit authentifizierten Cookies und kompatiblen M4A- oder Opus-Einstellungen 256 kbps erreichen.

Die Wahl von 320 kbps, FLAC oder WAV macht aus einer Quelle mit niedrigerer Bitrate keine höhere Qualität - sie erzeugt nur eine größere Datei. Für minimale Verarbeitung verwenden Sie M4A oder Opus mit deaktivierter Konvertierung; für maximale Kompatibilität verwenden Sie das Standard-MP3.

Terminal
# unnötige Konvertierung überspringen
spotdl download [URL] --format m4a --bitrate disable

# maximale Kompatibilität
spotdl download [URL] --format mp3

Die Bitrate akzeptiert konstante Raten von 8-320 kbps, variable Stufen 0-9, auto (an die Quelle anpassen) oder disable. Bei M4A und Opus können auto oder disable die Konvertierung überspringen, wenn die Quelle bereits kompatibel ist.

Metadaten, Cover & Songtexte

Dateien können alles enthalten, was ein moderner Player und Bibliotheksmanager erwartet. Metadaten können mit dem Vorgang meta auch auf vorhandenes Audio angewendet werden.

TitelnameHaupt- & GastkünstlerAlbum & Album-KünstlerAlbum-CoverTitel- & CD-NummernErscheinungsjahr & OriginaldatumGenreVerlag / PlattenlabelISRCSpotify-Titel-IDSongtexteDauer

Das Album-Cover wird standardmäßig eingebettet. Für Playlists verwendet --playlist-numbering den Titel und das Bild der Playlist als Album/Cover, während --playlist-retain-track-cover das eigene Cover jedes Titels beibehält. Songtexte stammen von Genius, Musixmatch oder AZLyrics in Ausweichreihenfolge, und ein synchronisierter Anbieter kann separate .lrc-Dateien erzeugen.

Terminal
spotdl download [query] --lyrics synced genius --generate-lrc

Datei- und Ordnernamen steuern

Die Standardvorlage ist {artists} - {title}.{output-ext}. Eine eigene Vorlage kann Dateinamen, Verzeichnisse oder beides definieren - und erzeugt so eine vorhersehbare Bibliothek statt eines einzigen Ordners.

Terminal
spotdl download [query] \
  --output "{artist}/{album}/{track-number} - {title}.{output-ext}"
VariableBedeutung
{title}Songtitel
{artists}Alle Künstler des Songs
{artist}Hauptkünstler
{album}Albumtitel
{album-artist}Haupt-Album-Künstler
{genre}Genre
{year}Erscheinungsjahr
{original-date}Ursprüngliches Erscheinungsdatum
{track-number}Titelnummer im Album
{tracks-count}Gesamtzahl der Titel im Album
{disc-number}CD-Nummer
{isrc}International Standard Recording Code
{track-id}Spotify-Titel-ID
{publisher}Verlag oder Plattenlabel
{list-name}Name der Playlist oder Sammlung
{list-position}Position in der Playlist
{output-ext}Dateiendung der Ausgabe

Begrenzen Sie die Länge mit --max-filename-length und bereinigen Sie Namen für die Gerätekompatibilität mit --restrict strict|ascii|none. Das Betriebssystem kann dennoch einen kürzeren maximalen Pfad erzwingen.

Steuerung für Bibliothek & Automatisierung

M3U-Playlists

Erzeugen Sie M3U- oder M3U8-Dateien zusammen mit dem Audio mit --m3u, wählen Sie einen Namen mit --m3u "My Playlist.m3u8" oder eine Datei pro Liste mit --m3u "{list}". Erfassen Sie nicht verfügbare Songs in M3U- und Archivdateien mit --add-unavailable.

Duplikate & Überschreiben

Drei Überschreibmodi - --overwrite skip (Vorhandenes behalten), --overwrite metadata (Tags aktualisieren, Audio behalten) und --overwrite force (erneut herunterladen). Fügen Sie --scan-for-songs hinzu, um vorhandene Titel zu erkennen, --archive, um abgeschlossene Downloads zu erfassen, und --create-skip-file / --respect-skip-file für idempotente Stapelaufträge.

Die Sammlung filtern

Überspringen Sie explizite Titel mit --skip-explicit, ignorieren Sie Alben mit --ignore-albums, rufen Sie die Alben eines Songs mit --fetch-albums ab, begrenzen Sie den Veröffentlichungstyp mit --album-type single|album|compilation, akzeptieren Sie nur verifizierte Ergebnisse mit --only-verified-results oder deaktivieren Sie die Filterung mit --dont-filter-results.

Fehler bei großen Downloads verwalten

Lange Aufträge können nicht verfügbare Titel, regionale Beschränkungen und Anbieterfehler enthalten. Geben Sie eine Zusammenfassung mit --print-errors aus oder speichern Sie sie mit --save-errors errors.txt, sodass Sie zuerst eine große Sammlung verarbeiten und Ausnahmen danach prüfen können.

Erweiterte Download-Steuerung

Optimieren Sie Durchsatz und Verhalten mit --threads, --ffmpeg / --ffmpeg-args, --yt-dlp-args, --proxy http://host:port, --sponsor-block und --detect-formats. Eigene Tool-Argumente sind für erfahrene Nutzer gedacht und können mit den Standardeinstellungen von spotDL in Konflikt geraten.

Die lokale Web-Oberfläche ausführen

Starten Sie die Browser-Oberfläche mit spotdl web. Sie wird lokal gehostet - nicht über einen entfernten Konvertierungsdienst - und eignet sich am besten für einfache Einzeltitel-Downloads. Konfigurieren Sie sie mit --host, --port (Standard 8800), --keep-alive, --allowed-origins und TLS-Optionen (--enable-tls, --cert-file, --key-file). Verwenden Sie --web-use-output-dir, um Ihrem üblichen --output-Speicherort zu folgen.

Die Konfiguration einmal speichern

Erzeugen Sie eine Konfigurationsdatei mit spotdl --generate-config; sie wird bei jedem Lauf automatisch geladen. Sie kann Anbieter, Formate, Bitrate, Ausgabevorlagen, FFmpeg/yt-dlp-Einstellungen, Threads, Cookie-Dateien, Proxy, Überschreibregeln, Sync-Verhalten und Web-UI-Einstellungen speichern. Deaktivieren Sie das automatische Laden mit { "load_config": false }.

JSON
# Standard-Konfigurationsorte
Windows:  C:\Users\<user>\.spotdl\config.json
Linux:    ~/.config/spotdl/config.json

Protokollierung & Diagnose

Legen Sie die Ausführlichkeit mit --log-level fest (CRITICAL → DEBUG, plus eine MATCH-Stufe), vereinfachen Sie das Terminal mit --simple-tui, passen Sie die Ausgabe mit --log-format an, erstellen Sie ein Profil mit --profile und sehen Sie alles mit spotdl --help.

Für echte Musikbibliotheken gemacht

Eine kuratierte Playlist offline mitnehmen

Verwandeln Sie eine Spotify-Playlist in Standarddateien für Laptop, Smartphone, Auto, tragbaren Player oder Offline-Bibliothek.

Vollständige Veröffentlichungen herunterladen

Verarbeiten Sie ein Album als einen einzigen Auftrag und behalten Sie Titel- und CD-Nummern, Veröffentlichungsangaben und Cover bei.

Eine Künstlersammlung aufbauen

Verwenden Sie einen Künstler-Link, um den verfügbaren Katalog zu verarbeiten, ohne jede Veröffentlichung einzeln einzugeben.

Musik zwischen Geräten verschieben

Dateien sind nicht an eine App gebunden - kopieren, sichern, umbenennen, indexieren und überall abspielen.

Eine selbst gehostete Bibliothek pflegen

Eigene Vorlagen und Standard-Metadaten eignen sich für Musikserver, NAS-Sammlungen und Archivordner.

Wiederkehrende Workflows automatisieren

Konfigurationsdateien, Archive, Skip-Dateien, gespeicherte Metadaten und Sync-Befehle machen wiederkehrende Aufträge reproduzierbar.

Fehlerbehebung

Schnelle Lösungen für die häufigsten Installations- und Download-Probleme.

„spotdl“ wird unter Windows nicht erkannt+

Python oder dessen Scripts-Verzeichnis ist nicht im PATH. Installieren Sie Python von python.org neu, aktivieren Sie „Add Python to PATH“ und starten Sie das Terminal neu. Python aus dem Microsoft Store kann Probleme bei der Befehlsauflösung verursachen.

spotdl: command not found unter Linux/macOS+

Das bin-Verzeichnis der Benutzerinstallation fehlt im PATH. Fügen Sie es hinzu und laden Sie Ihre Shell-Konfiguration neu:

Terminal
export PATH=~/.local/bin:$PATH
Fehlende yt-dlp-Abhängigkeiten+

Installieren oder aktualisieren Sie die erforderlichen Pakete:

Terminal
pip install brotli websockets yt-dlp -U
AudioProviderError: YT-DLP download error+

Einige YouTube-Downloads benötigen eine JavaScript-Laufzeitumgebung, darunter bestimmte als für Kinder gedacht markierte Videos. Installieren Sie Deno:

Terminal
spotdl --download-deno
HTTP-404 von den Spotify-Metadaten / Rekursionsfehler+

Eine alte Version verlässt sich möglicherweise auf geändertes API-Verhalten. Aktualisieren Sie spotDL:

Terminal
pip install -U spotdl
SSL: CERTIFICATE_VERIFY_FAILED+

Aktualisieren Sie den Zertifikatspeicher des Betriebssystems und das Zertifikatspaket von Python. Führen Sie unter macOS das mit Ihrer Python-Installation gelieferte Skript zur Zertifikatsinstallation aus. Die Überprüfung zu deaktivieren ist keine sichere Lösung.

Apple-Silicon-Fehler _raw_ecb / Cryptodome+

Python und eine kompilierte Abhängigkeit wurden für unterschiedliche Architekturen installiert. Verwenden Sie ein natives Apple-Silicon-Python und installieren Sie die betroffenen Abhängigkeiten in derselben Umgebung neu.

YouTube Music KeyError: 'header'+

Aktualisieren Sie ytmusicapi und erzwingen Sie bei anhaltendem Problem eine Neuinstallation von spotDL. YouTube Music kann gelegentlich seine Antwort ändern oder Anti-Bot-Verhalten auslösen; ein späterer Versuch kann helfen.

Terminal
pip install -U ytmusicapi

Häufig gestellte Fragen

Was ist spotDL?+

spotDL ist ein kostenloser, quelloffener Spotify-Downloader, der Spotify-Titel, -Alben, -Playlists und -Künstler-Links in organisierte lokale Audiodateien verwandelt. Es nutzt Spotify, um die Musik zu identifizieren und Metadaten zu sammeln, und findet dann das passende Audio über unterstützte Anbieter wie YouTube Music.

Lädt spotDL Audio direkt von Spotify herunter?+

Nein. Spotify liefert Informationen wie Titel, Künstler, Album, Erscheinungsdatum, Titelnummer und Cover. Das Audio selbst wird von YouTube Music, YouTube oder einem anderen konfigurierten Anbieter heruntergeladen, sofern eine passende Übereinstimmung verfügbar ist.

Kann spotDL eine ganze Spotify-Playlist herunterladen?+

Ja. Ein Playlist-Link kann als ein einziger Auftrag verarbeitet werden. spotDL findet das passende Audio, lädt jeden verfügbaren Titel herunter, bettet Metadaten ein und organisiert die Dateien gemäß Ihren Ausgabeeinstellungen. Große Playlists brauchen Zeit, und einzelne Titel können übersprungen werden, wenn keine zuverlässige Übereinstimmung gefunden wird.

Können heruntergeladene Playlists später aktualisiert werden?+

Ja. Der sync-Vorgang vergleicht eine gespeicherte lokale Sammlung mit der aktuellen Spotify-Playlist. Neue Titel werden automatisch heruntergeladen, und aus Spotify entfernte Titel können auch aus dem Ordner gelöscht werden. Das Löschen lässt sich mit --sync-without-deleting deaktivieren.

Welche Audioformate unterstützt spotDL?+

spotDL unterstützt MP3, M4A, Opus, OGG, FLAC und WAV. MP3 ist die Standardeinstellung und bietet die größte Kompatibilität. M4A und Opus können unnötige Konvertierungen reduzieren, wenn sie mit kompatiblen Quelleneinstellungen verwendet werden.

Kann spotDL Audio mit 320 kbps oder verlustfrei herunterladen?+

spotDL kann keine Qualität erzeugen, die in der Quelle nicht vorhanden ist. Standard-YouTube-Quellen liefern in der Regel bis zu 128 kbps, während authentifizierte YouTube-Music-Premium-Quellen bis zu 256 kbps erreichen können. Die Wahl von 320 kbps, FLAC oder WAV konvertiert die vorhandene Quelle lediglich in eine andere (oft größere) Datei - fehlendes Audio wird dadurch nicht wiederhergestellt.

Fügt spotDL Album-Cover, Songtexte und Metadaten hinzu?+

Ja. Je nach Verfügbarkeit und Konfiguration können Dateien Titel, Künstler, Album, Album-Künstler, Cover, Titel- und CD-Nummern, Erscheinungsdatum, Genre, Verlag, ISRC, Spotify-Titel-ID und Songtexte enthalten. spotDL kann auch synchronisierte .lrc-Songtextdateien erstellen.

Wie genau ist der Titelabgleich?+

spotDL verwendet Spotify-Metadaten, um vor dem Download verfügbare Ergebnisse zu durchsuchen und zu bewerten, was hilft, die Studioaufnahme von Coverversionen, Remixen, Live-Versionen und nicht verwandten Videos zu trennen. Der Abgleich ist nicht unfehlbar - Sie können eine bestimmte YouTube-URL mit einem Spotify-Titel verknüpfen, wenn exakte Kontrolle erforderlich ist.

Gibt es eine grafische Oberfläche?+

Ja. spotDL enthält eine lokale Web-Oberfläche für unkomplizierte Einzeltitel-Downloads, die auf Ihrem eigenen Computer statt über einen entfernten Dienst läuft. Die Befehlszeile bietet den vollen Funktionsumfang, einschließlich Playlist-Synchronisierung, Stapelverarbeitung, erweiterter Anbieter und Konfiguration.

Welche Betriebssysteme unterstützen spotDL?+

spotDL läuft unter Windows, macOS und Linux, mit Installationsoptionen für Docker, Termux, Arch Linux und Quellcode-Builds. Die Kompatibilität hängt von der gewählten Methode und den erforderlichen Komponenten wie Python und FFmpeg ab.

Was wird benötigt, um spotDL auszuführen?+

FFmpeg wird für die Audioverarbeitung, -konvertierung und -kennzeichnung benötigt (installieren Sie es mit "spotdl --download-ffmpeg"). Deno wird dringend empfohlen, da einige YouTube-Downloads eine JavaScript-Laufzeitumgebung benötigen ("spotdl --download-deno"). Die empfohlene Installation ist "pip install spotdl".

Ist spotDL kostenlos?+

Ja. spotDL wird unter der MIT-Lizenz vertrieben und kann unter diesen Bedingungen heruntergeladen, verwendet, eingesehen, verändert und weiterverbreitet werden. Es gibt kein kostenpflichtiges spotDL-Abonnement. Externe Plattformen, Anbieter oder Premium-Konten können eigene, separate Bedingungen und Kosten haben.

Ist spotDL mit Spotify oder YouTube verbunden?+

Nein. spotDL ist ein unabhängiges Open-Source-Projekt und steht in keiner Verbindung zu Spotify, YouTube, Google oder einem Plattenlabel, wird von diesen nicht gesponsert oder unterstützt. Spotify und YouTube sind Marken ihrer jeweiligen Eigentümer.

Ist die Nutzung von spotDL legal?+

spotDL ist ein universelles Software-Werkzeug. Ob ein bestimmter Download zulässig ist, hängt von der Musik, der Quelle, dem beabsichtigten Zweck, dem geltenden Urheberrecht und den Bedingungen der jeweiligen Plattformen ab. Das Herunterladen einer Datei verleiht weder Eigentum noch Weiterverbreitungsrechte. Verwenden Sie spotDL nur für Audio, das Sie rechtlich herunterladen, kopieren oder verarbeiten dürfen.

Bauen Sie eine Musikbibliothek, die portabel bleibt

Beginnen Sie mit einem Song, konvertieren Sie eine ganze Playlist oder bauen Sie einen wiederholbaren lokalen Workflow mit vollständiger Kontrolle über Formate, Metadaten, Dateinamen und Synchronisierung.

Kostenlos & quelloffen MIT-lizenziert Läuft lokal Für langfristige Sammlungen gemacht