Skip to content
pradelPublic

About

Controller app for the bose soundtouch speakers

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Revive ST

Open-source replacement for the discontinued Bose SoundTouch app.

Bose shut down the SoundTouch cloud in May 2026, leaving thousands of speakers without app control, broken preset buttons, and no way to play internet radio. Revive ST brings it all back — and then some.

Available on: iOS (coming soon) · Android (coming soon)

Website & Documentation: revivest.app · Self-hosting


Features

  • Full playback control — play, pause, skip, volume, and more
  • Volume & multi-room zones — group speakers, control per-speaker volume
  • Hardware preset restoration — physical buttons 1–6 work again
  • Internet radio — thousands of stations via Radio Browser
  • Custom scenes — trigger multi-speaker groups with a single tap
  • EQ & audio modes — bass, treble, Dialog/Night/Direct DSP modes
  • Real-time sync — WebSocket-based, instant state updates across devices
  • Setup wizard — easy onboarding with automatic speaker discovery
  • No account required — works entirely on your local network
  • Works with other community servers — speakers on soundcork, AfterTouch or STR play radio through them, with no migration

Feedback & support


Development

Prerequisites

Before you start, ensure you have the following prerequisites installed:

  • Node.js: v24 or newer.
  • Vite+: We use Vite+ (vp) as our unified toolchain for package and runtime management.
  • Expo CLI: Required for mobile development.

Setup

  • Setup the monorepo:
vp run ready

Contributing

We welcome contributions of all kinds, whether you want to fix a bug, add a new feature, or improve the documentation, this guide will help you get started.

  1. Fork the repository on GitHub.
  2. Create a branch for your feature or bug fix (git checkout -b feature/my-new-feature).
  3. Write your code and ensure it passes all tests (vp check, vp test).
  4. Commit your changes using Conventional Commits.
  5. Add a changeset for user-visible changes to the app or the server (pnpm changeset): one sentence written for users, under the package it changes. The app and the server are versioned and released separately; the website and internal packages aren't versioned. Their only contract is the SoundTouch protocol the speakers use, fixed by their firmware, GET / (the server's name and version), and the app's endpoints under /api/internal (a speaker's presets and its last contact). A server endpoint an app release calls stays until the X-Revive-App-Version header shows no app still in use calls it. When the app starts relying on something a server release added, raise MIN_SERVER_VERSION in apps/app/src/features/server/server-version.ts to that release: the app checks the version the server reports at GET / before it saves a server address or sets up a speaker.
  6. Open a Pull Request against the main branch.

For large features or architecture changes, please open an issue first to discuss what you would like to change.


Compatible servers

Revive ST isn't the only project keeping SoundTouch speakers alive. If your speakers already use one of these servers, the app recognises it and plays internet radio through it, with nothing to set up. See Other SoundTouch servers.


Acknowledgements

A huge thanks to the maintainers and contributors of the following projects, whose code and reverse-engineering efforts were instrumental in building Revive ST:


License

Revive ST is released under the MIT License.

Revive ST is not affiliated with or endorsed by Bose Corporation. Bose and SoundTouch are trademarks of Bose Corporation. Revive ST is not affiliated with soundcork, AfterTouch or STR; their names refer to those projects.

About

Controller app for the bose soundtouch speakers

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages