mpv(1) multimedia mpv(1) (NAME) mpv - (SYNOPSIS) mpv [options] [file|URL|PLAYLIST|-] mpv [options] files (DESCRIPTION) mpv MPlayer mplayer2 . . URL . . . (INTERACTIVE CONTROL) mpv mpv ( LIRC - ). --input- . . etc/input.conf mpv . input.conf Lua . COMMAND INTERFACE Key names . --input-test ( ) stats . ? . (Keyboard Control) LEFT and RIGHT /. Shift+arrow ( --hr-seek ). UP and DOWN /. Shift+arrow ( --hr-seek ). Ctrl+LEFT and Ctrl+RIGHT /. sub-seek . Ctrl+Shift+LEFT and Ctrl+Shift+RIGHT . . [ and ] / . { and } / . BACKSPACE . Shift+BACKSPACE (Undo). . . revert-seek . Shift+Ctrl+BACKSPACE . Shift+BACKSPACE ( ). . < and > / (playlist). ENTER (playlist). Shift+HOME and Shift+END / (playlist). p and SPACE ( ). . . . , . . q . Q q . . RESUMING PLAYBACK . / and * / . KP_DIVIDE and KP_MULTIPLY / . 9 and 0 / . m (Mute). _ . # . E (Editions) . f ( --fs ). ESC . T ( --ontop ). w and W / pan-and-scan. e W . --panscan . o and P OSD. O OSD / . v ..TP Alt+v (/). j J . z Z -/+ 0.1 . x Z . l / A-B. ab-loop . L (/). Ctrl++ Ctrl+- ( /) +/- 0.1 . Ctrl+KP_ADD Ctrl+KP_SUBTRACT ( /) +/- 0.1 . G F +/- 10%. u --sub-ass-* () SSA/ASS . --sub-ass-override . V ASS . --sub-ass-use-video-data . r R /. t R . s . S . ( VO .) Ctrl+s ( OSD ). HOME . PGUP PGDWN /. "" --chapter-seek-threshold . Shift+PGUP Shift+PGDWN . ( Shift PGUP/PGDWN .) b / (debanding). d (deinterlacing). A (aspect ratio). Ctrl+h (/). Alt+LEFT, Alt+RIGHT, Alt+UP, Alt+DOWN ( panning). Alt++ Alt+- (zoom). Alt+KP_ADD Alt+KP_SUBTRACT . Alt+BACKSPACE (pan/zoom). F8 . F9 . Ctrl+v URL . . clipboard . i I / (overlay) . STATS . ? (overlay) . STATS . DEL OSC never / auto ( ) / always ` . (ESC . CONSOLE .) ( .) 1 2 . 3 4 . 5 6 . 7 8 (saturation). Alt+0 ( Command+0 macOS) . Alt+1 ( Command+1 macOS) . Alt+2 ( Command+2 macOS) . Command + f ( macOS) ( --fs ). ( : Down Ctrl+n Up Ctrl+p Page down Ctrl+f Page up Ctrl+b .) . g-p . g-s . g-S . g-a . g-v . g-t . g-c . g-e MKV DVD/Blu-ray. g-l . ffmpeg PATH mpv Windows ..TP g-d . g-h . --save-watch-history . g-w ( RESUMING PLAYBACK ) . --write-filename-in-watch-later-config . g-b (input binding) . g-r (properties). g-m, MENU, Ctrl+p . SELECT . ( .) PAUSE . STOP . PREVIOUS and NEXT / . ZOOMIN and ZOOMOUT . etc/restore-old-bindings.conf mpv . (Mouse Control) Ctrl+left click (Pan) . Left double click (/). Right click (/). Forward/Back button / . Wheel up/down / . Wheel left/right / . Ctrl+Wheel up/down . (Context Menu) (Context Menu) ( ) . menu-data context-menu . (USAGE) - URL . (flag) ( yes ) --option=value . - ( ) stdin . -- ( ) - . ( - ./- .) flag no-flag --fs --no-fs . --fs=yes --fs --fs=no --no-fs . (XXX only) XXX XXX ..SS (Legacy option syntax) --option=value -option value -option=value . MPlayer . . . mpv -fs no no --fs (flag) . . mpv 0.31.0 -- - . mpv = . mpv --log-file f.txt f.txt --log-file f.txt ( mpv f.txt). -option value - -- . (Escaping spaces and other special characters) (shell) mpv . (quote) (escape) : mpv "filename with spaces.mkv" --title="window title" (suboption parser) . . " [...] . %n% . foo : mpv test.mkv --vf=foo:option1=value1:option2:option3=value3,bar option1 option3 foo option2 ( option2=yes) bar . , : : mpv '--vf=foo:option1="option value with spaces",bar' mpv " . [...] [ ] . ( bash) . ( mpv 0.9.0 ): [ ] ] [ . ( [a[b]c] a[b]c .) . % : %n%string_of_length_n (Examples) mpv '--vf=foo:option1=%11%quoted text' test.avi : mpv --vf=foo:option1=%`expr length "$NAME"`%"$NAME" test.avi : JSON-IPC %n% UTF-8 JSON . API . mpv_set_option_string() --name=data ( ). . --vf MPV_FORMAT_NODE (maps) ..SS " (Paths)" mpv . - . :// :// UNIX . mpv / ./ . file:// (unescaping) URL . - stdin mpv . ( stdin .) -- mpv . mpv ( : , ) (escape) . << >> %n%string_of_length_n ( ). API libmpv mpv_command_string loadfile mpv_command . API mp.command API << >> mp.commandv mp.command_native . mpv ~ mpv . ~ / . ~ ~/ . / : : --no-config << >> (~~/ ~~home/ ~~global/) . ~~home/ ~~home/foo/bar" (foo/bar) . . << >> . +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ | | | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~/ | | | | | | | ( ~/ | | | $HOME/ | | | ). | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~/ | | | | | | | | | | mpv | | | | | | | | | / | | | | | | | | | . | | | | | | ~~home/ . | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~home/ | | | | mpv | | | ( | | | ~/.config/mpv/). | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~global/ | | | | ( | | | /etc/mpv) | | | ( win32). | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~osxbundle/ | bundle | | | macOS ( macOS). | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~desktop/ | . | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~exe_dir/ | | | | mpv.exe ( | | | | | | | | | $MPV_HOME | | | | | | ) ( | | | win32). | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~cache/ | | | | (cache) | | | (~/.cache/mpv/). | | | | | | ~~home/ | | | | | | . | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~state/ | | | | (state) | | | | | | (~/.local/state/mpv/). | | | | | | | | | ~~home/ | | | | | | . | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |~~old_home/ | . | | (Per-File Options) | | | . : | | |0.0 | | |3.5 | | | | | |mpv --a file1.mkv --b file2.mkv --c | | | | | | | | |168u | | | | | |168u | | |box center; | | |l|l. | | | | | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |file1.mkv | --a --b --c | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ |file2.mkv | --a --b --c | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------+ ( MPlayer mplayer2 .) ( ) . . --{ --} . ( escape .) : mpv --a file1.mkv --b --\{ --c file2.mkv --d file3.mkv --e --\} file4.mkv --f +-------------+-----------------------------+ | | | | | | +-------------+-----------------------------+ |file1.mkv | --a --b --f | +-------------+-----------------------------+ |file2.mkv | --a --b --f --c --d --e | +-------------+-----------------------------+ |file3.mkv | --a --b --f --c --d --e | +-------------+-----------------------------+ |file4.mkv | --a --b --f | +-------------+-----------------------------+ . --c file2.mkv file3.mkv . --a ..SS (List Options) . --display-tags , --display-tags-append (escape) , . (String list and path list options) , . . , : () ; () . : +----------------+---------------------------------+ | | | +----------------+---------------------------------+ |-set | | | | | | | ( | | | | | | | | | | | | | | | ) | +----------------+---------------------------------+ |-append | | | | | | | ( | | | | | | | | | ) | +----------------+---------------------------------+ |-add | | | | | | | ( | | | | | | -set) | +----------------+---------------------------------+ |-pre | | | | | | | | | | ( | | | | | | -set) | +----------------+---------------------------------+ |-clr | | | | ( | | | ) | +----------------+---------------------------------+ |-del | | | | | | | | | | ( | | | | | | -set) | +----------------+---------------------------------+ |-remove | | | | | | | ( | | | | | | | | | ) | +----------------+---------------------------------+ |-toggle | | | | | | | | | | | | | | | | | | | ( | | | | | | ) | +----------------+---------------------------------+ -append ( ). / (Key/value list options) / / . (map) (dictionary) . . : +----------------+---------------------------------+ | | | +----------------+---------------------------------+ |-set | | | | | | | ( | | | , | | | | | | ) | +----------------+---------------------------------+ |-append | | | | | | | ( | | | | | | | | | ) | +----------------+---------------------------------+ |-add | | | | | | | ( | | | | | | -set) | +----------------+---------------------------------+ |-clr | | | | ( | | | ) | +----------------+---------------------------------+ |-del | | | | | | | | | | ( | | | | | | -set) | +----------------+---------------------------------+ |-remove | | | | | | | | | | ( | | | | | | | | | ) | +----------------+---------------------------------+ . . , -append . libmpv MPV_FORMAT_NODE_MAP JSON IPC . mpv 0.33 : -set ..SS (Object settings list options) --af --vf . . VIDEO FILTERS . : +----------------+-----------------------------------+ | | | +----------------+-----------------------------------+ |-set | | | | | | | ( | | | , | | | | | | ) | +----------------+-----------------------------------+ |-append | | | | | | | | +----------------+-----------------------------------+ |-add | | | | | | | ( | | | | | | -set) | +----------------+-----------------------------------+ |-pre | | | | | | | ( | | | | | | -set) | +----------------+-----------------------------------+ |-clr | | | | ( | | | ) | +----------------+-----------------------------------+ |-remove | | | | | | | ( | | | | | | -set) | +----------------+-----------------------------------+ |-toggle | | | | | | | | | | | | | | | | | +----------------+-----------------------------------+ |-help | | | | | | | | | | | | | | +----------------+-----------------------------------+ (General) -set . -add -pre . -append ( , ). ( --sub-file --audio-file --glsl-shader) -append . --sub-file --sub-files-append . change-list ( -) . ..SH " (CONFIGURATION FILES)" (Location and Syntax) mpv . 'mpv.conf' ( /etc/mpv /usr/local/etc/mpv) ~/.config/mpv/mpv.conf . ( Windows) FILES . . option=value . # . yes no yes . . # . autofit-larger=100%x100% # =yes . hwdec # . osd-playing-msg=File: ${filename} (Escaping special characters) . " ' (%n%) . . C ( ). # " ' % . (Putting Command Line Options into the Configuration File) . : +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------+ | | | | | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------+ |--flag | flag | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------+ |-opt val | opt=val | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------+ |--opt=val | opt=val | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------+ |-opt "has spaces" | opt=has spaces | | . 'video.avi' 'video.avi.conf' ~/.config/mpv/ . . --use-filedir-conf ( ) . ~/.config/mpv . --use-filedir-conf . mpv mpv.conf . | | | | | | . [my-profile]. . ( --profile=help ) profile-desc . default . | | | --profile=help --show-profile= ( ). --profile= apply-profile . | | |0.0 | | |3.5 | | |" mpv " | | |0.0 | | |3.5 | | | | | |# normal top-level option | | |fullscreen=yes | | | | | |# a profile that can be enabled with --profile=big-cache | | |[big-cache] | | |cache=yes | | |demuxer-max-bytes=512MiB | | |demuxer-readahead-secs=20 | | | | | |[network] | | |profile-desc="profile for content over network" | | |force-window=immediate | | |# you can also include other profiles | | |profile=big-cache | | | | | |[reduce-judder] | | |video-sync=display-resample | | |interpolation=yes | | | | | |# using a profile again extends it | | |[network] | | |demuxer-max-back-bytes=512MiB | | |# reference a builtin profile | | |profile=fast | | | | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |168u | | | | | | apply-profile . "" ( ) . | | | apply-profile restore . | | | profile-restore : | | |0.0 | | |3.5 | | |0.0 | | | | | |default | | | (). | | | | | |copy | | | . . | | | . ( apply-profile name ) . . | | | "undo" () . vf-add vf . vf vf-add ( vf-remove ) __. | | | ( profile) . . ( ) . | | | | | |copy-equal | | | copy . . | | | | | |168u | | | | | |168u | | | | | |168u | | |0.0 | | |3.5 | | |"" | | |0.0 | | |3.5 | | | | | |[something] | | |profile-restore=copy-equal | | |vf-add=rotate=PI/2 # rotate by 90 degrees | | | | | | | | |168u | | | | | |168u | | | : | | |0.0 | | |3.5 | | | | | |set vf vflip | | |apply-profile something | | |vf add hflip | | |apply-profile something | | |# vf == vflip,rotate=PI/2,hflip,rotate=PI/2 | | |apply-profile something restore | | |# vf == vflip | | | | | | | | |168u | | | | | |168u | | | | | |168u | | | | | | profile-cond ( ). Lua . (truthy) . (falsy) . Lua (sandbox) . | | | . Lua mpv . pause . - _ - . playback_time playback-time . | | | p.property_name get("property-name", default_value) . ( pause() pause pause ). | | | nil . (verbose) (false) . | | | . . | | | " " . profile-restore . . | | | . | | |0.0 | | |3.5 | | |"" | | | HD: | | |0.0 | | |3.5 | | | | | |[something] | | |profile-desc=HD video sucks | | |profile-cond=width >= 1280 | | |hue=-50 | | | | | | | | |168u | | | | | |168u | | | "youtube" "youtu.be" : | | |0.0 | | |3.5 | | | | | |[youtube] | | |profile-cond=path:find('youtu%.?be') | | |gamma=20 | | | | | | | | |168u | | | | | |168u | | | (false) profile-restore : | | |0.0 | | |3.5 | | | | | |[something] | | |profile-desc=Mess up video when entering fullscreen | | |profile-cond=fullscreen | | |profile-restore=copy | | |vf-add=rotate=PI/2 # rotate by 90 degrees | | | | | | | | |168u | | | | | |168u | | | rotate . vf . . : | | |0.0 | | |3.5 | | | | | |[something] | | |profile-cond=fullscreen | | |vf-add=@rot:rotate=PI/2 | | | | | |[something-inv] | | |profile-cond=not fullscreen | | |vf-remove=@rot | | | | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |168u | | |: | | |0.0 | | |3.5 | | | . p.playback_time . . | | | | | |168u | | | | | |168u | | | Lua . Lua . : | | |0.0 | | | | | |(function environment table) | | | Lua . . Lua . | | | "" mpv . _G mpv . _ - . mp.get_property_native(name) . . | | | _ get() ( ). | | | (metamethod) __index . | | | | | |p | | | "" . _G - . | | | | | |get(name [, def]) | | | . nil ( ) def . | | | mp.get_property_native(name) . ( ). . | | | "" . _ . | | | | | |168u | | | Lua mpv . math Lua . | | |: | | |0.0 | | |3.5 | | | . mpv . | | | | | |168u | | | (legacy) . | | | : | | |0.0 | | |3.5 | | |" (Auto profile loading)" | | |0.0 | | |3.5 | | | | | |[extension.mkv] | | |profile-desc="profile for .mkv files" | | |vf=vflip | | | | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |168u | | | type.name type | | |protocol / ( --list-protocols ) | | | extension | | |( ). | | | (soft-deprecated) . | | | . | | |" mpv (USING MPV FROM OTHER PROGRAMS OR SCRIPTS)" | | | mpv : | | |0.0 | | |3.5 | | |0.0 | | |1. 3 | | | UNIX. (parse) . | | | . | | | . . | | | --terminal=no . | | | stdin mpv . | | | --input-ipc-server | | |--input-ipc-client . JSON IPC | | | unix domain socket ( named pipe Windows) . | | | --no-config --config-dir | | | mpv | | | CLI . | | | --input-ipc-server --input-ipc-client | | | ( IPC "" | | | ). | | |2. 3 | | | libmpv. mpv (backend) | | | . C API | | | CLI API . | | | libmpv | | | CLI ( | | | ). | | | EMBEDDING INTO OTHER PROGRAMS (LIBMPV) . | | |3. 3 | | | (LUA SCRIPTING JAVASCRIPT C PLUGINS). | | | "" CLI . | | | API mpv . | | | (third-party) . | | | | | |168u | | | | | |168u | | | | | |168u | | | API | | | : OPTIONS | | |List of Input Commands Properties List of events ( C API ) | | |Hooks. | | |" (TAKING SCREENSHOTS)" | | | () 'screenshot' | | | s . | | |mpv-shotNNNN.jpg | | | - . pseudo-GUI | | | . PSEUDO GUI MODE . | | | | | | . S | | | s . | | | MPlayer screenshot . | | | mpv ..SH " (TERMINAL STATUS LINE)" | | | mpv . : | | |0.0 | | |3.5 | | |AV: 00:03:12 / 00:24:25 (13%) A-V: -0.000 | | | | | |168u | | | | | |168u | | | --term-status-msg . | | | . (properties) . | | |0.0 | | |o 2 | | |AV: V: ( ) A: ( ) | | |o 2 | | | HH:MM:SS ( playback-time) | | |o 2 | | | ( ) ( duration) | | |o 2 | | | x2.0. . ( ). ( speed.) | | |o 2 | | | (13%). . ( ) . ( percent-pos.) | | |o 2 | | | A-V: 0.000. . 0 0 . . ( avsync.) | | |o 2 | | | / ct: -0.417. . " " . . ( total-avsync-change.) | | |o 2 | | | {...} . | | |o 2 | | | (Display sync). ( display-sync-active) DS: 2.500/13 vsync ( 2.5 24Hz 60Hz) (vsync-ratio) vsync ( vo-delayed-frame-count). (heuristic) . | | |o 2 | | | (Dropped frames) Dropped: 4. . () . ("hiccups") . ( frame-drop-count.) | | | (decoder) : Dropped: 4/34. --framedrop . ( decoder-frame-drop-count.) | | |o 2 | | | (Cache) Cache: 2s/134KB. (stream cache) . demuxer . ( demuxer-cache-duration demuxer-cache-state.) | | | | | |168u | | |" (LOW LATENCY PLAYBACK)" | | | mpv . (latency) . . | | | low-latency . --profile=low-latency . --show-profile=low-latency ( mpv ). | | | . | | | . --untimed . | | | MJPEG . . --untimed --correct-pts=no --container-fps-override=60 . | | | (livestreams) " " . demuxer . drop-buffers . | | | TCP . | | | : | | |0.0 | | |o 2 | | |--opengl-glfinish=yes | | |o 2 | | |--opengl-swapinterval=0 | | |o 2 | | |--vo=xv | | |o 2 | | | --framedrop=no --speed=1.01 ( ) | | |" (RESUMING PLAYBACK)" | | | mpv . quit-watch-later ( Shift+Q) write-watch-later-config --save-position-on-quit . | | | quit-watch-later --save-position-on-quit mpv ( ) . mpv mpv . | | | mpv / . --watch-later-options . | | | (playlist) mpv . quit-watch-later mpv . | | | Watch Later . | | |" (PROTOCOLS)" | | |mpv://... | | |0.0 | | |3.5 | | | mpv. mpv (URL handler) . . . | | | | | |168u | | | | | |168u | | |http://..., https://, ... | | |0.0 | | |3.5 | | | . mpv . . | | | . (alias) FFmpeg . | | | data: data:// . . lavf:// ffmpeg:// . | | | | | |168u | | | | | |168u | | |ytdl://... | | |0.0 | | |3.5 | | | youtube-dl http(s) . ytdl:// . youtube-dl . | | | youtube-dl --ytdl-raw-options . | | | | | |168u | | | | | |168u | | |- | | |0.0 | | |3.5 | | | stdin ( ). | | | | | |168u | | | | | |168u | | |smb://PATH | | |0.0 | | |3.5 | | | Samba. ( FFmpeg .) | | | | | |168u | | | | | |168u | | |bd://[title][/device] --bluray-device=PATH | | |0.0 | | |3.5 | | | Blu-ray. libbluray 1.0.1 ISO --bluray-device . | | | title : longest first ( ) mpls/ ( .mpls ) ( ). mpv . | | |bluray:// . | | | | | |168u | | | | | |168u | | |dvd://[title][/device] --dvd-device=PATH | | |0.0 | | |3.5 | | | DVD. DVD . (title) . --dvd-device . | | |dvdnav:// dvd:// . | | | | | |168u | | | | | |168u | | |dvb://[cardnumber@]channel --dvbin-... | | |0.0 | | |3.5 | | | DVB. ( .) | | | | | |168u | | | | | |168u | | |mf://[@listfile|filemask|glob|printf-format] --mf-... | | |0.0 | | |3.5 | | | . | | | @ . , , . % POSIX glob * . printf %[.][NUM]d ( NUM ) %% . mf://image-%d.jpg image-1.jpg image-2.jpg image-10.jpg . | | | | | |168u | | | | | |168u | | |cdda://[device] --cdda-device=PATH | | |0.0 | | |3.5 | | | CD. --start --end (chapters) (tracks) . (PGUP PGDOWN ). | | |0.0 | | |3.5 | | |" (Example)" | | |0.0 | | |3.5 | | | | | |mpv cdda:// --start=#4 --end=#6 | | | | | | | | |168u | | | | | |168u | | | . | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |168u | | |lavf://... | | |0.0 | | |3.5 | | | libavformat FFmpeg. // libavformat . | | | | | |168u | | | | | |168u | | |av://type:options | | |0.0 | | |3.5 | | | libavdevice . type (demuxer) libavdevice options ( ) . | | |0.0 | | |3.5 | | |" (Example)" | | |0.0 | | |3.5 | | | | | |mpv av://v4l2:/dev/video0 --profile=low-latency --untimed | | | | | | | | |168u | | | | | | v4l | | | . tv:// . | | | --untimed | | | . ( | | | .) | | | | | |168u | | | | | |168u | | |avdevice:// . | | | | | |168u | | | | | |168u | | |file://PATH | | |0.0 | | |3.5 | | | URL. . | | | PATH / | | | . | | | | | |168u | | | | | |168u | | |appending://PATH | | |0.0 | | |3.5 | | | . | | | . | | | | | | . | | | | | | . | | | (pipe) | | |(something | mpv -). tail | | | tail -f -c +0 file.mkv | mpv -. | | | | | |168u | | | | | |168u | | |fd://123 | | |0.0 | | |3.5 | | | (file descriptor) ( 123). | | | stdin - . | | | "" mpv | | | . | | | | | |168u | | | | | |168u | | |fdclose://123 | | |0.0 | | |3.5 | | | fd:// . | | | URL fd . | | | | | |168u | | | | | |168u | | |edl://[edl specification as in edl-mpv.rst] | | |0.0 | | |3.5 | | | . | | | | | |168u | | | | | |168u | | |slice://start[-end]@URL | | |0.0 | | |3.5 | | | . | | |start end | | | KiB MiB . end . | | | end + start . | | | (seekable) . | | |: | | |0.0 | | |3.5 | | | | | |mpv slice://1g-2g@cap.ts | | | | | | cap.ts 1 GiB | | | 2 GiB . | | | | | |mpv slice://1g-+2g@cap.ts | | | | | | cap.ts 1 GiB | | | 3 GiB . | | | | | |mpv slice://100m@appending://cap.ts | | | | | | cap.ts 100MiB | | | . | | | | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |168u | | |null:// | | |0.0 | | |3.5 | | | . . | | | null (autoprobing) | | | ( ). | | | | | |168u | | | | | |168u | | |memory://data | | |0.0 | | |3.5 | | | data . | | | | | |168u | | | | | |168u | | |hex://data | | |0.0 | | |3.5 | | | memory:// hexdump . | | | | | |168u | | | mpv GUI OSC ( ON SCREEN CONTROLLER) . mpv . | | | : | | |0.0 | | |o 2 | | | mpv.desktop ( ) | | |o 2 | | | explorer.exe ( stdout/stderr/stdin ) | | |o 2 | | | (bundle) macOS | | |o 2 | | | --player-operation-mode=pseudo-gui | | | | | |168u | | | builtin-pseudo-gui --profile=builtin-pseudo-gui . | | | : | | |0.0 | | |3.5 | | | | | |[builtin-pseudo-gui] | | |terminal=no | | |force-window=yes | | |idle=once | | |screenshot-directory=~~desktop/ | | | | | | | | |168u | | | | | |168u | | | pseudo-gui . pseudo-gui . --profile=pseudo-gui mpv : | | |0.0 | | |3.5 | | | | | |[pseudo-gui] | | |player-operation-mode=pseudo-gui | | | | | | | | |168u | | | | | |168u | | |: | | |0.0 | | |3.5 | | | pseudo-gui . . mpv / . | | | | | |168u | | | | | |168u | | |" (OPTIONS)" | | |" (Track Selection)" | | |0.0 | | | | | |--alang= | | | IETF . ISO 639-1 ISO 639-2 . . . --aid . | | | . (List Options) . | | |7.0 | | |3.5 | | |" (Examples)" | | |0.0 | | |o 2 | | | mpv dvd://1 --alang=hu,en DVD . | | |o 2 | | | mpv --alang=jpn example.mkv Matroska . | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |--slang= | | | --alang . | | | . (List Options) . | | |7.0 | | |3.5 | | |" (Examples)" | | |0.0 | | |o 2 | | | mpv dvd://1 --slang=hu,en DVD . | | |o 2 | | | mpv --slang=jpn example.mkv Matroska . | | |o 2 | | | mpv --slang=pt-BR example.mkv Matroska . | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |--vlang=<...> | | | --alang --slang . | | | . (List Options) . | | | | | |--aid= | | | . auto no . --alang . mpv . | | | --audio --aid . | | | --aid=no --audio=no . | | |: | | |7.0 | | |3.5 | | | ( --aid --sid ) . mpv . | | | ( ) . --aid=auto aid 2 ( ). | | | mpv 0.32.0 ( ) ( --aid=2 ) aid no . aid 2 aid 2 . | | | mpv 0.33.0 . auto . . mpv 0.33.0 . | | | mpv 0.33.0 . . . | | | (fingerprint) . | | | : | | |mpv --aid=2 file_with_2_audio_tracks.mkv file_with_1_audio_track.mkv | | | . . --aid=2 set aid 2 . . | | | . | | | | | |168u | | | | | |168u | | | | | |--sid= | | | . auto no . | | | --sub --sid . | | | --sid=no --sub=no ..TP | | |--vid= | | | . auto no . | | |--video --vid . | | |--vid=no --video=no . | | | youtube-dl mpv . ytdl_format "bestaudio/best" ytdl_hook.lua . | | | | | |--edition= | | |( Matroska) | | | ( ) 0 . auto () mpv . | | | | | |--track-auto-selection= | | | (: yes). --aid --alang . . ( ). | | | --lavfi-complex : . --lavfi-complex . | | | | | |--subs-with-matching-audio= | | | (: yes). no --slang subs-fallback mpv . forced (forced) . | | | | | |--subs-match-os-language= | | | ( ) . --slang (: yes). | | | | | |--subs-fallback= | | | (: default). default default . | | | | | |--subs-fallback-forced= | | | yes . always . no . | | | | | |168u | | | (Playback Control) | | |0.0 | | | | | |--start= | | | . | | | [+|-][[hh:]mm:]ss[.ms] . - ( demuxer/) . + ( ). | | | : | | |pp% pp (0-100). | | |#c c . ( 1 .) | | |none ( libmpv ). | | | --rebase-start-time=no + . . + - ( ). | | |7.0 | | |3.5 | | |" (Examples)" | | |0.0 | | | | | |--start=+56, --start=00:56 | | | + 56 . | | | | | |--start=-56, --start=-00:56 | | | - 56 . | | | | | |--start=01:10:00 | | | . | | | | | |--start=50% | | | . | | | | | |--start=30 --end=40 | | | 30 10 . | | | | | |--start=-3:20 --length=10 | | | . | | | | | |--start='#2' --end='#4' | | | . | | | | | |168u | | | | | |168u | | | | | |168u | | | | | |--end= | | | . --start --length . --start . | | | | | |--length= | | | . | | | --start . | | | --end --length . | | | : --rebase-start-time=no --start "" . | | | | | |--rebase-start-time= | | | 00:00:00 (: yes). (transport streams) . . no . | | | | | |--speed=<0.01-100> | | | . | | | --audio-pitch-correction ( ) scaletempo2 . | | | | | |--pitch=<0.01-100> | | | (pitch) . . scaletempo2 . | | | (resampling) min-speed max-speed scaletempo2 : min-speed 0.25 4 (1/0.25) . | | | 2^(1/12) . . | | |7.0 | | |3.5 | | |" (Examples)" | | |0.0 | | | | | |--pitch=2 | | | . | | | | | |--pitch=0.5 | | | . | | | | | |--pitch=1.498307 (2^(7/12)) | | | (perfect fifth) . | | | | | |--pitch=0.667420 (2^(-7/12)) | | | . | | | | | |--pitch=1.059463 (2^(1/12)) | | | . | | | | | |--pitch=0.943874 (2^(-1/12)) | | | . | | | | | |168u | | | | | |168u | | | | | |--pause | | | . | | | | | |--shuffle | | | . | | | | | |--playlist-start= | | | . 0 . auto (). mpv . ( ). mpv mpv playlist.m3u --playlist-start=123 playlist.m3u . | | | no auto . | | | | | |--playlist= | | | . . . . XML . | | | --demuxer=playlist . CUE . . | | | . 0.31.0 mpv 0.31.0 . --load-unsafe-playlists . : | | |7.0 | | |3.5 | | |mpv --{ --playlist=filename --load-unsafe-playlists --} | | | | | |168u | | | | | |168u | | |: | | |7.0 | | |3.5 | | | mpv --playlist . . mpv 0.31.0 MPlayer --playlist . mpv 0.31.0 --playlist . | | | avdevice:// ( ). | | | | | |168u | | | | | |168u | | | | | |--chapter-merge-threshold= | | | (: 100). Matroska . (seek) . | | | | | |--chapter-seek-threshold= | | | (: 5.0). . . | | | | | |--hr-seek= | | | . . . . | | |7.0 | | | | | |no | | | . | | | | | |absolute | | | ( ) . | | | | | |default | | | absolute hr-seek . (). | | | | | |yes | | | . | | | | | |always | | | yes ( ). | | | | | |168u | | | | | |--hr-seek-demuxer-offset= | | | ( --hr-seek) . . . 1.5 60 58.5 60 . . | | | | | |--hr-seek-framedrop= | | | (drop) . . deinterlacing (backstepping) . | | |: yes | | | | | |--index= | | | . (index) . . | | |7.0 | | | | | |default | | | | | | | | |recreate | | | | | | | | |168u | | |: | | |7.0 | | |3.5 | | | ( stdin pipe ). | | | | | |168u | | | | | |168u | | | | | |--load-unsafe-playlists | | | (URL) (: no). . HTTP . | | | . ( mpv loadfile .) | | | | | |--access-references= | | | (: yes). ( ) . . mov . | | | FFmpeg . FFmpeg . | | | . --autoload-files=no . | | | ( dvd://directory ). ./ / . | | | | | |--loop-playlist=, --loop-playlist | | | N () . 1 () 2 . inf . no 1 . . --loop-playlist --loop-playlist=inf ..sp | | | force inf . CPU . . | | | | | |--loop-file=, --loop= | | | N . inf no . --loop-file --loop-file=yes --loop-file=inf . | | | --loop-playlist . (seek) . | | |: | | |7.0 | | |3.5 | | | --loop-file . --loop-file=1 . --loop-playlist . | | | | | |168u | | | | | |168u | | |--loop . | | | | | |--ab-loop-a=