MPVD(1) General Commands Manual MPVD(1)

mpvdA simple server for the mpv JSON IPC protocol

mpvd [-hVv] [-f config] [-s socket]

mpvd is a simple server that uses libmpv to respond to mpv JSON IPC commands, typically from mpvc(1). A similar server can be created with the below mpv(1) command.

$ mpv --idle --no-video --input-ipc-server=/tmp/mpvd.sock

mpvd also handles setting log levels via the command line and locking the socket using lock files.

The options are as follows:

Set and load configuration file. By default, mpvd looks for ~/.config/mpvd/mpvd.conf.
Print the help message and exit.
Set the socket file. By default mpvd listens on /tmp/mpvd.sock.
Print version information and exit.
Print diagnostics to standard output. This flag can be specified up to four times to increase verbosity.

The default mpvd configuration file.
The default listening socket mpvd attempts to create to receive JSON IPC commands.

The mpvd utility exits 0 on success, and >0 if an error occurs. It can fail for any of these reasons:

  • It could not connect to the socket.
  • It could not open the lock file (named <socket file>.lck) exclusively.
  • It could not load the configuration file, if it exists.

mpv(1), mpvc(1)

mpv's online manual has a section JSON IPC documenting the JSON IPC protocol used by mpvd.

January 29, 2022