This release includes 2 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+2 more
Affected surfaces
ReleasePort's take
Light signalAll v0.1.x users must migrate from PostgreSQL to SQLite before any other updates; the image cache migration begins in v0.3.1 and requires backing up the data folder first.
Why it matters: Mandated database migration for v0.1.x releases prevents compatibility issues; scheduled image‑cache migration in v0.3.1 with required backup avoids data loss.
Summary
AI summaryFixes a cache‑key typo and adjusts the Deezer image query.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Breaking | High |
Migrate from PostgreSQL to SQLite required before any other updates for v0.1.x users. Migrate from PostgreSQL to SQLite required before any other updates for v0.1.x users. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Breaking | High |
Migrate image cache system from old to new starting in v0.3.1; backup data folder first. Migrate image cache system from old to new starting in v0.3.1; backup data folder first. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Bugfix | Medium |
Add timezone to stats cache key to prevent mismatches. Add timezone to stats cache key to prevent mismatches. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Bugfix | Medium |
Adjust query for Deezer images to retrieve correct results. Adjust query for Deezer images to retrieve correct results. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Bugfix | Medium |
Delete listens path in client to clean up stale data. Delete listens path in client to clean up stale data. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Bugfix | Medium |
Load background color before rendering to ensure correct display. Load background color before rendering to ensure correct display. Source: llm_adapter@2026-06-01 Confidence: high |
— |
| Bugfix | Low |
Fix typo occurrences throughout the codebase. Fix typo occurrences throughout the codebase. Source: llm_adapter@2026-06-01 Confidence: low |
— |
Full changelog
⚠️ Caution: if you are upgrading from any version v0.1.x on PostgreSQL, you MUST upgrade to v0.2.1 to perform the SQLite migration before performing any other updates! If you are already on SQLite, you don't have to worry about this. ⚠️
⚠️ Versions v0.3.1 onwards contain a migration from the old image cache system to the new one, which has worked in testing but I make no guarantees you won't lose your uploaded images. Make sure you backup your data folder before updating from a version before v0.3.1! ⚠️
What's Changed
- chore: fix typo in all its instances by @paezdavid in https://github.com/gabehf/Koito/pull/290
- fix: add timezone to stats cache key by @gabehf in https://github.com/gabehf/Koito/pull/289
- fix: adjust query for deezer images by @gabehf in https://github.com/gabehf/Koito/pull/288
- fix: delete listens path in client by @gabehf in https://github.com/gabehf/Koito/pull/293
- fix: load background color before rendering by @gabehf in https://github.com/gabehf/Koito/pull/294
New Contributors
- @paezdavid made their first contribution in https://github.com/gabehf/Koito/pull/290
Full Changelog: https://github.com/gabehf/Koito/compare/v0.3.1...v0.3.2
Breaking Changes
- PostgreSQL users must upgrade to v0.2.1 before any other updates; SQLite users are unaffected.
- Image cache system migration from v0.3.1 requires backing up the data folder.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Koito
Koito is a modern, themeable scrobbler that you can use with any program that scrobbles to a custom ListenBrainz URL
Related context
Earlier breaking changes
- v0.3.1 Changes many API endpoints under /apis/web/v1/ and image URIs; client updates needed.
- v0.3.1 Migrates database from PostgreSQL to SQLite; backup required.
- v0.3.0 All PostgreSQL code and references have been removed; migration to SQLite required for v0.1.x users.
- v0.3.0 Many API endpoints under /apis/web/v1/ and image URIs have changed.
- v0.2.1 KOITO_SQLITE_ENABLED environment variable no longer needed
Beta — feedback welcome: [email protected]