Skip to content

Music Assistant has support for Apple Music! Contributed and maintained by MarvinSchenkel

NOTE

  • A paid subscription is required to add this Music Source.
  • Audio playback is not officially supported by Apple, use at your own risk
Subscription FREENo
Self-Hosted Local MediaNo
Media Types SupportedArtists, Albums, Tracks, Playlists, Radio
Recommendations SupportedYes
Lyrics SupportedNo
Radio ModeYes
Maximum Stream QualityLossy AAC (256kbps)
Login MethodOAuth or Cookie
  • Searching the Apple Music catalogue
  • Browsing playlists organised in folders
  • Artist radio stations available via Browse and the Discover view; live broadcast stations are not supported

The required token can be retrieved automatically by authenticating your Music Assistant instance with Apple Music.

Click the Authenticate with Apple Music button, then in the pop-up window sign in with your Apple ID and authorize Music Assistant to access your Apple Music Library.

Preview image

NOTE

This token will expire and needs to be re-authenticated manually after 180 days.

  • Manual Music User Token. If the normal authentication flow is unavailable then the token can be added manually here
Instructions for Manual Token Retrieval

The token needs to be retrieved through your browser. Instructions were written for Chrome:

  1. Navigate to https://music.apple.com/

  2. Go to View > Developer > Developer Tools. A new side window will open.

  3. Click the ‘Application’ tab. You might need to expand your window or click the >> button

    Preview image

  4. Under Storage > Cookies, click “https://music.apple.com” and find the entry called “media-user-token”

  5. Click it and copy the cookie value and use this in Music Assistant as the ‘Music user token’

    Preview image

  6. Currently in order for the callback to work MA must be accessed via the exposed webserver port when setting up this source. If MA has been installed as an app, then the port must be manually exposed as described in the core settings. Thus the URL when setting this source up must be http://<YOUR_MA_IP>:8095. Once successfully configured the webserver port can be disabled again if desired.

Note: Take note of the “Expires / Max-Age” column. The token will expire on that date and Apple Music within Music Assistant will stop working. The above process must then be repeated to obtain a fresh token.

  • Due to Apple’s proprietary encryption (FairPlay), Lossless and Dolby Atmos versions of songs are not supported
  • Due to limitations in the API, favouriting an item will only sync back to Apple Music for albums, playlists and tracks
  • Due to lack of an offical API, it can take up to 5 seconds to transition between tracks
  • Only user-created playlists can be edited; shared and curated playlists are read-only