Koito
Koito is a modern, themeable ListenBrainz-compatible scrobbler for self-hosters who want control over their data and insights into their listening habits.
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
Security check: 3 serious findings
- Uses github.com/jackc/pgx/v5 v5.7.4, which has a known critical vulnerability (Go)
- Uses github.com/jackc/pgx/v5 v5.7.4, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
Automated checks on commit a079fa6, 27 Oct 2026. Not an audit.
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
Variants
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.
Community
- Reddit (reddit)
- Question for those that have done Koito headlight upgrade (forum)
- What are your top self hosted services that you are very ... - Reddit (reddit)
Collected 48 days ago - public community threads