Spotify Provider

Music Assistant has full support for Spotify media listing and playback.

Features

Subscription FREE	No
Self-Hosted Local Media	No
Media Types Supported	Artists, Albums, Tracks, Playlists, Podcasts, Audiobooks
Recommendations Supported	No
Lyrics Supported	No
Radio Mode	Yes
Maximum Stream Quality	Lossy, OGG Vorbis (320kbps)
Login Method	OAuth

Other

• Searching the Spotify catalogue is possible
• Items in your Spotify library (including the Liked Songs playlist) will be added to the Library in Music Assistant
• Adding an item from Spotify to the Music Assistant Library will also add it to "Your Library" in Spotify
• Marking an item as a favourite in Music Assistant will also add it to the MA Library and "Your Library" in Spotify
• Multiple Spotify accounts can be added. All playlists from all accounts will be shown. If a playlist is selected for playback the source Spotify account will be used

Configuration

• The Spotify provider can only be configured from a device which is on the same subnet as the MA server (and not via a VPN)
• Configuration is done with an OAuth callback. Clicking on the AUTHENTICATE WITH SPOTIFY button will open a new tab where permission can be given for MA to access the logged in account
• Once the intial authentication is done a new option will appear towards the bottom of the view titled Developer Token. It is advantageous to add a personal Client ID as this will speed up access to the Spotify API and should eliminate rate limiting. How to obtain a Client ID is explained here. When entering the information in the various fields the only mandatory item is the REDIRECT URL which must be set to https://music-assistant.io/callback. Using a personal Client ID is optional but rate limiting and streaming errors may be seen in the log if it is not supplied
• If a personal Client ID is added then click on the large button AUTHENTICATE DEVELOPER SESSION
• Finally the SAVE button must be pressed on the Spotify settings page. If the device being used kills the MA frontend before this is done then the provider setup will fail (Use a different, typically non-mobile, device if this happens)

Settings

Refer to the Library Import Control settings.

Known Issues / Notes

• Due to restrictions with Spotify's API, only Spotify Premium accounts are supported (including Duo and Family). Free accounts will not work
• Upon first saving of the provider a check is done for Audiobook support within the account. If the check is successful then additional Audiobook related options will be seen when revisiting the provider settings
• After adding the developer token there is then two sessions created to a single spotify provider and MA routes the requests appropriately. For example, playlists are requested via the MA global token (which is rate limited but allows playlist retrieval) while other items are retrieved via the dev token. Search is done using the dev token by default as otherwise it is very slow. Playing and browsing playlists is routed through the global token to the originating provider (useful when multiple Spotify accounts are added)
• The Spotify API does not support the provision of recommendations