Since it's a debugging option, its semantics may change at any time. The pseudo-mode no disables automatic conversion completely. Window height is set so that the window has the video aspect ratio. This affects image files, which are defined as having only 1 video frame and no audio. This takes care of any necessary normalization conversions.
Other configuration files are blocked as well, such as resume playback files. A value of 0 enables automatic control. See below for a list of hookable textures. Every value below this point is guaranteed to be mapped 1:1. The rotation value is added to the rotation metadata, which means the value 0 would rotate the video according to the rotation metadata. . The option variants --vf-add, --vf-pre, --vf-del and --vf-clr exist to modify a previously specified list, but you should not need these for typical use.
Only active if dithering is enabled in general. Values other than 0 seem to break playback of anything but the first track. This means playback will never automatically advance to the next file. The downside of setting this option is that precise seeks become slower, as video between the earlier demuxer position and the real target may be unnecessarily decoded. Expect malfunctions, crashes, and security issues if you do it anyway. The intention is that it can be always enabled so may not remove all parts added. Note that hardware decoding overrides this flag.
This behavior is disabled by default, but is always available when quitting the player with Shift+Q. This is especially useful to sync subtitles to audio. Note If the main subtitle stream contains formatting tags which display the subtitle at the top of the screen, it will overlap with the secondary subtitle. The force mode is like inf, but does not skip playlist entries which have been marked as failing. Values up to 6 are also accepted, but are purely experimental. Options that work without values can be enabled by setting them to yes and disabled by setting them to no.
The window will always be resized to cover the parent window fully. Warning There is not much reason to use this. With no, playback will continue in video-only or audio-only mode if one of them fails. It's possible to show two subtitles at once: use --sid to select the first subtitle index, and --secondary-sid to select the second index. This accepts a media file like mkv or even a pseudo-format like ffmetadata and uses its chapters to replace the current file's chapters.
Keep in mind that some use-cases, like playing ordered chapters with cache enabled, will actually create multiple cache files, each of which will use up to this much disk space. The coordinates are relative to the screen given with --screen for the video output drivers that fully support --screen. See the --input- options for ways to customize it. The latter is a heuristic, as it's generally not possible to determine this with certainty. If the image is not subsampled, this option is ignored entirely. It can steal away all keyboard input from the application embedding the mpv window, and on the other hand, the mpv window will receive no input if the mouse is outside of the mpv window, even though mpv has focus.
A protocol prefix is always required. This easy-to-use manual details the operating instructions and benefits of the Remote Start System. Note This option is not respected when using --frames. You can also put the configuration file in the same directory as the file to be played. Some implementations might support multiple formats. The value no is a deprecated alias for auto.
This completely silences any message output. If playback of the new file starts slowly, for example because it is played from a remote network location or because you have specified cache settings that require time for the initial cache fill, then the buffered audio may run out before playback of the new file can start. New and Improved Layla Grayce is coming soon with a new platform and new message! This is usually what you want. If this is disabled, changing the window size won't change the subtitle font size. It only works if the subtitle is close enough to the seek target. This significantly helps cover up remaining quantization artifacts. By default, no textures are bound.
If set to auto the default , mpv will choose the first edition declared as a default, or if there is no default, the first edition defined. The output size size is limited in order to make resample speed changes react faster. A value of 50 means the bar is half the screen wide. Enabling this option makes the demuxer start reading data a bit before the seek target, so that subtitles appear correctly. Otherwise, the result will be totally incorrect. Image subtitles are implemented as a bitmap video stream which can be superimposed over the main movie.
It should be unique, and libass uses it for fast elimination of duplicates. Color used for sub text shadow. Useful if your expensive hardware discards the first 1 or 2 seconds of audio data sent to it. It also discards the top left pixel of each frame for some reason. For some video formats, precise seeks are disabled.