Koito

Koito is a modern, themeable ListenBrainz-compatible scrobbler for self-hosters who want control over their data and insights into their listening habits.

  • Databases
  • Media Applications
  • Other
  • Productivity
  • Tools & Utilities
Koito is a modern, themeable ListenBrainz-compatible scrobbler for self-hosters who want control over their data and insights into their listening habits. It supports relaying to other compatible scrobblers, so you can try it safely without replacing your current setup.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

52/100 Fair

Maintained
75last commit 121 days ago
Popular
611,121 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
103 serious findings, 6 minor, CI, tests

Availability: platform listings confirmed today, links checked 47 days ago

GitHub stars
1,121
Open issues
95
Last commit
2026-07-23
Latest release
v0.3.2
License
MIT
Activity
stale

Checked 22 days ago - source: GitHub (gabehf/koito)

Resources & Compatibility

Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Validate your API key first If you plan to use Koito's API, test your API key with GET /validate-token before relying on it; if the key is wrong, Koito replies 401 and API requests will fail. source
  • Set the default theme you want Set KOITO_DEFAULT_THEME to the theme you want before starting Koito if you care about the initial look; without it, the initial theme may not be the one you expect, and you can check the value in GET /apis/web/v1/config. source
  • Consider relaying first If Koito's active-development status worries you, configure it as a relay to your existing ListenBrainz-compatible scrobbler before replacing your setup. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which port should Koito expose and how do I open the UI?

Expose port 4110 and open your server on that port in a browser.

Which volume should I mount in the provided Docker Compose example?

Mount a local directory to /etc/koito, such as ./koito:/etc/koito.

Do I need to set a database environment variable for a new installation?

New installations use SQLite as of v0.2.1. If you are running an older version, set KOITO_SQLITE_ENABLED=true.

Can Koito send listens to other scrobbling services?

Yes, it can automatically relay listens submitted to your Koito instance to other ListenBrainz-compatible servers.

Which external sources does Koito use for metadata?

It automatically fetches data from MusicBrainz and images from Deezer and Cover Art Archive.

Answers sourced from koito.io, koito.io

Community

Collected 48 days ago - public community threads