Merge branch 'music-assistant:main' into main

Author: OzGav

docs/music-providers/index.md

@@ -34,6 +34,14 @@ Lastly, depending on providers installed, there may be additional sync related o
 
 ![image](../assets/screenshots/library-import-settings.png)
 
+- <b>Sync Library Artists/Albums/Tracks/Playlists/Audiobooks/Podcasts from this provider to Music Assistant.</b> Whether to synchronize all artists/albums/tracks/playlists/audiobooks/podcasts from the local provider. 
+- <b>Import album tracks.</b> By default, adding albums to the Music Assistant library imports only the album entry rather than the associated tracks. This approach allows for the manual selection of specific tracks to include. To override this behavior, this configuration option can be enabled. Users should note that some streaming providers may already automate this process by adding all tracks to their favorites by default.
+- <b>Import playlist tracks.</b> By default, importing a playlist into Music Assistant adds only the playlist itself to the library. This allows the playlist to be streamed and individual tracks can be added manually as desired. This configuration option overrides that behavior for specific playlists by importing all associated tracks. Entries can be made using either the case-sensitive playlist name or the playlist URI.
+- <b>Automatic sync interval for Artists/Albums/Tracks/Playlists/Podcasts/Audiobooks.</b> Various time periods are selectable or it can be disabled
+- <b>Sync back library additions/removals (2-way sync).</b> This setting determines the behavior when an item is manually added to or removed from the Music Assistant library. Enabling this option ensures that these actions are synchronized back to the original provider. Without synchronization, items removed from the library may reappear during the next automatic sync if they remain present on the provider's side.
+- <b>Sync Podcast Progress from (provider).</b> Automatically sync episode played status from the provider to Music Assistant. Episodes marked as played in the provider will be marked as played in MA. Only enable this if you use both the the provider app and Music Assistant for podcast playback.
+- <b>Sync Audiobook Progress from (provider).</b> Automatically sync audiobook progress from \<provider> to Music Assistant. Progress from Spotify app will sync to MA when audiobooks are accessed. Only enable this if you use both the the provider app and Music Assistant for audiobook playback.
+
 ## Summary
 
 The table below provides an at-a-glance summary of all of the music providers. Green ticks indicate a desirable quality or function is available. 

docs/music-providers/spotify.md

@@ -23,7 +23,7 @@ Music Assistant has full support for Spotify media listing and playback.
 
 ### Other
 
-- Searching the Spotify catalogue
+- 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
@@ -38,20 +38,11 @@ Music Assistant has full support for Spotify media listing and playback.
 
 ### Settings
 
-- <b>Sync Library Artists/Albums/Tracks/Playlists/Audiobooks/Podcasts from this provider to Music Assistant.</b> Whether to synchronize all artists/albums/tracks/playlists/audiobooks/podcasts from the local provider. 
-- <b>Import album tracks.</b> By default, adding albums to the Music Assistant library imports only the album entry rather than the associated tracks. This approach allows for the manual selection of specific tracks to include. To override this behavior, this configuration option can be enabled. Users should note that some streaming providers may already automate this process by adding all tracks to their favorites by default.
-- <b>Import playlist tracks.</b> By default, importing a playlist into Music Assistant adds only the playlist itself to the library. This allows the playlist to be streamed and individual tracks can be added manually as desired. This configuration option overrides that behavior for specific playlists by importing all associated tracks. Entries can be made using either the case-sensitive playlist name or the playlist URI.
-- <b>Automatic sync interval for Artists/Albums/Tracks/Playlists/Podcasts/Audiobooks.</b> Various time periods are selectable or it can be disabled
-- <b>Sync back library additions/removals (2-way sync).</b> This setting determines the behavior when an item is manually added to or removed from the Music Assistant library. Enabling this option ensures that these actions are synchronized back to the original provider. Without synchronization, items removed from the library may reappear during the next automatic sync if they remain present on the provider's side.
-- <b>Sync Podcast Progress from Spotify.</b> Automatically sync episode played status from Spotify to Music Assistant. Episodes marked as played in Spotify will be marked as played in MA. Only enable this if you use both the Spotify app and Music Assistant for podcast playback.
-- <b>Sync Audiobook Progress from Spotify.</b> Automatically sync audiobook progress from Spotify to Music Assistant. Progress from Spotify app will sync to MA when audiobooks are accessed. Only enable this if you use both the Spotify app and Music Assistant for audiobook playback.
+Refer to the [Library Import Control](index.md#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).
-
-## Not yet supported
-
-- Recommendations ([see this feature request](https://github.com/music-assistant/support/discussions/535))
+- 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