Quickstart

Wundio einrichten

Schritt-für-Schritt Anleitung – von der leeren SD-Karte zur fertigen Box. Auch ohne technische Erfahrung umsetzbar.

Welches Raspberry Pi Modell verwendest du?

↑ Wähle dein Pi-Modell – die Anleitung passt sich automatisch an.

01

Raspberry Pi Imager herunterladen

Der Raspberry Pi Imager ist ein kostenloses Programm, das das Betriebssystem auf die SD-Karte überträgt. Es läuft auf Windows, macOS und Linux.

Raspberry Pi Imager herunterladen ↗
02

Betriebssystem auf SD-Karte flashen

⚠️

Modell auswählen

Wähle oben dein Pi-Modell – wir empfehlen die passende OS-Version automatisch.

So gehst du vor:

  1. 1.SD-Karte in deinen Computer einstecken (mindestens 16 GB, Class 10).
  2. 2.Raspberry Pi Imager öffnen. Klicke auf „Raspberry Pi Device" und wähle dein Modell.
  3. 3.Klicke auf „Operating System" → „Raspberry Pi OS (other)" → 64-bit Lite empfohlen.
  4. 4.Klicke auf „Storage" und wähle deine SD-Karte aus.
  5. 5.Klicke auf das Zahnrad-Symbol ⚙ (oder „Edit Settings") für wichtige Voreinstellungen – dieser Schritt ist entscheidend!
Imager – Erweiterte Einstellungen
🖥️

Hostname

Empfehlung: wundio — damit ist der Pi im Heimnetz als wundio.local erreichbar.

👤

Benutzername & Passwort

Wähle einen Benutzernamen (z.B. wundio) und ein sicheres Passwort. Notiere beides – du benötigst es für die Installation per SSH.
Achtung: Verwende kein einfaches Passwort wie wundio123 wenn die Box später im Netzwerk erreichbar ist.

📶

WLAN einrichten (optional)

Du kannst hier bereits dein Heimnetzwerk eintragen. Der Pi verbindet sich dann direkt nach dem ersten Start. Alternativ richtest du das WLAN später im Wundio Web-Interface ein.

🔑

SSH aktivieren Wichtig!

SSH muss aktiviert sein, damit du dich vom Computer aus mit dem Pi verbinden kannst. Wähle „Passwort-Authentifizierung". Ohne SSH kannst du Wundio nicht installieren.

Nach dem Bestätigen auf „Write" klicken. Das Flashen dauert je nach SD-Karte 3–10 Minuten.

03

Pi starten und verbinden

  1. 1.SD-Karte in den Raspberry Pi einlegen und Strom anschließen. Eine grüne LED zeigt an, dass er bootet.
  2. 2.Warte ca. 60–90 Sekunden bis der erste Boot abgeschlossen ist.
  3. 3.Öffne auf deinem Computer ein Terminal:
    Windows: PowerShell oder Windows Terminal (Win + X → Terminal)
    Mac: Terminal App (⌘ + Leertaste → „Terminal")
    Linux: Strg + Alt + T
  4. 4.Mit dem Pi verbinden – ersetze DEIN_BENUTZERNAME mit dem Namen, den du in Schritt 2 gewählt hast:
$ssh DEIN_BENUTZERNAME@wundio.local

💡 Tipp: Pi nicht gefunden?

Falls wundio.local nicht funktioniert, öffne deinen Router (meist 192.168.1.1) und suche dort nach dem Pi in der Geräteliste. Verbinde dich dann mit der IP-Adresse direkt:
ssh DEIN_BENUTZERNAME@192.168.x.x

Beim ersten Verbinden erscheint eine Sicherheitsfrage – mit yes + Enter bestätigen, dann das Passwort eingeben.

04

Wundio installieren

Du bist jetzt im Terminal deines Raspberry Pi. Kopiere den folgenden Befehl, füge ihn ein (Ctrl+Shift+V im Terminal oder Rechtsklick → Einfügen) und bestätige mit Enter:

$cd; curl -fsSL https://wundio.dev/install.sh | sudo bash

Was passiert jetzt automatisch:

  • ✓Dein Raspberry Pi wird erkannt – Features werden automatisch aktiviert
  • ✓SPI und I2C Schnittstellen werden für RFID-Reader und OLED-Display aktiviert
  • ✓Alle benötigten Programme werden installiert (dauert je nach Modell 5–15 Minuten)
  • ✓Spotify (librespot) wird eingerichtet
  • ✓Ein eigenes WLAN “Wundio-Setup” wird gestartet
  • ✓Der Pi startet automatisch neu
05

Mit Wundio verbinden & einrichten

Nach dem automatischen Neustart erscheint ein neues WLAN:

WLAN-Einstellungen (Handy oder Computer)
📶Wundio-Setup
Verbinden
📶Mein-Heimnetz
  1. 1.Mit dem WLAN Wundio-Setup verbinden. Passwort: wundio123
  2. 2.Browser öffnen (Chrome, Firefox, Safari) und aufrufen: http://192.168.50.1:8000
  3. 3.Das Wundio Web-Interface öffnet sich. Unter Einstellungen → WLAN dein Heimnetzwerk eintragen.
  4. 4.Wundio verbindet sich automatisch und ist danach im Heimnetz erreichbar. Den Pi jetzt wieder mit dem Heimnetz verbinden und die neue IP im Router nachschlagen.
06

Kinder-Profile & RFID einrichten

Im Web-Interface kannst du jetzt alles nach deinen Wünschen einstellen:

👤

Kinder-Profile

Namen, Emoji-Avatar und Lieblingslautstärke für jedes Kind.

⬡

RFID-Tags

Figuren oder Karten mit Spotify-Playlists oder Kinderprofilen verknüpfen.

🎵

Spotify

Wundio taucht automatisch als Gerät in deiner Spotify-App auf.

⚙

Einstellungen

Gerätename, WLAN, Lautstärke-Grenzen und mehr.

🎉

Deine Wundio Box ist bereit!

Lege eine RFID-Figur auf den Reader und die Musik startet. Viel Spaß beim Basteln!

Hardware-Pinout ansehenProbleme? → FAQ

Updates

Wundio per SSH aktuell halten:

$sudo bash /opt/wundio/scripts/update.sh