V1.8.0beta - smol refactor, apple music fixes, yt music, spotify API Keys and global Retry-After

[moddroid94]

As the title says, this is a big change.

This is almost a refactor of the codebase, now contributions should be easier, code cleaner and better to improve on, but let me know what you think in the discussion below!

As most code was changed this will be kept as pre-release for some time to get feedbacks!

TLDR of changes:

• Fixed Apple music downloads
• Fixed Free youtube music downloads
• Fixed Spotify downloads using Dev API via config settings
  (FREE SPOTIFY ACCOUNTS ARE NOT SUPPORTED ANYMORE!)
  you'll need to make an app in the Spotify developer console, google it or ask chatgpt :)
• Added Spotify Metadata exclusion via config settings to reduce API calls
• Probably something broke too.

What's Changed

• Replaces PR Broaden the Artist check in Filter Albums #300 by @liberatorcnx in Replaces PR #300 #305
• Fix Deezer/Bandcamp/YouTube/Crunchyroll service path. Improve Spotify API logging and search routing by @liberatorcnx in Fix Deezer/Bandcamp/YouTube/Crunchyroll service path. Improve Spotify API logging and search routing #315
• feat: add randomized download delay variance setting by @KiLLeRRaT in feat: add randomized download delay variance setting #319
• feat: add support for {composer} tag with smart path formatting by @edisun3003 in feat: add support for {composer} tag with smart path formatting #324
• Handle lyrics download error gracefully by @Snowy-Fluffy in Handle lyrics download error gracefully #327
• fix: apple music token retrieval update and better error handling Apple Music not connecting #329 by @kasterby in fix: apple music token retrieval update and better error handling #329 #331
• feat: refactor and yt-music fix by @moddroid94 de551b3

New Contributors

• @KiLLeRRaT made their first contribution in feat: add randomized download delay variance setting #319
• @edisun3003 made their first contribution in feat: add support for {composer} tag with smart path formatting #324
• @Snowy-Fluffy made their first contribution in Handle lyrics download error gracefully #327
• @kasterby made their first contribution in fix: apple music token retrieval update and better error handling #329 #331

Full Changelog: v1.2.2beta...1.8.0beta

You can check the validity of the artifacts with the MD5 in the run where they are built: https://github.com/justin025/onthespot/actions/runs/27786143733

---

This discussion was created from the release V1.8.0beta - smol refactor, apple music fixes, yt music, spotify API Keys and global Retry-After.

[liberatorcnx]

@moddroid94 - Great work to pull all of this stuff together. A little problem I have encountered:
Spotify downloads fail.

From log:
C:\Users\Steve\AppData\Local\Temp\onthespot\reqcache\3511722e050a169624c5e50c825e85b1.json [2026-06-19 18:28:29,872 :: downloader :: onthespot\downloader.py -> 378: run() :: ERROR] -> Unknown Exception: [WinError 2] The system cannot find the file specified: 'C:\\Users\\Steve\\Music\\OnTheSpot\\Tracks\\Electric Light Orchestra\\[1977] Out of the Blue\\~13. Mr. Blue Sky' -> 'C:\\Users\\Steve\\Music\\OnTheSpot\\Tracks\\Electric Light Orchestra\\[1977] Out of the Blue\\13. Mr. Blue Sky.mp3' Traceback: Traceback (most recent call last): File "onthespot\downloader.py", line 330, in run File "onthespot\downloader.py", line 1156, in _finalize_audio FileNotFoundError: [WinError 2] The system cannot find the file specified: 'C:\\Users\\Steve\\Music\\OnTheSpot\\Tracks\\Electric Light Orchestra\\[1977] Out of the Blue\\~13. Mr. Blue Sky' -> 'C:\\Users\\Steve\\Music\\OnTheSpot\\Tracks\\Electric Light Orchestra\\[1977] Out of the Blue\\13. Mr. Blue Sky.mp3'

The problem is that the temp_path is being set with a .ogg extension whereas the file is actually being saved with no extension. Simple quick fix I used -

src\onthespot\downloader.py
Change line 595 from:
        default_format = ".ogg"
to:
        default_format = ""

You may want to look at where the temp_path is set.

[moddroid94]

thanks for the feedback! i'll fix it and push a new beta build