Kodi

In order for multi-scrobbler to communicate with Kodi you must have the Web Interface enabled. This can be done in the Kodi GUI:

• Settings -> Services -> Control
  • Check Allow remote control via HTTP
  • Ensure you have a Username and Password set, you will need to provide them in the ENV/File configuration below.

URL

The URL used to connect to Kodi, set in your file config as url. The URL used to connect ultimately must be formed like this:

Syntax  => [protocol]://[hostname]:[port]/[path]
Default =>       http://localhost:8080/jsonrpc

If any part of this URL is missing multi-scrobbler will use a default value. This also means that if any part of your URL is not standard you must explicitly define it.

Kodi Settings

• Make sure the port number matches what is found in Port in the Control section mentioned above.
• If your installation is on the same machine but you cannot connect using localhost try 0.0.0.0 instead.

URL Transform Examples

Examples of a given url in your file config and the final URL multi-scrobbler will use to connect to Kodi:

url	Transformed URL
(none set)	http://localhost:8080/jsonrpc
kodi.mydomain.com	http://kodi.mydomain.com:8080/jsonrpc
192.168.0.101:3456	http://192.168.0.101:3456/jsonprc
mydomain.com:80/kodiReverse/jsonrpc	http://mydomain.com:80/kodiReverse/jsonrpc

Configuration

ENV

ENV Config Type

Environmental Variable	Required	Default	Description
KODI_URL	Yes	http://localhost:8080/jsonrpc	The URL of the Kodi server
KODI_USERNAME	No		The username set
KODI_PASSWORD	No		The password set

File

File Config Type

CONFIG/kodi.json

[
  {
    "name": "MyKodi",
    "enable": true,
    "data": {
      "url": "http://localhost:8080/jsonrpc",
      "username": "myUser",
      "password": "myPassword"
    }
  }
]

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

AIO

AIO Config Type

CONFIG_DIR/config.json

{
  "sources": [
    {
      "name": "MyKodi",
      "enable": true,
      "data": {
        "url": "http://localhost:8080/jsonrpc",
        "username": "myUser",
        "password": "myPassword"
      },
      "type": "kodi"
    }
  ]
}

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