umpv-go
October 19, 2025 ยท View on GitHub
A Go language version of umpv (https://github.com/mpv-player/mpv/blob/master/TOOLS/umpv)
Only work on Windows.
Usage
Place umpv.exe in the same directory as mpv.exe, or define the path to mpv.exe in the environment variable MPV
umpv video.mkv
Options
--ipc-server
Specify the IPC server socket path. Default path is \\.\pipe\umpv.
Format: \\.\pipe\<PipeName>,PipeName can include any character other than a backslash, including numbers and special characters. The entire pipe name string can be up to 256 characters long. Pipe names are not case-sensitive.
Tips: The prefix \\.\pipe\ can be omitted, meaning \\.\pipe\umpv and umpv refer to the same pipe.
--loadfile-flag
Specify the loadfile flag. Possible values are:
replace: Replace the current playlist.append: Append to the current playlist.append-play: (default) Append the file, and if nothing is currently playing, start playback.insert-next: Insert the file into the playlist, directly after the current entry.insert-next-play: Insert the file next, and if nothing is currently playing, start playback.
Read mpv manual for more details.
--config
Specify the config file path. If not provided, the default path umpv.conf in the executable directory will be used.
--foreground
Control whether to bring the mpv window to the foreground after loading files. Default is true.
true: (default) Bring mpv window to foregroundfalse: Don't bring mpv window to foreground
Example
umpv --ipc-server=\\.\pipe\mpvpipe --loadfile-flag=replace --foreground=false video.mkv
Config
The default configuration file umpv.conf in the executable directory will be used, or you can specify the configuration file path using the --config command line option.
Refer to the Options section for available settings.
Note: Command line arguments will override the corresponding settings in the configuration file.
Example
ipc-server=\\.\pipe\mpvpipe
loadfile-flag=replace
foreground=false