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
Moderate signalThis release migrates the database from PostgreSQL to SQLite and overhauls many API endpoints under /apis/web/v1/ along with image URIs.
Why it matters: Backup your data before migration; update client code for changed API paths or risk service failures. Severity is high (70).
Summary
AI summaryUpdates Highlights, chore, and feat across a mixed release.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Breaking | High |
Migrates database from PostgreSQL to SQLite; backup required. Migrates database from PostgreSQL to SQLite; backup required. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Breaking | High |
Changes many API endpoints under /apis/web/v1/ and image URIs; client updates needed. Changes many API endpoints under /apis/web/v1/ and image URIs; client updates needed. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Feature | Medium |
Redesigns UI with refreshed look and additional stats. Redesigns UI with refreshed look and additional stats. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Feature | Medium |
Adds streaks and more statistics to the UI. Adds streaks and more statistics to the UI. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Performance | Low |
Adds caching to stats handler for faster responses. Adds caching to stats handler for faster responses. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Bugfix | Medium |
Adds head middleware to handle missing headers. Adds head middleware to handle missing headers. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Bugfix | Medium |
Prevents nil mbz client passed to maloja importer. Prevents nil mbz client passed to maloja importer. Source: llm_adapter@2026-05-27 Confidence: high |
— |
| Refactor | Low |
Removes all PostgreSQL code and references from the project. Removes all PostgreSQL code and references from the project. Source: llm_adapter@2026-05-27 Confidence: high |
— |
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. ⚠️
⚠️ This update contains 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! ⚠️
Highlights
Refreshed UI
The UI has a new look! I think it does a good job of not being so boring but still providing a lot of quick stats for your listening data.
API Changes
Many API endpoints under the /apis/web/v1/ routes, as well as the image URIs, have changed. If you were previously using one of these endpoints for your own purposes, you will likely need to fix the endpoint. You can look at the engine/routes.go file to see a list of all the endpoints. These changes are in preparation for eventual API documentation once I deem the API stable.
What's Changed
- chore: rewrite api surface by @gabehf in https://github.com/gabehf/Koito/pull/265
- Fix/change listen track model by @gabehf in https://github.com/gabehf/Koito/pull/273
- feat: A very big PR that redesigns the UI among other things by @gabehf in https://github.com/gabehf/Koito/pull/275
- fix: add head middleware by @gabehf in https://github.com/gabehf/Koito/pull/277
- chore: tests for conflicting listens on merge by @gabehf in https://github.com/gabehf/Koito/pull/279
- UI/tweaks by @gabehf in https://github.com/gabehf/Koito/pull/280
- feat: streaks and more stats by @gabehf in https://github.com/gabehf/Koito/pull/282
- chore: add cache to stats handler by @gabehf in https://github.com/gabehf/Koito/pull/281
- fix: nil mbz client passed to maloja importer by @gabehf in https://github.com/gabehf/Koito/pull/283
- chore: remove all postgres code and references by @gabehf in https://github.com/gabehf/Koito/pull/278
Full Changelog: https://github.com/gabehf/Koito/compare/v0.2.1...v0.3.1
Breaking Changes
- All `/apis/web/v1/` routes and image URIs have changed; existing integrations must update endpoint paths.
- PostgreSQL code and references removed; SQLite is now the only supported database. Must upgrade to v0.2.1 first when migrating from v0.1.x on PostgreSQL.
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
Related tools
Earlier breaking changes
- v0.3.2 Migrate image cache system from old to new starting in v0.3.1; backup data folder first.
- v0.3.2 Migrate from PostgreSQL to SQLite required before any other updates for v0.1.x users.
- 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]