Download Latest Version spotdl-4.5.2-win32.exe (46.0 MB)
Email in envelope

Get an email when there's a new version of spotDL

Home / v4.5.1
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-07-20 4.3 kB
v4.5.1 source code.tar.gz 2026-07-20 3.7 MB
v4.5.1 source code.zip 2026-07-20 3.8 MB
Totals: 3 Items   7.4 MB 0

Highlights

  • Downloads are faster and smoother. The download pipeline and FFmpeg conversion now use native asyncio for non-blocking I/O, and the progress bar reports more accurate stages (searching, getting metadata, downloading, converting).
  • Several providers are working again:
  • Piped: now searches via a working API instance and downloads through yt-dlp.
  • AZLyrics: no longer blocked by a redirect loop.
  • Bandcamp: no longer crashes on malformed API responses.
  • SoundCloud: fixed a bug where result durations were compared in milliseconds, causing poor matches.
  • Web UI fixes: the web player should work again, including when launched from the prebuilt executables.
  • Docker image changes:
  • The base image moved from python:3.13-alpine to python:3.14-slim-bookworm, and Deno is now pre-installed in the image, so JavaScript-runtime-dependent downloads work out of the box.
  • For those using spotDL as a library: the downloader is now async-first. Downloader.search_and_download will raise an error if called from a running event loop — await Downloader.async_search_and_download instead.

[!CAUTION] The executables attached to this release crash on startup with AudioProviderError: Deprecated Feature: Support for Python version 3.10 has been deprecated. Use v4.5.2 instead, which fixes this. This also affects pip installs of 4.5.1 running on Python 3.10 — upgrade with pip install -U spotdl, or use Python 3.11+. The executable downloads have been removed from this release.

What's Changed

New Contributors

Full Changelog: https://github.com/spotDL/spotify-downloader/compare/v4.5.0...v4.5.1

Source: README.md, updated 2026-07-20