Keep your Bose SoundTouch speaker fully functional after Bose shuts down the SoundTouch cloud servers on May 6, 2026.
SoundCork is a self-hosted replacement for the four Bose cloud servers that SoundTouch speakers depend on. It serves all responses locally — no traffic to Bose, no risk of unwanted firmware updates, no data leaving your network.
Fork of deborahgu/soundcork with added Docker support, smart proxy mode, and deployment guides.
We'll maintain a forum post with the Current Status of Bose Cloud Services. Check there for updates. We will update whenever we learn new information.
| Feature | Status | Notes |
|---|---|---|
| TuneIn radio presets | Working | Presets 1-6, station playback |
| Spotify Connect | Working | Cast from the Spotify app — independent of Bose servers |
| Spotify presets | Working | Requires a one-time kick-start via Spotify Connect |
| AUX input | Working | Not affected by shutdown |
| Bluetooth | Working | Not affected by shutdown |
| Firmware updates | Blocked | SoundCork returns "no updates available" |
| SoundTouch app presets | Not working | App can no longer configure TuneIn presets — use Bose CLI instead |
docker run -d --name soundcork \
-p 8000:8000 \
-v ./data:/soundcork/data \
-e base_url=http://your-server:8000 \
-e data_dir=/soundcork/data \
ghcr.io/timvw/soundcork:mainVerify it's running:
curl http://your-server:8000/
# {"Bose":"Can't Brick Us"}The container image supports linux/amd64 and linux/arm64 (Raspberry Pi).
See Deployment Guide for Docker Compose, Kubernetes, and bare metal options.
- Get SSH access to your speaker — Speaker Setup Guide
- Extract your speaker data (presets, sources, device info) — Speaker Setup Guide
- Deploy SoundCork on your network — Deployment Guide
- Redirect your speaker to SoundCork — Speaker Setup Guide
SoundTouch speakers communicate with four Bose cloud servers. SoundCork replaces all of them by editing the speaker's configuration to point to your server instead.
See Architecture for details on the Bose servers, operating modes, and data flows.
The official SoundTouch app can no longer configure presets pointing to TuneIn stations. The Bose CLI talks directly to the speaker's local API (port 8090) and works independently of any cloud server:
brew install timvw/tap/bose
bose preset # view presets
bose status # speaker status
bose volume 30 # set volume- Speaker Setup Guide — SSH access, data extraction, speaker redirect
- Deployment Guide — Docker, Docker Compose, Kubernetes, bare metal
- Architecture — Bose servers, proxy modes, circuit breaker, data flows
- Spotify Guide — Spotify Connect vs SoundTouch Spotify, preset fix
- API Specification — Reverse-engineered Bose server API
- Shutdown Emulation — Test results without Bose servers
- deborahgu for creating the original soundcork project
- Bose for publishing the SoundTouch Web API documentation to support community developers
MIT — see LICENSE