mpv
a media player
Copyright: GPLv2+
Manual
section:
1
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
RESUMING PLAYBACK 27
PROTOCOLS 28
PSEUDO GUI MODE 31
Linux desktop issues 32
Disabling Screensaver 32
OPTIONS 33
Track Selection 33
Playback Control 35
Program Behavior 42
Watch Later 47
Video 48
Audio 59
Subtitles 65
Window 77
Disc Devices 85
Equalizer 86
Demuxer 86
Input 91
OSD 94
Screenshot 97
Software Scaler 100
Audio Resampler 101
Terminal 102
Cache 104
Network 106
DVB 108
ALSA audio output options 108
GPU renderer options 109
Miscellaneous 134
AUDIO OUTPUT DRIVERS 140
VIDEO OUTPUT DRIVERS 144
AUDIO FILTERS 156
VIDEO FILTERS 160
ENCODING 173
COMMAND INTERFACE 175
input.conf 175
input.conf syntax 175
Key names 176
Flat command syntax 177
Commands specified as arrays 177
Named arguments 178
List of Input Commands 178
Input Commands that are Possibly Subject to Change 187
List of events 195
Hooks 197
Input Command Prefixes 198
Synchronous vs. Asynchronous 199
Asynchronous command details 200
Input Sections 200
Properties 200
Property list 200
Inconsistencies between options and properties 223
Property Expansion 223
Raw and Formatted Properties 224
ON SCREEN CONTROLLER 226
Using the OSC 226
The Interface 226
Key Bindings 227
Configuration 227
Config Syntax 227
Command-line Syntax 228
Configurable Options 228
Script Commands 231
STATS 233
Usage 233
Font 233
Configuration 233
Configurable Options 233
Different key bindings 235
Active key bindings page 235
Internal stuff page 235
CONSOLE 237
Keybindings 237
Commands 238
Known issues 238
Configuration 238
Configurable Options 238
LUA SCRIPTING 240
Example 240
Script location 240
Details on the script initialization and lifecycle 241
mp functions 241
Advanced mp functions 246
mp.msg functions 248
mp.options functions 248
mp.utils functions 249
Events 251
Extras 251
JAVASCRIPT 253
Example 253
Similarities with Lua 253
Differences from Lua 253
Language features - ECMAScript 5 253
Unsupported Lua APIs and their JS alternatives 253
Scripting APIs - identical to Lua 254
Additional utilities 255
Timers (global) 256
CommonJS modules and require(id) 257
Custom initialization 257
The event loop 257
JSON IPC 259
Socat example 259
Command Prompt example 259
Protocol 260
Data flow 261
Asynchronous commands 261
Commands with named arguments 261
Commands 261
UTF-8 263
JSON extensions 263
Alternative ways of starting clients 264
CHANGELOG 265
EMBEDDING INTO OTHER PROGRAMS (LIBMPV) 266
C PLUGINS 267
C plugins location 267
API 267
Linkage to libmpv 267
Examples 267
ENVIRONMENT VARIABLES 268
EXIT CODES 270
FILES 271
FILES ON WINDOWS 273