[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(docsite): fix heading hierarchy in applemusic.mdx
Adjusted markdown heading levels to ensure proper document structure.
+5
-5
+5
-5
docsite/docs/configuration/sources/applemusic.mdx
+5
-5
docsite/docs/configuration/sources/applemusic.mdx
···
13
13
14
14
Because of how the Apple Music API works, Multi-Scrobbler (MS) requires two different tokens to function: a **Media User Token** (identifies your personal account) and an **Authentication Token** (authorizes API access).
15
15
16
-
#### 1. Getting a Media User Token
16
+
### 1. Getting a Media User Token
17
17
18
18
The `mediaUserToken` is required to access your recently played history. You can extract it directly from the Apple Music web app:
19
19
···
27
27
The `mediaUserToken` will eventually expire. If Multi-Scrobbler begins throwing authentication errors in the logs, simply repeat these steps to obtain and configure a fresh token.
28
28
:::
29
29
30
-
#### 2. Authentication
30
+
### 2. Authentication
31
31
32
32
To authorize API access, Multi-Scrobbler requires an Authentication Token (JWT). Because the official Apple Music API is designed for developers, there are two ways to provide this token depending on your situation:
33
33
···
98
98
99
99
---
100
100
101
-
#### How Multi-Scrobbler handles Apple Music quirks
101
+
### How Multi-Scrobbler handles Apple Music quirks
102
102
103
-
**Timestamp Estimation**
103
+
#### Timestamp Estimation
104
104
105
105
The Apple Music API **does not provide timestamps** for when tracks were played. Multi-Scrobbler estimates play times by taking the current time and subtracting track durations backwards:
106
106
* The most recent track is assumed to have finished playing **now**.
···
108
108
109
109
*For the most accurate scrobble timestamps, it is highly recommended to keep the polling interval (`APPLEMUSIC_INTERVAL`) low (the default is 60 seconds).*
110
110
111
-
**Duplicate Play Recovery**
111
+
#### Duplicate Play Recovery
112
112
113
113
The Apple Music history API strictly deduplicates tracks. Instead of showing the same song multiple times in a row, it simply bumps the re-played track back to the #1 spot and removes the older entry.
114
114