-
Notifications
You must be signed in to change notification settings - Fork 1
BEDIENUNG
So nutzt du OpenCloudTouch im Alltag.
Öffne im Browser: http://opencloudtouch.local:7777
Die Web-UI ist für Desktop und Smartphone optimiert. Auf dem Handy einfach die URL als Lesezeichen oder zum Homescreen hinzufügen.
💡 Tipp: Auf dem iPhone/Android kannst du die Seite als Web-App zum Homescreen hinzufügen. Dann öffnet sich OCT wie eine native App.
Auf der Startseite siehst du deine SoundTouch-Geräte. Hast du mehrere Boxen, kannst du nach links/rechts wischen um zwischen den Geräten zu wechseln.
Für jedes Gerät werden angezeigt:
- Name des Lautsprechers
- 6 Preset-Tasten (1-6)
- Lautstärke-Regler
Die 6 Presets entsprechen den Favoritentasten auf deinem SoundTouch-Lautsprecher. Du kannst jedem Preset einen Radiosender zuordnen.
- Tippe auf einen leeren Preset (z.B. Taste 1)
- Die Radio-Suche öffnet sich
- Gib einen Sendernamen ein (z.B. „Bayern 3", „SWR3", „BBC Radio 1")
- Wähle den gewünschten Sender aus der Ergebnisliste
- Der Sender ist jetzt deinem Preset zugeordnet ✅
- In der Web-UI: Tippe auf den Preset-Button
- Am Lautsprecher: Drücke die entsprechende Preset-Taste (1-6) direkt am Gerät
- Halte den Preset-Button gedrückt (oder tippe auf das Bearbeiten-Symbol)
- Suche einen neuen Sender
- Bestätige die Auswahl
- Tippe auf das Bearbeiten-Symbol am Preset
- Wähle Preset löschen
Die Radiosuche durchsucht über 30.000 Sender weltweit (via RadioBrowser.info — ein kostenloses Community-Verzeichnis).
| Suche nach | Beispiel |
|---|---|
| Sendername | „Bayern 3", „SWR3", „WDR 2" |
| Genre | „Jazz", „Classical", „Rock" |
| Stadt/Land | „Wien", „London", „Australia" |
| Sprache | „German", „French" |
Die Suche zeigt:
- Sendername
- Land/Region
- Genre/Tags
- Bitrate (Qualität)
💡 Tipp: Je spezifischer die Suche, desto besser die Ergebnisse. „SWR3" findet den Sender direkt, „Radio" liefert tausende Treffer.
OCT scannt regelmäßig dein Netzwerk nach SoundTouch-Geräten. Neue Geräte erscheinen automatisch.
Du kannst auch manuell nach Geräten suchen:
- Gehe zur Startseite
- Klicke auf Geräte suchen
Falls ein Gerät nicht automatisch gefunden wird (z.B. in einem anderen Netzwerk-Segment):
- Gehe zu Einstellungen (⚙️)
- Unter Manuelle Geräte-IPs: Gib die IP-Adresse des Lautsprechers ein
- Klicke auf Hinzufügen
Die IP-Adresse findest du in deinem Router unter den verbundenen Geräten.
Unter Einstellungen (⚙️) findest du:
| Einstellung | Beschreibung |
|---|---|
| Manuelle Geräte-IPs | IP-Adressen für Geräte, die nicht automatisch gefunden werden |
Die Preset-Tasten (1-6) am SoundTouch-Lautsprecher funktionieren wie gewohnt. Du musst die Web-UI nicht öffnen, um Musik zu hören — die Boxen erinnern sich an die Presets.
Füge http://opencloudtouch.local:7777 als Web-App zu deinem Smartphone-Homescreen hinzu. So hast du schnellen Zugriff ohne Browser zu öffnen.
OCT wird regelmäßig verbessert. Updates installierst du mit:
cd ~/opencloudtouch
docker compose pull
docker compose up -dDu kannst beliebig viele SoundTouch-Lautsprecher mit einer OCT-Installation verwalten. Wische in der Web-UI zwischen den Geräten.
Diese Funktionen sind in Vorbereitung:
| Feature | Status |
|---|---|
| 🎵 Wiedergabe-Steuerung (Play/Pause/Skip) | In Arbeit |
| 🔊 Multi-Room-Zonen | In Arbeit |
| 📻 Weitere Musik-Dienste (Spotify, etc.) | Geplant |
| 🔄 Firmware-Info | In Arbeit |
👉 FAQ — Häufig gestellte Fragen
👉 Fehlerbehebung — Wenn etwas nicht klappt
Fragen? Probleme? Schau in die FAQ oder erstelle ein GitHub Issue.
🇩🇪 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