Zum Inhalt springen
Architektur

Architektur

OpenCloudTouch ersetzt die Bose SoundTouch Cloud-Infrastruktur durch einen lokalen Dienst in deinem Netzwerk.

Wie Bose SoundTouch funktioniert (Original)

    graph LR
    Speaker[🔊 SoundTouch Lautsprecher] -->|HTTPS| Bose[☁️ Bose Cloud]
    Bose -->|Presets, Radio, Updates| Speaker
    App[📱 Bose App] -->|API| Bose
  

Bose-Lautsprecher sind auf Cloud-Dienste angewiesen für Presets, Internetradio-Suche, Multi-Room-Koordination und Firmware-Updates. Als Bose diese Dienste abschaltete, verloren die Lautsprecher den Großteil ihrer smarten Funktionen.

Wie OpenCloudTouch funktioniert

    graph LR
    Speaker[🔊 SoundTouch Lautsprecher] -->|HTTP/SSDP| OCT[🏠 OpenCloudTouch]
    OCT -->|Presets, Radio, Steuerung| Speaker
    UI[🌐 Web UI] -->|REST API| OCT
    OCT -.->|Optional| TuneIn[📻 TuneIn API]
  

OpenCloudTouch fängt die Cloud-Aufrufe der Lautsprecher ab und fungiert als lokaler Ersatz:

  • SSDP-Erkennung — findet Lautsprecher im Netzwerk automatisch
  • REST API — bietet Preset-Verwaltung, Radio-Suche und Lautsprechersteuerung
  • Web UI — browserbasierte Oberfläche für Konfiguration und Wiedergabe
  • Kein Internet nötig — funktioniert vollständig offline (außer für Streaming von Radioinhalten)

Komponenten

KomponenteTechnologieZweck
BackendPython (FastAPI)REST API, Lautsprecherkommunikation, SSDP-Erkennung
FrontendReact (TypeScript)Webbasierte Steuerungsoberfläche
DatenbankSQLitePreset-Speicherung, Lautsprecher-Registrierung
ContainerDockerDeployment und Isolation
Raspberry Pi ImageFertiges OS-ImageSofort einsatzbereites Image mit allem vorkonfiguriert

Netzwerkanforderungen

OpenCloudTouch muss sich im selben Netzwerksegment wie deine Lautsprecher befinden. Es nutzt:

  • UDP 1900 — SSDP-Erkennung (Multicast)
  • UDP 5353 — mDNS (Multicast)
  • TCP 7777 — Web UI und REST API
Zuletzt aktualisiert am