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.

Media Library Search support (added with the HA 2026.08.0 release) was enabled with the 1.0.213 release version of the integration.  The functionality is pretty limited due to the generic nature of the HA Media Browser UI (no support for paging, limited # of search results, etc), but it does give you the ability to search the Spotify catalog directly for different types of media.  The different favorites / recently played / new releases / etc are also searchable, so you can filter those lists down if you're looking for something specific in your favorites.  I would still suggest the [SpotifyPlus Card Dashboard](https://github.com/thlucas1/spotifyplus_card/wiki) for a more premium experience.

The following library index node content is supported:

- [Playlists](#playlists)
- [Artists](#artists)
- [Albums](#albums)
- [Tracks](#tracks)
- [Podcasts](#podcasts)
- [Top Artists](#top-artists)
- [Top Tracks](#top-tracks)
- [Featured Playlists](#featured-playlists)
- [New Releases](#new-releases)
- [Categories](#categories)
- [Made For You Playlists](#made-for-you-playlists)
- [Recently Played](#recently-played)

### How it Looks
<img src="images/MediaBrowser/Spotify_Index.png?v01_20240226">

### Requirements
A Spotify Premium account is required to control a Spotify Connect media player(s).  

The [SpotifyWebApiPython](https://github.com/thlucas1/SpotifyWebApiPython) library is used to make queries to the Spotify Web API for data gathering.

### Customized Icon
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.


## Playlists
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.

### How it Looks
_Playlist Index Page_

<img src="images/MediaBrowser/Spotify_Playlist_01Index.png?v01_20240226">

_Playlist Detail Page_  

<img src="images/MediaBrowser/Spotify_Playlist_02Detail.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetPlaylistFavorites](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Artists
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.

### How it Looks
_Artist Index Page_

<img src="images/MediaBrowser/Spotify_Artist_01Index.png?v01_20240226">

_Artist Albums Page_  

<img src="images/MediaBrowser/Spotify_Artist_02Albums.png?v01_20240226">

_Artist Album Tracks Page_  

<img src="images/MediaBrowser/Spotify_Artist_03AlbumTracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetArtistsFollowed](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Albums
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.

### How it Looks
_Album Index Page_

<img src="images/MediaBrowser/Spotify_Albums_01Index.png?v01_20240226">

_Album Tracks Page_  

<img src="images/MediaBrowser/Spotify_Albums_02Tracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetAlbumFavorites](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Tracks
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.

### How it Looks
_Tracks Index Page_  

<img src="images/MediaBrowser/Spotify_Tracks_01Index.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetTrackFavorites](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Podcasts
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.

### How it Looks
_Podcasts Index Page_  

<img src="images/MediaBrowser/Spotify_Podcasts_01Index.png?v01_20240226">

_Podcasts Episode Page_  

<img src="images/MediaBrowser/Spotify_Podcasts_02Episodes.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetShowFavorites](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Top Artists
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.

### How it Looks
_Top Artists Index Page_

<img src="images/MediaBrowser/Spotify_TopArtists_01Index.png?v01_20240226">

_Top Artist Albums Page_  

<img src="images/MediaBrowser/Spotify_Artist_02Albums.png?v01_20240226">

_Top Artist Album Tracks Page_  

<img src="images/MediaBrowser/Spotify_Artist_03AlbumTracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetUsersTopArtists](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Top Tracks
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.

### How it Looks
_Top Tracks Index Page_  

<img src="images/MediaBrowser/Spotify_TopTracks_01Index.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetUsersTopTracks](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Featured Playlists
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.

### How it Looks
_Playlist Index Page_

<img src="images/MediaBrowser/Spotify_FeaturedPlaylists_01Index.png?v01_20240226">

_Playlist Detail Page_  

<img src="images/MediaBrowser/Spotify_FeaturedPlaylists_02Tracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetFeaturedPlaylists](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## New Releases
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.

### How it Looks
_New Releases Index Page_

<img src="images/MediaBrowser/Spotify_NewReleases_01Index.png?v01_20240226">

_New Releases Tracks Page_  

<img src="images/MediaBrowser/Spotify_NewReleases_02Tracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetAlbumNewReleases](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Categories
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.

### How it Looks
_Category Index Page_

<img src="images/MediaBrowser/Spotify_Categories_01Index.png?v01_20240226">

_Category Playlists Page_  

<img src="images/MediaBrowser/Spotify_Categories_02Playlists.png?v01_20240226">

_Category Playlist Tracks Page_  

<img src="images/MediaBrowser/Spotify_Categories_03PlaylistTracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetBrowseCategorys](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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

### Customized Icon
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.


## Made For You Playlists
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.

### How it Looks
_Made For You Playlist Index Page_

<img src="images/MediaBrowser/Spotify_MadeForYou_01Index.png?v01_20240226">

_Made For You Playlist Tracks Page_  

<img src="images/MediaBrowser/Spotify_MadeForYou_02PlaylistTracks.png?v01_20240226">

### How it Works
The list of items is queried from the Spotify Web API using the [GetCategoryPlaylists](https://spotifywebapipython.readthedocs.io/en/latest/spotifywebapipython/spotifyclient.html#SpotifyClient.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.

### Customized Icon
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.


## Recently Played
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.

### How it Looks
<img src="images/MediaBrowser/Spotify_RecentlyPlayed_01Index.png?v01_20240226">

### How it Works
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.

### Customized Icon
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.