-
Notifications
You must be signed in to change notification settings - Fork 3
Media Library Browser
Media Library Browsing support was enabled with the 1.0.1 release version of the integration. It includes various types of Spotify media content, as well as recently played items.
The following library index node content is supported:
- Playlists
- Artists
- Albums
- Tracks
- Podcasts
- Top Artists
- Top Tracks
- Featured Playlists
- New Releases
- Categories
- Made For You Playlists
- Recently Played
![](images/MediaBrowser/Spotify_Index.png?v01_20240226)
A Spotify Premium account is required to control a Spotify Connect media player(s).
The SpotifyWebApiPython library is used to make queries to the Spotify Web API for data gathering.
A custom icon (or logo) can be displayed for each library index item by adding the images to the \config\www\images\
location with a filename format or spotifyplus_medialib_<NAME>.png
, where <NAME>
is the index entry name. For example, the "Playlists" entry image file name would be spotifyplus_medialib_playlists.png
. The specified images will be displayed in the HA media browser index page. A stock icon image will be displayed if a custom image is not found for an index entry.
Displays the playlists owned or followed by the Spotify user.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the contents of the playlist by tappping on the media item image outside of the play
overlay icon.
Playlist Index Page
![](images/MediaBrowser/Spotify_Playlist_01Index.png?v01_20240226)
Playlist Detail Page
![](images/MediaBrowser/Spotify_Playlist_02Detail.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetPlaylistFavorites method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_playlists.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's followed artists.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the artist's albums by tappping on the media item image outside of the play
overlay icon.
Artist Index Page
![](images/MediaBrowser/Spotify_Artist_01Index.png?v01_20240226)
Artist Albums Page
![](images/MediaBrowser/Spotify_Artist_02Albums.png?v01_20240226)
Artist Album Tracks Page
![](images/MediaBrowser/Spotify_Artist_03AlbumTracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetArtistsFollowed method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_artists.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's album favorites.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the album's tracks by tappping on the media item image outside of the play
overlay icon.
Album Index Page
![](images/MediaBrowser/Spotify_Albums_01Index.png?v01_20240226)
Album Tracks Page
![](images/MediaBrowser/Spotify_Albums_02Tracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetAlbumFavorites method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_albums.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's track favorites.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item.
Tracks Index Page
![](images/MediaBrowser/Spotify_Tracks_01Index.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetTrackFavorites method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_tracks.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's podcast (aka show) favorites.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item.
Podcasts Index Page
![](images/MediaBrowser/Spotify_Podcasts_01Index.png?v01_20240226)
Podcasts Episode Page
![](images/MediaBrowser/Spotify_Podcasts_02Episodes.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetShowFavorites method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_podcasts.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's top artists based on calculated affinity.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the artist's albums by tappping on the media item image outside of the play
overlay icon.
Top Artists Index Page
![](images/MediaBrowser/Spotify_TopArtists_01Index.png?v01_20240226)
Top Artist Albums Page
![](images/MediaBrowser/Spotify_Artist_02Albums.png?v01_20240226)
Top Artist Album Tracks Page
![](images/MediaBrowser/Spotify_Artist_03AlbumTracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetUsersTopArtists method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_top_artists.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the Spotify user's top tracks based on calculated affinity.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item.
Top Tracks Index Page
![](images/MediaBrowser/Spotify_TopTracks_01Index.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetUsersTopTracks method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_top_tracks.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the contents of the playlist by tappping on the media item image outside of the play
overlay icon.
Playlist Index Page
![](images/MediaBrowser/Spotify_FeaturedPlaylists_01Index.png?v01_20240226)
Playlist Detail Page
![](images/MediaBrowser/Spotify_FeaturedPlaylists_02Tracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetFeaturedPlaylists method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_featured_playlists.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays new album releases featured in Spotify.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the album's tracks by tappping on the media item image outside of the play
overlay icon.
New Releases Index Page
![](images/MediaBrowser/Spotify_NewReleases_01Index.png?v01_20240226)
New Releases Tracks Page
![](images/MediaBrowser/Spotify_NewReleases_02Tracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetAlbumNewReleases method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_new_releases.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays a list of Spotify categories (aka genres), and subsequent playlists tagged with a particular category.
This will allow you to select a category to display playlists that have been tagged with that category. It will then allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the playlist's tracks by tappping on the media item image outside of the play
overlay icon.
Category Index Page
![](images/MediaBrowser/Spotify_Categories_01Index.png?v01_20240226)
Category Playlists Page
![](images/MediaBrowser/Spotify_Categories_02Playlists.png?v01_20240226)
Category Playlist Tracks Page
![](images/MediaBrowser/Spotify_Categories_03PlaylistTracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetBrowseCategorys method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
The category playlist of items is queried from the Spotify Web API using the GetCategoryPlaylists method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item. The playlists for the category is qu
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_categories.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the "Made For You" category playlists, which are created by the Spotify AI engine for the user based on their listening habits.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item. You can also display the contents of the playlist by tappping on the media item image outside of the play
overlay icon.
Made For You Playlist Index Page
![](images/MediaBrowser/Spotify_MadeForYou_01Index.png?v01_20240226)
Made For You Playlist Tracks Page
![](images/MediaBrowser/Spotify_MadeForYou_02PlaylistTracks.png?v01_20240226)
The list of items is queried from the Spotify Web API using the GetCategoryPlaylists method, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_made_for_you.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.
Displays the current Spotify Player recently played list for a given device.
This will allow you to select a media item for play on the device by tapping on the play
overlay icon of the media item.
![](images/MediaBrowser/Spotify_RecentlyPlayed_01Index.png?v01_20240226)
The list of recently played items is queried from the Spotify Web API, and returned to the media browser for display. Cover art images (if any) are in the form of url links, supplied by the music service for each item.
A custom icon (or logo) can be displayed for this library index entry by adding the image to the \config\www\images\
location with a filename of spotifyplus_medialib_recently_played.png
. The specified image will be displayed in the HA media browser index page. A stock icon will be displayed if a custom image is not found for an index entry.