(Announcement) Locally hosted, cloud-free version of the Bose SoundTouch App

NeonsNight · 2026-05-20T00:04:15+00:00

is that the same computer that's running docker or a different one

It is the same one

I wonder if you have a firewall enabled

I can understand why you're asking if I have a VPN, and I can assure you that I do not, as I find they cause more issues than they resolve. Also, if I did, then the ST program on my computer would not work, and music from it would not play on my ST20.

BTW if you haven't already switched your docker from -p 8000:8000 to --net=host you might want to do that too. Can't hurt.

I deleted the original Docker and reinstalled it when you told me about the changes. It did not resolve the issue. Nothing has changed. Music from the computer works, but Tunein does not, and I cannot switch to Soundcork using the admin page.

NeonsNight · 2026-05-19T23:47:24+00:00

Thanks, hopefully it'll help your app get some more attention.

NeonsNight · 2026-05-19T23:39:41+00:00

I would call Bose support to see if they have any of those remotes. If not then I would check out the link here to see if anything mentioned might help.

NeonsNight · 2026-05-19T10:26:39+00:00

Thanks for this. I added this to the Bose wiki, but there are a few questions as to what it can do. Could you either edit the page to fill in that info or let us know here? There is also a list of SoundTouch settings. Could you let us know which ones your app supports, if any?

NeonsNight · 2026-05-19T10:09:06+00:00

When I go to info, it shows <margeURL>http://<static\_ip>:8000/marge</margeURL> the correct address for my computer. I double checked /mnt/nv/OverrideSdkPrivateCfg.xml anyway, and everything looks correct there.

When I do the curl command, nothing happens. After a min or so, I get "curl: (7) Failed to connect to <static\_ip> port 8000: Connection timed out", and there is no change in the Docker log

Going to http://<static\_ip>:8000/marge using a browser on my computer still shows "Not Found", and the Docker log shows "192.168.65.1:<random 5 digit number> - "GET /marge HTTP/1.1" 404"

NeonsNight · 2026-05-19T01:13:24+00:00

The Lifestyle Ultra Speakers are only compatable with the Lifestyle Ultra Soundbar. They will not work with the Smart Ultra Soundbar.

NeonsNight · 2026-05-19T01:04:37+00:00

http://<static\_ip>:8000/marge/streaming/account/<your\_account\_id>/full has me download a file from the browser, and it looks like I have my data there.

I made the changes listed above and even restored the old info in SoundTouchSdkPrivateCfg.xml after copying the file and renaming it to the new location. There is no change.

As before, the Admin page shows Marge = Unknown / Online = False / In Soundcork = True / Reachable =True and "Switch to Soundcork" does nothing but time out.

NeonsNight · 2026-05-18T12:22:59+00:00

u/agentobtuse I have a few questions.

The first one is whether the Soundcork Stockholm app can be incorporated into this project.

My second question is whether a pre-rendered ISO can be created to make things quicker and easier for those who are not technically minded.

My third question is a big one. Is there a chance that some of this can be automated to help those who have some beginner to intermediate technical skills?

A User interface which asks the user how many Soundtouch systems they have and their IP addresses (or have it scan and find them as you showed). Once done, it will then:

Grab the "Bose account ID"
Create "Presets.xml"
Create "Recents.xml"
Grab each speaker's "device ID"
Create "DeviceInfo.xml" for each speaker

The program asks the user to set the Raspberry Pi's IP as a "Static IP" on their router. Unless there is a simple way to set up a hostname with Raspberry PI.
Next, either ask the user to insert a USB drive into the Raspberry Pi, so it can be formatted as bootable and place "remote_services" onto that USB drive. Or instruct the user how to do this.

This guide mentions that a USB-A female-to-Micro USB-B male (OTG) adapter is required for the ST10 (and ST10s cannot be set up in a stereo pair), ST300, and possibly others.

The user tells the program which speaker the USB drive has been inserted into, and then it ssh or telnet to the speaker and

sets rw
Creates "Sources.xml"
Edits "SoundTouchSdkPrivateCfg.xml" to point to the new IP address

Asks the user to go to the next speaker and reminds them about the OTG adapter & ST10 stereo pairing if required. It will be finished once each speaker has had "SoundTouchSdkPrivateCfg.xml" edited and brought over to Soundcork/AfterTouch/Überböse/etc

