MuPiBox Dokumentation MuPiBox NG

Einstellungsreferenz

Wo finde ich welche Einstellung? Menüpfade der Verwaltung, Standardverhalten, Voraussetzungen und Änderungen, die einen Neustart brauchen.

Neue Navigation: Alle Konfigurationsoptionen findest du unter Einstellungen. Die Kategorien heißen Aussehen, Box & Bedienung, Hardware, Verbindungen, Familie & Schutz, System & Wartung und Apps. Anbieter und Dienste bleiben unter Inhalte & Provider. Die Tabellen unten führen teilweise noch die bisherigen technischen Kurzpfade; sie sind weiterhin gültig und innerhalb der neuen Einstellungsnavigation erreichbar.

Diese Referenz hilft, eine Einstellung in der Verwaltung zu finden. Wie die Pfade zu lesen sind, erklärt der Wegweiser durch die Verwaltung. Je nach Version, Hardware und aktivierten Providern können Felder fehlen oder andere Werte anbieten; die Detailseiten nennen die verfügbaren Optionen.

Zugang und Sicherheit

EinstellungMenüpfadErklärung
Admin-PasswortVerbindungen & Schutz → SicherheitSchützt die Verwaltung. Direkt nach der Installation setzen; mindestens 6 Zeichen mit Buchstaben und Ziffern.
ElternkontrolleVerbindungen & Schutz → ElternkontrolleZeitfenster, Hörzeit und erlaubte Quellen begrenzen; gilt auch für RFID und App.
Boxname / ZeitzoneBox & Bedienung → AllgemeinName im Netz und als Spotify-Connect-Gerät, Uhrzeit der Box.
MuPiBox AppMuPiBox App (Hauptmenü, direkt unter Box & Bedienung)Verbindet die normale App und, bei aktivierter Elternkontrolle, eine Eltern-App mit zusätzlichen Rechten.
Smart HomeVerbindungen & Schutz → Smart HomeHome-Assistant-Anbindung.

Siehe Sicherheit, Elternkontrolle, Allgemein und Smart Home.

Wiedergabe, Lautstärke und Display

EinstellungMenüpfadErklärung
Player-ModusBox & Bedienung → Player & VerhaltenDediziert (Standard) beendet die Wiedergabe beim Verlassen des großen Players; Persistent spielt mit Miniplayer weiter.
Miniplayer-GrößeBox & Bedienung → Player & VerhaltenSchmal, Normal oder Compact; nur im Modus Persistent.
Sprungtasten / SprungweiteBox & Bedienung → Player & Verhalten−/+ Tasten im großen Player ein- oder ausblenden und ihre Schrittweite festlegen.
EinschaltlautstärkeBox & Bedienung → AudioLautstärke nach jedem Start.
Maximale LautstärkeBox & Bedienung → AudioObergrenze für Touch, Tasten, App und Home Assistant.
AudioausgangHardware → Audio-AusgabePhysische Ausgabe mit Testton abspielen; manche Hardwareprofile brauchen einen Neustart.
DarstellungsgrößeBox & Bedienung → Display & EnergieKlein, Normal oder Groß.
Inaktivität „Während Musik läuft“Box & Bedienung → Display & EnergieDimmen, Bildschirmschoner oder Display aus; die Wiedergabe läuft weiter.
Inaktivität „Wenn nichts läuft“Box & Bedienung → Display & EnergieZusätzlich Standby und Ausschalten; die Stufen folgen nacheinander.
Standby über die Ein/Aus-TasteBox & Bedienung → Display & Energie„Ein/Aus-Taste schaltet in den Standby“; braucht eine geeignete Taste und ist nicht gleich Ausschalten.
Theme, Startbild, HintergrundBox & Bedienung → CustomizingAussehen der Kinderoberfläche.
SprachausgabeBox & Bedienung → Text-to-SpeechAnsagen von Titeln und Zuständen, Stimmen, Cache.

Siehe Player, Audio, Display & Energie, Design und Text-to-Speech.

Inhalte und Netzwerk

EinstellungMenüpfadErklärung
Kategorien & MedienInhalte & Dienste → InhalteKategorien, Medienquellen, Cover, Reihenfolge und RFID-Zuordnungen.
Provider aktivierenInhalte & Dienste → Provider & DiensteSpotify, Audible, Jellyfin, Music Assistant, NAS, Kinder-Apps, Fotogalerie einrichten und anmelden.
NAS-FreigabeInhalte & Dienste → Provider & Dienste → NASSMB-Ordner einbinden oder lokal kopieren.
WLANVerbindungen & Schutz → Netzwerk → WLAN & AdapterAdapter und Netze auswählen.
DateifreigabeVerbindungen & Schutz → Netzwerk → DateifreigabeSamba-Freigabe für den Musikordner; braucht vorher ein Admin-Passwort.

Siehe Medien & Kategorien, Provider & Dienste, NAS, Netzwerk und Dateifreigabe.

Hardware

EinstellungMenüpfadErklärung
DisplayprofilHardware → DisplayTreiber für das angeschlossene Display; wirkt nach einem Neustart.
MuPiHATHardware → MuPiHATAkkuprofil, Ladestrom, Warnungen, Schutzabschaltung, Akku-Historie.
Tasten, LEDs, DrehreglerHardware → TastenGPIO-Tasten und Lautstärke-Drehregler.
RFIDHardware → RFIDLeser wählen, Entprellzeit; Karten werden bei den Medien zugeordnet.
LüfterHardware → LüfterTemperaturgesteuerter Lüfter, Hardware-PWM.
BluetoothHardware → BluetoothKopfhörer und Lautsprecher koppeln und verwalten.

Siehe Display & Touch, MuPiHAT, Tasten, RFID, Lüfter und Bluetooth.

System und Wartung

EinstellungMenüpfadErklärung
Neustart, Ausschalten, Boot-ReihenfolgeSystem & Wartung → Neustart & PowerBox sicher neu starten oder ausschalten.
LeistungsoptionenSystem & Wartung → PerformanceManche Änderungen wirken erst nach einem Neustart; Hinweise beachten.
Sicherung / WiederherstellungSystem & Wartung → Backup und WiederherstellungKonfiguration und optional lokale Medien sichern.
UpdatesSystem & Wartung → UpdatesVerfügbare Versionen des gewählten Kanals installieren.
ProtokolleSystem & Wartung → ProtokolleFehler und Dienste untersuchen; ausführliche Protokolle schalten sich selbst wieder ab.
Touch-OberflächeSystem & Wartung → Touch-OberflächeZustand und Neustart der Kinderoberfläche.

Siehe Neustart & Power, System, Backup, Updates, Protokolle und Touch-Oberfläche.

Was vor einem Neustart zu prüfen ist

Wenn die Verwaltung einen Neustart verlangt, zuerst ein Backup anlegen. Bei Display-, Audio- oder GPIO-Änderungen die verwendete Hardware notieren. Ohne funktionierendes Display bleibt die Verwaltung im Browser der einfachere Weg zur Diagnose.

Pflegehinweis: Diese Tabelle nennt bewusst nur geprüfte Werte. Eine vollständige, automatisch erzeugte Liste aller Felder mit Standardwerten und Grenzen gibt es noch nicht.

© 2026 MuPiBox