Koito

Koito is a modern, themeable scrobbler that implements the ListenBrainz-compatible scrobbling API and provides a web UI to explore listening history and trends. It is built for self-hosting with a focus on performance, theming, and interoperable relaying of scrobbles.

Key Features

• ListenBrainz-compatible scrobbling endpoint compatible with clients that support custom ListenBrainz URLs
• Scrobble relay to forward listens to other ListenBrainz-compatible servers
• Import support for Maloja, ListenBrainz, LastFM, and Spotify export formats
• Automatic metadata fetching from MusicBrainz and cover images from Deezer and Cover Art Archive
• Themeable web UI with multiple built-in themes and support for custom themes
• Docker-friendly deployment with example docker-compose and a PostgreSQL backend
• Focus on performance and a sleek TypeScript-based frontend for responsive dashboards

Use Cases

• Run a personal scrobbling server to store and visualize your listening history locally
• Migrate or import historical scrobbles from LastFM, Spotify, or other ListenBrainz-compatible sources
• Relay scrobbles to a public ListenBrainz instance or other compatible collectors while keeping a private copy

Limitations and Considerations

• The project is under active development and marked as unstable; users may encounter bugs and breaking changes
• Current deployments use PostgreSQL as the primary supported database, requiring a Postgres instance
• Feature set and testing coverage are still growing; some advanced analytics or integrations may be missing

Koito is a practical option for users who want a fast, themeable, self-hosted scrobbler with import and relay capabilities. It emphasizes interoperability with ListenBrainz and provides a modern UI for exploring listening data.