What's Changed

• AZLyrics: change user agent and catch too many redirects error by @satvikgosai in #2477
• AZLyrics: logic to fail if no js_code retrieved by @Silverarmor in #2483
• Add support for artist compilations by @Silverarmor in #2487
• Publish v4.4.2 by @Silverarmor in #2484

New Contributors

• @satvikgosai made their first contribution in #2477

Full Changelog: v4.4.1...v4.4.2

If you find spotDL useful, please consider sponsoring the project: https://github.com/sponsors/Silverarmor

What's Changed

• Fix issue where azlyrics wont fetch lyrics by @fer-hnndz in #2444
• M3U playlist bug fixes by @Silverarmor in #2449
• Remove genius lyric header by @Silverarmor in #2450
• Fix mypy issues on AZLyrics Provider by @fer-hnndz in #2452
• Publish v4.4.1 by @Silverarmor in #2451
• meta: add isort to CI.

Full Changelog: v4.4.0...v4.4.1

Breaking Change

• Dropped support for Python 3.9 due to upstream dependency requirements. Please update Python to v3.10-v3.13
  • ytmusicapi requires Python 3.10 and yt-dlp will soon
  • Noting further that Python 3.9 reaches end-of-life in October 2025.

What's Changed

• Fix azlyrics logic, and disable it temporarily by @Silverarmor in #2442
• Publish v4.4.0 by @Silverarmor in #2443

Full Changelog: v4.3.1...v4.4.0

Support the project

What's Changed

• fix(docs): replace broken Installation Guide link with correct ReadTheDocs URL by @Milutin-P in #2421
• fix: Dockerfile by @JackGlobetrotter in #2427
• Fix: Invalid directory creation when downloading from YouTube Music. by @tylerlv3 in #2431
• Fix extractor_args being list instead of dict by @bolshoytoster in #2435
• Publish v4.3.1 by @Silverarmor in #2437

New Contributors

• @Milutin-P made their first contribution in #2421
• @JackGlobetrotter made their first contribution in #2427
• @tylerlv3 made their first contribution in #2431
• @bolshoytoster made their first contribution in #2435

Full Changelog: v4.3.0...v4.3.1

Support the project

What's Changed

• Set default bitrate to 128k
• Fix passing arguments to yt-dlp. by @jessicah in #2250
• Bump setuptools from 75.8.0 to 78.1.1 by @dependabot[bot] in #2379
• switch from poetry to uv by @phcreery in #2305
• Add yt-dlp Extractor Argument Support by @Kyrluckechuck in #2285
• docs: add info about --sync-without-deleting by @BOTKooper in #2359
• v4.3.0 by @Silverarmor in #2418
  • Changed tests to run on only py3.11
  • Apply pytube innertube version patch. Credit @epignatelli. Note YT audio provider is not fully supported at the moment, needs to be rewritten due to pytube's loss of support.
  • Updated PR description
  • Remove max parallel limit on GH action runners
  • Update documentation and readme
  • Update development instructions in CONTRIBUTING.md

New Contributors

• @jessicah made their first contribution in #2250
• @Kyrluckechuck made their first contribution in #2285

Full Changelog: v4.2.11...v4.3.0

What's Changed

• Fix flac scanning when no album art present by @joeyballentine in #2238
• Fix m3u file creation, with correct metadata generation by @Silverarmor in #2258
• Bump jinja2 from 3.1.4 to 3.1.5 by @dependabot in #2268
• Publish spotDL 4.2.11 by @Silverarmor in #2277
• Various documentation changes & updates @Silverarmor

Bumped yt-dlp to 2025.1.15 to attempt to alleviate 403 Forbidden errors.

New Contributors

• @joeyballentine made their first contribution in #2238

Full Changelog: v4.2.10...v4.2.11

What's Changed in v4.2.10

This is a hotfix for spotDL executable

Infrastructure and Dependency Updates:

• Added websockets to project dependencies by @xnetcat
• Bundled all modules from pyproject.toml by @xnetcat
• Updated pyproject for Python 3.13 support by @xnetcat
• Dropped support for Python 3.8 by @xnetcat
  • Removed Python 3.8 from pyproject.toml

Documentation:

• Updated bug_report.yml by @Silverarmor

Version Update:

• Bumped version to 4.2.10 by @xnetcat

Breaking Changes

• Python 3.8 is no longer supported. Please upgrade to Python 3.9 or later.

Contributors

• @Silverarmor contributed to documentation updates
• @xnetcat made several infrastructure and dependency updates

Full Changelog: v4.2.9...v4.2.10

Donate

Help support the development and maintenance of the software ❤️

What's Changed

Bug fixes:

• Make --save-errors append to file instead of overwriting (#2198) by @truppelito
• Fixed path sanitization when creating m3u file by @xnetcat
• Disabled SliderKZ by @xnetcat
• Fixed linter errors by @xnetcat

Features:

• Download lyrics with save operation (#2206) by @SilentDude
• Download individual album art for each track when using --playlist-numbering (#2208) by @PranjalSurana
• Skip duplicate songs from sub-folders (#2212) by @himanshumahajan138
• Add metadata to playlist files (#2215) by @PranjalSurana

Documentation:

• Update README.md by @inform880
• Fix link in README by @Silverarmor

Other changes:

• Updated dependencies by @xnetcat
• Made album type optional by @xnetcat
• Reverted #2214 by @xnetcat

New Contributors

• @truppelito made their first contribution in #2198
• @SilentDude made their first contribution in #2206
• @PranjalSurana made their first contribution in #2204
• @inform880 made their first contribution in #2227

Full Changelog: v4.2.8...v4.2.9

Donate

Help support the development and maintenance of the software ❤️

What's Changed

Bug fixes:

• Always include filter when sending requests to piped by @xnetcat
• Check status code when getting response from piped by @xnetcat
• Use piped.video instead of main piped instance by @j3bx in #2172
• Fixed RuntimeError: Directory 'C:\Users\myuser\.spotdl\web-ui\dist' does not exist by @R0GUE-A5H in #2173
• Make sync command aware of file name changes by @xnetcat

Documentation:

• Chore: update downloader.py by @eltociear

New Contributors

• @eltociear made their first contribution in #2169
• @R0GUE-A5H made their first contribution in #2175

Full Changelog: v4.2.7...v4.2.8

Donate

help support the development and maintenance of the software ❤️

What's Changed

• Fix RuntimeError: Directory 'C:\dist' does not exist by @phcreery in #2165

Full Changelog: v4.2.6...v4.2.7