Tonado

Die Musikbox, die dir gehört.

Open-Source Kinder-Musikbox mit Figuren und Karten, gesteuert vom Smartphone. Raspberry Pi basiert, kein Abo, keine Cloud, keine Limits.

Jede Figur oder Karte enthält einen kleinen RFID-Chip (13.56 MHz), den die Box beim Auflegen erkennt. Ab hier im Text nur noch „Figur".

Features

• Figur auflegen, Musik spielt — Kinder legen eine Figur oder Karte auf, der Rest passiert von allein
• Smartphone als Fernbedienung — Musik verwalten, Figuren zuweisen, Lautstärke begrenzen, Einschlaftimer setzen
• Eigene Musik, eigene Regeln — MP3s hochladen, Internetradio, Podcasts — alles auf deinem Pi, nichts in der Cloud
• Kindersicher — PIN-geschützte Eltern-Einstellungen, maximale Lautstärke, automatischer Einschlaftimer
• Gesten-Steuerung — Box kippen zum Skippen, schütteln für Shuffle (optional, mit Gyro-Sensor)
• Physische Tasten — Lautstärke, Play/Pause, Skip per Knopfdruck — automatisch erkannt, kein Pin-Wissen nötig
• Open Source — MIT-Lizenz, vollständig anpassbar, keine versteckten Kosten

So sieht es aus

Die App läuft im Browser auf deinem Smartphone, Tablet oder Laptop — kein App-Store, keine Installation.

Bibliothek	Figur einrichten	Eltern-Einstellungen

Setup-Wizard — kein Terminal, keine Config-Datei:

Hardware erkennen	Audio-Ausgang	Tasten einlernen

Was du brauchst

Komponente	Beispiel	ca. Preis
Raspberry Pi	Zero W, 3B+, 4 oder 5	15–50 €
microSD-Karte	mind. 16 GB, Class 10	8 €
Lautsprecher	HifiBerry MiniAmp + kleiner Lautsprecher	15–25 €
RFID-Reader	RC522 (SPI) oder USB-RFID-Reader	5–10 €
Figuren oder Karten	13.56 MHz RFID-Chips (MIFARE Classic o.ä.)	5 € / 10 Stk
USB-Netzteil	5V, passend zum Pi-Modell	10 €
Optional: Gyro-Sensor	MPU6050 — für Gesten-Steuerung	3 €
Optional: Tasten	Arcade Buttons o.ä. — für Lautstärke, Skip	5 €
Optional: Ein/Aus-Taster	OnOff SHIM — sauberes Hoch-/Herunterfahren	8 €
Optional: Gehäuse	3D-Druck, Holzbox, Brotdose, ...	variabel

Gesamtkosten: ca. 70–100 € — eigene Musik, kein Abo, keine laufenden Kosten.

Alle Details zu Modellen, Optionen und Verkabelung: Hardware-Anleitung

Schnellstart

1. SD-Karte vorbereiten

1. Raspberry Pi Imager installieren
2. Raspberry Pi OS Lite auswählen (64-bit, oder 32-bit für Pi Zero W)
3. In den Einstellungen: Hostname, SSH, WLAN, Benutzername pi konfigurieren
4. Image auf SD-Karte schreiben

2. Tonado installieren

Per SSH auf dem Pi einloggen und einen Befehl ausführen:

ssh pi@<hostname>.local
curl -sSL https://raw.githubusercontent.com/t13gazh/tonado/main/system/install.sh | sudo bash

Das Script erledigt alles automatisch — Pakete, Audio, RFID, Webserver. Dauert 5–15 Minuten je nach Pi-Modell. Falls ein Neustart nötig ist: sudo reboot

3. Loslegen

Browser öffnen, http://<hostname>.local aufrufen, Musik hochladen, Figuren zuweisen — fertig.

Ausführliche Anleitung mit Troubleshooting: Installationsanleitung

Aktualisierung

Über die App: Einstellungen > System > Nach Updates suchen

Oder per SSH:

cd /opt/tonado && sudo -u pi git pull && sudo systemctl restart tonado

Für Entwickler

Tonado ist gebaut mit Svelte 5, FastAPI, MPD und SQLite. Hardware-Services laufen auf Windows/Mac im Mock-Modus.

Entwicklungsumgebung, Tests, Deployment: Entwickler-Anleitung

