Home

OpenCloudTouch Wiki

Deine Bose SoundTouch-Lautsprecher leben weiter! 🎵

OpenCloudTouch (OCT) ist eine lokale, kostenlose Open-Source-Lösung, die deine Bose SoundTouch-Lautsprecher nach der Cloud-Abschaltung weiter nutzbar macht — mit Internetradio, Presets und einer modernen Web-Oberfläche.

Your Bose SoundTouch speakers live on! OCT is a free, open-source local solution that keeps your speakers working after the cloud shutdown — with internet radio, presets, and a modern web interface.

---

🇩🇪 Benutzerhandbuch

• Was ist OpenCloudTouch? — Warum du es brauchst und wie es funktioniert
• Installation — Auf Raspberry Pi, NAS oder PC installieren
• Ersteinrichtung — SoundTouch-Geräte mit OCT verbinden
• Bedienung — Presets belegen, Radiosender suchen, Musik hören
• Häufige Fragen — FAQ für Anwender
• Fehlerbehebung — Wenn etwas nicht klappt

🇬🇧 User Guide

• What is OpenCloudTouch? — Why you need it and how it works
• Installation — Install on Raspberry Pi, NAS, or PC
• First Setup — Connect SoundTouch devices with OCT
• Usage Guide — Assign presets, search radio stations, listen to music
• FAQ — Frequently asked questions
• Troubleshooting — When something doesn't work

---

🛠️ Development

• Testing — Test infrastructure (pytest, Vitest, Cypress)
• Commit Conventions — Conventional Commits guide
• Git Hooks — Pre-commit and pre-push hooks
• Dependency Management — Python + npm dependencies
• No-Verify Ban — Why --no-verify is forbidden
• Git Tracking Policy — What belongs in Git
• CI Config — CI/CD configuration

📐 API & Architecture

• REST API — API documentation
• ADR 001 – Clean Architecture
• ADR 002 – FastAPI App State
• ADR 003 – SSDP Discovery
• ADR 004 – React/TypeScript/Vite

📄 Technical Reference

• Configuration (Dev) 🇩🇪 · 🇬🇧
• SSH Quickstart 🇩🇪 · 🇬🇧
• Preset Playback (Technical) 🇩🇪 · 🇬🇧

⚖️ Licenses

• All Licenses · Backend · Frontend