This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.
Bose SoundTouch adapter for ioBroker IoT platform
Control States
To control your speaker, the following objects can be written:
| State | Description |
|---|---|
| key | One of the following keys to send: PLAY PAUSE STOP PREV_TRACK NEXT_TRACK THUMBS_UP THUMBS_DOWN BOOKMARK POWER MUTE VOLUME_UP VOLUME_DOWN PRESET_1 PRESET_2 PRESET_3 PRESET_4 PRESET_5 PRESET_6 AUX_INPUT SHUFFLE_OFF SHUFFLE_ON REPEAT_OFF REPEAT_ONE REPEAT_ALL PLAY_PAUSE ADD_FAVORITE REMOVE_FAVORITE INVALID_KEY |
| muted | Mute or un-mute the device. |
| on | Power on or off the device. |
| playEverywhere | Define speaker as zone master and play its content on all other speakers. |
| volume | Change device volume between 0 and 100. |
| livestream | Play directly a http/https audio live stream. E.g. http://liveradio.swr.de/sw282p3/swr3/play.mp3 |
Info States
The following information is collected from your speaker (read-only states):
Device Info
| State | Description |
|---|---|
| ipAddress | The device IP address, usually the same that you configured in adapter settings. |
| macAddress | The device MAC address |
| name | The name you configured with your SoundTouch App. |
| type | The device type (e.g. SoundTouch 300). |
Now Playing
| State | Description |
|---|---|
| album | The currently playing album. |
| art | The URL of the source art. |
| artist | The currently playing artist. |
| genre | The genre of current playing track. |
| source | The type or name of the service playing. To determine if the product is in standby mode, check if source == STANDBY. |
| station | The station or playlist name. |
| track | The currently playing track. |
Presets
The following states are present for each of the 6 available presets:
| State | Description |
|---|---|
| iconUrl | The URL of the source art. |
| name | The album, station, playlist, song, phone, etc. name depending on the source. |
| source | The type or name of the service. |
Zones
The following description will help you to create groups with you multi room system. The read-only field are automatically updated by the soundtouch devices, also if you change the groups by the Soundtouch Application itself.
| State | Description |
|---|---|
| masterOf | Display the MAC addresses of the slaves of a speaker (split by ";") (read-only) |
| memberOf | Display the MAC address of the master of this speaker (read-only) |
| addMasterOf | Add MAC address of the speaker you would like to add to this master speaker. Also possible to put more then one speaker (split by ";"). |
| removeMasterOf | Add MAC address of the speaker you would like to remove from this master speaker. Also possible to put more then one speaker (split by ";"). |
Changelog
0.13.0 (2026-07-11)
- (JR-home) Control objects have been extended to suppiort playing a livestream directly
- (mcm1957) Deprecated delete state has been migrated.
- (mcm1957) Dependencies have been updated
0.12.0 (2026-05-09)
- (copilot) Adapter requires node.js >= 22 now
- (copilot) Adapter requires admin >= 7.7.22 now
- (copilot) Adapter requires js-controller >= 6.0.11 now
- (mcm1957) Dependencies have been updated
- (copilot) Migrated to ESLint 9 and @iobroker/eslint-config following ioBroker community standards
0.11.1 (2024-04-03)
- (mcm1957) Release workflow has been fixed
0.11.0 (2024-04-03)
- (mcm1957) Adapter requires node.js 18 and js-controller >= 5 now
- (mcm1957) Testing has been changed to support node 18 and 20
- (mcm1957) Dependencies have been updated
0.10.3 (2022-06-17)
- (Apollon77) Fix crash case reported by Sentry
License
MIT License
Copyright (c) 2024-2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2019-2022 SwedishChef swedish.chef@gmx.at
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.