MuPiBox NG – Overview
What MuPiBox NG can do, how to use it and where this documentation explains every page of the admin interface.
MuPiBox NG is a music and audiobook player for kids built on a Raspberry Pi. It plays local music, web radio, podcasts, Spotify, audiobooks and content from your home network – controlled by a touchscreen, hardware buttons, RFID cards, the MuPiBox app or a web browser. Every way of controlling it drives the same player with the same queue.
New to MuPiBox? Start with installation, complete the guided first-time setup with a direct admin link, and check the interactive GPIO pinout.
How the box is built
| Part | Purpose |
|---|---|
| Touch interface | The kids' interface on the display: categories, covers, the big player. |
| Admin interface | The settings pages in the browser at http://<boxname>:8090/admin/. |
| Player service | Plays every source through one shared audio output. |
| System agent | A small, sandboxed helper for system changes (Wi-Fi, display, battery, updates). |
Opening the admin interface
- Switch the box on and wait for the kids' interface to appear.
- In the same network, open
http://<boxname>.local:8090/admin/orhttp://<IP address>:8090/admin/in a browser. Your router shows the IP address. - The first time there is no password yet. Set your own admin password under Security.
Every admin page has a "Documentation" link at the top right that opens the matching page of this guide in your language.
Areas of the admin interface
- Box & playback: General, Player, Display & power, Design, Audio, Text-to-speech
- Content & services: Media & categories, Providers, Spotify, Audible, Jellyfin, Music Assistant & Sendspin, NAS, Kids apps, Photo gallery
- Connections & security: Network, File sharing, Parental control, Smart home, Security & app
- Hardware: Overview, Display & touch, MuPiHAT, Buttons & rotary encoder, RFID, Fan, Bluetooth, GPIO reference
- System & maintenance: System, Remote display, Restart & power, Touch interface, Backup, Updates, Logs, Troubleshooting
Development status
MuPiBox NG is in its alpha phase. Features can still change; what is new is listed in the release notes on the Updates page. The project takes bug reports and wishes on GitHub.