mpv a media player Copyright: GPLv2+ Manual 1 section: Manual group: multimedia Table of Contents SYNOPSIS 6 DESCRIPTION 7 INTERACTIVE CONTROL 8 Keyboard Control 8 Mouse Control 11 USAGE 12 Legacy option syntax 12 Escaping spaces and other special characters 12 Paths 13 Per-File Options 14 List Options 14 String list and path list options 14 Key/value list options 15 Filter options 15 General 16 CONFIGURATION FILES 17 Location and Syntax 17 Escaping spaces and special characters 17 Putting Command Line Options into the Configuration File 17 File-specific Configuration Files 17 Profiles 18 Runtime profiles 18 Conditional auto profiles 19 Legacy auto profiles 21 Using mpv from other programs or scripts 23 TAKING SCREENSHOTS 24 TERMINAL STATUS LINE 25 LOW LATENCY PLAYBACK 26 PROTOCOLS 27 PSEUDO GUI MODE 30 Linux desktop issues 31 Disabling Screensaver 31 OPTIONS 32 Track Selection 32 Playback Control 34 Program Behavior 42 Video 47 Audio 58 Subtitles 65 Window 77 Disc Devices 84 Equalizer 86 Demuxer 86 Input 91 OSD 94 Screenshot 97 Software Scaler 99 Audio Resampler 101 Terminal 101 Cache 103 Network 106 DVB 107 ALSA audio output options 108 GPU renderer options 109 Miscellaneous 132 Debugging 137 AUDIO OUTPUT DRIVERS 139 VIDEO OUTPUT DRIVERS 143 AUDIO FILTERS 154 VIDEO FILTERS 158 ENCODING 171 COMMAND INTERFACE 174 input.conf 174 input.conf syntax 174 Key names 175 Flat command syntax 176 Commands specified as arrays 176 Named arguments 177 List of Input Commands 177 Input Commands that are Possibly Subject to Change 186 List of events 194 Hooks 197 Input Command Prefixes 198 Synchronous vs. Asynchronous 198 Asynchronous command details 199 Input Sections 199 Properties 199 Property list 200 Inconsistencies between options and properties 223 Property Expansion 223 Raw and Formatted Properties 224 ON SCREEN CONTROLLER 225 Using the OSC 225 The Interface 225 Key Bindings 226 Configuration 226 Config Syntax 226 Command-line Syntax 227 Configurable Options 227 Script Commands 230 STATS 231 Usage 231 Font 231 Configuration 231 Configurable Options 231 Different key bindings 233 Active key bindings page 233 Internal stuff page 233 CONSOLE 235 Keybindings 235 Commands 235 Known issues 236 Configuration 236 Configurable Options 236 LUA SCRIPTING 237 Example 237 Script location 237 Details on the script initialization and lifecycle 238 mp functions 238 Advanced mp functions 244 mp.msg functions 245 mp.options functions 245 mp.utils functions 246 Events 249 Extras 249 JAVASCRIPT 250 Example 250 Similarities with Lua 250 Differences from Lua 250 Language features - ECMAScript 5 250 Unsupported Lua APIs and their JS alternatives 250 Scripting APIs - identical to Lua 251 Additional utilities 252 Timers (global) 253 CommonJS modules and require(id) 254 Custom initialization 254 The event loop 254 JSON IPC 256 Socat example 256 Command Prompt example 256 Protocol 257 Data flow 258 Asynchronous commands 258 Commands with named arguments 258 Commands 258 UTF-8 260 JSON extensions 260 Alternative ways of starting clients 261 CHANGELOG 262 EMBEDDING INTO OTHER PROGRAMS (LIBMPV) 263 C PLUGINS 264 C plugins location 264 API 264 Linkage to libmpv 264 Examples 264 ENVIRONMENT VARIABLES 265 EXIT CODES 267 FILES 268 FILES ON WINDOWS 270 SYNOPSIS mpv [options] [file|URL|PLAYLIST|-] mpv [options] files DESCRIPTION mpv is a media player based on MPlayer and mplayer2. It supports a wide variety of video file formats, audio and video codecs, and subtitle types. Special input URL types are available to read input from a variety of sources other than disk files. Depending on platform, a variety of different video and audio output methods are supported. Usage examples to get you started quickly can be found at the end of this man page. INTERACTIVE CONTROL mpv has a fully configurable, command-driven control layer which allows you to control mpv using keyboard, mouse, or remote control (there is no LIRC support - configure remotes as input devices instead). See the --input- options for ways to customize it. The following listings are not necessarily complete. See etc/input.conf for a list of default bindings. User input.conf files and Lua scripts can define additional key bindings. See also --input-test for interactive binding details by key, and the stats built-in script for key bindings list (including print to terminal). Keyboard Control LEFT and RIGHT Seek backward/forward 5 seconds. Shift+arrow does a 1 second exact seek (see --hr-seek). UP and DOWN Seek forward/backward 1 minute. Shift+arrow does a 5 second exact seek (see --hr-seek). Ctrl+LEFT and Ctrl+RIGHT Seek to the previous/next subtitle. Subject to some restrictions and might not always work; see sub-seek command. Ctrl+Shift+Left and Ctrl+Shift+Right Adjust subtitle delay so that the next or previous subtitle is displayed now. This is especially useful to sync subtitles to audio. [ and ] Decrease/increase current playback speed by 10%. { and } Halve/double current playback speed. BACKSPACE Reset playback speed to normal. Shift+BACKSPACE Undo the last seek. This works only if the playlist entry was not changed. Hitting it a second time will go back to the original position. See revert-seek command for details. Shift+Ctrl+BACKSPACE Mark the current position. This will then be used by Shift+BACKSPACE as revert position (once you seek back, the marker will be reset). You can use this to seek around in the file and then return to the exact position where you left off. < and > Go backward/forward in the playlist. ENTER Go forward in the playlist. p / SPACE Pause (pressing again unpauses). Step forward. Pressing once will pause, every consecutive press will play one frame and then go into pause mode again. , Step backward. Pressing once will pause, every consecutive press will play one frame in reverse and then go into pause mode again. q Stop playing and quit. Q Like q, but store the current playback position. Playing the same file later will resume at the old playback position if possible. / and * Decrease/increase volume. 9 and 0 Decrease/increase volume. m Mute sound. _ Cycle through the available video tracks. # Cycle through the available audio tracks. f Toggle fullscreen (see also --fs). ESC Exit fullscreen mode. T Toggle stay-on-top (see also --ontop). w and W Decrease/increase pan-and-scan range. The e key does the same as W currently, but use is discouraged. o (also P) Show progression bar, elapsed time and total duration on the OSD. O Toggle OSD states between normal and playback time/duration. v Toggle subtitle visibility. j and J Cycle through the available subtitles. z and Z Adjust subtitle delay by +/- 0.1 seconds. The x key does the same as Z currently, but use is discouraged. l Set/clear A-B loop points. See ab-loop command for details. L Toggle infinite looping. Ctrl + and Ctrl - Adjust audio delay (A/V sync) by +/- 0.1 seconds. Shift+g and Shift+f Adjust subtitle font size by +/- 10%. u Switch between applying no style overrides to SSA/ASS subtitles, and overriding them almost completely with the normal subtitle style. See --sub-ass-override for more info. V Toggle subtitle VSFilter aspect compatibility mode. See --sub-ass-vsfilter-aspect-compat for more info. r and R Move subtitles up/down. The t key does the same as R currently, but use is discouraged. s Take a screenshot. S Take a screenshot, without subtitles. (Whether this works depends on VO driver support.) Ctrl s Take a screenshot, as the window shows it (with subtitles, OSD, and scaled video). PGUP and PGDWN Seek to the beginning of the previous/next chapter. In most cases, "previous" will actually go to the beginning of the current chapter; see --chapter-seek-threshold. Shift+PGUP and Shift+PGDWN Seek backward or forward by 10 minutes. (This used to be mapped to PGUP/PGDWN without Shift.) d Activate/deactivate deinterlacer. A Cycle aspect ratio override. Ctrl h Toggle hardware video decoding on/off. Alt+LEFT, Alt+RIGHT, Alt+UP, Alt+DOWN Move the video rectangle (panning). Alt + and Alt - Combining Alt with the + or - keys changes video zoom. Alt+BACKSPACE Reset the pan/zoom settings. F8 Show the playlist and the current position in it (useful only if a UI window is used, broken on the terminal). F9 Show the list of audio and subtitle streams (useful only if a UI window is used, broken on the terminal). i and I Show/toggle an overlay displaying statistics about the currently playing file such as codec, framerate, number of dropped frames and so on. See STATS for more information. del Cycle OSC visibility between never / auto (mouse-move) / always ` Show the console. (ESC closes it again. See CONSOLE.) (The following keys are valid only when using a video output that supports the corresponding adjustment.) 1 and 2 Adjust contrast. 3 and 4 Adjust brightness. 5 and 6 Adjust gamma. 7 and 8 Adjust saturation. Alt+0 (and command+0 on macOS) Resize video window to half its original size. Alt+1 (and command+1 on macOS) Resize video window to its original size. Alt+2 (and command+2 on macOS) Resize video window to double its original size. command + f (macOS only) Toggle fullscreen (see also --fs). (The following keys are valid if you have a keyboard with multimedia keys.) PAUSE Pause. STOP Stop playing and quit. PREVIOUS and NEXT Seek backward/forward 1 minute. If you miss some older key bindings, look at etc/restore-old-bindings.conf in the mpv git repository. Mouse Control Left double click Toggle fullscreen on/off. Right click Toggle pause on/off. Forward/Back button Skip to next/previous entry in playlist.