What it is
spotDL reads Spotify track and playlist metadata, finds matching audio on YouTube, then writes local files with names, tags, artwork and optional lyrics. It does not download Spotify audio. That distinction matters for quality, matching and expectations.
Best for
It suits people who organise music around Spotify links but want a tagged local library, particularly when its sync file can keep a playlist mirror up to date. The project offers a CLI, web UI, executables and Docker paths.
Avoid it if
Avoid it when an exact source master matters. The audio comes from a YouTube match and can be wrong, unavailable or lower quality. Official documentation states up to 128 kbps for ordinary YouTube access and 256 kbps with YouTube Music Premium. Users remain responsible for rights and local law.
Current state
spotDL 4.5.2 shipped on 20 July 2026 to fix 4.5.1 crashing at startup when yt-dlp surfaced its Python 3.10 deprecation notice. Current development documentation supports Python 3.10 through 3.14, requires FFmpeg, and strongly recommends Deno because some YouTube downloads need it.
Alternatives
yt-dlp gives direct control over media formats but does not provide Spotify-led matching and library sync. MusicBrainz Picard is a better answer when the files already exist and the problem is tagging. Streaming-service offline modes are simpler when files do not need to leave the app.
Why it belongs
It belongs because its workflow is specific and surprisingly complete: a Spotify playlist becomes a maintainable local collection rather than a folder of mystery files.
Get started
- Install:
python3 -m pip install -U spotdl. - Install the required FFmpeg locally:
spotdl --download-ffmpeg. - Download:
spotdl download <spotify-url>. Create and retain a.spotdlsync file if the playlist should remain mirrored.
References (2)
Linked from you-get: downloader that scrapes the web, Linked from The 5 Best Downloaders for Videos, Music & Images (No Browser Needed)