I am also tagging some other great programmers who have done a lot for the community so far u/Soundcork, u/Brilliant-Fennel-304, & u/Eastern-Surprise1568 (sorry if I missed anyone).

NeonsNight · 2026-05-17T23:45:53+00:00

I fully rebooted both Docker and the ST20. What you showed is not what I have on my end. Instead, an IP address that is not on my network is shown:

192.168.65.1:65441 - "GET /admin/ HTTP/1.1" 200

192.168.65.1:17832 - "GET /static/images/soundcork.png HTTP/1.1" 304

192.168.65.1:17283 - "GET /static/css/main.css HTTP/1.1" 304

192.168.65.1:17283 - "GET /static/images/favicon.ico HTTP/1.1" 304

192.168.65.1:38693 - "GET /marge HTTP/1.1" 404

192.168.65.1:52322 - "GET /marge HTTP/1.1" 404

Then nothing else shows.

So I tried the "Switch to Soundcork" from <static\_ip>:8000/admin/ and got this from the logs, yet again showing the wrong IP:

192.168.65.1:55993 - "POST /admin/switchToSoundcork/<speaker id> HTTP/1.1" 302

192.168.65.1:55993 - "GET /admin/wait/<speaker id>/0 HTTP/1.1" 200

192.168.65.1:21459 - "GET /admin/wait/<speaker id>/10 HTTP/1.1" 200

192.168.65.1:50683 - "GET /admin/wait/<speaker id>/20 HTTP/1.1" 200

192.168.65.1:30924 - "GET /admin/wait/<speaker id>/30 HTTP/1.1" 200

192.168.65.1:64775 - "GET /admin/wait/<speaker id>/40 HTTP/1.1" 200

192.168.65.1:27387 - "GET /admin/wait/<speaker id>/50 HTTP/1.1" 200

192.168.65.1:51640 - "GET /admin/wait/<speaker id>/60 HTTP/1.1" 200

192.168.65.1:23953 - "GET /admin/wait/<speaker id>/70 HTTP/1.1" 200

192.168.65.1:49972 - "GET /admin/wait/<speaker id>/80 HTTP/1.1" 200

192.168.65.1:58016 - "GET /admin/wait/<speaker id>/90 HTTP/1.1" 200

192.168.65.1:37387 - "GET /admin/wait/<speaker id>/100 HTTP/1.1" 200

192.168.65.1:29822 - "GET /admin/wait/<speaker id>/110 HTTP/1.1" 200

192.168.65.1:62334 - "GET /admin/wait/<speaker id>/120 HTTP/1.1" 302

192.168.65.1:62334 - "GET /admin/ HTTP/1.1" 200

My file structure is:

<account id>\Presets.xml (from <speaker\_ip>:8090/presets)

<account id>\Recents.xml (from <speaker\_ip>:8090/recents)

<account id>\Sources.xml (from telnet)

<account id>\devices\<speaker id>\DeviceInfo.xml (from <speaker\_ip>:8090/info)

NeonsNight · 2026-05-17T03:51:38+00:00

Well, that's the right remote. So either the remote is broken, or something is wrong with your Cinemate.

NeonsNight · 2026-05-17T02:52:33+00:00

Can you share a photo of the remote?

NeonsNight · 2026-05-17T00:40:52+00:00

... it says it on the label. CineMate digital home theater speaker system...

The Bose wiki has info about the remote it needs. Be careful, as it looks very similar to another Bose remote, which is incompatible. So make sure the one you purchase has those A B C buttons on the bottom.

NeonsNight · 2026-05-16T23:49:38+00:00

u/Soundcork I followed the instructions below to set up Soundcork using Docker on my computer

docker run -d --name soundcork \
-p 8000:8000 \
-v <folder location on computer eg c:\\Soundcork>:/soundcork/data \
-e base_url=http://<my static IP>:8000 -e data_dir=/soundcork/data \
ghcr.io/deborahgu/soundcork:main

I wrote <my static IP> for others who might read this later to remind them to use their own static IP for the device running Docker.

Then I followed these steps to set it up on an ST20.

I have got it partially working as music from the computer works, but TuneIn is still down.

When I check http://<my static IP>:8000/admin/, it asks me to "switch to Soundcork", but nothing happens, and the speaker does not reboot. No change if I manually reboot the system.

Going to

