Troubleshooting Guide
Having a problem configuring the card? Or maybe something doesn't look right, or behave in the way you expected?
This page tries to document common issues (and their solutions) that you might encounter while configuring or using the card.
Use the following index to get to where you want to be:
-Why am I missing most of the icons in the Player section?
Player control requires a Spotify Premium account (Spotify rules, not mine) to control the player via the Spotify Web API. If you are using a Spotify Free account, then all of the player deck controls will be hidden / unavailable (e.g. pause, resume, skip next / prev, shuffle, repeat, volume up / down / mute). You also cannot start play of tracks or context.
For Spotify Free accounts, you have to control the player on a Spotify mobile / desktop / web player which does allow you limited functionality.
In summary, the only things you can really do with SpotifyPlus and a Spotify Free account are:
- display currently playing track information via the Player section.
- add / remove Spotify favorites (tracks, playlists, albums, artists, podcasts).
- search for and display Spotify catalog information.
The following error message is displayed when trying to retrieve information from various Spotify Web API endpoints:
SAM1010E - The "x" endpoint has been deprecated by Spotify without prior notice as of November 27th 2024, and the supporting functionality is no longer available.
The Spotify Developer Team deprecated (aka removed) 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 not worth giving thanks for IMHO!) AFTER the changes were already implemented. 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 (
SimpleTrackobject) - Algorithmic and Spotify-owned editorial playlists (e.g. "Daily Mix 1", etc)
What these changes mean for 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 the SAM1010E error message.
It also means other endpoints that retrieve data for Spotify Algorithmic playlists will now return a 404 - Resource Not Found error (e.g. GetPlaylist, etc). We can no longer return even basic information about thesee playlists (e.g. name, description, etc), which is really frustrating!
Unfortunately, this is out of my control as the Spotify developers just decided to make the change to their API without prior notice, and my (and many other) complaints fall on deaf ears. Let's just say I lost a LOT of respect for the Spotify platform after over the past few days after realizing what they did and their lack of communication!
You don't. However ...
You can make your voice and opinion 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).
On the Search Media section form, the search type icons are displayed weirdly and there is no search criteria text entry field.
How it Looks
Why is it like this?
The card search functionality uses the HA <ha-md-button-menu> control to display the search type dropdown list. For the HA 2024.10.0 release, this control was renamed from <ha-button-menu-new> (HA 2024.09.x and prior) to <ha-md-button-menu> (HA 2024.10 and forward). Refer to PR #22016 for more details of the change.
If you are running the HA 2024.09.x release (or lower), the search media section will render incorrectly since the <ha-md-button-menu> control element does not exist.
Unfortunately, this is out of my control as the HA developers just decided to make the change with the 2024.10.0 release. I have to make changes to the card to accomodate the changes made by HA developers.
How do I fix it?
- Upgrade to the latest HA 2024.10 (or greater) release.
- Ensure SpotifyPlus v1.0.6 or greater is installed.
- In your browser, be sure to do a "forced refresh" of the page to ensure any cached pages are not displayed.