v1.0.18

[ 1.0.18 ] - 2024/12/11

• This release requires the SpotifyPlus Integration v1.0.69+ release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added playerVolumeControlsHideLevels config option that hides volume level numbers and percentages in the volume controls area of the Player section form. Volume slider control is not affected by this setting.
• Added albumFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Album Favorites media browser.
• Added artistFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Artist Favorites media browser.
• Added audiobookFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Audiobook Favorites media browser.
• Added episodeFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Episode Favorites media browser.
• Added playlistFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Playlist Favorites media browser.
• Added showFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Show Favorites media browser.
• Added trackFavBrowserItemsLimit config option that specifies the maximum number of items to be returned by the Track Favorites media browser.
• Added "Copy X Preset JSON to Clipboard" action for all section detail displays that contain a "Copy X Preset Info to Clipboard" action. This will create a user-preset JSON format configuration entry for the selected media and copy it to the clipboard; the entry can then be pasted into the userPresets.json file, which will create a user preset for the media item.
• Added theme variable --spc-card-footer-background-color to set card footer area background color; default value for the player section is vibrant color (based on cover art colors); default value for all other sections is card background color.
• Added theme variable --spc-card-footer-background-image to set card footer area background image; default value for the player section is a gradient, which provides good contrast; default value for all other sections is card background color.
• Added theme variable --spc-card-footer-color to set card footer icon foreground color; default value is inherit, which is card foreground color value.
• Adjusted scrollbar colors to more closely match selected theme.

v1.0.17

[ 1.0.17 ] - 2024/12/09

• This release requires the SpotifyPlus Integration v1.0.69+ release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Modified the media list items' text color to use the --spc-medialist-items-color variable (defaults to white) instead of the --secondary-text-color, as well as the title and sub-title background gradient. Media list item text was difficult to read using certain themes.
• Disabled Categories section by default when adding instance from card picker. Spotify Web API functionality was deprecated unexpectedly (and without prior notice!) by the Spotify Development Team.
• Updated underlying turn_on service to first check if the previously selected source is active or not; if so, then play is resumed immediately; if not, then a source_select is performed to activate the selected source. This result in a faster time to play when powering on the media player.
• Updated various underlying SpotifyClient methods to discard favorites that do not contain a valid URI value. Sometimes the Spotify Web API returns favorite items with no information, which causes exceptions in the card while trying to display them! The following methods were updated: GetAlbumFavorites, GetEpisodeFavorites, GetShowFavorites, GetTrackFavorites.

v1.0.16

[ 1.0.16 ] - 2024/12/06

• This release requires the SpotifyPlus Integration v1.0.68+ release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added "Active User" information to Spotify Connect Device details display.

v1.0.15

[ 1.0.67 ] - 2024/12/02

• Updated underlying spotifywebapiPython package requirement to version 1.0.22.
• The above spotifywebapiPython package will now return an exception due to the functions being deprecated by the Spotify development team. More information can be found on the Spotify Developer Forum Blog post that was conveyed on November 27, 2024. The following methods will now raise a SpotifyApiError exception due to the Spotify development team changes: GetArtistRelatedArtists, GetTrackRecommendations, GetTrackAudioFeatures, GetFeaturedPlaylists, GetCategoryPlaylists, GetGenres. The following properties were also marked as deprecated for the same reason: TrackSimplified.PreviewUrl.
• Due to the above changes made by Spotify, any Algorithmic and Spotify-owned editorial playlists are no longer accessible or have more limited functionality. This means that you can no longer obtain details via the SpotifyClient.GetPlaylist and SpotifyClient.GetPlaylistItems methods for Spotify-owned / generated content (e.g. "Made For You", etc). A 404 - Not Found error will be returned when trying to retrieve information for these playlist types.

v1.0.14

[ 1.0.14 ] - 2024/11/25

• Non-Administrator accounts can now use the card without receiving the unauthorized message. Note that non-administrators cannot change the card configuration (as designed).
• Changed the way calls are made to the underlying SpotifyPlus integration services. Calls are now made using the hass.callService method instead of the hass.connection.sendMessagePromise with type execute_script. This was causing all calls that returned service response data to fail with unauthorized errors.
• Removed references to custom-card-helpers npm package, as it was outdated and is not being maintained. We will now create our own card helpers when needed.
• Added reference to home-assistant-js-websocket version 9.4.0, as it was a dependency of custom-card-helpers npm package.

v1.0.13

[ 1.0.13 ] - 2024/11/20

