[READ-ONLY] Mirror of https://github.com/FoxxMD/multi-scrobbler. Scrobble plays from multiple sources to multiple clients
docs.multi-scrobbler.app
deezer
docker
jellyfin
koito
lastfm
listenbrainz
maloja
mopidy
mpris
music
music-assistant
plex
scrobble
self-hosted
spotify
subsonic
tautulli
youtube-music
docs(azuracast): Add clearer guidance on station configuration and access
+65
-3
+65
-3
docsite/docs/configuration/sources/azuracast.mdx
+65
-3
docsite/docs/configuration/sources/azuracast.mdx
···
16
16
17
17
:::
18
18
19
-
The Azuracast server should have **Use High-Performance Now Playing Updates** enabled in _Administration -> System Settings_
19
+
The Azuracast server should have **Use [High-Performance Now Playing Updates](https://www.azuracast.com/docs/developers/now-playing-data/#high-performance-updates)** enabled in _Administration -> System Settings_
20
20
21
-
#### URL
21
+
### URL
22
22
23
23
The URL used by MS to connect to Azuracast has the syntax:
24
24
···
47
47
48
48
If neither is configured automatic scrobble defaults to **off** and you should either manually initiate it or explicitly set the default behavior.
49
49
50
+
### Station
51
+
52
+
#### Station Identifier
53
+
54
+
The station identifier multi-scrobbler uses (ENV `AZURA_STATION` or `station` in File/AIO config) needs to be the **URL Stub** or **shortcode** of the Azuracast station, **not** its display name. Use of the methods below to find an apprioriate station identifier.
55
+
56
+
<Tabs groupId="stationId" queryString>
57
+
<TabItem value="stub" label="URL Stub">
58
+
The **URL Stub** is the value used in the URL to access the station EX
59
+
60
+
```
61
+
https://azura.mydomain.com/public/my-cool-station
62
+
^^^^ url stub ^^
63
+
```
64
+
65
+
Use `my-cool-station` as the station identifier.
66
+
</TabItem>
67
+
<TabItem value="shortcode" label="Shortcode">
68
+
The **shortcode** can be found in the raw JSON response for your station. Navigate to this URL in your browser:
69
+
70
+
```
71
+
https://azura.mydomain.com/api/stations
72
+
```
73
+
74
+
Find your station in the returned data (by `name`) and then locate the value of the `shortcode` property in that object.
75
+
76
+
<details>
77
+
78
+
<summary>Example</summary>
79
+
80
+
```json
81
+
[
82
+
{
83
+
"id": 1,
84
+
"name": "My Cool Station",
85
+
"shortcode": "my-cool-station",
86
+
"description": "Re-broadcasts of my cool music",
87
+
"frontend": "icecast",
88
+
"backend": "liquidsoap",
89
+
...
90
+
```
91
+
92
+
Use `my-cool-station` as the station identifier.
93
+
</details>
94
+
</TabItem>
95
+
</Tabs>
96
+
97
+
#### Station Access
98
+
99
+
Multi-Scrobbler does not use authentication to communicate with Azuracast. Your station will likely need some form of **Public Pages** in order for you to monitor it.
100
+
101
+
In your station's **Edit Station Settings** -> **Public Pages** make sure that at least one of these is enabled:
102
+
103
+
* Enable Public Pages
104
+
* Enable Public APIs
105
+
106
+
:::note
107
+
108
+
For users who aren't administrators of Azuracast: if you can access the station using `https://azura.mydomain.com/public/xxxxxx` then it is public.
109
+
110
+
:::
111
+
50
112
## Configuration
51
113
52
114
<Config config="AzuracastSourceConfig" fileContent={AzuracastConfig} name="azuracast">
···
54
116
| :--------------------- | :-------- | :------ | ---------------------------------------------------------------------------------------------- |
55
117
| `AZURA_ID` | Yes | | A unique ID |
56
118
| `AZURA_URL` | Yes | | Azuracast URL *without station name* |
57
-
| `AZURA_STATION` | Yes | | The station name shown on the public page |
119
+
| `AZURA_STATION` | Yes | | The station URL Stub or shortcode |
58
120
| `AZURA_LIVE` | No | Yes | Only scrobble when station status is ONLINE |
59
121
| `AZURA_LISTENERS_NUM` | No | `true` | Only scrobble if station has any listeners (`true`) or listeners are equal-to/greater-than `X` |
60
122
| `AZURA_NAME` | No | | A vanity name different than ID |