# Bose hat Ihr SoundTouch getötet. So reparieren Sie es

_Sie haben es nicht kaputt gemacht. Das war Bose. Hier ist die Lösung – und warum Sie das eigentlich nicht tun müssten._

---

Ich habe ein SoundTouch 20. Solide Hardware, jahrelang täglich im Einsatz, und seit dem 6. Mai funktionieren die Preset-Tasten nicht mehr. Dieser Beitrag erklärt, was eigentlich kaputt gegangen ist und warum, und zeigt dann, wie man den Lautsprecher mit [AfterTouch](https://github.com/gesellix/Bose-SoundTouch) wieder zum Leben erweckt, einem kostenlosen Open-Source-Toolkit, das alles ersetzt, was die Bose-Server früher erledigt haben. Keine Cloud, kein Bose-Konto, keine App erforderlich. Getestet am SoundTouch 20; der Prozess ist bei allen SoundTouch-Modellen gleich oder sehr ähnlich: 10, 30, Portable und den Heimkino-Systemen.

## Das Architekturproblem

Jede der sechs Preset-Tasten auf dem Gerät speichert keinen Link zu dem, was sie abspielen soll. Ein Druck darauf sendet eine Anfrage an die Server von Bose, um zu fragen, was gestreamt werden soll. Ohne eine Antwort vom Server wird nichts abgespielt. Es gab nie eine Möglichkeit, es lokal zum Laufen zu bringen.

Bose wusste dies bei der Auslieferung des Produkts und hat es nie offengelegt. Über ein Jahrzehnt lang verkauften sie ein "Knopf drücken und zuhören"-Gerät mit einer versteckten Serverabhängigkeit, von der die Kunden nichts wissen konnten. Das [Consumer Rights Wiki](https://consumerrights.wiki) – das verbraucherfeindliche Praktiken in der Verbrauchertechnologie verfolgt – dokumentierte dies als klares Beispiel für eine nicht offengelegte Cloud-Abhängigkeit, die zum funktionalen Verlust gekaufter Hardware führt.

Im Oktober 2025 kündigte Bose an, dass die Server abgeschaltet werden. Unter dem Druck der Kunden verlängerten sie die Frist vom 18. Februar auf den 6. Mai 2026. Sie veröffentlichten auch die [SoundTouch Web-API-Dokumentation](https://assets.bosecreative.com/m/496577402d128874/original/SoundTouch-Web-API.pdf) – obwohl die Community diese lokale Geräteschnittstelle größtenteils bereits dokumentiert hatte und Boses Veröffentlichung bis auf die Versionsnummer kaum etwas geändert zu haben scheint. Wichtiger noch, sie deckt die Geräte-API auf Port 8090 ab, nicht jedoch die Cloud-seitigen Endpunkte, von denen die Preset-Tasten tatsächlich abhängen. Diese hat Bose nie dokumentiert. Die Community musste sie [Reverse-Engineering unterziehen](https://www.gesellix.net/posts/aftertouch-bose-soundtouch/).

Der offizielle Workaround von Bose besteht darin, Ihre Sender als Favoriten in einzelnen Musik-Apps zu speichern und von dort zu streamen. Das ist nicht wirklich ein Ersatz für Preset-Tasten – es erfordert jedes Mal, das Handy herauszuholen, die richtige App zu öffnen und an den richtigen Ort zu navigieren.


## Was noch funktioniert

| Funktion | Status |
| -------------------------------- | -------------------- |
| Bluetooth-Wiedergabe | ✅ Funktioniert |
| AUX-Eingang | ✅ Funktioniert |
| AirPlay / Spotify Connect / UPnP | ✅ Funktioniert |
| Preset-Tasten (1–6) | ❌ Funktioniert nicht mehr |
| TuneIn / Pandora / iHeartRadio | ❌ Funktioniert nicht mehr |
| SoundTouch-App Musik durchsuchen | ❌ Funktioniert nicht mehr |

Sie können immer noch Audio abspielen, Sie benötigen nur jedes Mal Ihr Telefon. Die physischen Tasten, das, was es Ihnen ermöglichte, den Lautsprecher ohne Telefon zu bedienen, funktionieren nicht mehr.


## Die Lösung: AfterTouch

[AfterTouch](https://github.com/gesellix/Bose-SoundTouch) ist ein Open-Source-Toolkit des Entwicklers [Tobias Gesellchen](https://www.gesellix.net/posts/aftertouch-bose-soundtouch/), das die Cloud-Dienste von Bose in Ihrem lokalen Netzwerk emuliert. Sobald Ihr Lautsprecher auf AfterTouch statt auf die Server von Bose verweist, funktionieren die Preset-Tasten wieder – zusammen mit TuneIn-Suchen und der internen Konto- und Geräteverwaltung, die der Lautsprecher erwartet.

Es wird als einzelnes Binary ohne zu installierende Laufzeitumgebung geliefert, und die folgenden Schritte erfordern nur grundlegende Kenntnisse im Umgang mit einem Terminal.

AfterTouch muss auf einem Rechner laufen, der eingeschaltet bleibt. Ein Raspberry Pi, ein NAS oder jeder ständig eingeschaltete Heimserver funktioniert. Es benötigt nicht viele Ressourcen, da es meistens nur einen Link bereitstellt, von wo der Lautsprecher die Musik abspielen soll. Es gibt Pläne, AfterTouch später direkt auf der SoundTouch-Hardware selbst auszuführen, was das gesamte Setup in sich geschlossen machen würde, aber das sprengt den Rahmen dieses Beitrags.

AfterTouch baut auf [SoundCork](https://github.com/deborahgu/soundcork) auf, dem Python-basierten Server, der ursprünglich von Deborah Gu geschrieben wurde und der zuerst das Bose-Cloud-Protokoll knackte. AfterTouch erweitert ihn um eine Web-Benutzeroberfläche, automatische Geräteerkennung, Docker-Unterstützung und einen Migrationsassistenten. Die vollständige Dokumentation finden Sie unter [gesellix.github.io/Bose-SoundTouch](https://gesellix.github.io/Bose-SoundTouch/). Diese Anleitung zeigt Ihnen, wie Sie AfterTouch einrichten, Ihren Lautsprecher migrieren und die Preset-Tasten mit Ihren eigenen Sendern programmieren.

**Was Sie brauchen:**

- Einen Raspberry Pi, NAS oder einen anderen Computer, der zu Hause eingeschaltet bleibt
- Docker auf dieser Maschine installiert
- Ihren SoundTouch-Lautsprecher und ein Heimnetzwerk


### Schritt 1: Führen Sie AfterTouch aus

Die einfachste Methode ist Docker. Auf Ihrer stets eingeschalteten Maschine:

```sh
docker run -d \
  --name soundtouch-service \
  --network host \
  --restart unless-stopped \
  -v $(pwd)/AfterTouch-Data:/app/data \
  ghcr.io/gesellix/bose-soundtouch:latest
```

> **Linux:** `--network host` ermöglicht AfterTouch die automatische Erkennung Ihres Lautsprechers über Multicast. Unter macOS oder Windows verwenden Sie stattdessen `-p 8000:8000 -p 8443:8443` und fügen die IP Ihres Lautsprechers manuell in der Benutzeroberfläche hinzu.

Oder wenn Sie Docker Compose bevorzugen:

```yaml
services:
  soundtouch-service:
    image: ghcr.io/gesellix/bose-soundtouch:latest
    container_name: soundtouch-service
    network_mode: host
    volumes:
      - ./AfterTouch-Data:/app/data
    restart: unless-stopped
```

Sobald es läuft, öffnen Sie `http://<Ihre-Maschinen-IP>:8000` in einem Browser. AfterTouch beginnt mit der Suche nach SoundTouch-Geräten in Ihrem Netzwerk. Bluetooth- und AUX-Wiedergabe funktionieren unabhängig davon, ob AfterTouch läuft – sie berühren das Netzwerk überhaupt nicht.

{{< figure
src="AfterTouch-page.jpg"
alt="Screenshot der AfterTouch-Weboberfläche, die eine Liste der erkannten Bose SoundTouch-Geräte im lokalen Netzwerk anzeigt"
caption="AfterTouch Web-Benutzeroberfläche zeigt erkannte Geräte"
>}}

### Schritt 2: Migrieren Sie Ihren Lautsprecher

Ihr Lautsprecher wird auf der Registerkarte "Geräte" angezeigt. Klicken Sie auf **Migrate**.

AfterTouch wählt automatisch die beste Methode für Ihr Modell aus. Für die meisten SoundTouch-Geräte, einschließlich des SoundTouch 20, verwendet es die **Telnet-Methode**: Der Lautsprecher verfügt über einen internen Diagnoseport (Port 17000), mit dem die Server-URLs umgeleitet werden können, ohne das Gerät zu öffnen oder SSH zu aktivieren. Es gibt auch eine USB-SSH-Methode für einige Modelle, aber Telnet funktioniert, ohne die Hardware überhaupt zu berühren. Auf dem SoundTouch 20 konnte ich SSH ohnehin nicht zum Laufen bringen.

AfterTouch verbindet sich mit dem Diagnoseport, leitet alle Server-URLs auf Ihre lokale Instanz um und startet den Lautsprecher neu. Nach dem Neustart meldet sich der Lautsprecher bei Ihrem Server anstelle von dem von Bose an. Die Preset-Tasten reagieren, aber die Slots sind nach der Migration leer – Sie müssen sie programmieren.

Der [AfterTouch Migrationsleitfaden](https://gesellix.github.io/Bose-SoundTouch/guides/MIGRATION-GUIDE.html) behandelt jedes Modell und jeden Randfall, falls Sie auf Probleme stoßen.

{{< figure
  src="AfterTouch-migrate.jpg"
    alt="Screenshot des AfterTouch-Gerätemigrationsbildschirms, der eine erfolgreiche Migration für ein SoundTouch 20 anzeigt"
    caption="AfterTouch Migrationserfolgsbildschirm"
>}}

Die Lautsprecher erhalten zukünftig keine Firmware- oder Sicherheitsupdates mehr. Bose empfiehlt, sie in einem privaten, durch eine Firewall geschützten Netzwerk zu betreiben, was ohnehin ein vernünftiger Rat ist.

Wenn Sie einen Lautsprecher einrichten, der auf die Werkseinstellungen zurückgesetzt wurde oder noch nie mit Wi-Fi verbunden war, benötigen Sie die SoundTouch-App für diesen Teil nicht. Der Lautsprecher sendet während der Einrichtung seinen eigenen Access Point aus; das Verbinden mit diesem öffnet eine Webseite, auf der Sie Ihre Wi-Fi-Anmeldeinformationen direkt eingeben können.


#### Wie es wirklich funktioniert

Ihr SoundTouch-Lautsprecher verfügt über eine Konfigurationsdatei, in der die Server-URLs aufgeführt sind, die er für verschiedene Funktionen aufruft – TuneIn-Suchen, Kontoverwaltung (intern "Marge" genannt), Software-Updates ("BMX") und so weiter. Ab Werk verweisen sie alle auf `*.bose.com`.

Die Migration überschreibt diese URLs, um auf Ihre AfterTouch-Instanz zu verweisen. Wenn Sie ab diesem Zeitpunkt Preset-Taste 1 drücken, fragt der Lautsprecher Ihren Server, was abgespielt werden soll. AfterTouch sucht, was Sie für Slot 1 konfiguriert haben, und weist den Lautsprecher an, es zu streamen. Der Lautsprecher ruft den Ton direkt vom Radiosender ab. Bose ist komplett aus dem Spiel.

Das Einzige, was Ihr Heimnetzwerk verlässt, ist der Audiostream selbst, der direkt zu den Servern des Senders geht – genau wie immer.


### Schritt 3: Finden Sie Ihre Stream-URLs

Nach der Migration sind die Preset-Slots leer. Sie weisen jeder Taste eine Stream-URL zu. Dies ist der wirklich befreiende Teil: Sie sind nicht mehr auf das beschränkt, was in der kuratierten Diensteliste von Bose enthalten war. Jeder öffentlich zugängliche Audiostream funktioniert.

**Option A: Direkte Stream-URLs (empfohlen)**

Die meisten Radiosender veröffentlichen eine Roh-Stream-URL auf ihrer eigenen Website – suchen Sie nach "Live hören" oder "Stream", oft in der Fußzeile versteckt – oder über [radio-browser.info](https://www.radio-browser.info), ein von der Community gepflegtes Verzeichnis, das Zehntausende von Sendern weltweit abdeckt. Stream-URLs enden meist auf `.mp3`, `.aac` oder `/stream`.

Dies ist die langlebigigste Option, da nichts zwischen Ihnen und dem Sender steht. Wenn der Sender weiter sendet, funktioniert die URL weiterhin. Kein Bose, kein TuneIn, nichts dazwischen.

**Option B: TuneIn-Sender-IDs**

AfterTouch enthält eine TuneIn-Emulationsschicht. Bei meinen Tests funktionierten sowohl direkte Stream-URLs als auch TuneIn-Sender-IDs zuverlässig. Um einen TuneIn-Sender zu verwenden, extrahieren Sie die ID aus der URL des Senders:

```
https://tunein.com/radio/Example-FM-s112738/
```

Das `s112738` am Ende ist die Sender-ID. Übergeben Sie sie mit `--source TUNEIN`, wie in Schritt 4 gezeigt. Dennoch ist TuneIn selbst ein Dienst mit eigenen Langlebigkeitsrisiken. Verwenden Sie daher direkte Stream-URLs, wo immer Sie sie finden können.

### Schritt 4: Programmieren Sie die Preset-Tasten

AfterTouch wird mit `soundtouch-cli` zur lokalen Lautsprechersteuerung ausgeliefert. Sie müssen [Go installiert](https://go.dev/dl/) haben, um es zu bekommen, oder Sie können ein vorgefertigtes Binary direkt von der [Releases-Seite](https://github.com/gesellix/Bose-SoundTouch/releases) für Linux, macOS oder Windows herunterladen.

**Installation mit Go:**

```sh
go install github.com/gesellix/bose-soundtouch/cmd/soundtouch-cli@latest
```

Suchen Sie die IP Ihres Lautsprechers in der AfterTouch-Weboberfläche oder der Geräteliste Ihres Routers, und dann:

**Entdecken Sie Ihr Gerät:**

```sh
soundtouch-cli discover devices
```

**Programmieren Sie ein Preset — direkte Stream-URL:**

```sh
soundtouch-cli --host 192.168.1.50 preset store \
  --slot 1 \
  --source LOCAL_INTERNET_RADIO \
  --location "http://stream.example.com/live.mp3" \
  --name "Example Radio"
```

**Programmieren Sie ein Preset — TuneIn-Sender-ID:**

```sh
soundtouch-cli --host 192.168.1.50 preset store \
  --slot 2 \
  --source TUNEIN \
  --location "/v1/playback/station/s112738" \
  --name "Example FM"
```

**Überprüfen Sie, ob alles gespeichert ist:**

```sh
soundtouch-cli --host 192.168.1.50 preset list
```

Drücken Sie Taste 1 am physischen Lautsprecher. Er sollte innerhalb weniger Sekunden mit der Wiedergabe beginnen.

Die vollständige CLI-Referenz – Multiroom-Zonen, Skripte, Smart-Home-Hooks – finden Sie unter [gesellix.github.io/Bose-SoundTouch](https://gesellix.github.io/Bose-SoundTouch/).


## Home Assistant und Smart Home

Wenn Sie SoundTouch bereits in Home Assistant hatten und die UPnP-Integration verwendet haben, sollte es ohne Änderungen weiterhin funktionieren. Das UPnP funktionierte lokal wie bisher.

## Andere Optionen

AfterTouch ist nicht das einzige Projekt, das daraus hervorgegangen ist. [ÜberBöse](https://github.com/julius-d/ueberboese-api) – das ist passend – bietet native Spotify-OAuth-Unterstützung und hat eine [Android-App auf F-Droid](https://f-droid.org/packages/io.github.juliusd.ueberboese.app/). Mehrere funktionierende Ersatzlösungen existierten, bevor Bose den Schalter umlegte. Die Community war der Frist voraus.

## Das größere Bild

Die Hardware funktioniert. Die Firmware funktioniert. Was gescheitert ist, war eine nicht offengelegte, absichtliche Abhängigkeit von einem Remote-Server für etwas so Grundlegendes wie das Aufrufen eines Presets – eine Abhängigkeit, für die es nie einen lokalen Fallback gab, die den Käufern nie offengelegt wurde und die schließlich mit wenigen Monaten Vorlaufzeit gekündigt wurde.

Das Gespräch über das Recht auf Reparatur hat sich traditionell auf die physische Reparierbarkeit konzentriert: das Recht, ein Gerät zu öffnen, ein Teil auszutauschen, Komponenten zu beschaffen. Dasselbe Prinzip gilt jedoch auch für Software. Wenn ein Gerät funktionale Hardware ist, auf der funktionale Firmware läuft, sollten Verbraucher ein sinnvolles Recht haben, es weiter zu nutzen, auch nachdem der Hersteller entschieden hat, dass sich die Wartung der Serverkosten nicht mehr lohnt. Was Bose hier getan hat – eine stille Cloud-Abhängigkeit einbauen, das Produkt ein Jahrzehnt lang verkaufen und dann die Server abschalten – ist das Software-Äquivalent zum Bau eines Autos mit einer Komponente, die in dem Moment nicht mehr funktioniert, in dem der Händler schließt.

Die Community hat dieses Problem behoben. Eine Handvoll Entwickler haben das Cloud-Protokoll in ihrer eigenen Zeit einem Reverse Engineering unterzogen und vor Ablauf der Frist funktionierenden Ersatz gebaut. Das ist ein gutes Ergebnis. Es hätte nicht nötig sein dürfen.

Wenn Sie weitere Fälle wie diesen verfolgen möchten, verfolgt das [Consumer Rights Wiki](https://consumerrights.wiki) dieses Muster in der gesamten Branche – von Cloud-abhängiger Hardware, geplanter Obsoleszenz und den dahinter stehenden Unternehmen.