Subsonic

This Source can be used for any application that implements the Subsonic API and supports the getNowPlaying endpoint (such as Airsonic and Navidrome)

Known Issues

• Multiple artists are reported as one value and cannot be separated
• If using Airsonic Advanced the password used (under Credentials) must be Decodable

Recommended Alternative Sources

If your service supports scrobbling to Listenbrainz (such as Navidrome), considering using a Listenbrainz (Endpoint) Source instead of this one.

Service-specific scrobble implementations tend to be more accurate and provide more information (multiple artists) compared to the Subsonic API.

Use the optional usersAllow property with File or AIO configuration to restrict scrobbling to a list of defined users.

Enhanced Playback Reporting

Multi-Scrobbler supports the new Open Subsonic extension, Playback Report, that enables millisecond-accurate player position and state reporting.

To use this new data, your Subsonic server must support the extension and the active playback Client must report it. The UI for your Subsonic Source and active Player will indicate support using contextual icons.

Usage of Enhanced Playback Reporting is optional: MS will fallback to classic, less accurate Subsonic Now Playing when it is not available.

Stale Players without Playback Reporting

For Subsonic server/client combinations that do not support Enhanced Playback Reporting, multi-scrobbler will cleanup players that report they are playing for much longer period of time than the track's length (when length is reported). This prevents repeated scrobbles from Subsonic-compatible servers that continue returning a track after playback stops.

If the server properly reports no playing song when playback has stopped or this causes issues for your setup, the detection can be disabled by setting detectStaleNowPlayingFromMinutesAgo to false in File/AIO config.

Configuration

ENV

Configuration Type

This is configuration for the ENV Config Type.

Environmental Variable	Required?	Default	Description
SUBSONIC_ID	Yes		A unique ID
SUBSONIC_USER	Yes
SUBSONIC_PASSWORD	Yes
SUBSONIC_URL	Yes		Base url of your subsonic-api server
SUBSONIC_NAME	No		A vanity name different than ID

File

Config Structure

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

[
  {
    "id": "mySubsonic",
    "name": "Airsonic Server",
    "enable": true,
    "data": {
      "url": "http://localhost:4040/airsonic",
      "user": "yourUser",
      "password": "yourPassword",
      "usersAllow": [
        "yourUser"
      ],
      "detectStaleNowPlayingFromMinutesAgo": true
    }
  }
]

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 subsonic 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 subsonic 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 subsonic 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": [
    {
      "id": "mySubsonic",
      "name": "Airsonic Server",
      "enable": true,
      "data": {
        "url": "http://localhost:4040/airsonic",
        "user": "yourUser",
        "password": "yourPassword",
        "usersAllow": [
          "yourUser"
        ],
        "detectStaleNowPlayingFromMinutesAgo": true
      },
      "type": "subsonic"
    }
  ]
}