• v0.6.3 8ecff44811

    0.6.3 Stable

    andrew released this 2026-07-15 09:50:57 -06:00 | 6 commits to master since this release

    Fixes playlists downloading nothing (and showing an empty tracklist in alembic) for Spotify apps created after Spotify's February 2026 API change, even on playlists the connected account owns.

    The cause: for new apps, Spotify renamed part of the playlist response. Each entry's song data moved from a field called track to one called item. Old (grandfathered) apps still get the old name, so this only hit new apps. alembic only looked for the old name, so every song in the playlist was silently skipped: runs finished "successfully" having downloaded nothing, and the playlist page showed no songs. alembic now reads both forms.

    Also in this release:

    • Spotify only gives new apps the contents of playlists the connected account owns or collaborates on. Being public is no longer enough. That case now shows a clear error explaining what to do, instead of looking like an empty playlist. The README's Spotify sections explain this too.
    • Every playlist run now logs how many tracks it fetched from Spotify, and warns loudly if the answer is zero.

    Upgrade: change the version in your docker-compose.yml, then docker compose pull alembic && docker compose up -d alembic.

    Downloads