Simple MPV WebUI provides a web-based interface with controls for the mpv media player.

github.com/open-dynaMIX/simple-mpv-webui
Simple MPV WebUI homepage screenshot

About Simple MPV WebUI

Simple MPV WebUI is a web-based interface with controls for the mpv media player. It runs as an mpv script and is accessed from a browser at 127.0.0.1:8080 or [::1]:8080 by default, listening on 0.0.0.0:8080 and [::0]:8080 unless changed.

It supports configuration of port, IPv4 and IPv6 listening, request and OSD logging, audio devices for cycling, a custom static directory for an alternative frontend, and exposed directories for the /api/collections file-browser. Authentication uses Basic Authentication with an htpasswd file, and /api/collections responses remain empty until directories are configured.

Key features

  • Control mpv through a browser-based interface
  • Configurable server port, defaulting to 8080
  • Separate toggles for IPv4 and IPv6 listening
  • Cycle through specified audio output devices
  • Serve alternative frontend from custom static directory
  • Browse configured folders via /api/collections endpoint
Best for: People who use mpv and want to operate it through a web browser.
Good for
  • Installs by copying repository into mpv scripts directory for mpv >= v0.33.0
  • Allows use of an alternative frontend via static_dir option
  • Supports Basic Authentication with htpasswd file
Watch out for
  • Responses from /api/collections remain empty until directories are configured
  • Authentication is described as a very simple Basic Authentication implementation
  • Relative htpasswd paths use working directory and do not support ~/ shortcuts

Simple MPV WebUI at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Not stated
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

Simple MPV WebUI alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 8 alternatives

rmpc

rmpc.mierak.dev

Control MPD from the terminal with rmpc, a configurable text interface with development documentation.

Popular in Media Players & Servers

Well-known listings from the same topic.

All 194

Simple MPV WebUI FAQ

How do I install it for mpv 0.33.0 or newer?
Clone or copy the whole repository into the mpv scripts directory, or load it with --script, --scripts-append, or scripts-append in mpv.conf.
How do I enable password protection?
Provide an htpasswd file with the htpasswd_path option to enable Basic Authentication.
Why does /api/collections return empty responses?
You must configure absolute, semicolon-delimited directory paths in the collections option; it is empty by default.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing