SoundTouchPlus Integration

Share your Projects! Custom Integrations
,
142

@bkaz88
per chatGPT, some of the Lifestyle 535 models support SoundTouch web-services API. If it does, then it probably uses the SoundTouch Wireless Adapter to control limited aspects of the device. If it does, then you might be able to control limited functionality (e.g. power on/off, volume, etc); still no streaming services after the end-of-life date though.

All of that is just a guess / assumptions based on a quick chatGPT search.

To know for sure, try issuing a SoundTouch web-services API Information service call to the device and see if you get a response. Example (change 192.168.1.131 to your 535 device ip address):

http://192.168.1.131:8090/info

Example response:

<?xml version="1.0" encoding="UTF-8" ?>
<info deviceID="1004567890AA">
  <name>SoundTouch 10</name>
  <type>SoundTouch 10</type>
...
  <countryCode>US</countryCode>
  <regionCode>US</regionCode>
</info>
143

Thanks! Yes, I can control Power. (Still looking for Mute and Volume). But my big question has to do with something you wrote:

ā€œThe /selectLocalSource service selects the LOCAL source; for some SoundTouch devices, this is the only way that the LOCAL source can be selectedā€

This is listed in my supportedURLs, so it is hopeful.

My Chromecast showed as source LOCAL, but Iā€™ve tried everything to be able to call it with no luck so far .

How do I use /selectLocalSource ?

I tried a POST with /select and with as Body:

<?xml version="1.0" encoding="UTF-8" ?>
<status>/selectLocalSource</status>

Am I close? Also, do I need to specify which ā€œlocalā€? I now have the Chromecast in RCA jacks for ā€œComponent 4ā€ (as labeled on the outside of the unit). And a turntable is plugged in similarly but in ā€œComponent 5ā€. So they may both be ā€œLocalā€?

144

@bkaz88
I believe the LOCAL source is how the SoundTouch Wireless Adapter refers to the host device source that was in use prior to switching to the SoundTouch source it know about. Keep in mind that the SoundTouch Wireless Adapter is an add-on product, so it does not know how to ā€œtalkā€ to the host device sources (e.g. AUX, HDMI1-5, etc) - it only knows how to talk to itā€™s sources (e.g. Bluetooth, Pandora, Spotify, TuneIn, etc). The host sources (e.g. AUX, HDMI1-5, etc) are not controllable from the SoundTouch WebServices API (only the Wireless Adapter sources are controllable).

The selectLocalSource call comes into play when you want the SoundTouch Wireless Adapter to switch back to the local source that was previously in play (e.g. HDMI2) before transfer was controlled to a SoundTouch Wireless Adapter source (e.g. PANDORA).

On the flip side, you use the selectLastSoundTouchSource to do the opposite.

There are no arguments for the selectLocalSource service - you just call the endpoint.

http://192.168.1.131:8090/selectLocalSource

Hereā€™s a PostMan console output of the command:

GET /selectLocalSource HTTP/1.1
User-Agent: PostmanRuntime/7.48.0
Accept: */*
Cache-Control: no-cache
Postman-Token: f74721c3-e1d2-4796-8836-f3a51c885ea8
Host: 192.168.1.81:8090
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
 
HTTP/1.1 200 OK
Content-Type: text/xml
Date: Wed, 15 Oct 2025 09:38:09 GMT
Cache-Control: no-cache,must-revalidate
Expires: Thu, 26 Oct 1995 00:00:00 GMT
Transfer-Encoding: chunked
Server: Allegro-Software-RomPager/5.40b1
Access-Control-Allow-Origin: http://192.168.1.81
Access-Control-Allow-Headers: Content-Type
Connection: close
 
<?xml version="1.0" encoding="UTF-8" ?><status>/selectLocalSource</status>

The Chromecast is a different animal in its own right, in that it has to be initialized every time you want to play something to it. I donā€™t think it will work just switching back to the LOCAL source, if the source was a Chromecast session, as it probably ends the session after a small timeout period (e.g. 5 minutes). Iā€™m not positive on that one though - just thinking it thru based on past experience with Spotify and Chromecast devices.

Hope it helps!

145

Since Bose is bricking these devices, I think this would be a good replacement. My question is are you able to re-add these speakers to the network using Home Assistant after the 2026 date?

1 Like
146

It turns out I was wrong about Bluetooth when I wrote:

" but newer Bluetooth can connect to both devices at the same time"

New phones have the capability, but the two connected devices also need to have the newer capability. The old Bose units arenā€™t capable.

147

Thanks Todd. Yes, Iā€™m resolved to using the remote control to select the local sources for my turntable and Chromecast connections on the Lifestyle 535, and can use the IP calls on the SA-5 to connect them - so am successful playing those simultaneously in the two zones. :slight_smile: Apart from those, the Tasker buttons now control everything (except I couldnā€™t get a Mute/Unmute call to work :thinking: which is minor.). Iā€™m not worried about connecting to a new Wi-Fiā€¦ hope that is never needed, but am hopeful it will be possible using your documentation if it is ever needed to be set up.

Thanks again!!

1 Like
148

@Piccolodee @bkaz88
Check out this SoundTouchPlus GitHub discussion for a post where a user reset his ST-10 and reconnected it to the network via http calls.

Eventually, I will probably add services to the integration for this to make it easier. Just have not had time to address it yet.

149

@bkaz88
You should be able to send a remote keypress (MUTE) to toggle the mute status. If volume changes work, then mute should work as well.

You can also use the Volume endpoint to set the volume to zero, but you have to store the state of the current value in order to reset it back when un-muting.

150

Thanks Todd. No luck with keypress using the standard MUTE (nor with BOOKMARK, which was listed.) Surprising as that is.

If need be, Iā€™ll try storing the current Volume Level (variables are kind of new to meā€¦ thanks for the suggestion!). I had stopped at dropping Volume to 0 and had left it at that.

1 Like
151

This is genius. After the Bose announcement I went searching for a solution to maintain my system. Iā€™m brand new to HA and after a day of testing, learning and trial and error, I stumbled upon SoundTouchPlus. I unplugged my internet, loaded a local mp3 in the media folder and was able to play it through MA and group the speakers on the overview screen with perfect audio sync. Iā€™m hopeful that come February ā€˜26, weā€™ll still be in business. THANK YOU!

1 Like
152

FYI - just released a new version of the SoundTouchPlus Integration

Be sure to check out the SoundTouchPlus Card as well.

I added a bunch of new services to support the ability to change device settings from HA without using the SoundTouch App; this is in support of the upcoming Bose SoundTouch end-of-life date.

I also added some new topics under the SoundTouch Model Notes wiki page:

Release Notes

[ 1.0.163 ] - 2025/11/04

  • Added service add_wireless_profile; Adds a new wireless profile to a SoundTouch device network configuration.
  • Added service set_language; Sets the device language code.
  • Added service set_name; Sets the device name.
  • Added service get_audio_product_level_controls; Gets the audio level controls configuration of the device.
  • Added service set_audio_product_level_controls; Sets the audio level controls configuration of the device.
  • Added service get_audio_speaker_attribute_and_setting; Gets the audio speaker attribute and setting configuration of the device.
  • Added service get_product_cec_hdmi_control; Gets the cec hdmi control configuration of the device.
  • Added service set_product_cec_hdmi_control; Sets the cec hdmi control configuration of the device.
  • Added service get_product_hdmi_assignment_controls; Gets the hdmi assignment controls configuration of the device.
  • Added service set_product_hdmi_assignment_controls; Sets the hdmi assignment controls configuration of the device.
  • Updated bosesoundtouchapi package requirement to bosesoundtouchapi>=1.0.86.
5 Likes
153

Good day Sir, Thank you for all the work you have done thus far. I have some additional information to share with you from Bose, in addition I would like to offer my services, should you require any testing, I would be more than willing to assist.

As for the information, I asked Bose if its just the app being dropped or any external services, the information given was ā€œYes AirPlay should work if the speaker has capabilities. Only SoundTouch app is going offline so you may not connect Spotify through SoundTouch app but it should work standalone with Spotify appā€

As for Grouping, I know when soundtouch launched grouping was done locally and was later moved to the cloud, I donā€™t know if that can be reinstated but when Soundtouch launched you were able to run your local music library and group your speakers without internet access.

I hope this helps.

1 Like
154

@SOUNDSYSTEMSCC

Yes, you should be able to stream Spotify to the Bose device via bluetooth AirPlay (for devices that support it). I think the issue with that is the quality, in that it does not stream at the same rate as the native Spotify Music Service does. Iā€™m not sure on that though - just going by what users have reported on the various discussion forums.

As for Grouping ā€¦ there have been reports on the SoundTouchPlus Integration Discussion Forum of grouping functions still working with external internet disconnected. I am wondering though if that is due to the fact that the group relationships have already been formed and settings pushed to the device. In other words, will grouping still work if you have a factory reset device that you want to add to the group? Not sure on that one yet.

You might check out the SoundTouchPlus Integration Discussion Forum topic that I created a few weeks ago. There seems to be more input on there than there is on the HA Community forum.

Thanks for your input - everything helps right now, as there are no clear answers from Bose as of yet.

155

Would you like to give me a list of questions that you would like clarity on and I can see what I am able to discover from Bose?

2 Likes
156

@SOUNDSYSTEMSCC
If you have an ā€œinā€ to Bose engineers, that would be awesome! Any insight you / they can provide would be very helpful.

Questions

  1. will Presets still work? e.g. storing, selecting, etc. I understand that they may not be able to share presets among devices like they do now, but if I target a specific device with a store / select preset command will it work? I also understand that music service presets will not work, but DLNA / UPNP presets would be nice to have.

  2. From tests I have done on my ST-10, it seems that after a factory reset you can still add a wireless profile upon setup (via http://192.0.2.1). Will this same functionality work for other SoundTouch devices? e.g. ST-300 with bass module, Wireless Link Adapter, etc. And will it continue to work after February? I would assume yes, as the 192.0.2.1 is a local address which means there is an internal web-server running on the device to service the request / page.

  3. Clock syncing / timezone offset. Will clockTime / clockDisplay functions still automatically adjust for daylight savings time? I assume it pulls that info from the cloud service, and updates the internal clock time on the device as needed.

  4. Can they confirm that speaker grouping will still work or not? Some people have reported it still works after disabling external internet access. I think that is due to the fact that group settings were already pushed to the device prior to disconnecting external access, which is why it still works. The real test will be for a factory reset device, can it still be grouped with other SoundTouch devices and maintain audio syncing after February? For example, I group 4 of my ST-10ā€™s with my ST-300 for whole-house listening.

  5. Will the ST-10 still support playing of notifications? For example, if I send the following POST body to the http://192.168.1.131:8090/speaker endpoint, will it still work? I am assuming not, since the app_key probably has to do some sort of verification in the cloud services.

<?xml version="1.0" encoding="UTF-8"?>
<play_info>
  <url>http://translate.google.com/translate_tts?ie=UTF-8&amp;tl=EN&amp;client=tw-ob&amp;q=a.There%20is%20activity%20at%20the%20front%20door.</url>
  <app_key>1234567890 ...</app_key>
  <service>TTS Notification</service>
  <message>Google TTS</message>
  <reason>There is activity at the front door.</reason>
</play_info>
  1. Any chance of Bose releasing the firmware source code so that devices could be re-used / re-purposed if they turn into ā€œbricksā€? Iā€™m betting there are a lot of tinkerers out there that would love a chance to breathe new life into these devices. I know that (the ST-10ā€™s at least) run a flavor of linux OS, which opens up possibilities for modification. For example, Spotify could potentially be supported locally on the device using a librespot server with zeroconf enabled. If Iā€™m asking for stuff, I may as well shoot for the moon right? :slight_smile:

Thatā€™s all I can think of for now; I am sure there will be more in the near future.

And thanks again for your help / looking into this.

157

I have an additional question:

Will it be possible to specify the streaming source for the presets? At the moment my kids love to hear a specific child radio channel which can be selected in the app.

158

@webwude
I assume that all streaming services will be shut down with the Bose Cloud service shutdown, with the exception of local DLNA streaming. I canā€™t say for sure on that though.

159

Bose just announced they will be extending the SoundTouch Cloud Services EOL to May 6, 2026.

Reposting from the official Bose site:

Update: Jan 7, 2026

In October 2025, we announced cloud support for SoundTouch products would be ending. Since then, weā€™ve heard from some owners with questions and feedback, and weā€™ve been listening carefully. Cloud support will still be ending, but weā€™re extending the date from February 18 to May 6, 2026 , to better support you during the transition. This page has been updated to reflect these new options.

Before cloud support ends, the SoundTouch app will get an automatic update.

On May 6, 2026, the app will update to a version that supports the functions that can operate locally without the cloud. No action will be required on your part. Opening the app will apply the update automatically.

What will continue to work:

ā€¢ Streaming music from your favorite apps directly via BluetoothĀ®, AirPlay, Spotify Connect, and AUX

ā€¢ Setting up and configuring your system

ā€¢ Remote control features, such as Play, Pause, Skip, and Volume

ā€¢ Grouping multiple speakers together

What will no longer work:

ā€¢ Presets (preset buttons on the product and in the app)

ā€¢ Browsing or playing music services directly from the SoundTouch app

Important note: Your system will no longer receive security and software updates. Please make sure to always use your system on a secure, private network.

How to keep listening after May 6
You can continue enjoying music through your favorite music services (i.e. TuneIn and Pandora) by streaming directly from their apps and sending the audio to your SoundTouch system using AirPlay, Bluetooth, or AUX. Soundbars and home theater systems can still use HDMI or optical connections for TV audio.

If you use Spotify, you can continue streaming with Spotify Connect through the Spotify app.

With the Bose SoundTouch cloud going away, you will lose access to Presets and System Updates. Please take note of any saved presets that you would like to listen to after the cloud is offline and refer to the SoundTouch End-of-service Guidance for instructions on how to set up those presets as favorites within your music service apps.

Additionally, please use the Bose SoundTouch app to update your systems to the latest firmware version. System updates will no longer be available after the cloud is offline.

Open-source options for the community

Weā€™re making our technical specifications available so that independent developers can create their own SoundTouch-compatible tools and features. The documentation is available here: SoundTouch API Documentation.

1 Like
160

This is very interesting

They found a way (hack) to change the cloud link in the Soundtouch devices and provide a locally hosted cloud to still have internet radio (presets donā€™t seem to work yet as of 27/01/2026).

Also, this may be worth a look:
https://www.reddit.com/r/bose/comments/1os3upd/workaround_keep_bose_soundtouch_live_internet/

Music Assistant also still seems to work (Iā€™ve blocked all traffic to Bose servers already) with Internet radios (e.g., via RadioBrowser).

4 Likes
161

Sounds very interesting indeed.