Koito

Other Uses

To monitor and re-scrobble activity from a Koito account create a Koito (Source)

Setup a Koito server if you have not already done this.

Create (or get) an API Key
- From your Koito server dashboard navigate to Settings (bottom-left icon) => API Keys
- Create a new Key (or use an existing) and Copy the key using the copy icon to the right of the key
- EX pM195xPV98CDpk0QW47FIIOR8AKATAX5DblBF-Jq0t1MbbKL
Take note of your Koito username (used below as KOITO_USER)
Determine your Koito URL
- This is the URL you use to access your Koito dashboard OR whatever URL is accessible from your multi-scrobbler instance.
- EX dashboard at http://192.168.0.100:4110 => KOITO_URL is set to http://192.168.0.100:4110

Koito Base URL

Using the URL path /apis/listenbrainz Koito docs describe is not required. The Koito URL used for multi-scrobbler should only be the base URL. Only include a URL path if your Koito base url is not at host:port. See the table below for examples.

Base URL Examples

`KOITO_URL`	MS Detected Base URL	Example Scrobble Api URL
`http://192.168.0.100:4110`	`http://192.168.0.100:4110`	`http://192.168.0.100:4110/apis/listenbrainz/1`
`https://koito.mydomain.com`	`https://koito.mydomain.com`	`https://koito.mydomain.com/apis/listenbrainz/1`
`http://192.168.0.100:4110/apis/listenbrainz`	`http://192.168.0.100:4110`	`http://192.168.0.100:4110/apis/listenbrainz/1`
`http://192.168.0.100:80/koito`	`http://192.168.0.100:80/koito`	`http://192.168.0.100:80/koito/apis/listenbrainz/1`

tip

Ensure that Koito is configured to allow requests from multi-scrobbler! In Koito config set KOITO_ALLOWED_HOSTS to the IP the multi-scrobbler dashboard is accessible from.

Configuration

ENV
File
AIO

ENV Config Type

Environmental Variable	Required?	Description
KOITO_TOKEN	Yes	API Key from your Koito Account
KOITO_USER	Yes	Your Koito username
KOITO_URL	No	The base URL for the Koito server

File Config Type

CONFIG/koito.json
[
  {
    "name": "koito-client",
    "configureAs": "client",
    "data": {
      "token": "029b081ba-9156-4pe7-88e5-3be671f5ea2b",
      "username": "admin",
      "url": "http://192.168.0.100:4110"
    }
  }
]

or explore the schema with an example and live editor/validator

AIO Config Type

CONFIG_DIR/config.json
{
  "clients": [
    {
      "name": "koito-client",
      "configureAs": "client",
      "data": {
        "token": "029b081ba-9156-4pe7-88e5-3be671f5ea2b",
        "username": "admin",
        "url": "http://192.168.0.100:4110"
      },
      "type": "koito"
    }
  ]
}

or explore the schema with an example and live editor/validator

Configuration​

Configuration