SpotifyPlus Card Dashboard

thlucas · November 30, 2024, 1:18am

Sorry folks, but I have some disappointing news from the Spotify Developer API camp. It turns out Spotify has decided to remove the following functionality without any sort of warning or grace period. This was announced on the Spotify Developer Forum Blog on Thursday November 27th 2024 (US Thanksgiving holiday - definitely nothing worth giving thanks for IMHO!).

The Spotify Web API will no longer be able to access or use the following endpoints and functionality in third-party applications (SpotifyPlus being one of them):

Related Artists
Recommendations
Audio Features
Audio Analysis
Get Featured Playlists
Get Category’s Playlists
30-second preview URLs, in multi-get responses (SimpleTrack object)
Algorithmic and Spotify-owned editorial playlists

What does this mean for me?

What these changes mean for the SpotifyPlus Integration and SpotifyPlus Card Dashboard users is that the corresponding functions that access the above features will no longer work, and in most case will return an error message.

What can I do about this?

You can make your voice and opinion be heard by posting a reply on the Spotify Community Forum. Let them know that this change is not acceptable and how disappointed you are. Please be respectful in the process; scream and shout with your internal voice if you have to (like I did).

Can these functions be replaced with equivalent functionality?

I currently have no plans to try an re-implement the affected functionality, as the deprecated Spotify Web API functions were the only way to retrieve the information. It’s proprietary data, and if they don’t want to share then that’s their prerogative.

In Summary

Spotify is still a great platform for music streaming, but they lost a lot of respect from me today as a Spotify Champion and user of their Spotify Web API. As a developer of numerous API’s myself, it’s unheard of to simply shut off a feature or endpoint without giving some sort of notice or grace period; and we definitely don’t make major changes like this over a major holiday! IMHO, they totally dropped the ball on this one, not to mention dropped the hammer on numerous developers!

Just thought that you would want to know, and sorry to be the bearer of bad news. I will cross-post this in the SpotifyPlus Card community forum post as well.

tomoqv · December 2, 2024, 7:01pm

I guess you are referring to the above settings in the integration SpotifyPlus, which I find a bit confusing. In the docs, there is mention of " the Spotify Connect canonical login ID (e.g. 3758dfdsfjk435hjk6k79lm0n3c4, 1257898300, etc)", which is where I stumble. Is that the number next to the player in the dropdown list or where do I find that?

thlucas · December 2, 2024, 7:18pm

@tomoqv
wiki docs:

Spotify Connect Device LoginId

This option contains the Spotify Connect canonical login ID (e.g. 3758dfdsfjk435hjk6k79lm0n3c4, 1257898300, etc) used to login to a Spotify Connect device. This MUST be the canonical equivalent value of the spotifyConnectUsername value. Note that for some Spotify accounts, the LoginId and Username values are the same. Not sure why that is, as it’s a Spotify internals kind of thing.

The LoginId value can easily be found using the Spotify Developer Web portal, using the Get Current Users profile service. Click on the Try It button, then find the id response value.

This option is required when activating Spotify Connect devices (including librespot).

tomoqv · December 2, 2024, 7:32pm

I am very sorry to hear this! I was just getting into using Spotify more from my HA platform.

tomoqv · December 2, 2024, 7:47pm

Yes, thank you, this is where I have been reading. I still don’t understand how to retrieve the “canonical login id”.

This doesn’t give me a login id in the format described above, just my Spotify user name.

thlucas · December 2, 2024, 8:54pm

@tomoqv
The canonical logon is and the username are the same for some Spotify users. Just use the username for the loginid.

thlucas · December 3, 2024, 2:45am

FYI - just released a new version of the SpotifyPlus Card Dashboard

[ 1.0.15 ] - 2024/12/02

