NAME

mpvd — A simple server for the mpv JSON IPC protocol

SYNOPSIS

DESCRIPTION

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.

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

The options are as follows:

-f config

Set and load configuration file. By default, mpvd looks for ~/.config/mpvd/mpvd.conf.

-h

Print the help message and exit.

-s socket

Set the socket file. By default mpvd listens on /tmp/mpvd.sock.

-V

Print version information and exit.

-v

Print diagnostics to standard output. This flag can be specified up to four times to increase verbosity.

FILES

~/.config/mpvd/mpvd.conf

The default mpvd configuration file.

/tmp/mpvd.sock

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

EXIT STATUS

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.

SEE ALSO

mpv(1), mpvc(1)

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