Skip to content

Koito

v0.3.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 8d Media Servers
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

docker listenbrainz music navidrome scrobble scrobbler
+2 more
self-hosted subsonic

Affected surfaces

breaking_upgrade

ReleasePort's take

Moderate signal
editorial:auto 7d

The release removes all PostgreSQL code and mandates migration to SQLite for v0.1.x users; many API endpoints under /apis/web/v1/ and image URIs have also changed.

Why it matters: All PostgreSQL references are removed, requiring immediate SQLite migration for version v0.1.x deployments; endpoint and URI changes affect integrations.

Summary

AI summary

Updates Highlights, chore, and feat across a mixed release.

Changes in this release

Breaking High

Many API endpoints under /apis/web/v1/ and image URIs have changed.

Many API endpoints under /apis/web/v1/ and image URIs have changed.

Source: llm_adapter@2026-05-27

Confidence: high

 —
Breaking High

All PostgreSQL code and references have been removed; migration to SQLite required for v0.1.x users.

All PostgreSQL code and references have been removed; migration to SQLite required for v0.1.x users.

Source: llm_adapter@2026-05-27

Confidence: high

 —
Feature Medium

UI has a refreshed look with quick stats for listening data.

UI has a refreshed look with quick stats for listening data.

Source: llm_adapter@2026-05-27

Confidence: high

 —
Feature Medium

Adds streaks and additional statistics to the UI.

Adds streaks and additional statistics to the UI.

Source: llm_adapter@2026-05-27

Confidence: high

 —
Performance Low

Adds cache to stats handler for performance improvement.

Adds cache to stats handler for performance improvement.

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

Fixes nil mbz client passed to maloja importer.

Fixes nil mbz client passed to maloja importer.

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. ⚠️

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.0

Breaking Changes

  • All PostgreSQL code and references removed; must upgrade to v0.2.1 and migrate to SQLite before any further updates.
  • Many API endpoints under `/apis/web/v1/` routes and image URIs have changed; existing integrations will break.
View diff on GitHub

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

Share on X Share on Bluesky

Track Koito

Get notified when new releases ship.

Sign up free

About Koito

Koito is a modern, themeable scrobbler that you can use with any program that scrobbles to a custom ListenBrainz URL

All releases →

Related context

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.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.2.1 KOITO_SQLITE_ENABLED environment variable no longer needed

Beta — feedback welcome: [email protected]