This release requires the SpotifyPlus Integration v1.0.67+ release; please make sure you update the SpotifyPlus integration prior to updating this SpotifyPlus Card release.
Some Spotify Web API functionality has been deprecated unexpectedly (and without prior notice!) by the Spotify Development Team, and has affected SpotifyPlus Card functionality. More information can be found on the SpotifyPlus Card Troubleshooting Guide wiki page, as well as the Spotify Developer Forum Blog.
Due to the above chnages 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.
Added category shortcut capability to user-defined presets. This will allow you to quickly display category playlists. This change is irrelevant though, as the support for category playlists was deprecated by the above Spotify Development team changes to their API!
I am leaving the deprecated functionality within the card for the time being, with the hope that Spotify changes it’s mind and restores the functionality.

thlucas · December 3, 2024, 2:50am

@Richi
I believe you posted this same question in the SpotifyPlus integration community forum …

In your reply to that, you mentioned you have a Denon AVR X-1600H and Teufel holist speakers. I am waiting on someone to run some Wireshark network traces for me on a Denon HEOS device (similar to yours maybe). After I get those, I should know a little bit better of what is going on with the Denon devices.

I don’t have any Denon devices to test with, so I am relying on others with Wireshark network tracing abilities to help me out.

Richi · December 3, 2024, 4:55am

Hello, I would love to help you with Wireshark. However, I have no experience with it! If you say the whole thing is feasible for a layman with your help, then I can install it. Best regards
Stefan

thlucas · December 3, 2024, 2:11pm

@Richi
Thanks for the offer, but there is a steep learning curve to Wireshark and network tracing and I just don’t have much extra time these days.

With that said, check out the following links if you want to try things on your own …

Hope it helps!

tomoqv · December 3, 2024, 4:34pm

Thank you, it worked! From the wiki I didn’t think it was that simple as my 6 letter user id.

Richi · December 3, 2024, 7:31pm

Thanks Lucas, I will look into it!

awagner64404 · December 4, 2024, 2:27pm

Hi Todd, please send me a PN for sharing the trace. Thanks

thlucas · December 6, 2024, 7:44pm

FYI - just released a new version of the SpotifyPlus Card Dashboard

[ 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.

somansch · December 7, 2024, 12:43pm

Thanks for this great card!

I just done first tests and identified an issue around the default coloring. I’m using dark theme and the colors of background and font do not have enough contrast. What would be best way to change it? By card-mod or would you add this feature native?

thlucas · December 7, 2024, 1:29pm

@somansch
What is the name of the playlist that you marked in your screenshot with the red arrow? I would like to search for it and see how it appears on my system. It should not be too hard to add more contrast to the titles.

somansch · December 7, 2024, 1:32pm

It’s not about the specific playlist. All search results have the same appearance. Seems to be a styling issue in my CSS. I use “Mac-OS theme” and done some changes around coloring. What colors variables are you using for the background and font of these buttons?

I’ve done some research in dev-tools of the element “button.button”, but can’t find the difference .

That’s the result with the default HA-Dark theme:

…and with the MacOS-Dark theme:

thlucas · December 8, 2024, 2:14am

@somansch
I just installed the macOS theme, and see the problem.

The text color is the --secondary-text-color value.
The background color is the --rgb-card-background-color value.

        .title {
          font-size: 0.8rem;
          background-color: rgba(var(--rgb-card-background-color), 0.733);
          color: var(--secondary-text-color);
          font-weight: normal;
        }

I am going to adjust the background of the title / sub-title text to use a faded gradient instead of a solid color. I am also going to change the text color to use a variable (e.g. --spc-medialist-items-color: white) for the media items. This value defaults to white, which will contrast better on the gradient background. You can customize the --spc-medialist-items-color by overriding the theme. I am also thinking about a configurable “media list item text color”, so you can set the media list items via configuration settings. That will come later though.

Here’s some preliminary results from testing:

Theme macOS, dark mode

Theme macOS, light mode

Theme default, dark mode

Check out the Overriding Theme forum post on how to add custom theming.

somansch · December 8, 2024, 1:54pm

Thanks, this information helps a lot. I’ve setup the additional “rgb-card-background-color” entry in the existing MacOS theme (as it was not defined in this theme yet). Now, I got the contrast for better readibility

thlucas · December 11, 2024, 4:11pm

FYI - just released a new version of the SpotifyPlus Card Dashboard

[ 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.