-
Notifications
You must be signed in to change notification settings - Fork 1
ERSTEINRICHTUNG
Nach der Installation ist OpenCloudTouch bereit. Jetzt verbindest du deine SoundTouch-Lautsprecher.
Deine SoundTouch-Boxen versuchen noch, mit der (abgeschalteten) Bose-Cloud zu sprechen. Die manuelle Einrichtung konfiguriert sie so um, dass sie stattdessen mit deinem lokalen OpenCloudTouch-Server kommunizieren.
Dafür ist einmalig nötig:
- Ein USB-Stick wird vorbereitet (aktiviert SSH auf der Box)
- Die Box wird per SSH konfiguriert
- OCT übernimmt die Cloud-Funktion lokal
Der Prozess umfasst einige manuelle Schritte, muss aber nur einmal pro Gerät durchgeführt werden.
Öffne im Browser:
http://opencloudtouch.local:7777
Beim ersten Start siehst du die Willkommensseite mit drei Optionen:
- 🔍 Geräte suchen — Scannt dein Netzwerk nach SoundTouch-Geräten
- ✏️ Manuelle Einrichtung — Richtet eine Box für OpenCloudTouch per SSH ein
- ✏️ Manuelle IP-Eingabe — Für Geräte, die nicht automatisch gefunden werden
💡 Ein geführter Setup-Wizard ist für eine zukünftige Version geplant.
Für die Einrichtung wird ein USB-Stick benötigt, um SSH auf deinem SoundTouch-Lautsprecher zu aktivieren.
- Einen USB-Stick (mindestens 1 GB)
- Der USB-Stick wird formatiert — sichere vorher alle Daten!
- Klicke auf „Gerät manuell einrichten“
- Folge den Anweisungen zur USB-Vorbereitung (Schritt 1)
- Formatiere den USB-Stick als FAT32
- Der Wizard erstellt die nötige Konfigurationsdatei — lade sie herunter und kopiere sie auf den USB-Stick
💡 Tipp: Der USB-Stick wird nur einmalig pro Gerät benötigt. Nach der Einrichtung kannst du ihn anderweitig verwenden.
- Stecker ziehen — Schalte dein SoundTouch-Gerät aus (Strom trennen)
- USB-Stick einstecken — Stecke den vorbereiteten USB-Stick in den USB-Anschluss der Box
- Stecker wieder rein — Schalte das Gerät wieder ein
- Warten — Die Box startet und liest den USB-Stick. Das dauert ca. 30-60 Sekunden
Der Wizard erkennt automatisch, wann die Box bereit ist (SSH verfügbar).
Die manuelle Einrichtung umfasst folgende Schritte:
| Schritt | Was passiert | Deine Aktion |
|---|---|---|
| USB | USB-Stick vorbereiten | Datei auf Stick kopieren |
| SSH | SSH-Verbindung zur Box | Box mit USB-Stick starten |
| Backup | Sicherung der Original-Konfiguration | Empfohlen! „Backup erstellen" klicken |
| Verbindung | Box wird auf OCT umgeleitet | Anweisungen auf dem Bildschirm folgen |
| DNS | Bose-Domains werden umgeleitet | Anweisungen auf dem Bildschirm folgen |
| Prüfung | Konfiguration wird getestet | Verbindung zur Box prüfen |
| Neustart | Box wird neu gestartet | Neustart abwarten |
| Fertig! | Zusammenfassung | 🎉 |
⚠️ Wichtig: Erstelle unbedingt ein Backup (Schritt 3)! Falls etwas schiefgeht, kannst du damit die Originalkonfiguration wiederherstellen.
Nach dem Wizard-Durchlauf ist dein Gerät für OCT konfiguriert. Gehe zurück zur Startseite und klicke auf:
🔍 Jetzt Geräte suchen
OCT scannt dein Netzwerk und findet deine SoundTouch-Boxen. Die Geräte erscheinen nacheinander auf dem Bildschirm.
- Prüfe, ob OCT und die Box im selben Netzwerk sind
- Prüfe, ob die Box eingeschaltet ist (LED leuchtet)
- Versuche die manuelle IP-Eingabe unter Einstellungen
- Weitere Tipps: Fehlerbehebung
Dein SoundTouch-Lautsprecher ist jetzt mit OpenCloudTouch verbunden. Du kannst nun:
- 📻 Radiosender suchen und Presets belegen
- 🔘 Presets 1-6 per Knopfdruck auf der Box abspielen
- 🔊 Lautstärke über die Web-UI steuern
Wiederhole die manuelle Einrichtung für jedes weitere SoundTouch-Gerät. Du kannst mehrere Boxen mit einer OCT-Installation verwalten.
👉 Bedienung — So nutzt du die Web-Oberfläche im Alltag
👉 FAQ — Häufige Fragen
Probleme bei der Einrichtung? Siehe Fehlerbehebung
🇩🇪 Benutzerhandbuch
🇬🇧 User Guide
Development
API & Architecture
- REST API
- ADR 001 Clean Architecture
- ADR 002 FastAPI App State
- ADR 003 SSDP Discovery
- ADR 004 React/TS/Vite
Technical Reference
Legal