mpv-web-control
Control mpv from your phone.
A web interface for the music player on your Raspberry Pi. Open a browser, pick a track, press play. That's it. No apps, no Bluetooth pairing, no proprietary protocols.
$ sudo apt install mpv $ pnpm install $ MUSIC_ROOT=/mnt/music pnpm start → listening on http://0.0.0.0:3000 Open that address on your phone. You're done.
What it does
Browse your library
Navigate folders under MUSIC_ROOT. Queue a single file or dump an entire directory into the playlist. Recursive folder support means your "Jazz" folder with 40 subfolders is two taps away from playing.
Full playback control
Play, pause, skip, seek, adjust volume. The seek bar works. The volume slider works. Nothing crashes when you mash the buttons.
Playlists that stick
Save your current queue as a JSON file. Load it later, append to it, or delete it. The files live on disk — no database to corrupt, no migration to run.
Zero setup friction
One environment variable tells it where your music lives. That plus an mpv binary is the entire dependency tree. Runs on any Debian-based Pi in about 90 seconds.
Built for the Pi on your shelf
Plug in speakers. Run one command. Control everything from the couch.
mpv-web-control doesn't try to be a streaming server or a media center. It does one job — letting you pick and play music through mpv — and stays out of your way.
Read the setup guide