Copied to clipboard!
mpvFILE
# Playback Control
| Command | Input | Description |
|---|---|---|
| Speed | Slow down or speed up playback by the factor given as parameter. More Info | |
| Seek Start | Seek to a given time position. Format: [+|-][[hh:]mm:]ss[.ms]. More Info | |
| Seek End | Stop at a given time. Format: [+|-][[hh:]mm:]ss[.ms]. More Info | |
| Seek Length | Stop after a given time relative to the start time. Format: [+|-][[hh:]mm:]ss[.ms]. More Info | |
| Play by Frames | Play the first NUMBER of frames, then quit. More Info | |
| Pause | Place the player in a paused stated. More Info | |
| Shuffle Files | Play files in random order. More Info |
# Loops
| Command | Input | Description |
|---|---|---|
| Loop Through Playlist | Loops through the entire playlist. Accepts: inf (Infinite), no (Disable loop),[NUMBER] (Total loops). More Info | |
| Loop A File | Loops a single file. Accepts: inf (Infinite), no (Disable loop),[NUMBER] (Total loops). More Info | |
| A/B Looping | Set loop points. Loops from point a to b. Looping will start when video reaches between a or b. Format: [[hh:]mm:]ss[.ms]. More Info | |
| A/B Loop Count | Number of times to loop A/B points. Default: inf. Accepts: inf (Infinite) & [NUMBER]. More Info |
# Video
| Command | Input | Description |
|---|---|---|
| Prioritize Video Output Drivers | Specify a priority list of video output drivers to use. Video Output Drivers | More Info | |
| Prioritize Video Decoders | Specify a priority list of video decoders to use. More Info | |
| Video Filters | Specify a list of video filters to apply to a video stream. Video Filters List | Filter Syntax | More Info | |
| Scale Multiplier | Scale the video display size by a multiple. Default: 1.0. More Info | |
| Position Multiplier | Moves the video display by a fraction of its size. More Info | |
| Pan and Scan | Enables pan-and-scan functionality. Attempts to crop a 16:9 video into a 4:3 display.NUMBER determines how much of the image is cropped. More Info | |
| Video Unscaled | Disable scaling of the video. This disables the effects of Pan and Scan. More Info | |
| Override Aspect | Override video aspect ratio. Accepts: W:H or DECIMAL(ratio), 0 (Disables ratio handling). More Info | |
| Frame Drop | Skip displaying some frames to maintain audio/video sync. More Info | |
| Video Sync | Determines how the player synchronizes audio & video. More Info |
# Audio
| Command | Input | Description |
|---|---|---|
| Volume | Set volume on startup. More Info | |
| Mute | Mute audio on startup. More Info | |
| Audio Files | Play audio from external file(s) while viewing a video. Use : (Unix) or ; (Windows) as separator. More Info | |
| Prioritize Audio Output Drivers | Specify a priority list of audio output drivers to use. Audio Output Drivers | More Info | |
| Audio Decoders | Specify a priority list of audio decoders to use. More Info | |
| Audio Filters | Specify a list of audio filters to apply to an audio stream. Audio Filter List | Filter Syntax | More Info | |
| Audio Delay | Delay the audio in SECONDS. Positive values delay audio. Negative values delay video. More Info | |
| Audio Channels | Control which audio channels are output. More Info | |
| Audio Display | Determines whether to display cover art when playing audio files and with what priority. Default: embedded-first. More Info |
# Subtitles
| Command | Input | Description |
|---|---|---|
| Subtitle Files | Add a subtitle file to the list of external subtitles. Use : (Unix) or ; (Windows) as separator. More Info | |
| Scale Multiplier | Subtitle font size by scale factor. Default: 1. More Info | |
| Vertical Position | Specify the vertical position of the subtitle in PERCENT of the screen height. More Info | |
| Speed | Multiply the subtitle event timestamps with the DECIMAL value. Only affects text subtitles. More Info | |
| Subtitle Delay | Delays subtitles by SECONDS. Values can be negative. More Info | |
| Fix Timing | Adjust subtitle timing to remove minor gaps or overlaps between subtitles. More Info | |
| Hide | Hide subtitles. More Info |
# Font Style
| Command | Input | Description |
|---|---|---|
| Color | Specify the color of the unstyled subtitle font. Format: Red/Green/Blue/Alpha where each ranges from 0.0 to 1.0. More Info | |
| Background Color | Specify color for subtitle text background. Format: Red/Green/Blue/Alpha where each ranges from 0.0 to 1.0. More Info | |
| Size | Specify the subtitle font size. Default: 55. More Info | |
| Bold | Makes text subtitles bold. More Info | |
| Italic | Makes text subtitles italic. More Info | |
| Border Color | Specify color for the subtitle font border. Format: Red/Green/Blue/Alpha where each ranges from 0.0 to 1.0. More Info | |
| Border Size | Size of the sub font border in scaled pixels. 0 disables border. Default: 3. More Info | |
| Shadow Color | Specify the shadow color of the subtitle text. Format: Red/Green/Blue/Alpha where each ranges from 0.0 to 1.0. More Info | |
| Shadow Offset | Displacement of the sub text shadow in scaled pixels. Default: 0 (Disable shadows). More Info | |
| Horizontal Alignment | Corner of the screen text subtitles should be horizontally aligned to. Default: center. More Info | |
| Vertical Alignment | Corner of the screen text subtitles should be vertically aligned to. Default: bottom. More Info | |
| Blur Effect Multiplier | Apply Gaussian blur by DECIMAL. Default: 0 (no blur). More Info |
# Track Selection
| Command | Input | Description |
|---|---|---|
| Prioritize Audio Languages | Specify a priority list of audio languages to use. Accepts: ISO 639-1 and ISO 639-2 language codes. More Info | |
| Prioritize Subtitle Languages | Specify a priority list of subtitle languages to use. Accepts: ISO 639-1 and ISO 639-2 language codes. More Info | |
| Prioritize Video Languages | Specify a priority list of video languages to use. Accepts: ISO 639-1 and ISO 639-2 language codes. More Info | |
| Select Audio Track | Select an audio track to use. Accepts: no, auto (selects default), and [NUMBER] (1 = first audio track). More Info | |
| Select Subtitle Stream | Select a subtitle stream to use. Accepts: no, auto (selects default), and [NUMBER] (1 = first subtitle stream). More Info | |
| Select Video Channel | Select a video channel to use. Accepts: no, auto (selects default), and[NUMBER] (1 = first video channel). More Info | |
| Subs & Audio Mismatch | When autoselecting a subtitle track, only show subtitles for foreign audio or onscreen text. More Info |
# Playlist
| Command | Input | Description |
|---|---|---|
| Playlist File | Play files according to a playlist file. More Info | |
| Playlist Start | From the playlist, select the file to start with. Accepts: auto & [INDEX] (0 = first file in playlist). More Info | |
| Allow Unsafe Playlists | Load URLs from playlists which are considered unsafe. More Info |
# Chapters
| Command | Input | Description |
|---|---|---|
| Chapter File | Load chapters from this file, instead of main file. More Info | |
| Ordered Chapter Files | Loads the given file as playlist, and tries to use the files contained in it as reference files when opening a Matroska file that uses ordered chapters. More Info | |
| Select Edition | MKV files only. Specify set of chapters (edition) to use, where 0 is the first set. Default: auto. More Info | |
| No Ordered Chapters | Disable support for Matroska (.mkv) ordered chapters. More Info |
# Image/Screenshot
| Command | Input | Description |
|---|---|---|
| JPEG Quality | Set the JPEG quality level for screenshots. Default: 90. More Info | |
| PNG Compression | Set the PNG compression level. Default: 7. More Info | |
| WebP Quality | Set the WebP quality level. Default: 75. More Info | |
| Webp Compression | Set the WEBP compression level. Default: 4. More Info | |
| Screenshot Format | Set the image file type used for saving screenshots. Default: jpeg. More Info | |
| No High Bit Depth | Do not write screenshots with a bit depth similar to the source video. More Info | |
| Screenshot Directory | Store screenshots in this directory. If directory does not exist, it is created. More Info | |
| Screenshot Template | Specify the filename template used to save screenshots. More Info | |
| Display Duration | If an image, display it for SECONDS long. Accepts: SECONDS or inf (Infinite).More Info |
# Equalizer
| Command | Input | Description |
|---|---|---|
| Brightness | Adjust the brightness of the video. Not supported by all video output drivers. Default: 0. More Info | |
| Contrast | Adjust the contrast of the video. Not supported by all video output drivers. Default: 0. More Info | |
| Saturation | Adjust the saturation of the video. Not supported by all video output drivers. Default: 0. More Info | |
| Gamma | Adjust the gamma of the video. Not supported by all video output drivers. Default: 0. More Info | |
| Hue | Adjust the hue of the video. Not supported by all video output drivers. Default: 0. More Info |
# Program Behavior
| Command | Input | Description |
|---|---|---|
| Save Position on Quit | Save the current playback position on quit. Only works when quitting normally! More Info |
# Window
| Command | Input | Description |
|---|---|---|
| Title | Set the window title. More Info | |
| Screen | In multi-monitor configurations, set screen to display the video on. More Info | |
| Scale Multiplier | Resize the video window by a factor. More Info | |
| FullScreen | In multi-monitor configurations, set screen to go fullscreen. Accepts 0-32, all, or current. More Info | |
| No Window Border | Disable the standard window border & decorations. More Info | |
| Stay On Top | Makes the player window stay on top of other windows. More Info | |
| Disable Dragging | Disable moving the window when clicking on it and moving the mouse pointer. More Info |
# Network
| Command | Input | Description |
|---|---|---|
| User Agent | Set the user agent for HTTP streaming. More Info | |
| Support Cookies | Support cookies when making HTTP requests. More Info | |
| Cookies File | Read HTTP cookies from FILE. Must be in Netscape format! More Info | |
| HTTP Headers | Set custom HTTP fields when accessing HTTP stream. More Info | |
| HTTP Proxy | URL of the HTTP/HTTPS proxy. Ignored if it does not start with http://. More Info |
# Devices
| Command | Input | Description |
|---|---|---|
| CD-ROM | Specify the CD-ROM device. Default: /dev/cdrom. More Info | |
| DVD | Specify the DVD device or .iso filename. Default: /dev/dvd. More Info | |
| Blu-ray | Specify the Blu-ray disc location. Must be a directory with Blu-ray structure. More Info | |
| DVD Speed | Try to limit DVD speed. SPEED of at least 100 is in kB/s. SPEED less than 100 are multiples of 1385 kB/s. Default: 0. More Info | |
| CD Audio Speed | Set spin speed for CD Audio. More Info |