VOOZH about

URL: https://www.home-assistant.io/integrations/soundtouch/

⇱ Bose SoundTouch - Home Assistant


The Bose SoundTouch integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control your Bose SoundTouch speakers from Home Assistant.

Configuration

To add the Bose SoundTouch device to your Home Assistant instance, use this My button:

👁 Image

Bose SoundTouch can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Playing media

You can switch between one of your 6 pre-configured presets using media_player.play_media

# Play media preset
- action: media_player.play_media
 target:
 entity_id: media_player.soundtouch_living_room
 data:
 media_content_id: 1..6
 media_content_type: PLAYLIST

You can also play HTTP (not HTTPS) URLs:

# Play media URL
- action: media_player.play_media
 target:
 entity_id: media_player.soundtouch_living_room
 data:
 media_content_id: http://example.com/music.mp3
 media_content_type: MUSIC

Text-to-speech services

You can use TTS services like Google text-to-speech or Amazon Polly only if your Home Assistant is configured in HTTP and not HTTPS (current device limitation, a firmware upgrade is planned).

A workaround if you want to publish your Home Assistant installation on Internet in SSL is to configure an HTTPS Web Server as a reverse proxy (NGINX for example) and let your Home Assistant configuration in HTTP on your local network. The SoundTouch devices will be available to access the TTS files in HTTP in local and your configuration will be in HTTPS on the Internet.

List of actions

The Bose SoundTouch integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

  • Add zone follower (soundtouch.add_zone_slave) Adds media players to an existing Bose SoundTouch zone.

  • Create zone (soundtouch.create_zone) Creates a Bose SoundTouch multi-room zone.

  • Play everywhere (soundtouch.play_everywhere) Plays the same content on all Bose SoundTouch devices.

  • Remove zone follower (soundtouch.remove_zone_slave) Removes media players from an existing Bose SoundTouch zone.

For an overview of every action across all integrations, see the actions reference.

Help us improve our documentation

Suggest an edit to this page, or provide/view feedback for this page.