Azuracast

Scrobbling Threshold

Azuracast may not correctly report track length or position. If this is the case you should reduce the "listened to" duration using Scrobble Thresholds so that multi-scrobbler scrobbles correctly.

The Azuracast server should have Use High-Performance Now Playing Updates enabled in Administration -> System Settings

URL

The URL used by MS to connect to Azuracast has the syntax:

[ws|wss]://HOST:[PORT]

MS will automatically add the path required for websockets, /api/live/nowplaying/websocket, to your URL if none is provided. If you use a reverse proxy with a path-based URL or otherwise need a custom path to access the websockets path correctly then explicitly provide it. Examples:

URL From Config                => MS Uses

'ws://192.168.0.101'                 => ws://192.168.0.101/api/live/nowplaying/websocket
'ws://azura.mydomain.com'            => ws://azura.mydomain.com.com/api/live/nowplaying/websocket
'wss://mydomain.com/custom/azura/ws' => wss://mydomain.com/custom/azura/ws

Scrobble Behavior

info

This Source supports toggling scrobbling on or off manually. This action can be taken on the Web Dashboard by clicking the link next to Should Scrobble found in each Source's status card.

Additionally, the default behavior for scrobbling can be explicitly set by adding the following value to a Source's options in file or aio config:

azuracast.json

{
  "data": {
      // ...
  },
  "options": {
      // set to true to always scrobble automatically
      // set to false to never scrobble automatically
      "systemScrobble": true
  }
}}

Multi-scrobbler will set the default scrobbling behavior based on if either of these settings is configured:

• live status (AZURA_LIVE or monitorWhenLive) or
• listener count (AZURA_LISTENERS_NUM or monitorWhenListeners)

If either is configured then MS will automatically scrobble based on when these conditions are met.

If neither is configured automatic scrobble defaults to off and you should either manually initiate it or explicitly set the default behavior.

Configuration

ENV

Environmental Variable	Required?	Default	Description
AZ_URL	Yes		Azuracast URL without station name
AZ_STATION	Yes		The station name shown on the public page
AZURA_LIVE	No	Yes	Only scrobble when station status is ONLINE
AZURA_LISTENERS_NUM	No	true	Only scrobble if station has any listeners (true) or listeners are equal-to/greater-than X

File

CONFIG_DIR/azuracast.json

[
  {
    "type": "azuracast",
    "enable": true,
    "name": "azura",
    "data": {
      "url": "ws://192.168.0.101",
      "station": "my-station-name",
      "monitorWhenLive": true,
      "monitorWhenListeners": 1
    }
  }
]

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

AIO

CONFIG_DIR/config.json

{
  "sources": [
    {
      "type": "azuracast",
      "enable": true,
      "name": "azura",
      "data": {
        "url": "ws://192.168.0.101",
        "station": "my-station-name",
        "monitorWhenLive": true,
        "monitorWhenListeners": 1
      }
    }
  ]
}

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