From 504e2336b7631fac55413d660adad5c734dac10a Mon Sep 17 00:00:00 2001 From: wm4 Date: Thu, 2 Aug 2012 21:37:33 +0200 Subject: manpage: merge new manpage MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit About a year ago, ubitux converted most of the old manpage from the hard to maintain nroff format to reStructuredText. This was not merged back into the master repository immediately. The argument was that the new manpage still required work to be done. However, progress was very slow. Even worse: the old manpage wasn't updated, because it was scheduled for deletion, and updating it would have meant useless work. Now the situation is that the new manpage still isn't finished, and the old manpage is grossly out of sync with the player. This is not helpful for users. Additionally, keeping the new manpage in a separate branch, while the normal development repository for code had the old manpage, was very inconvenient, because you couldn't just update the documentation in the same commit as the code. Even though the new manpage isn't finished yet, merging it now seems to be the best course of action. Squash-merge the manpage development branch [1], revision e89f5dd3f2, which branches from the mplayer2 master branch after revision 159102e0cb. Committers: * Clément Bœsch (Initial conversion to RST.) * Uoti Urpala (Many updates.) * Myself (Minor edits.) Most text of the manpage has been directly taken from the old manpage, because this is a conversion, not a complete rewrite. [1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man --- DOCS/man/en/options.rst | 2517 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 2517 insertions(+) create mode 100644 DOCS/man/en/options.rst (limited to 'DOCS/man/en/options.rst') diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst new file mode 100644 index 0000000000..0fea91078c --- /dev/null +++ b/DOCS/man/en/options.rst @@ -0,0 +1,2517 @@ +--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 ',' MPlayer will fall back on codecs not contained + in the list. + + *NOTE*: See ``--ac=help`` for a full list of available codecs. + + *EXAMPLE*: + + :``--ac=mp3acm``: Force the l3codeca.acm MP3 codec. + :``--ac=mad,``: Try libmad first, then fall back on others. + :``--ac=hwac3,a52,``: Try hardware AC-3 passthrough, software AC-3, then + others. + :``--ac=hwdts,``: Try hardware DTS passthrough, then fall back on + others. + :``--ac=-ffmp3,``: Skip FFmpeg's MP3 decoder. + +--adapter= + Set the graphics card that will receive the image. You can get a list of + available cards when you run this option with ``-v``. Currently only works + with the directx video output driver. + +--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 MPlayer 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. + :``--afm=acm,dshow``: Try Win32 codecs first. + +--aid= + Select audio channel (MPEG: 0-31, AVI/OGM: 1-99, ASF/RM: 0-127, VOB(AC-3): + 128-159, VOB(LPCM): 160-191, MPEG-TS 17-8190). MPlayer prints the + available audio IDs when run in verbose (-v) mode. When playing an MPEG-TS + stream, MPlayer will use the first program (if present) with the chosen + audio stream. 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. MPlayer prints the + available languages when run in verbose (``-v``) mode. See also ``--aid``. + + *EXAMPLE*: + + ``mplayer dvd://1 --alang=hu,en`` + Chooses the Hungarian language track on a DVD and falls back on + English if Hungarian is not available. + ``mplayer --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 ``--noaspect``. + + *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*: Some of the other subtitle options were written for the old + non-libass subtitle rendering system and may not work the same way or at + all with libass rendering enabled. + +--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 + :0-3 + 4: The same, but hinting will only be performed if the OSD is + rendered at screen resolution and will therefore not be scaled. + + 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-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. + +--ausid= + Select audio substream channel. Currently the valid range is 0x55..0x75 + and applies only to MPEG-TS when handled by the native demuxer (not by + libavformat). The format type may not be correctly identified because of + how this information (or lack thereof) is embedded in the stream, but it + will demux correctly the audio streams when multiple substreams are + present. MPlayer prints the available substream IDs when run with + ``--identify``. See also ``--alang``. + +--autoq= + Used with ``--vf=[s]pp``. + Dynamically changes the level of postprocessing depending on the available + spare CPU time. The number you specify will be the maximum level used. + Usually you can use some big number. You have to use ``--vf=[s]pp`` + without parameters in order for this to work. + +--autosub, --no-autosub + Load additional subtitle files matching the video filename. Enabled by + default. See also ``--sub-fuzziness``. + +--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 ``--nosound`` 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 ``--nosound``. 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. + +--benchmark + Prints some statistics on CPU usage and dropped frames at the end of + playback. Use in combination with ``--nosound`` and ``--vo=null`` for + benchmarking only the video codec. + + *NOTE*: With this option MPlayer will also ignore frame duration when + playing only video (you can think of that as infinite fps). + +--bluray-angle= + Some Blu-ray discs contain scenes that can be viewed from multiple angles. + Here you can tell MPlayer which angles to use (default: 1). + +--bluray-chapter= + (Blu-ray only) + Tells MPlayer 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. + +--bpp= + Override the autodetected color depth. Only supported by the fbdev, dga, + svga, vesa video output drivers. + +--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 ``--nocache``. + +--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, MPlayer will wait for the cache to be + filled to this position rather than performing a stream seek (default: + 50). + +--capture + Allows capturing the primary stream (not additional audio tracks or other + kind of streams) into the file specified by ``--dumpfile`` or by default. + If this option is given, capturing can be started and stopped by pressing + the key bound to this function (see section `INTERACTIVE CONTROL`_). Same + as for ``--dumpstream``, this will likely not produce usable results for + anything else than MPEG streams. Note that, due to cache latencies, + captured data may begin and end somewhat delayed compared to what you see + displayed. + +--cdda= + This option can be used to tune the CD Audio reading feature of MPlayer. + + 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). MPlayer 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 (default: 1). + +--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. + +--codecpath= + Specify a directory for binary codecs. + +--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 gl 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 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 + :sd: alias for BT.601 + :hd: alias for BT.709 + :0: compatibility alias for auto (do not use) + :1: compatibility alias for BT.601 (do not use) + :2: compatibility alias for BT.709 (do not use) + :3: compatibility alias for SMPTE-240M (do not use) + +--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. + + 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 (16-235 for luma, 0-255 for 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 fbdev, svga, vesa, xmga, xover, + xv (see ``--vo=xv:ck``) and directx video output drivers. See also + ``--nocolorkey``. + +--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 (default: ``~/.mozilla/`` and + ``~/.netscape/``) and skip reading from default locations. The file is + assumed to be in Netscape format. + +--correct-pts, --no-correct-pts + Switches MPlayer 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. + +--crash-debug + DEBUG CODE. + Automatically attaches gdb upon crash or **SIGTRAP**. Support must be + compiled in by configuring with ``--enable-crash-debug``. + +--cursor-autohide-delay= + Make mouse cursor automatically hide after given number of milliseconds. + A value of -1 will disable cursor autohide. A value of -2 means the cursor + will stay hidden. Supported by video output drivers which use X11 or + OS X Cocoa. + +--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``. + +--display= + (X11 only) + Specify the hostname and display number of the X server you want to + display on. + + *EXAMPLE*: + + ``--display=xtest.localdomain:0`` + +--double, --no-double + Double buffering. The option to disable this exists mostly for debugging + purposes and should not normally be used. + +--doubleclick-time + Time in milliseconds to recognize two consecutive button presses as a + double-click (default: 300). Set to 0 to let your windowing system decide + what a double-click is (``--vo=directx`` only). + +--dr + Turns on direct rendering (not supported by all codecs and video outputs) + + *WARNING*: May cause OSD/SUB corruption! + +--dumpaudio + Dumps raw compressed audio stream to ``./stream.dump`` (useful with + MPEG/AC-3, in most other cases the resulting file will not be playable). + If you give more than one of ``--dumpaudio``, ``--dumpvideo``, + ``--dumpstream`` on the command line only the last one will work. + +--dumpfile= + Specify which file MPlayer should dump to. Should be used together with + ``--dumpaudio`` / ``--dumpvideo`` / ``--dumpstream`` / ``--capture``. + +--dumpjacosub + Convert the given subtitle (specified with the ``--sub`` option) to the + time-based JACOsub subtitle format. Creates a ``dumpsub.js`` file in the + current directory. + +--dumpmicrodvdsub + Convert the given subtitle (specified with the ``--sub`` option) to the + MicroDVD subtitle format. Creates a dumpsub.sub file in the current + directory. + +--dumpmpsub + Convert the given subtitle (specified with the ``--sub`` option) to + MPlayer's subtitle format, MPsub. Creates a dump.mpsub file in the current + directory. + +--dumpsami + Convert the given subtitle (specified with the ``--sub`` option) to the + time-based SAMI subtitle format. Creates a ``dumpsub.smi`` file in the + current directory. + +--dumpsrtsub + Convert the given subtitle (specified with the ``--sub`` option) to the + time-based SubViewer (SRT) subtitle format. Creates a ``dumpsub.srt`` file + in the current directory. + + *NOTE*: Some broken hardware players choke on SRT subtitle files with Unix + line endings. If you are unlucky enough to have such a box, pass your + subtitle files through ``unix2dos`` or a similar program to replace Unix + line endings with DOS/Windows line endings. + +--dumpstream + Dumps the raw stream to ``./stream.dump``. Useful when ripping from DVD or + network. If you give more than one of ``--dumpaudio``, ``--dumpvideo``, + ``--dumpstream`` on the command line only the last one will work. + +--dumpsub + BETA CODE. + Dumps the subtitle substream from VOB streams. Also see the **--dump*sub** + options. + +--dumpvideo + Dump raw compressed video stream to ``./stream.dump`` (not very usable). + If you give more than one of ``--dumpaudio``, ``--dumpvideo``, + ``--dumpstream`` on the command line only the last one will work. + +--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 MPlayer to read the channels list from + . Default is + ``~/.mplayer/channels.conf.{sat,ter,cbl,atsc}`` (based + on your card type) or ``~/.mplayer/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. MPlayer 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 MPlayer 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), MPlayer 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. + +--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). + +--endpos=<[[hh:]mm:]ss[.ms]> + Stop at given time. + + *NOTE*: When used in conjunction with ``--ss`` option, ``--endpos`` time + will shift forward by seconds specified with ``--ss``. + + *EXAMPLE*: + + ``--endpos=56`` + Stop at 56 seconds. + ``--endpos=01:10:00`` + Stop at 1 hour 10 minutes. + ``--ss=10 --endpos=56`` + Stop at 1 minute 6 seconds. + +--extbased, --no-extbased + Enabled by default. + 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. + +--fbmode= + (``--vo=fbdev`` only) + Change video mode to the one that is labeled as in + ``/etc/fb.modes``. + + *NOTE*: VESA framebuffer does not support mode changing. + +--fbmodeconfig= + (``--vo=fbdev`` only) + Override framebuffer mode configuration file (default: ``/etc/fb.modes``). + +--ffactor= + Resample the font alphamap. Can be: + + :0: plain white fonts + :0.75: very narrow black outline (default) + :1: narrow black outline + :10: bold black outline + +--field-dominance=<-1-1> + Set first field for interlaced content. Useful for deinterlacers that + double the framerate: ``--vf=tfields=1``, ``--vf=yadif=1`` and + ``--vo=vdpau:deint``. + + :-1: auto (default): If the decoder does not export the appropriate + information, it falls back to 0 (top field first). + :0: top field first + :1: bottom field first + +--fixed-vo, --no-fixed-vo + ``--fixed-vo`` enforces a fixed video system for multiple files (one + (un)initialization for all files). Therefore only one window will be + opened for all files. Now enabled by default, use ``--no-fixed-vo`` to + disable and create a new window whenever the video stream changes. Some of + the older drivers may not be *fixed-vo* compliant. + +--flip + Flip image upside-down. + +--flip-hebrew + Turns on flipping subtitles using FriBiDi. + +--flip-hebrew-commas, --no-flip-hebrew-commas + Enabled by default. + Change FriBiDi's assumptions about the placements of commas in subtitles. + Use this if commas in subtitles are shown at the start of a sentence + instead of at the end. + +--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 + ``~/.mplayer/subfont.ttf`` with freetype enabled, or + ``~/.mplayer/font/font.desc`` without it. + + *EXAMPLE*: + + - ``--font=~/.mplayer/arial-14/font.desc`` (no fontconfig or freetype) + - ``--font=~/.mplayer/arialuni.ttf`` (no fontconfig) + - ``--font='Bitstream Vera Sans'`` (usual case with fontconfig) + - ``--font='Bitstream Vera Sans:style=Bold'`` (usual case with fontconfig) + +--fontconfig, --no-fontconfig + Enables the use of fontconfig managed fonts. Enabled by default. + +--force-window-position + Forcefully move MPlayer'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. + +--forcedsubsonly + 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. + +--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. See also + ``--hardframedrop``. + +--frames= + Play/convert only first frames, then quit. + +--fribidi-charset= + Specifies the character set that will be passed to FriBiDi when decoding + non-UTF-8 subtitles (default: ISO8859-8). + +--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 ``--xineramascreen`` for the video output drivers that fully + support ``--xineramascreen`` (direct3d, gl, vdpau, x11, xv, corevideo). + + *NOTE*: May not be supported by some of the older VO drivers. + + *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. + +--hardframedrop + More intense frame dropping (breaks decoding). Leads to image distortion! + +--heartbeat-cmd + Command that is executed every 30 seconds during playback via *system()* - + i.e. using the shell. + + *NOTE*: mplayer 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 ``--novideo`` 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*: ``mplayer --heartbeat-cmd="xscreensaver-command + -deactivate" file`` + + *EXAMPLE for GNOME screensaver*: ``mplayer + --heartbeat-cmd="gnome-screensaver-command -p" file`` + +--help + Show short summary of options and key bindings. + +--hr-mp3-seek + Only affects the internal ``audio`` demuxer, which is not used by default + for mp3 files any more. The equivalent functionality is always enabled + with the now default libavformat demuxer for mp3. Hi-res MP3 seeking. + Enabled when playing from an external MP3 file, as we need to seek to the + very exact position to keep A/V sync. Can be slow especially when seeking + backwards since it has to rewind to the beginning to find an exact frame + position. + +--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. + + :off: 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). + :always: 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*: + + ``mplayer --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 + Shorthand for ``--msglevel=identify=4``. Show file parameters in an easily + parseable format. Also prints more detailed information about subtitle and + audio track languages and IDs. In some cases you can get more information + by using ``--msglevel=identify=6``. For example, for a DVD or Blu-ray it + will list the chapters and time length of each title, as well as a disk + ID. Combine this with ``--frames=0`` to suppress all video output. The + wrapper script ``TOOLS/midentify.sh`` suppresses the other MPlayer output + and (hopefully) shellescapes the filenames. + +--idle + Makes MPlayer wait idly instead of quitting when there is no file to play. + Mostly useful in slave mode where MPlayer 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 + 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 MPlayer 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 + MPlayer 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 ``~/.mplayer/``. + + *NOTE*: Autorepeat is currently only supported by joysticks. + + Available commands are: + + conf= + Specify input configuration file other than the default + ``~/.mplayer/input.conf``. ``~/.mplayer/`` 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 MPlayer 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 MPlayer opens both ends so you + can do several `echo "seek 10" > mp_pipe` and the pipe will stay + valid. + +--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. + +--keepaspect, --no-keepaspect + Keep window aspect ratio when resizing windows. Enabled by default. By + default MPlayer tries to keep the correct video aspect ratio by + instructing the window manager to maintain window aspect when resizing, + and by adding black bars if the window manager nevertheless allows window + shape to change. This option disables window manager aspect hints and + scales the video to completely fill the window without regard for aspect + ratio. + +--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 MPlayer 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. + +--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. + +--loadidx= + The file from which to read the video index data saved by ``--saveidx``. + This index will be used for seeking, overriding any index data contained + in the AVI itself. MPlayer will not prevent you from loading an index file + generated from a different AVI, but this is sure to cause unfavorable + results. + + *NOTE*: This option is obsolete now that MPlayer has OpenDML support. + +--loop= + Loops movie playback times. 0 means forever. + +--mc= + Maximum A-V sync correction per frame (in seconds) + +--mf= + Used when decoding from multiple PNG or JPEG files. + + Available options are: + + :w=: input file width (default: autodetect) + :h=: input file height (default: autodetect) + :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 MPlayer 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. + +--monitor-dotclock= + Used with ``--vo=fbdev`` and ``--vo=vesa`` only. + Specify the dotclock or pixelclock range of the monitor. + +--monitor-hfreq= + Used with ``--vo=fbdev`` and ``--vo=vesa`` only. + Specify the horizontal frequency range of the monitor. + +--monitor-vfreq= + Used with ``--vo=fbdev`` and ``--vo=vesa`` only. + Specify the vertical frequency range of the monitor. + +--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 MPlayer 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). + +--msgcharset= + Convert console messages to the specified character set (default: + autodetect). Text will be in the encoding specified with the --charset + configure option. Set this to "noconv" to disable conversion (for e.g. + iconv problems). + + *NOTE*: The option takes effect after command line parsing has finished. + The ``MPLAYER_CHARSET`` environment variable can help you get rid of the + first lines of garbled output. + +--msgcolor + Enable colorful console output on terminals that support ANSI color. + +--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 ``MPLAYER_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. + +--name + Set the window class name for X11-based video output methods. + +--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). + +--noaspect + Ignore aspect ratio information from video file and assume the video has + square pixels. See also ``--aspect``. + +--nobps + (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. + +--nocache + Turn off input stream caching. See ``--cache``. + +--nocolorkey + Disables colorkeying. Only supported by the fbdev, svga, vesa, xmga, + xover, xv (see ``--vo=xv:ck``) and directx video output drivers. + +--noconfig= + 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 + +--noidx + Do not use index present in the file even if one is present. + +--nosound + Do not play sound. Useful for benchmarking. + +--nosub + Disables any otherwise auto-selected internal subtitles (as e.g. the + Matroska/mkv demuxer supports). Use ``--no-autosub`` to disable the + loading of external subtitle files. + +--novideo + Do not play video. With some demuxers this may not work. In those cases + you can try ``--vc=null --vo=null`` instead; but ``--vc=null`` is always + unreliable. + +--ontop + Makes the player window stay on top of other windows. Supported by video + output drivers which use X11, except SDL, as well as directx, corevideo + and ggi. + +--ordered-chapters, --no-ordered-chapters + Enabled by default. + Disable support for Matroska ordered chapters. MPlayer 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=