...is a web based user interface with controls for the mpv mediaplayer.
This project is a fork of simple-mpv-webui.
The webserver is re-implemented using libwebsockets C library.
To use it, you'll need to compile the plugin:
$ make
Then, copy the library (ws-webui.so) and the directory ws-webui-page to ~/.config/mpv/scripts.
Alternatively you can also use the --script option from mpv or add something like
scripts-add=/path/to/simple-mpv-webui/ws-webui.so to mpv.conf.
You can access the webui when accessing http://127.0.0.1:8080 or
http://[::1]:8080 in your webbrowser.
By default it listens on 0.0.0.0:8080 and [::0]:8080. As described below, this can be changed.
Options can be set with --script-opts
with the prefix ws-webui-.
Set the port to serve the webui (default: 8080).
Example:
ws-webui-port=8000
Enable/disable listening on ipv6 (default: yes)
Example:
ws-webui-ipv6=no
The interface to which the http and websocket severs are bound (default: all).
You can limit binding to a specific interface (see ip link show).
Example:
ws-webui-interface=eth0
The name of the directory containing web files (static http hosting).
Not intended as absolute path. It's relative to ws-webui.so file.
Default is ws-webui-page, but you can change whenever you need to.
Example:
ws-webui-dir=ws-webui-page-mod
Support not planned.
The code was tested on GNU/Linux only.
Specifically on Arch Linux.
- libwebsockets (
pacman -S libwebsockets)
Thanks to open-dynaMIX for his work on this.
- More media controls (namely: sub-seek, sub-scale)
- mpv controls are exposed through a websocket backend instead of HTTP+REST backend (static files are still served with a simple HTTP server)
- C backend
The C code of this project is released under GPLv3 license [1].
The README and webui files keep the same license of the upstream project and were modified just to make the UI works with websockets [2].
This project was done for educational purposes and for fun.