Repository navigation
1.2.21
Spotify2 v1.2.21
Update v1.2.21: Promotes the tested v1.2.20.x development line into the next Spotify2 release candidate. This release combines the Spotify Web API compatibility work introduced with v1.2.20 with improved artist-library handling, album context playback, automatic continuation between albums, cache/prefetch optimizations, and hardened Kodi foreground GUI synchronization.
Highlights
Spotify Web API and artist browsing
Artist browsing continues to respect Spotify's endpoint-specific Web API restrictions instead of treating them as one global API limit.
GET /v1/artists/{id}/albumsremains limited to a maximum of 10 items per request, with Spotify2 automatically combining paginated responses to preserve the configured Kodi browse page size.- The combined artist release view supports albums, singles, appearances and compilations (
album,single,appears_on,compilation). - Market selection continues to follow the authenticated Spotify account without hard-coded country-specific behavior.
- Spotify2 retains its shared API gate, conservative request pacing, cache reuse,
Retry-Afterhandling, and separate handling of ordinary rate limiting andQUOTA_EXCEEDED. My Music > Artistsnow uses improved followed-artist caching, immediate cache invalidation after follow/unfollow operations, and a saved-library-derived fallback when Spotify returns an empty result or the API is temporarily unavailable.
Album playback and automatic next album
Album context-menu Play now reuses the mature playlist playback workflow instead of maintaining a separate album-specific playback path.
This provides the established playlist behavior for albums as well, including:
- complete album queue creation
- Kodi music full-screen handling
- active-track highlighting and foreground focus synchronization
- existing queue, sequence and transition infrastructure
After the final track of an album, Spotify2 can automatically continue with the next album in the current artist listing.
Chained transitions such as:
Album A → Album B → Album C
reuse the existing playlist sequence, successor preparation, audio prefetch and foreground hand-off mechanisms.
GUI synchronization and transition performance
v1.2.21 hardens Kodi's retained-container behavior during automatic album transitions. This prevents an earlier album from being reopened and keeps the visible album list and active-track focus synchronized across chained transitions.
Successor albums are prepared cache-first, with prepared queue data and prefetched audio reused at the album boundary. Album metadata stored in transition caches is compact and cycle-free, while Spotify Web API initialization remains lazy on genuine cache misses.
The mature v1.2.19.1 playlist browse, playback, focus and foreground hand-off core remains unchanged. No skin-specific XML, forced GUI control hacks, autonomous background Container.Update() calls, or fixed-delay focus timing are required.
Diagnostics and compatibility
Platform diagnostics continue to identify the active authentication and playback binaries for Windows, ARM Linux/LibreELEC, Android ARM, Linux X86 and macOS.
Spotify2 continues to separate:
- Legacy Spotty v1.x / librespot 0.4.2 for Device Connect, authentication and token operations where required.
- Modern Spotty v2.x / librespot 0.8.x for dedicated playback on supported Windows and ARM targets.
Windows 10 32-bit package
v1.2.21 additionally provides a dedicated package for Windows 10 32-bit (x86):
plugin.audio.spotify2-v1.2.21-WINDOWS-32BIT.zip
This package is intended only for a 32-bit Kodi installation. It contains two native PE32/i386 binaries:
- Spotty v1.3.1 / librespot 0.4.2 for Device Connect, authentication and token operations.
- Spotty v2.1.2 / librespot 0.8.0 for playback and audio prefetch.
The modern playback binary was built from michaelherger/librespot commit 3b817a9, matching the Spotty v2.1.2 source generation used by the existing Windows x64 playback package.
The 32-bit package contains no x64 executable and no x64 msvcr110.dll. Apart from the architecture-specific Windows binaries and removal of the unused x64 runtime DLL, its add-on files are byte-identical to the regular v1.2.21 Windows package.
Linux X86 and macOS Intel/Apple Silicon continue to use the legacy Spotty runtime and remain not user-tested. Android X86/X86_64 contains legacy authentication/token payloads only and also remains not user-tested.
Validation
The final v1.2.21 candidate was runtime-tested on Windows 11 x64 with Kodi 22.0 Beta 2.
The final chained album test successfully completed Album A → Album B → Album C with successor preparation, queue-cache reuse, audio prefetch, foreground hand-off and verified GUI focus after both transitions.
No Spotify2 Python traceback, foreground transition timeout, GUI identity/focus timeout, HTTP 429 rate-limit event or QUOTA_EXCEEDED event was observed during the final validation.
The Windows 10 32-bit package passed the following static validation:
- both Windows executables were verified as native PE32 / Intel 80386 files
- no PE32+ / x86-64 executable or DLL is included
- all non-Windows-runtime add-on files are byte-identical to the regular v1.2.21 Windows package
- all Python files compile successfully
addon.xmlparses successfully- the final installation ZIP has the correct
plugin.audio.spotify2/root structure
The Windows 10 32-bit package has not yet been runtime-tested on a real Windows 10 32-bit system and should therefore be considered an additional test build.
ARM and X86/macOS packages also passed Python compilation and addon.xml validation.
Packages
| Package | Platform | SHA-256 |
|---|---|---|
plugin.audio.spotify2-v1.2.21-WINDOWS.zip |
Windows 10/11 64-bit (x64) | a2ad16735973dc0207c9f904c15cd5bf2d61cc91c1b11000c9f29c85d58d1424 |
plugin.audio.spotify2-v1.2.21-WINDOWS-32BIT.zip |
Windows 10 32-bit (x86) — not runtime-tested | eed8a45dfc0105b243487507e4ca0d1c39e460629d5091c643bb7353b96ff140 |
plugin.audio.spotify2-v1.2.21-ARM.zip |
ARM Linux/LibreELEC and Android ARM | 890ad4849dffe4125e2fe4a5240b2a28cdca485723e333c7bf52ddd82b92bd3f |
plugin.audio.spotify2-v1.2.21-X86-MACOS.zip |
Linux/Android x86 and macOS | 659b005404f5dd232ca194595856bf98af27071d171d6506c094ed498aa9d030 |
Notes
- Spotify Premium is required.
- Spotify2 remains targeted at Kodi 21 and Kodi 22.
- Windows packages are architecture-specific: use
WINDOWS.zipfor 64-bit Kodi andWINDOWS-32BIT.ziponly for 32-bit Kodi on Windows 10. - The Windows 10 32-bit package is currently build-validated but not runtime-tested on real 32-bit Windows hardware.
- Direct ZIP installation does not provide automatic updates.
- Restart Kodi once after installing or updating Spotify2 before starting the add-on.
- Spotify2 is an independent, unofficial Kodi add-on and is not affiliated with or endorsed by Spotify or the Kodi project.
This v1.2.21 release supersedes the v1.2.20 public pre-release for continued validation.