mupibox

MuPiBox is a portable music box built on Raspberry Pi and operated through a touch display. It is aimed at children and older people, so the interaction model is kept simple: users pick music on the screen rather than managing a conventional desktop player. Playback sources include local music files, Spotify and streams. The project is distributed as a stable release on GitHub and is documented through its own website, which covers requirements, known compatible hardware and installation instructions. Community support is available through a Discord channel, with additional material on YouTube and Facebook. The software builds on a set of existing components, including DietPi as the base system, librespot for Spotify playback, mplayer-wrapper, pi-blaster, google-tts, fbv and an initramfs splash, and it credits the Sonos Kids Controller and SpotifyController projects as influences. Dependencies such as npm packages, system packages, binaries and services are listed in a dedicated DEPENDENCIES.md file. For development, the repository separates the box UI and backend servers under src from the PHP-based admin interface under AdminInterface/www. GitHub Codespaces is supported, so contributors can work in the browser without a local setup; the README describes running npm install, copying configuration templates, starting the backend and frontend development servers, and using php -S for the admin interface. A Dockerfile allows testing changes in a production-like setting, currently limited to the box UI. A separate document provides a prompt for an AI coding assistant to rebuild the Cover Flow theme in another MuPiBox project. Contributions are welcomed, primarily through issues and pull requests. The project also accepts donations via PayPal.