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

For Koito versions <=0.1.7, you must have the environment variable KOITO_ALLOWED_HOSTS set correctly in your Koito environment/container. Ensure it is set to the IP address or domain name that you use to access Koito with e.g. koito.mydomain.com.

Configuration

ENV
File
AIO

Configuration Type

This is configuration for the ENV Config Type.

Environmental Variable	Type	Default	Description
`KOITO_ID`	string		A globally unique ID EX `myComponentId`
`KOITO_NAME`	string	Value of `KOITO_ID`	A vanity name EX `My Cool Component`
`KOITO_ENABLE`	boolean	true	Should this component be used?
`KOITO_URL`	string		URL for the Koito server
`KOITO_TOKEN`	string		User token for the user to scrobble for
`KOITO_USER`	string		Username of the user to scrobble for

Bold/Italic = Required

Config Structure

This displays the structure of the File Configuration for a koito type Client with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Loading ...

Config Example

This displays an example config file of a koito Client File Configuration that adheres to the shown Config Structure.

text mode lets you edit the JSON directly.
tree mode gives you a guided point-and-click editing experience that always keeps the JSON syntax valid.

Both modes validate that the configuraion is correct. Any errors show up as squiggly lines.

After you finish editing, switch to text and then copy all text to get a completed config.

Config Example Mobile Experience

This displays an example config file of a koito Client File Configuration that adheres to the shown Config Structure.

The example config file editor is meant for a larger screen experience so only the read-only example is shown. Please use this site on a tablet/laptop/desktop to enable file editor features.

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

Config Structure

This displays the structure of the all-in-one (config.json) configuration with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Select the koito type from the respective clients node below, then expand it.