wtf is music-machine?

Music Machine is a self hosted jukebox that runs on your local network and pulls together your own music library, Spotify search, and control of Sonos speakers in one place. It offers a touch friendly interface meant for guests to use casually, a separate administration interface for the person running it, two independently configurable favorites profiles, listening history, the ability to build local playlists, and control over multiple Sonos rooms at once. The tool scans your music folders for MP3, FLAC, M4A, MP4, AAC, and WAV files, reads embedded and folder artwork into a cache, and lets you search across both your local library and Spotify when it is configured. On the playback side, it can shuffle albums and playlists while keeping the shuffled order stable even if Sonos rooms are added, removed, or the queue screen is reopened, alongside the usual straight-through and choose-a-track playback options. To run it, you need Node.js 20 or later, a computer that can stay on and reach your music folders, and Sonos speakers on the same local network. Setup involves unzipping the release, copying the example environment file, editing it with your own paths and settings, then installing dependencies and starting the server. Once running, the guest interface, admin panel, and playlist builder are each available at their own local address, and other devices on the network can reach them using the host computer's address instead of localhost. Because the app has no built in authentication, it is meant to stay on a trusted home network, kept away from the open internet unless placed behind a VPN or an authenticated proxy. The project is released under the MIT license.