• This release requires the SpotifyPlus v1.0.66+ release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added "Copy Preset Info to Clipboard" action for track and artist in the player track details action menu. This will create a user-preset configuration entry for the selected media and copy it to the clipboard; the entry can then be pasted into the configuration editor under the userPresets: key, which will create a user preset for the media item.
• Added "Copy Preset Info to Clipboard" action for track and artist in the favorites track details action menu. This will create a user-preset configuration entry for the selected media and copy it to the clipboard; the entry can then be pasted into the configuration editor under the userPresets: key, which will create a user preset for the media item.
• Added "Show Album Tracks" action for all album action menus. This will display all tracks on the album in the search browser.
• Added "Connect / Login to this device" action menu item to Spotify Connect device browser action menu. This will add the device to the Spotify Connect player device list.
• Added "Disconnect / Logout from this device" action menu item to Spotify Connect device browser action menu. This will remove the device from the Spotify Connect player device list.
• Fixed a bug in userpreset details display that was causing an error alert of "MediaItem not set in updateActions" when a userpreset with type "recommendations" was selected.

v1.0.12

[ 1.0.12 ] - 2024/11/15

• This release requires the SpotifyPlus v1.0.65 release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added category browser: browse Spotify playlists by categories; existing card configurations have to enable the section in the general configuration settings.
• Added dynamic track recommendation capability to user-defined presets. Simply put, you define a preset with the parameters of what you want to play and Spotify searches its media catalog for tracks that match. The matching tracks are then added to a play queue and played in random order. The matching tracks will change over time, as Spotify adds new content to its media catalog.
• Added action for all playable media types: Copy Preset Info to Clipboard. This will create a user-preset configuration entry for the selected media and copy it to the clipboard; the entry can then be pasted into the configuration editor under the userPresets: key, which will create a user preset for the media item.
• Updated artist details to show more information about the artist. Note that actions menu can be used to display more artist-related details (albums, top tracks, etc).
• Added artist action: show artist albums; lists only the artist albums (no compilations, no appears on, no singles, etc).
• Added artist action: show artist album compilations; lists only the artist compilation albums (no appears on, no singles, etc).
• Added artist action: show artist albums appears on (aka collaborations); lists only the artist appears on albums (no compilations, no singles, etc).
• Added artist action: show artist album singles; lists only the artist single release albums (no compilations, no appears on, etc).
• Added artist action: show artist related artists; lists artists that are similar to the selected artist.
• Added show action: search show episodes; lists show episodes with cover art for the selected show.
• Updated show details form to only display the first 20 episodes of the show after the show description. This will make the UI much more responsive, as most shows have 200+ episodes. More shows can be listed by using the actions menu drop down.

v1.0.11

[ 1.0.11 ] - 2024/11/04

• Fixed a bug in all media list rendering controls that was causing the media list not to render for some browser types (Fire HD, iPad Air, etc).
• Replaced all lastupdatedon properties with date_last_refreshed property that is populated by the spotifywebapiPython package.

v1.0.10

[ 1.0.10 ] - 2024/11/03

• This release requires the SpotifyPlus v1.0.64 release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added footerIconSize general config option to change the size of the footer area icons.
• Added playerControlsIconSize player controls config option to change the size of the player control area icons, volume mute icon, and power on/off icons.
• Added actions dropdown menu to all section favorites browser details; most of these are the ability to search for related details. More actions to come in future releases.
• Added actions dropdown menu to all player information details; most of these are the ability to search for related details. More actions to come in future releases.
• Added ability to copy device details to the clipboard; for example, click on the value next to the Device ID title to copy the device id to the clipboard.
• Added (all browsers) action: copy Spotify URI to clipboard.
• Added playlist action: recover playlists via Spotify web ui.
• Added playlist action: delete (unfollow) a playlist.
• Updated playlist item action: track will now be added to the play queue instead of being played. This will avoid wiping out the play queue.
• Updated album item action: track will now be added to the play queue instead of being played. This will avoid wiping out the play queue.
• Updated podcast show item action: episode will now be added to the play queue instead of being played. This will avoid wiping out the play queue.
• Updated audiobook item action: chapter will now be added to the play queue instead of being played. This will avoid wiping out the play queue.

v1.0.9

[ 1.0.9 ] - 2024/10/30

• This release requires the SpotifyPlus integration v1.0.63 release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
• Added searchMediaBrowserSearchTypes config option to enable / disable selected search types.
• Added playerControlsHidePlayQueue config option to enable / disable play queue information area.