Skip to content

Troubleshooting Guide

Jump to bottom
Todd Lucas edited this page Dec 3, 2024 · 9 revisions

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:

Issue - SAM1010E Deprecated Error Messages

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.

How it Looks

Why is it like this?
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):

  1. Related Artists
  2. Recommendations
  3. Audio Features
  4. Audio Analysis
  5. Get Featured Playlists
  6. Get Category's Playlists
  7. 30-second preview URLs, in multi-get responses (SimpleTrack object)
  8. Algorithmic and Spotify-owned editorial playlists (e.g. "Made For You", 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.

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!

How do I fix it?
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).

Issue - Search Media Type Icons Weird, No Search Text Field

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.
Clone this wiki locally