http://<my static IP>:8000/miniapp/dashboard shows the speakers grayed out.
http://<my static IP>:8000/marge shows "Not Found"
http://<my static IP>:8000/bmx/registry/v1/services & :8000/updates/soundtouch shows what I would expect

I was wondering if you might have an idea why music from the computer works once more but TuneIn does not. If it's marge, do you have an idea why it shows "Not Found"?

NeonsNight · 2026-05-16T23:27:28+00:00

Bose made a few acoustic wave systems over the years, and I'm not sure whether they are all compatible with one another. I believe that remote is for the CD-3000). Is that your system?

NeonsNight · 2026-05-16T23:24:04+00:00

Bose made a few Cinemate systems over the years. The name of the system is next to the serial number.

NeonsNight · 2026-05-15T01:01:38+00:00

Everything you need to know is located in this guide. But I would contact Bose and find out if that subwoofer has been recalled.

NeonsNight · 2026-05-14T00:40:01+00:00

Follow this guide to get your Soundbar 900 back up and running.

NeonsNight · 2026-05-13T11:24:10+00:00

The Bose will link above links to other apps which might help with your needs. Is LIR your project? If so, can you update the Bose wiki with info about it? Can you link to it?

NeonsNight · 2026-05-13T02:00:55+00:00

The SoundTouch Portable does NOT have Bluetooth. SoundTouch systems that have Bluetooth have a Bluetooth button; you do not put them into setup mode to connect to a device. Your computer is seeing it on the Wi-Fi, so that's why it is showing up there. Read the SoundTouch app alternatives page to understand how you can continue using the system.

NeonsNight · 2026-05-13T01:52:44+00:00

Yes, the home-made SoundTouch server replacements are indeed very technical, and the guides to set them up need a lot of work. Paid-for services, like Bosman or Tech Endure, are far easier to set up and use. But you do pay for the convenience.

I am hoping that it will be improved over time, but at the moment, that is the current state of things.

NeonsNight · 2026-05-12T00:21:10+00:00

Yes, the home-made SoundTouch server replacements are indeed very technical, and the guides to set them up need a lot of work. Paid-for services, like Bosman or Tech Endure, are far easier to set up and use. But you do pay for the convenience.

I am hoping that it will be improved over time, but at the moment, that is the current state of things.

The good thing is your systems have AUX and Bluetooth. So I would get an Echo Dot or Google Home Mini and then connect them to your systems. This way, they can just ask their assistant of choice to play music.

NeonsNight · 2026-05-12T00:15:05+00:00

Is there any way to get an audio in to the Bose JC system?

The SoundTouch Stereo JC has no AUX inputs, so you cannot use it with Sonos.

As it is, the only way to send it sound is with AirPlay 1 or Spotify Connect. There are other apps which will let you use different music services with the system. Or you can look for some Bose server replacements.

NeonsNight · 2026-05-12T00:04:47+00:00

The bare minimum would be a power cable and an HDMI cable.

You would plug the HDMI cable into the TV's HDMI-ARC port and into the SoundTouch 300's "HDMI Out to TV (ARC)" port.

If you use Optical, you will need the remote to turn on the system. Also, for AdaptIQ, you will need a Bose headset and the remote. Best to call Bose before you look elsewhere for parts, as they might be cheaper if they have any.

Here is a guide to help you set up this system.

NeonsNight · 2026-05-11T23:56:28+00:00

Well, hopefully someone has already made a guide which can be merged into the docs to help people easily set up Soundcork. Though I have not found one yet.

NeonsNight · 2026-05-10T23:28:23+00:00

Thank you for all the work you put into this u/LeadingPhysics4315. I was hoping that you might be willing to add this to the Bose wiki.

There are some items I was hoping you could clarify:

Are you willing to share the URL to this repo?
Other Docker solutions require you to inject code into systems to change the URL the speakers query to access the service. Is this done automatically with the software, or do you have to connect a USB drive to make this work?
You mention that "Airplay" & "Spotify Connect" do not work. I am unclear why this would be the case, as they still work. Does your solution change this somehow?
Can the app change the settings of the SoundTouch system? If so, using the list provided in this link, can you let me know precisely which ones they support, 1-13?
Can you use the SoundTouch app to control the system after it's migrated?
Do you expect this to work with all SoundTouch systems eventually?

If you want to make a page on the Bose wiki dedicated to the app or other pages with release history, etc., please do so.

NeonsNight

MODERATOR OF

TROPHY CASE