JRiver

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

• Tools -> Options -> Media Network
  • Check Use Media Network to share this library...
  • If you have Authentication checked you will need to provide the Username and Password in the ENV/File configuration below.

URL

The URL used to connect to JRiver, 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:52199/MCWS/v1/

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.

Jriver Settings

• Make sure the port number matches what is found in Advanced section in the Media Network options.
• 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 JRiver:

url	Transformed URL
(none set)	http://localhost:52199/MCWS/v1/
jriver.mydomain.com	http://jriver.mydomain.com:52199/MCWS/v1/
192.168.0.101:3456	http://192.168.0.101:3456/MCWS/v1/
mydomain.com:80/jriverReverse/MCWS/v1/	mydomain.com:80/jriverReverse/MCWS/v1/

Configuration

ENV

Configuration Type

This is configuration for the ENV Config Type.

Environmental Variable	Required	Default	Description
JRIVER_URL	Yes	http://localhost:52199/MCWS/v1/	The URL of the JRiver server
JRIVER_USERNAME	No		If authentication is enabled, the username set
JRIVER_PASSWORD	No		If authenticated is enabled, the password set

File

Config Structure

This displays the structure of the File Configuration for a jriver type Source 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 jriver Source 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 jriver Source 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/jriver.json

[
  {
    "name": "MyJriver",
    "enable": true,
    "data": {
      "url": "0.0.0.0",
      "username": "auser",
      "password": "apassword"
    }
  }
]

AIO

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 jriver type from the respective sources node below, then expand it.

Loading ...

Config Example

This displays an example config file of a all-in-one (config.json) configuration that includes a jriver Source 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 all-in-one (config.json) configuration that includes a jriver Source 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/config.json

{
  "sources": [
    {
      "name": "MyJriver",
      "enable": true,
      "data": {
        "url": "0.0.0.0",
        "username": "auser",
        "password": "apassword"
      },
      "type": "jriver"
    }
  ]
}