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

What's Changed

New features:

• Add TLS to the web server by @Randy-Blancett in #2086
• Added new web gui options (--web-gui-location and --web-gui-repo by @xnetcat
• Added --sync-remove-lrc option by @xnetcat
• Added option to choose own genius api access code by @j3bx in #2152

Bug fixes:

• Prevent error if playlist has no image by @scaphandroid in #2089
• Preserve original list-position, when local/unavailable songs are skipped by @dxrcy in #2105
• Preserving local web-ui, added --force-update-gui option to force checkout a new copy of web ui by @karanbheda in #2117
• Update lrc.py for updated function in python-syncedlyrics by @jerz4lunch in #2120
• Updated the url from sliderkz.py by @xKristee29 in #2125
• Ignore key errors for missing ytmusicapi data by @xnetcat
• Fixed attribute error when setting keyword in logging env by @xnetcat
• Sanitize m3u file by @xnetcat
• Fixed Unknown format code 'd' for object of type 'float' by @xnetcat
• Synced lyrics fixes by @xnetcat
• Respect skip file by @xnetcat
• Fixed yt-dlp-args by @xnetcat
• Don't update metadata on files with mismatching suffix by @xnetcat
• Fixed get file metadata function for track/dics count by @xnetcat

Improvements:

• Remove dependency on setuptools by @dotlambda in #2057
• Added --profile code by @xnetcat
• Added function to get path to new web ui directory by @xnetcat
• Dont cache web ui files by @xnetcat
• Update dependencies (mainly YT-DLP) by @xnetcat
• Fixed disc total and track total for flac ogg opus by @xnetcat
• Added TYER tag by @xnetcat
• Remove artists from the list that are already in the title only when short=true
• Improve proxy URL regex matching by @zigzag1001 in #2155

Matching:

• Improved isrc search by @xnetcat
• Improved matching in case of a result with a string with all artists in it by @xnetcat

New Contributors ❤️ ❤️ ❤️

• @scaphandroid made their first contribution in #2089
• @Randy-Blancett made their first contribution in #2086
• @dxrcy made their first contribution in #2105
• @karanbheda made their first contribution in #2117
• @jerz4lunch made their first contribution in #2120
• @xKristee29 made their first contribution in #2125
• @zigzag1001 made their first contribution in #2155
• @j3bx made their first contribution in #2152

Full Changelog: v4.2.5...v4.2.6

Donate

help support the development and maintenance of the software ❤️

What's Changed

New features:

• Add Skip Album Art Functionality by @egndz in #2032
• Update/implement skip flag by @prodigy7 in #2010
• Add filtering by album type by @egndz in #2048
• split get user playlists and get saved playlists to two shortcuts by @xnetcat in 92d3338

Bug fixes:

• Fix for multiple keywords in --ignore-albums option by @bharat-nair in #2014
• Fix milliseconds for song initialization in by @egndz #2028
• Fix performance issue when ffmpeg outputs a lot of lines by @pekkarr in #2013
• remove sync tags from lyrics when saving them in uslt tag by @xnetcat in f47d77c
• Add Album Cover Art Check by @egndz in #2033
• Fix termux installation by @rimurum in #2038 and #2042
• save errors when main thread crashes by @xnetcat in ffb9f2b
• update the app scope by @xnetcat in 205e127

Matching improvements:

• lower average match for explicit mismatch by @xnetcat in 1b9bc72
• always skip results with low time match by @xnetcat in ff952d3
• improved lyrics matching by @xnetcat in e4de031

Quality of life improvements:

• Default to the current directory when running web interface from a frozen application by @xnetcat in 1988035
• added isrc tag to mp3 files by @xnetcat in a6a98ec
• added artist id to song object by @xnetcat in d5416ab

New Contributors

• @Mahasvan made their first contribution in #1981
• @pekkarr made their first contribution in #2013
• @egndz made their first contribution in #2028
• @prodigy7 made their first contribution in #2010
• @rimurum made their first contribution in #2038

Full Changelog: v4.2.4...v4.2.5

Donate

help support the development and maintenance of the software ❤️

What's Changed

#1971

Full Changelog: v4.2.3...v4.2.4

What's Changed

Improvements

• added support for python 3.12 by @xnetcat in b64e879

Important

If you are getting ModuleNotFoundError: No module named 'pkg_resources', try updating setuptools

• pip install -U setuptools

Full Changelog: v4.2.2...v4.2.3

Donate

help support the development and maintenance of the software ❤️