Skip to content

thlucas1/homeassistantcomponent_soundtouchplus_card

Repository files navigation

SoundTouchPlus Card

GitHub Release License docs hacs

Project Maintenance BuyMeCoffee

Home Assistant UI card that supports features unique to the SoundTouchPlus custom integration.
Extended support for the Bose SoundTouch line of speaker products for use in Home Assistant.

Features

  • Media player interface with customizable controls and information display
  • Display / Select / Store SoundTouch Device Presets
  • Display / Select User-Defined Presets
  • Display / Select SoundTouch Device Recently Played items
  • Display / Select your Pandora Stations
  • Display / Select Source Inputs
  • Card Configuration Editor User-Interface for changing options

with more to come!

How it Looks

Here's a quick overview on what the card can look like. The card is highly customizable when it comes to the information displayed. Check out the UI Dashboards wiki page for more examples and YAML configuration.

Media Player Control (Panel Mode)

SoundTouch Recently Played (Panel Mode)

recentlyplayed_nofooter_panel

User-Defined Presets (Panel Mode)

presets_user_nofooter_panel

SoundTouch Device Presets (Panel Mode)

presets_device_nofooter_panel

SoundTouch Sources (Panel Mode)

sources_nofooter_panel

Pandora Stations (Panel Mode)

pandora_nofooter_panel

Editor UI, General Options

general_editor_options

HACS Installation Instructions (recommended)

  • 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/homeassistantcomponent_soundtouchplus_card in the Repository textbox and select Lovelace for the category entry.
  • Click on Add to add the custom repository.
  • You can then click on the SoundTouchPlus Card repository entry (you may need to filter your list first to find the new entry).
  • Click on download to start the download. It will install the card to your /config/www/community/homeassistantcomponent_soundtouchplus_card directory.
  • Go back on your dashboard and click on the icon at the right top corner then on Edit dashboard.
  • You can now click on Add card in the bottom right corner and search for "Custom: SoundTouchPlus Card".

Manual Installation

  • 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 soundtouchplus-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/soundtouchplus-card.js?v=1.
  • click on JavaScript Module then Create.
  • go back and refresh your page.
  • you can now click on Add card in the bottom right corner and search for "Custom: SoundTouchPlus Card".
  • after any update of the file you will have to edit /local/soundtouchplus-card.js?v=1 and change the version (e.g. v=1) to any higher number (e.g. v=1.2).

More Information

Check out the following links for more information:

Reporting a Problem

Submit a Bug Report to bring the issue to my attention. I receive a notification when a new issue is opened, and will do my best to address it in a prompt and professional manner.

Request a New Feature

Do you have an idea for a new feature that could be added to the integration? Submit a Feature Request to get your idea into the queue. I receive a notification when a new request is opened, and will do my best to turn your idea into the latest and greatest feature.