Overview

Koito is a modern, themeable scrobbler that you can use with any program that scrobbles to a custom ListenBrainz URL Visualize your listening history with a modern, open source, ListenBrainz-compatible scrobbler. Koito (小糸) is a Japanese surname. It is also homophonous with the words 恋と (koi to), meaning “and/with love”. The project has 678 GitHub stars and is licensed under MIT.

Key Features

Source: GitHub README

⚡ More performant than similar software
🖌️ Sleek UI
🔁 Compatible with anything that scrobbles to ListenBrainz
🔌 Easy relay to your existing setup
📂 Import support for Maloja, ListenBrainz, LastFM, and Spotify

Getting Started

Source: GitHub README

services:
  koito:
    image: gabehf/koito:latest
    container_name: koito
    depends_on:
      - db
    environment:
      - KOITO_DATABASE_URL=postgres://postgres:secret_password@db:5432/koitodb
      - KOITO_ALLOWED_HOSTS=koito.example.com,192.168.0.100:4110
    ports:
      - "4110:4110"
    volumes:
      - ./koito-data:/etc/koito
    restart: unless-stopped

  db:
    image: postgres:16
    container_name: psql
    restart: unless-stopped
    environment:
      POSTGRES_DB: koitodb
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: secret_password
    volumes:
      - ./db-data:/var/lib/postgresql/data

Normalized Features

Source: tool-features-normalized.json

docker, docker compose, postgresql, rest api.

Deploy

Docker

Self-host with Docker Compose

Coolify

One-click via Coolify panel

Elestio

Managed hosting from $9/mo

PikaPods

Simple managed hosting

Features

Integrations & APIs

REST API

Related Media & Streaming Tools

View all 334 →

Immich

95K

High-performance self-hosted photo and video management — automatic backup, ML-powered search, and a Google Photos-like experience on your own server.

media AGPL-3.0

Jellyfin

49K

The volunteer-built media solution that puts you in control of your media. Stream movies, shows, music, and photos to any device from your own server.

media GPL-2.0