Skip to content

Card Features

Jump to bottom
Todd Lucas edited this page May 11, 2024 · 13 revisions

The following is a quick overview of the features and functionality that this card provides.

Check out the Configuration Options page for details on how to modify the look and feel of the card.

Pandora Stations

You must have the Pandora Music Service configured on the SoundTouch device in order for the card to access Pandora. The Pandora Music Service can be added and configured via the Bose SoundTouch App.

The card accesses Pandora via the SoundTouch device - there is no direct communication from the card to Pandora. The SoundTouch device limits you to one Pandora account per device, so you must use THAT account when accessing Pandora.

Pandora Stations are retrieved from the SoundTouch device using the PANDORA source. The stations are retrieved in real time by the device (not cached), so any stations you just added via the web or mobile player should show up immediately upon the next refresh of the list.

Pandora Stations are presented to the user in a Media Browser format. An item may be selected for play immediately by clicking on the item.

Presets

Recently Played

Media Browser

Most of the various section displays in the card utilize a media browser for displaying media content items. This media browser functionality is similar to the Home Assistant Media Browser functionality in how it looks, but it behaves a little bit differently under the covers.

Here are a few features of the media browser:

  • supports item click functionality to play the given content. The item is immediately selected for play once it is clicked.

  • supports item click and hold functionality for some section types. For example, the Presets media browser allows a preset to be set to the currently playing media by clicking and holding the preset slot item for @ 2 seconds.

  • supports both icon (see Figure 1a) and list (see Figure 1b) formats. For the icon format, the number of icons in the row is configurable. The size of the icons is also responsive, in that they will expand / shrink in size to fill the available space.

  • supports custom image url's based on the track title, so that you can manually override the image that is displayed for a named track if you like. This also works well for recently played items, as the SoundTouch device automatically removes cover art image url's from the recently played list due to copyright agreements with the various music services.

Figure 1a - Media Items Icon Format

Figure 1b - Media Items List Format

Clone this wiki locally