Installation Instructions - thlucas1/spotifyplus_card GitHub Wiki

The easiest way to install the card is via the Home Assistant Community Store (or HACS for short). Check out the HACS Install Documentation for more information on how to install HACS in your Home Assistant environment.

If you do not want to use HACS, you can also install the card manually by copying files from the GitHub project.

Both installation types are covered below.

The following requirements must be met prior to installing the SpotifyPlus Card.

• A Spotify Premium account is recommended, but not required; Free accounts will work, but are limited just as they are in the Spotify official apps (see limitations for more details).
• SpotifyPlus integration >= v1.0.64 must be installed and configured.
• Home Assistant 2024.10+ release.

The easiest way to install the card is via the Home Assistant Community Store (or HACS for short). Check out the HACS Install Documentation page for more information on how to install HACS in your Home Assistant environment.

Don't have HACS, or do not want to use HACS? No problem! You can also install the card manually by copying files from the GitHub project.

• HACS Installation
• Manual Installation

Both installation types are covered below.

It's recommended that you utilize the local HA instance URL (e.g. http://homeassistant.local:8123) when installing via HACS, as some public URL access providers (Cloudfare, etc) block access to the GitHub repository site by default unless properly configured. It is also recommended that you use a desktop browser (not a mobile / tablet device) for the install process.

Use the following link to open (and add) the custom repository in HACS:

If the above does not work for you, then use the following steps to add the custom repository manually.

• On your Home Assistant sidebar menu, go to HACS > Frontend
• Click on the 3-dot overflow menu in the upper right, and select custom repositories item.
• Copy / paste https://github.com/thlucas1/spotifyplus_card in the Repository textbox and select Dashboard for the category entry.
• Click on Add to add the custom repository.
• You can then click on the SpotifyPlus Card repository entry (you may need to filter your list first to find the new entry).

Note at this point you have only added the repository to the HACS Repository List. Now it's time to actually download the contents of the repository itself. You should now be displaying the repository details, which will also display a Download button (lower right corner) that can be used to download the repository contents.

• Click on download to start the download. It will install the card to your /config/www/community/spotifyplus_card directory.
• Refer to the Card Picker wiki topic for how to add the card to an HA dashboard.

• using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
• change directory to the www folder; if you don't have this directory, then create it.
• download the spotifyplus_card.js file from the GitHub repository into your <config>/www folder.
• on your dashboard click on the icon at the right top corner then on Edit dashboard.
• click again on that icon and then on Manage resources.
• click on Add resource.
• copy and paste this: /local/spotifyplus_card.js?v=1.0.12 (change version number to match what was downloaded).
• click on JavaScript Module then Create.
• go back and refresh your page.
• after any update of the file you will have to edit /local/spotifyplus_card.js?v=1 and change the version (e.g. v=1) to any higher number (e.g. v=1.2).
• Refer to the Card Picker wiki topic for how to add the card to an HA dashboard.