Status

Beta (v0.4.1) — Installierbar und funktionsfähig auf Pi 3B+ und Pi Zero W. Das flashbare Pi-Image samt Eltern-Anleitung — SD-Karte flashen, Box starten, im Browser einrichten, kein SSH nötig. v0.4.1-beta bringt den headless-Boot-Fix und den überarbeiteten Setup-Wizard (Wahl zwischen Heim-WLAN und reinem Offline-Betrieb, funktionierende WLAN-Liste, echte Audio-Aktivierung). Dieser headless-Image-Pfad wird gerade auf echter Hardware mit nicht-technischen Eltern validiert; der bewährte SSH-Pfad (curl | sudo bash) bleibt als Fallback. Changelog · Install-Strategie

Implementiert: Player, Bibliothek mit Ordnern/Radio/Podcasts/Playlisten, Figuren-Wizard, Eltern-Einstellungen (PIN, Lautstärkelimit, Sleep-Timer mit Fade-Out), PIN-geschützter Bibliothek-Zugriff, Hardware-Erkennung (RC522/PN532/USB), Gesten-Steuerung, interaktive GPIO-Button-Erkennung, Setup-Wizard (6 Schritte, Re-Run-sicher), Error-Boundaries mit globalem Toast-System, Audio-Testton im Wizard, Hardware Graceful Degradation, Browser-Audio, automatische Updates, Backup/Restore.

Pi-Kompatibilitätsmatrix (Stand 2026-04-17):

Modell	Status	Hinweise
Raspberry Pi 3B+	✅ Beta-getestet	Referenz-Plattform. HifiBerry MiniAmp + RC522 + MPU6050 + GPIO-Buttons verifiziert.
Raspberry Pi Zero W	✅ Beta-getestet	Install-Script End-to-End auf 4 GB Bookworm-Lite SD verifiziert (2026-04-22). Backend-Idle: CPU 40 °C, RAM 160/427 MB. Erster Build 20-30 min wegen aiosqlite-Kompilierung auf ARMv6.
Raspberry Pi Zero 2 W	⚠️ Experimentell	Nicht getestet, sollte aber ähnlich Pi 3B+ laufen (ARM64).
Raspberry Pi 4	❓ Ungetestet	Sollte funktionieren — Rückmeldungen willkommen.
Raspberry Pi 5	❓ Ungetestet	Neuer GPIO-Controller (RP1); gpiod v2 sollte abstrahieren, nicht verifiziert.

Performance (Pi 3B+): API-Responses 15–25 ms, 50 MB RAM, 10s Startup, 1.3 MB Frontend.

Known Issues:

• Headless-Image-Erstboot noch nicht auf echter Hardware mit nicht-technischer Zielgruppe validiert. Das flashbare Image baut in CI und die Setup-WLAN-/Captive-Portal-/Wizard-Kette ist code-reviewt + per Offline-Checks abgesichert, aber der „aus dem Karton flashen → booten → einrichten"-Pfad wird gerade erst auf Pi 3B+ field-getestet. Bis dahin ist der SSH-Install-Pfad die erprobte Route.

Was noch fehlt: Feld-Validierung des Image-Erstboots mit echten Eltern, PN532- und USB-RFID-Reader-Tests, Performance-Optimierung (Health-Endpoint, CPU-Idle-Last), Mehrsprachigkeit (Englisch vorbereitet).

Dokumentation

Die Doku ist nach Zielgruppe sortiert:

• Für Eltern — Tonado flashen · Erste Schritte · Vision · Was Tonado kann · Häufige Fragen · Updates · Backup
• Für Bastler — Installation · Hardware
• Für Entwickler — Mitmachen · Architektur · Entwicklung · Roadmap · Install-Strategie

Mitmachen

• Testen: Probier Tonado aus und melde Probleme als Issue
• Hardware testen: Wir suchen Tester mit Pi 4/5, PN532 (I2C) und USB-RFID-Readern
• Übersetzen: Tonado ist auf Deutsch — Hilfe bei weiteren Sprachen willkommen (web/src/lib/i18n/)

Inspiration

Inspiriert von großartigen Open-Source-Projekten wie Phoniebox und TonUINO — und der Idee, dass Kinderzimmer keine Cloud-Anbindung brauchen.

Lizenz

MIT License — siehe LICENSE