Überböse Api 🔈🎶

Überböse: /ˈyːbɐˌbøːzə/ (german) adjective - extremely or supremely evil; beyond ordinary wickedness.

Bose has stopped supporting its consumer streaming boxes called SoundTouch on May 6, 2026 ☹️ This renders millions of completely working streaming boxes useless.

From their last announcement:

What no longer works:

• Presets (preset buttons on the product and in the app)
• Browsing or playing music services directly from the SoundTouch app
• Stereo pairing for SoundTouch 10

This projects helps you overcome these limitations with a self-hosted server that replaces the Bose streaming HTTP API.

Documentation

Full documentation is available at: https://julius-d.github.io/ueberboese-api/

• Quick Start Guide - Step-by-step installation and configuration
• Überböse Api Spec - The missing api-specification. These are the endpoints your speaker calls.

Features

• Easy installation with Docker Compose
• Spotify OAuth integration support
• Self-hosted and open source
• Comprehensive logging for API research

With the Überböse Api and the Überböse App you can

• boot up your speakers without any problems
• play presets from Spotify, TuneIn, and internet radio
• change presets to other Spotify, TuneIn, and internet radio stations
• create multi room zones
• create and change stereo pairs

This has been tested on:

• SoundTouch 10
• SoundTouch 20
• SoundTouch 30
• SoundTouch 300

Installation

See the Quick Start Guide.