--a52drc= Select the Dynamic Range Compression level for AC-3 audio streams. is a float value ranging from 0 to 1, where 0 means no compression and 1 (which is the default) means full compression (make loud passages more silent and vice versa). Values up to 2 are also accepted, but are purely experimental. This option only shows an effect if the AC-3 stream contains the required range compression information. --abs= (``--ao=oss`` only) (OBSOLETE) Override audio driver/card buffer size detection. --ac=<[-\|+]codec1,[-\|+]codec2,...[,]> Specify a priority list of audio codecs to be used, according to their codec name in codecs.conf. Use a '-' before the codec name to omit it. Use a '+' before the codec name to force it, this will likely crash! If the list has a trailing ',' mpv will fall back on codecs not contained in the list. *NOTE*: See ``--ac=help`` for a full list of available codecs. --af= Specify a list of audio filters to apply to the audio stream. See :ref:`audio_filters` for details and descriptions of the available filters. The option variants ``--af-add``, ``--af-pre``, ``--af-del`` and ``--af-clr`` exist to modify a previously specified list, but you shouldn't need these for typical use. --af-adv= See also ``--af``. Specify advanced audio filter options: force=<0-7> Forces the insertion of audio filters to one of the following: 0 Use completely automatic filter insertion (currently identical to 1). 1 Optimize for accuracy (default). 2 Optimize for speed. *Warning*: Some features in the audio filters may silently fail, and the sound quality may drop. 3 Use no automatic insertion of filters and no optimization. *Warning*: It may be possible to crash mpv using this setting. 4 Use automatic insertion of filters according to 0 above, but use floating point processing when possible. 5 Use automatic insertion of filters according to 1 above, but use floating point processing when possible. 6 Use automatic insertion of filters according to 2 above, but use floating point processing when possible. 7 Use no automatic insertion of filters according to 3 above, and use floating point processing when possible. list= Same as ``--af``. --afm= Specify a priority list of audio codec families to be used, according to their codec name in codecs.conf. Falls back on the default codecs if none of the given codec families work. *NOTE*: See ``--afm=help`` for a full list of available codec families. *EXAMPLE*: :``--afm=ffmpeg``: Try FFmpeg's libavcodec codecs first. --aid= Select audio channel. ``auto`` selects the default, ``no`` disables audio. See also ``--alang``. --alang= Specify a priority list of audio languages to use. Different container formats employ different language codes. DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT use ISO 639-2 three letter language codes while OGM uses a free-form identifier. mpv prints the available languages when run in verbose (``-v``) mode. See also ``--aid``. *EXAMPLE*: ``mpv dvd://1 --alang=hu,en`` Chooses the Hungarian language track on a DVD and falls back on English if Hungarian is not available. ``mpv --alang=jpn example.mkv`` Plays a Matroska file in Japanese. --ao= Specify a priority list of audio output drivers to be used. For interactive use you'd normally specify a single one to use, but in configuration files specifying a list of fallbacks may make sense. See :ref:`audio_outputs` for details and descriptions of available drivers. --ar, --no-ar Enable/disable AppleIR remote support. Enabled by default. --aspect= Override movie aspect ratio, in case aspect information is incorrect or missing in the file being played. See also ``--no-aspect``. *EXAMPLE*: - ``--aspect=4:3`` or ``--aspect=1.3333`` - ``--aspect=16:9`` or ``--aspect=1.7777`` --ass, --no-ass Use libass to render all text subtitles. This enables support for the native styling of SSA/ASS subtitles, and also support for some styling features in other subtitle formats by conversion to ASS markup. Enabled by default if the player was compiled with libass support. *NOTE*: With ``--ass``, some of the ASS subtitle options work for non-ASS text subtitles only, because ASS subtitles include their own styling information. --ass-border-color= Sets the border (outline) color for text subtitles. The color format is RRGGBBAA. --ass-bottom-margin= Adds a black band at the bottom of the frame. The SSA/ASS renderer can place subtitles there (with ``--ass-use-margins``). --ass-color= Sets the color for text subtitles. The color format is RRGGBBAA. --ass-font-scale= Set the scale coefficient to be used for fonts in the SSA/ASS renderer. --ass-force-style=<[Style.]Param=Value[,...]> Override some style or script info parameters. *EXAMPLE*: - ``--ass-force-style=FontName=Arial,Default.Bold=1`` - ``--ass-force-style=PlayResY=768`` --ass-hinting= Set hinting type. can be: :0: no hinting :1: FreeType autohinter, light mode :2: FreeType autohinter, normal mode :3: font native hinter The default value is 0 (no hinting). --ass-line-spacing= Set line spacing value for SSA/ASS renderer. --ass-styles= Load all SSA/ASS styles found in the specified file and use them for rendering text subtitles. The syntax of the file is exactly like the ``[V4 Styles]`` / ``[V4+ Styles]`` section of SSA/ASS. --ass-style-override= Control whether user style overrides should be applied. :yes: Apply all the ``--ass-*`` style override options. Changing the default for any of these options can lead to incorrect subtitle rendering. (Default.) :no: Render subtitles as forced by subtitle scripts. --ass-top-margin= Adds a black band at the top of the frame. The SSA/ASS renderer can place toptitles there (with ``--ass-use-margins``). --ass-use-margins Enables placing toptitles and subtitles in black borders when they are available. --ass-vsfilter-aspect-compat Stretch SSA/ASS subtitles when playing anamorphic videos for compatibility with traditional VSFilter behavior. This switch has no effect when the video is stored with square pixels. The renderer historically most commonly used for the SSA/ASS subtitle formats, VSFilter, had questionable behavior that resulted in subtitles being stretched too if the video was stored in anamorphic format that required scaling for display. This behavior is usually undesirable and newer VSFilter versions may behave differently. However, many existing scripts compensate for the stretching by modifying things in the opposite direction. Thus if such scripts are displayed "correctly" they will not appear as intended. This switch enables emulation of the old VSFilter behavior (undesirable but expected by many existing scripts). Enabled by default. --audio-demuxer=<[+]name> Force audio demuxer type when using ``--audiofile``. Use a '+' before the name to force it, this will skip some checks! Give the demuxer name as printed by ``--audio-demuxer=help``. ``--audio-demuxer=audio`` forces MP3. --audiofile= Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a movie. --audiofile-cache= Enables caching for the stream used by ``--audiofile``, using the specified amount of memory. --autosub, --no-autosub Load additional subtitle files matching the video filename. Enabled by default. See also ``--autosub-match``. --autosub-match= Adjust matching fuzziness when searching for subtitles: :exact: exact match :fuzzy: Load all subs containing movie name. :all: Load all subs in the current and ``--sub-paths`` directories. --autosync= Gradually adjusts the A/V sync based on audio delay measurements. Specifying ``--autosync=0``, the default, will cause frame timing to be based entirely on audio delay measurements. Specifying ``--autosync=1`` will do the same, but will subtly change the A/V correction algorithm. An uneven video framerate in a movie which plays fine with ``--no-audio`` can often be helped by setting this to an integer value greater than 1. The higher the value, the closer the timing will be to ``--no-audio``. Try ``--autosync=30`` to smooth out problems with sound drivers which do not implement a perfect audio delay measurement. With this value, if large A/V sync offsets occur, they will only take about 1 or 2 seconds to settle out. This delay in reaction time to sudden A/V offsets should be the only side-effect of turning this option on, for all sound drivers. --bandwidth= Specify the maximum bandwidth for network streaming (for servers that are able to send content in different bitrates). Useful if you want to watch live streamed media behind a slow connection. With Real RTSP streaming, it is also used to set the maximum delivery bandwidth allowing faster cache filling and stream dumping. *NOTE*: probably broken/useless. --untimed Do not sleep when outputting video frames. Useful for benchmarks when used with --no-audio. --bluray-angle= Some Blu-ray discs contain scenes that can be viewed from multiple angles. Here you can tell mpv which angles to use (default: 1). --bluray-chapter= (Blu-ray only) Tells mpv which Blu-ray chapter to start the current title from (default: 1). --bluray-device= (Blu-ray only) Specify the Blu-ray disc location. Must be a directory with Blu-ray structure. --border, --no-border Play movie with window border and decorations. Since this is on by default, use ``--no-border`` to disable the standard window decorations. --brightness=<-100-100> Adjust the brightness of the video signal (default: 0). Not supported by all video output drivers. --cache= Enable caching of the input stream (if not already enabled) and set the size of the cache in kilobytes. Caching is enabled by default (with a default cache size) for network streams. May be useful when playing files from slow media, but can also have negative effects, especially with file formats that require a lot of seeking, such as mp4. See also ``--no-cache``. --cache-min= Playback will start when the cache has been filled up to of the total. --cache-seek-min= If a seek is to be made to a position within of the cache size from the current position, mpv will wait for the cache to be filled to this position rather than performing a stream seek (default: 50). --cdda= This option can be used to tune the CD Audio reading feature of mpv. Available options are: speed= Set CD spin speed. paranoia=<0-2> Set paranoia level. Values other than 0 seem to break playback of anything but the first track. :0: disable checking (default) :1: overlap checking only :2: full data correction and verification generic-dev= Use specified generic SCSI device. sector-size= Set atomic read size. overlap= Force minimum overlap search during verification to sectors. toc-bias Assume that the beginning offset of track 1 as reported in the TOC will be addressed as LBA 0. Some Toshiba drives need this for getting track boundaries correct. toc-offset= Add sectors to the values reported when addressing tracks. May be negative. (no-)skip (Never) accept imperfect data reconstruction. --cdrom-device= Specify the CD-ROM device (default: ``/dev/cdrom``). --channels= Request the number of playback channels (default: 2). mpv asks the decoder to decode the audio into as many channels as specified. Then it is up to the decoder to fulfill the requirement. This is usually only important when playing videos with AC-3 audio (like DVDs). In that case liba52 does the decoding by default and correctly downmixes the audio into the requested number of channels. To directly control the number of output channels independently of how many channels are decoded, use the channels filter (``--af=channels``). *NOTE*: This option is honored by codecs (AC-3 only), filters (surround) and audio output drivers (OSS at least). Available options are: :2: stereo :4: surround :6: full 5.1 :8: full 7.1 --chapter= Specify which chapter to start playing at. Optionally specify which chapter to end playing at. Also see ``--start``. --chapter-merge-threshold= Threshold for merging almost consecutive ordered chapter parts in milliseconds (default: 100). Some Matroska files with ordered chapters have inaccurate chapter end timestamps, causing a small gap between the end of one chapter and the start of the next one when they should match. If the end of one playback part is less than the given threshold away from the start of the next one then keep playing video normally over the chapter change instead of doing a seek. --codecs-file= Override the standard search path and use the specified file instead of the builtin codecs.conf. --colormatrix= Controls the YUV to RGB color space conversion when playing video. There are various standards. Normally, BT.601 should be used for SD video, and BT.709 for HD video. (This is done by default.) Using incorrect color space results in slightly under or over saturated and shifted colors. The color space conversion is additionally influenced by the related options --colormatrix-input-range and --colormatrix-output-range. These options are not always supported. Different video outputs provide varying degrees of support. The opengl and vdpau video output drivers usually offer full support. The xv output can set the color space if the system video driver supports it, but not input and output levels. The scale video filter can configure color space and input levels, but only if the output format is RGB (if the video output driver supports RGB output, you can force this with ``-vf scale,format=rgba``). If this option is set to ``auto`` (which is the default), the video's color space flag will be used. If that flag is unset, the color space will be selected automatically. This is done using a simple heuristic that attempts to distinguish SD and HD video. If the video is larger than 1279x576 pixels, BT.709 (HD) will be used; otherwise BT.601 (SD) is selected. Available color spaces are: :auto: automatic selection (default) :BT.601: ITU-R BT.601 (SD) :BT.709: ITU-R BT.709 (HD) :SMPTE-240M: SMPTE-240M --colormatrix-input-range= YUV color levels used with YUV to RGB conversion. This option is only necessary when playing broken files, which don't follow standard color levels or which are flagged wrong. If the video doesn't specify its color range, it is assumed to be limited range. The same limitations as with --colormatrix apply. Available color ranges are: :auto: automatic selection (normally limited range) (default) :limited: limited range (16-235 for luma, 16-240 for chroma) :full: full range (0-255 for both luma and chroma) --colormatrix-output-range= RGB color levels used with YUV to RGB conversion. Normally, output devices such as PC monitors use full range color levels. However, some TVs and video monitors expect studio level RGB. Providing full range output to a device expecting studio level input results in crushed blacks and whites, the reverse in dim grey blacks and dim whites. The same limitations as with --colormatrix apply. Available color ranges are: :auto: automatic selection (equals to full range) (default) :limited: limited range (16-235 per component), studio levels :full: full range (0-255 per component), PC levels --colorkey= Changes the colorkey to an RGB value of your choice. 0x000000 is black and 0xffffff is white. Only supported by the xv (see ``--vo=xv:ck``) video output driver. See also ``--no-colorkey``. --consolecontrols, --no-consolecontrols ``--no-consolecontrols`` prevents the player from reading key events from standard input. Useful when reading data from standard input. This is automatically enabled when ``-`` is found on the command line. There are situations where you have to set it manually, e.g. if you open ``/dev/stdin`` (or the equivalent on your system), use stdin in a playlist or intend to read from stdin later on via the loadfile or loadlist slave commands. --contrast=<-100-100> Adjust the contrast of the video signal (default: 0). Not supported by all video output drivers. --cookies, --no-cookies (network only) Support cookies when making HTTP requests. Disabled by default. --cookies-file= (network only) Read HTTP cookies from . The file is assumed to be in Netscape format. --correct-pts, --no-correct-pts Switches mpv to a mode where timestamps for video frames are calculated differently and video filters which add new frames or modify timestamps of existing ones are supported. Now enabled automatically for most common file formats. The more accurate timestamps can be visible for example when playing subtitles timed to scene changes with the ``--ass`` option. Without ``--correct-pts`` the subtitle timing will typically be off by some frames. This option does not work correctly with some demuxers and codecs. --cursor-autohide= Make mouse cursor automatically hide after given number of milliseconds. ``no`` will disable cursor autohide. ``always`` means the cursor will stay hidden. Supported by video output drivers which use X11 or OS X Cocoa. --audio-delay= audio delay in seconds (positive or negative float value). Negative values delay the audio, and positive values delay the video. --demuxer=<[+]name> Force demuxer type. Use a '+' before the name to force it, this will skip some checks! Give the demuxer name as printed by ``--demuxer=help``. --doubleclick-time= Time in milliseconds to recognize two consecutive button presses as a double-click (default: 300). --dvbin= Pass the following parameters to the DVB input module, in order to override the default ones: :card=<1-4>: Specifies using card number 1-4 (default: 1). :file=: Instructs mpv to read the channels list from . Default is ``~/.mpv/channels.conf.{sat,ter,cbl,atsc}`` (based on your card type) or ``~/.mpv/channels.conf`` as a last resort. :timeout=<1-30>: Maximum number of seconds to wait when trying to tune a frequency before giving up (default: 30). --dvd-device= Specify the DVD device or .iso filename (default: ``/dev/dvd``). You can also specify a directory that contains files previously copied directly from a DVD (with e.g. vobcopy). --dvd-speed= Try to limit DVD speed (default: 0, no change). DVD base speed is 1385 kB/s, so a 8x drive can read at speeds up to 11080 kB/s. Slower speeds make the drive more quiet. For watching DVDs 2700 kB/s should be quiet and fast enough. mpv resets the speed to the drive default value on close. Values of at least 100 mean speed in kB/s. Values less than 100 mean multiples of 1385 kB/s, i.e. ``--dvd-speed=8`` selects 11080 kB/s. *NOTE*: You need write access to the DVD device to change the speed. --dvdangle= Some DVD discs contain scenes that can be viewed from multiple angles. Here you can tell mpv which angles to use (default: 1). --edition= (Matroska files only) Specify the edition (set of chapters) to use, where 0 is the first. If set to -1 (the default), mpv will choose the first edition declared as a default, or if there is no default, the first edition defined. --edlout= Creates a new file and writes edit decision list (EDL) records to it. During playback, the user hits 'i' to mark the start or end of a skip block. This provides a starting point from which the user can fine-tune EDL entries later. See http://www.mplayerhq.hu/DOCS/HTML/en/edl.html for details. *NOTE*: broken. --embeddedfonts, --no-embeddedfonts Use fonts embedded in Matroska container files and ASS scripts (default: enabled). These fonts can be used for SSA/ASS subtitle rendering (``--ass`` option). --end= Stop at given absolute time. See ``--start`` for valid option values and examples. --no-extbased, --extbased ``--no-extbased`` disables extension-based demuxer selection. By default, when the file type (demuxer) cannot be detected reliably (the file has no header or it is not reliable enough), the filename extension is used to select the demuxer. Always falls back on content-based demuxer selection. --field-dominance= Set first field for interlaced content. Useful for deinterlacers that double the framerate: ``--vf=yadif=1`` and ``--vo=vdpau:deint``. :auto: (default) If the decoder does not export the appropriate information, it falls back to 0 (top field first). :top: top field first :bottom: bottom field first --no-fixed-vo, --fixed-vo ``--no-fixed-vo`` enforces closing and reopening the video window for multiple files (one (un)initialization for all files). --flip Flip image upside-down. --font= Specify font to use for OSD and for subtitles that do not themselves specify a particular font. See also ``--subfont``. With fontconfig enabled the argument is a fontconfig pattern and the default is ``sans``. Without fontconfig the argument is a filename and the default is ``~/.mpv/subfont.ttf``. *EXAMPLE*: - ``--font=~/.mpv/arialuni.ttf`` (no fontconfig) - ``--font='Bitstream Vera Sans'`` (usual case with fontconfig) - ``--font='Bitstream Vera Sans:style=Bold'`` (usual case with fontconfig) --force-window-position Forcefully move mpv's video output window to default location whenever there is a change in video parameters, video stream or file. This used to be the default behavior. Currently only affects X11 VOs. --sub-forced-only Display only forced subtitles for the DVD subtitle stream selected by e.g. ``--slang``. --forceidx Force index rebuilding. Useful for files with broken index (A/V desync, etc). This will enable seeking in files where seeking was not possible. *NOTE*: This option only works if the underlying media supports seeking (i.e. not with stdin, pipe, etc). --format= Select the sample format used for output from the audio filter layer to the sound card. The values that can adopt are listed below in the description of the ``format`` audio filter. --fps= Override video framerate. Useful if the original value is wrong or missing. *NOTE*: Works in ``--no-correct-pts`` mode only. --framedrop= Skip displaying some frames to maintain A/V sync on slow systems. Video filters are not applied to such frames. For B-frames even decoding is skipped completely. May produce unwatchably choppy output. With ``hard``, decoding and output of any frame can be skipped, and will lead to an even worse playback experience. *NOTE*: Practical use of this feature is questionable. Disabled by default. --frames= Play/convert only first frames, then quit. --fullscreen, --fs Fullscreen playback (centers movie, and paints black bands around it). --fsmode-dontuse=<0-31> OBSOLETE, use the ``--fs`` option. Try this option if you still experience fullscreen problems. --fstype= (X11 only) Specify a priority list of fullscreen modes to be used. You can negate the modes by prefixing them with '-'. If you experience problems like the fullscreen window being covered by other windows try using a different order. *NOTE*: See ``--fstype=help`` for a full list of available modes. The available types are: above Use the ``_NETWM_STATE_ABOVE`` hint if available. below Use the ``_NETWM_STATE_BELOW`` hint if available. fullscreen Use the ``_NETWM_STATE_FULLSCREEN`` hint if available. layer Use the ``_WIN_LAYER`` hint with the default layer. layer=<0...15> Use the ``_WIN_LAYER`` hint with the given layer number. netwm Force NETWM style. none Clear the list of modes; you can add modes to enable afterward. stays_on_top Use ``_NETWM_STATE_STAYS_ON_TOP`` hint if available. *EXAMPLE*: ``--fstype=layer,stays_on_top,above,fullscreen`` Default order, will be used as a fallback if incorrect or unsupported modes are specified. ``--fstype=fullscreen`` Fixes fullscreen switching on OpenBox 1.x. --gamma=<-100-100> Adjust the gamma of the video signal (default: 0). Not supported by all video output drivers. --gapless-audio Try to play consecutive audio files with no silence or disruption at the point of file change. This feature is implemented in a simple manner and relies on audio output device buffering to continue playback while moving from one file to another. If playback of the new file starts slowly, for example because it's 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. *NOTE*: The audio device is opened using parameters chosen according to the first file played and is then kept open for gapless playback. This means that if the first file for example has a low samplerate then the following files may get resampled to the same low samplerate, resulting in reduced sound quality. If you play files with different parameters, consider using options such as ``--srate`` and ``--format`` to explicitly select what the shared output format will be. --geometry=, --geometry=<[WxH][+-x+-y]> Adjust where the output is on the screen initially. The x and y specifications are in pixels measured from the top-left of the screen to the top-left of the image being displayed, however if a percentage sign is given after the argument it turns the value into a percentage of the screen size in that direction. It also supports the standard X11 ``--geometry`` option format, in which e.g. +10-50 means "place 10 pixels from the left border and 50 pixels from the lower border" and "--20+-10" means "place 20 pixels beyond the right and 10 pixels beyond the top border". If an external window is specified using the ``--wid`` option, then the x and y coordinates are relative to the top-left corner of the window rather than the screen. The coordinates are relative to the screen given with ``--screen`` for the video output drivers that fully support ``--screen``. *NOTE*: May not be supported by some of the older VO drivers. *NOTE (OSX)*: On Mac OSX the origin of the screen coordinate system is located on the the bottom-left corner. For instance, ``0:0`` will place the window at the bottom-left of the screen. *EXAMPLE*: ``50:40`` Places the window at x=50, y=40. ``50%:50%`` Places the window in the middle of the screen. ``100%`` Places the window at the middle of the right edge of the screen. ``100%:100%`` Places the window at the bottom right corner of the screen. --grabpointer, --no-grabpointer ``--no-grabpointer`` tells the player to not grab the mouse pointer after a video mode change (``--vm``). Useful for multihead setups. --heartbeat-cmd Command that is executed every 30 seconds during playback via *system()* - i.e. using the shell. *NOTE*: mpv uses this command without any checking. It is your responsibility to ensure it does not cause security problems (e.g. make sure to use full paths if "." is in your path like on Windows). It also only works when playing video (i.e. not with ``--no-video`` but works with ``-vo=null``). This can be "misused" to disable screensavers that do not support the proper X API (see also ``--stop-xscreensaver``). If you think this is too complicated, ask the author of the screensaver program to support the proper X APIs. *EXAMPLE for xscreensaver*: ``mpv --heartbeat-cmd="xscreensaver-command -deactivate" file`` *EXAMPLE for GNOME screensaver*: ``mpv --heartbeat-cmd="gnome-screensaver-command -p" file`` --help Show short summary of options. --hr-seek= Select when to use precise seeks that are not limited to keyframes. Such seeks require decoding video from the previous keyframe up to the target position and so can take some time depending on decoding performance. For some video formats precise seeks are disabled. This option selects the default choice to use for seeks; it's possible to explicitly override that default in the definition of key bindings and in slave mode commands. :no: Never use precise seeks. :absolute: Use precise seeks if the seek is to an absolute position in the file, such as a chapter seek, but not for relative seeks like the default behavior of arrow keys (default). :yes: Use precise seeks whenever possible. --hr-seek-demuxer-offset= This option exists to work around failures to do precise seeks (as in ``--hr-seek``) caused by bugs or limitations in the demuxers for some file formats. Some demuxers fail to seek to a keyframe before the given target position, going to a later position instead. The value of this option is subtracted from the time stamp given to the demuxer. Thus if you set this option to 1.5 and try to do a precise seek to 60 seconds, the demuxer is told to seek to time 58.5, which hopefully reduces the chance that it erroneously goes to some time later than 60 seconds. 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. --http-header-fields= Set custom HTTP fields when accessing HTTP stream. *EXAMPLE*: ``mpv --http-header-fields='Field1: value1','Field2: value2' http://localhost:1234`` Will generate HTTP request: | GET / HTTP/1.0 | Host: localhost:1234 | User-Agent: MPlayer | Icy-MetaData: 1 | Field1: value1 | Field2: value2 | Connection: close --hue=<-100-100> Adjust the hue of the video signal (default: 0). You can get a colored negative of the image with this option. Not supported by all video output drivers. --identify Deprecated. Use ``TOOLS/mpv_identify.sh``. --idle Makes mpv wait idly instead of quitting when there is no file to play. Mostly useful in slave mode where mpv can be controlled through input commands (see also ``--slave``). --idx Rebuilds index of files if no index was found, allowing seeking. Useful with broken/incomplete downloads, or badly created files. Now this is done automatically by the demuxers used for most video formats, meaning that this switch has no effect in the typical case. See also ``--forceidx``. *NOTE*: This option only works if the underlying media supports seeking (i.e. not with stdin, pipe, etc). --ifo= Indicate the VOBsub IFO file that will be used to load palette and frame size for VOBsub subtitles. --ignore-start Matters with the builtin AVI demuxer only, which is not enabled by default. Ignore the specified starting time for streams in AVI files. This nullifies stream delays. --include= Specify configuration file to be parsed after the default ones. --initial-audio-sync, --no-initial-audio-sync When starting a video file or after events such as seeking mpv will by default modify the audio stream to make it start from the same timestamp as video, by either inserting silence at the start or cutting away the first samples. Disabling this option makes the player behave like older mpv versions did: video and audio are both started immediately even if their start timestamps differ, and then video timing is gradually adjusted if necessary to reach correct synchronization later. --input= This option can be used to configure certain parts of the input system. Paths are relative to ``~/.mpv/``. *NOTE*: Autorepeat is currently only supported by joysticks. Available commands are: conf= Specify input configuration file other than the default ``~/.mpv/input.conf``. ``~/.mpv/`` is assumed if no full path is given. ar-dev= Device to be used for Apple IR Remote (default is autodetected, Linux only). ar-delay Delay in milliseconds before we start to autorepeat a key (0 to disable). ar-rate Number of key presses to generate per second on autorepeat. (no-)default-bindings Use the key bindings that mpv ships with by default. keylist Prints all keys that can be bound to commands. cmdlist Prints all commands that can be bound to keys. js-dev Specifies the joystick device to use (default: ``/dev/input/js0``). file= Read commands from the given file. Mostly useful with a FIFO. See also ``--slave``. *NOTE*: When the given file is a FIFO mpv opens both ends so you can do several `echo "seek 10" > mp_pipe` and the pipe will stay valid. test Input test mode. Instead of executing commands on key presses, mpv will show the keys and the bound commands on the OSD. Has to be used with a dummy video, and the normal ways to quit the player will not work (key bindings that normally quit will be shown on OSD only, just like any other binding). --ipv4-only-proxy Skip any HTTP proxy for IPv6 addresses. It will still be used for IPv4 connections. --joystick, --no-joystick Enable/disable joystick support. Enabled by default. --no-keepaspect, --keepaspect --no-keepaspect will always stretch the video to window size, and will disable the window manager hints that force the window aspect ratio. (Ignored in fullscreen mode.) --keep-open Do not terminate when playing or seeking beyond the end of the file. Instead, pause the player. When trying to seek beyond end of the file, the player will pause at an arbitrary playback position (or, in corner cases, not redraw the window at all). *NOTE*: this option is not respected when using ``--frames``, ``--end``, ``--length``, or when passing a chapter range to ``--chapter``. Explicitly skipping to the next file or skipping beyond the last chapter will terminate playback as well, even if ``--keep-open`` is given. --key-fifo-size=<2-65000> Specify the size of the FIFO that buffers key events (default: 7). If it is too small some events may be lost. The main disadvantage of setting it to a very large value is that if you hold down a key triggering some particularly slow command then the player may be unresponsive while it processes all the queued commands. --lavdopts= Specify libavcodec decoding parameters. Separate multiple options with a colon. *EXAMPLE*: ``--lavdopts=gray:skiploopfilter=all:skipframe=nonref`` Available options are: bitexact Only use bit-exact algorithms in all decoding steps (for codec testing). bug= Manually work around encoder bugs. :0: nothing :1: autodetect bugs (default) :2: (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection) :4: (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX) :8: (mpeg4): UMP4 (autodetected if fourcc==UMP4) :16: (mpeg4): padding bug (autodetected) :32: (mpeg4): illegal vlc bug (autodetected per fourcc) :64: (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/version) :128: (mpeg4): old standard qpel (autodetected per fourcc/version) :256: (mpeg4): another qpel bug (autodetected per fourcc/version) :512: (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/version) :1024: (mpeg4): edge padding bug (autodetected per fourcc/version) debug= Display debugging information. :0: disabled :1: picture info :2: rate control :4: bitstream :8: macroblock (MB) type :16: per-block quantization parameter (QP) :32: motion vector :0x0040: motion vector visualization (use ``--no-slices``) :0x0080: macroblock (MB) skip :0x0100: startcode :0x0200: PTS :0x0400: error resilience :0x0800: memory management control operations (H.264) :0x1000: bugs :0x2000: Visualize quantization parameter (QP), lower QP are tinted greener. :0x4000: Visualize block types. ec= Set error concealment strategy. :1: Use strong deblock filter for damaged MBs. :2: iterative motion vector (MV) search (slow) :3: all (default) fast (MPEG-2, MPEG-4, and H.264 only) Enable optimizations which do not comply to the specification and might potentially cause problems, like simpler dequantization, simpler motion compensation, assuming use of the default quantization matrix, assuming YUV 4:2:0 and skipping a few checks to detect damaged bitstreams. gray grayscale only decoding (a bit faster than with color) idct=<0-99> For best decoding quality use the same IDCT algorithm for decoding and encoding. This may come at a price in accuracy, though. lowres=[,] Decode at lower resolutions. Low resolution decoding is not supported by all codecs, and it will often result in ugly artifacts. This is not a bug, but a side effect of not decoding at full resolution. :0: disabled :1: 1/2 resolution :2: 1/4 resolution :3: 1/8 resolution If is specified lowres decoding will be used only if the width of the video is major than or equal to . o==[,=[,...]] Pass AVOptions to libavcodec decoder. Note, a patch to make the o= unneeded and pass all unknown options through the AVOption system is welcome. A full list of AVOptions can be found in the FFmpeg manual. *EXAMPLE*: ``o=debug=pict`` sb= (MPEG-2 only) Skip the given number of macroblock rows at the bottom. st= (MPEG-2 only) Skip the given number of macroblock rows at the top. skiploopfilter= (H.264 only) Skips the loop filter (AKA deblocking) during H.264 decoding. Since the filtered frame is supposed to be used as reference for decoding dependent frames this has a worse effect on quality than not doing deblocking on e.g. MPEG-2 video. But at least for high bitrate HDTV this provides a big speedup with no visible quality loss. can be one of the following: :none: Never skip. :default: Skip useless processing steps (e.g. 0 size packets in AVI). :nonref: Skip frames that are not referenced (i.e. not used for decoding other frames, the error cannot "build up"). :bidir: Skip B-Frames. :nonkey: Skip all frames except keyframes. :all: Skip all frames. skipidct= (MPEG-1/2 only) Skips the IDCT step. This degrades quality a lot of in almost all cases (see skiploopfilter for available skip values). skipframe= Skips decoding of frames completely. Big speedup, but jerky motion and sometimes bad artifacts (see skiploopfilter for available skip values). threads=<0-16> Number of threads to use for decoding. Whether threading is actually supported depends on codec. 0 means autodetect number of cores on the machine and use that, up to the maximum of 16. (default: 0) vismv= Visualize motion vectors. :0: disabled :1: Visualize forward predicted MVs of P-frames. :2: Visualize forward predicted MVs of B-frames. :4: Visualize backward predicted MVs of B-frames. vstats Prints some statistics and stores them in ``./vstats_*.log``. --lavfdopts= Specify parameters for libavformat demuxers (``--demuxer=lavf``). Separate multiple options with a colon. Available suboptions are: analyzeduration= Maximum length in seconds to analyze the stream properties. format= Force a specific libavformat demuxer. o==[,=[,...]] Pass AVOptions to libavformat demuxer. Note, a patch to make the *o=* unneeded and pass all unknown options through the AVOption system is welcome. A full list of AVOptions can be found in the FFmpeg manual. Note that some options may conflict with mpv options. *EXAMPLE*: ``o=fflags=+ignidx`` probesize= Maximum amount of data to probe during the detection phase. In the case of MPEG-TS this value identifies the maximum number of TS packets to scan. cryptokey= Encryption key the demuxer should use. This is the raw binary data of the key converted to a hexadecimal string. --length= Stop after a given time relative to the start time. See ``--start`` for valid option values and examples. --lirc, --no-lirc Enable/disable LIRC support. Enabled by default. --lircconf= (LIRC only) Specifies a configuration file for LIRC (default: ``~/.lircrc``). --list-options Prints all available options. --list-properties Print a list of the available properties. --loop= Loops playback times. ``inf`` means forever and ``no`` disables looping. --mc= Maximum A-V sync correction per frame (in seconds) --mf= Used when decoding from multiple PNG or JPEG files with ``mf://``. Available options are: :fps=: output fps (default: 25) :type=: input file type (available: jpeg, png, tga, sgi) --mixer= Use a mixer device different from the default ``/dev/mixer``. For ALSA this is the mixer name. --mixer-channel= (``--ao=oss`` and ``--ao=alsa`` only) This option will tell mpv to use a different channel for controlling volume than the default PCM. Options for OSS include **vol, pcm, line**. For a complete list of options look for ``SOUND_DEVICE_NAMES`` in ``/usr/include/linux/soundcard.h``. For ALSA you can use the names e.g. alsamixer displays, like **Master, Line, PCM**. *NOTE*: ALSA mixer channel names followed by a number must be specified in the format, i.e. a channel labeled 'PCM 1' in alsamixer must be converted to PCM,1. --monitoraspect= Set the aspect ratio of your monitor or TV screen. A value of 0 disables a previous setting (e.g. in the config file). Overrides the ``--monitorpixelaspect`` setting if enabled. See also ``--monitorpixelaspect`` and ``--aspect``. *EXAMPLE*: - ``--monitoraspect=4:3`` or ``--monitoraspect=1.3333`` - ``--monitoraspect=16:9`` or ``--monitoraspect=1.7777`` --monitorpixelaspect= Set the aspect of a single pixel of your monitor or TV screen (default: 1). A value of 1 means square pixels (correct for (almost?) all LCDs). See also ``--monitoraspect`` and ``--aspect``. --mouse-movements Permit mpv to receive pointer events reported by the video output driver. Necessary to select the buttons in DVD menus. Supported for X11-based VOs (x11, xv, etc) and the gl, direct3d and corevideo VOs. --mouseinput, --no-mouseinput Enabled by default. Disable mouse button press/release input (mozplayerxp's context menu relies on this option). --no-msgcolor Disable colorful console output on terminals. --msglevel= Control verbosity directly for each module. The *all* module changes the verbosity of all the modules not explicitly specified on the command line. See ``--msglevel=help`` for a list of all modules. *NOTE*: Some messages are printed before the command line is parsed and are therefore not affected by ``--msglevel``. To control these messages you have to use the ``MPV_VERBOSE`` environment variable; see its description below for details. Available levels: :-1: complete silence :0: fatal messages only :1: error messages :2: warning messages :3: short hints :4: informational messages :5: status messages (default) :6: verbose messages :7: debug level 2 :8: debug level 3 :9: debug level 4 --msgmodule Prepend module name in front of each console message. --mute= Set startup audio mute status. ``auto`` (default) will not change the mute status. Also see ``--volume``. --name Set the window class name for X11-based video output methods. --avi-ni (Internal AVI demuxer which is not used by default only) Force usage of non-interleaved AVI parser (fixes playback of some bad AVI files). --no-aspect Ignore aspect ratio information from video file and assume the video has square pixels. See also ``--aspect``. --no-bps (Internal AVI demuxer which is not used by default only) Do not use average byte/second value for A-V sync. Helps with some AVI files with broken header. --no-cache Turn off input stream caching. See ``--cache``. --no-colorkey Disables colorkeying. Only supported by the xv (see ``--vo=xv:ck``) video output driver. --no-config= Do not parse selected configuration files. *NOTE*: If ``--include`` or ``--use-filedir-conf`` options are specified at the command line, they will be honoured. Available options are: :all: all configuration files :system: system configuration file :user: user configuration file --no-idx Do not use index present in the file even if one is present. --no-audio Do not play sound. With some demuxers this may not work. In those cases you can try ``--ao=null`` instead. --no-sub Disables display of internal and external subtitles. --no-video Do not play video. With some demuxers this may not work. In those cases you can try ``--vo=null`` instead. --ontop Makes the player window stay on top of other windows. Supported by video output drivers which use X11, as well as corevideo. --ordered-chapters, --no-ordered-chapters Enabled by default. Disable support for Matroska ordered chapters. mpv will not load or search for video segments from other files, and will also ignore any chapter order specified for the main file. --osd-duration=