Bose SoundTouch mit Homematic steuern

01Allgemein

Ziel ist es, ein Bose-SoundTouch-Gerät mit der Homematic-Zentrale zu steuern. Ich habe versucht, alle wichtigen Kommandos in Script-Befehle zu verpacken, die sich dann leicht und schnell in einem Programm verwenden lassen. Damit eröffnen sich gleich wieder viele neue Möglichkeiten. Hinweis (Stand 2026): Bose hat den Cloud-Betrieb für SoundTouch eingestellt. Die hier genutzte lokale Schnittstelle (Port 8090) ist laut Bose davon nicht betroffen; einzelne Funktionen können sich aber geändert haben.
Beispiele:

• Jeden Samstag und Sonntag soll die SoundTouch mit Radiosender 1 eingeschaltet werden, wenn zwischen 07:30 und 10:00 Uhr eine Bewegung in der Küche erkannt wird und ich zu Hause bin.
• Die Bose SoundTouch als Wecker nutzen, indem das Zeitmodul die Befehle zur Weckzeit an die Bose sendet (diese Funktion fehlte in der Bose-App).

02Anleitung

Um HTTP-Befehle (Requests) senden zu können, nutzt man am besten die Zusatzsoftware CUx-Daemon (CUxD) mit einem virtuellen Taster. Wie man diese Zusatzsoftware installiert wird in verschiedenen Foren gut beschrieben, darum gehe ich hier nur grob darauf ein (siehe auch die CUxD-Anleitung unter „Passende Anleitungen“).

• Ist der CUx-Daemon installiert, öffnet man die WebUI der Homematic und navigiert zu: Einstellungen -> Systemsteuerung -> Zusatzsoftware und startet den Daemon mit "Einstellen"
• Nun muss ein virtuelles Gerät angelegt werden. Dazu wählt man z. B. einen Taster aus, benennt ihn und klickt auf "Gerät auf CCU erzeugen"
• Nachdem das Gerät erzeugt wurde, wechselt man in den Posteingang der Homematic und schließt das Gerät dort ab („Fertig“).
• Ist bereits ein anderes virtuelles Gerät vorhanden, z. B. eine Fernbedienung, kann man auch dieses verwenden.
• Jetzt notiert man sich noch die CUxD-Seriennummer, sie wird später im Script eingesetzt. In meinem Fall ist das die CUX2801001

Abbildung vergrößern

• Um den Status der Bose abzufragen, habe ich eine Systemvariable angelegt, die ich später im Programm gleich mitschalte. So weiß Homematic, ob die Bose an oder aus ist.
• Die Variable habe ich "Bose Status" genannt und sie hat die Werte "On und Off"

Abbildung vergrößern

• Jetzt können wir in der Homematic ein neues Programm anlegen.
• Um sicherzustellen, dass ich auch zu Hause bin, wenn die SoundTouch angeht, kann man die Anwesenheitsvariable nutzen.
• Alternativ lässt sich der Anwesenheitsstatus bequem über eine Geofencing-Funktion einer Homematic-App setzen (z. B. HomeZone).

Abbildung vergrößern

03Logic

Wenn: Zeitmodul: Jeden Samstag und Sonntag
Und: Bewegungsmelder Innen eine Bewegung erkennt
Und: Bose Variable bei Off
Und: ich zu hause
Dann: Script
Dann: Bose Variable bei On
Sonst: Bose Variable bei Off

04Script

Jetzt kommt das Wichtigste, um die SoundTouch mit der Homematic zu steuern. Dazu wird nur noch eine Kleinigkeit benötigt: die IP-Adresse des zu steuernden Systems. Diese Adresse findet man leicht im Router unter den verbundenen Geräten oder in der Bose-App unter Hilfe.
In den Scripten ersetzt man nun XXX durch die IP-Adresse der SoundTouch.
Dabei wird nur der Code ohne die Überschrift (z. B. „SoundTouch On/Off“) in das Script kopiert.

SoundTouch On/Off
WriteLine("Bose ON/Off");
dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC").State("LD_LIBRARY_PATH=/usr/local/addons/cuxd /usr/local/addons/cuxd/curl -d '<key state=\"press\" sender=\"Gabbo\">POWER</key>' http://XXX:8090/key");
dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC").State("LD_LIBRARY_PATH=/usr/local/addons/cuxd /usr/local/addons/cuxd/curl -d '<key state=\"release\" sender=\"Gabbo\">POWER</key>' http://XXX:8090/key");


Volumen von 0 bis 100
WriteLine("Volumen auf 20");
dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC").State("LD_LIBRARY_PATH=/usr/local/addons/cuxd /usr/local/addons/cuxd/curl -d '<volume>20</volume>' http://XXX:8090/volume");


Sender von 1 bis 6
WriteLine("Sender 1 (PRESET_1) wählen");
dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC").State("LD_LIBRARY_PATH=/usr/local/addons/cuxd /usr/local/addons/cuxd/curl -d '<key state=\"press\" sender=\"Gabbo\">PRESET_1</key>' http://XXX:8090/key");
dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC").State("LD_LIBRARY_PATH=/usr/local/addons/cuxd /usr/local/addons/cuxd/curl -d '<key state=\"release\" sender=\"Gabbo\">PRESET_1</key>' http://XXX:8090/key");

05Key/Values

Wie man in dem Befehl "Sender von 1 bis 6" sehen kann, wird hier das PRESET_1 auf der Bose gewählt. PRESET_1 kann man durch einen der unten genannten Keys ersetzen, um eigene Befehle zu erstellen.

PLAY
PAUSE
STOP
PREV_TRACK
NEXT_TRACK
THUMBS_UP
THUMBS_DOWN
POWER
MUTE
VOLUME_UP
VOLUME_DOWN
PRESET_1
PRESET_2
PRESET_3
PRESET_4
PRESET_5
PRESET_6
AUX_INPUT
SHUFFLE_OFF
SHUFFLE_ON
REPEAT_OFF
REPEAT_ONE
REPEAT_ALL
PLAY_PAUSE
ADD_FAVORITE
REMOVE_FAVORITE

06Tipps aus der Praxis

• Tasten-Befehle immer als Paar aus „press“ und „release“ senden, so wie in den Beispiel-Scripten. Fehlt das „release“, reagiert die SoundTouch unter Umständen nicht wie erwartet.
• Die Systemvariable „Bose Status“ kennt nur, was Homematic selbst geschaltet hat. Wird die SoundTouch per App oder Fernbedienung bedient, stimmt der Status nicht mehr – das im Programm berücksichtigen.
• Der SoundTouch im Router eine feste IP-Adresse zuweisen, damit die Scripte dauerhaft funktionieren.
• POWER ist ein Umschaltbefehl: Ist das Gerät bereits an, schaltet derselbe Befehl es aus. Deshalb ist die Abfrage der Statusvariable im Programm wichtig.
• Für einen Wecker den Lautstärke-Befehl mit ins Programm aufnehmen, sonst startet die Wiedergabe mit der zuletzt eingestellten Lautstärke.
• Neue Scripte zuerst in der WebUI unter „Skript testen“ ausprobieren und erst danach in ein Programm übernehmen.

07Häufige Fragen

08Passende Anleitungen

• Bose SoundTouch als Homematic MP3-FunkgongAnsagen wie „Waschmaschine fertig“ über die SoundTouch
• CUx-Daemon (CUxD) auf der Homematic CCU installierenVoraussetzung für die Scripte
• Erweiterte Astrofunktion für HomematicZeitfenster wie „nur vormittags“ für Programme
• Homematic mit Amazon Echo und Alexa steuernProgramme zusätzlich per Sprache auslösen