diff options
Diffstat (limited to 'DOCS/man/en/options.rst')
-rw-r--r-- | DOCS/man/en/options.rst | 2517 |
1 files changed, 2517 insertions, 0 deletions
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=<level> + Select the Dynamic Range Compression level for AC-3 audio streams. <level> + 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=<value> + (``--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=<value> + 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=<filter1[=parameter1:parameter2:...],filter2,...> + 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=<force=(0-7):list=(filters)> + 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=<filters> + Same as ``--af``. + +--afm=<driver1,driver2,...> + 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=<ID> + 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=<languagecode[,languagecode,...]> + 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=<driver1[:suboption1[=value]:...],driver2,...[,]> + 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=<ratio> + 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=<value> + Sets the border (outline) color for text subtitles. The color format is + RRGGBBAA. + +--ass-bottom-margin=<value> + Adds a black band at the bottom of the frame. The SSA/ASS renderer can + place subtitles there (with ``--ass-use-margins``). + +--ass-color=<value> + Sets the color for text subtitles. The color format is RRGGBBAA. + +--ass-font-scale=<value> + 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=<type> + Set hinting type. <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=<value> + Set line spacing value for SSA/ASS renderer. + +--ass-styles=<filename> + 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=<value> + 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=<filename> + Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a + movie. + +--audiofile-cache=<kBytes> + Enables caching for the stream used by ``--audiofile``, using the + specified amount of memory. + +--ausid=<ID> + 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=<quality> + 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=<factor> + 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=<Bytes> + 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=<ID> + 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=<ID> + (Blu-ray only) + Tells MPlayer which Blu-ray chapter to start the current title from + (default: 1). + +--bluray-device=<path> + (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=<depth> + 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=<kBytes> + 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=<percentage> + Playback will start when the cache has been filled up to <percentage> of + the total. + +--cache-seek-min=<percentage> + If a seek is to be made to a position within <percentage> 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=<option1:option2> + This option can be used to tune the CD Audio reading feature of MPlayer. + + Available options are: + + speed=<value> + 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=<value> + Use specified generic SCSI device. + + sector-size=<value> + Set atomic read size. + + overlap=<value> + Force minimum overlap search during verification to <value> 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=<value> + Add <value> sectors to the values reported when addressing tracks. May + be negative. + + (no)skip + (Never) accept imperfect data reconstruction. + +--cdrom-device=<path> + Specify the CD-ROM device (default: ``/dev/cdrom``). + +--channels=<number> + 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=<start[-end]> + Specify which chapter to start playing at. Optionally specify which + chapter to end playing at (default: 1). + +--chapter-merge-threshold=<number> + 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=<dir> + Specify a directory for binary codecs. + +--codecs-file=<filename> + Override the standard search path and use the specified file instead of + the builtin codecs.conf. + +--colormatrix=<colorspace> + 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=<color-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=<color-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=<number> + 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=<filename> + (network only) + Read HTTP cookies from <filename> (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=<number> + 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=<sec> + 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=<name> + (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=<filename> + 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=<options> + 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=<filename>: Instructs MPlayer to read the channels list from + <filename>. 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=<path> + 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=<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=<ID> + Some DVD discs contain scenes that can be viewed from multiple angles. + Here you can tell MPlayer which angles to use (default: 1). + +--edition=<ID> + (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=<filename> + 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=<modename> + (``--vo=fbdev`` only) + Change video mode to the one that is labeled as <modename> in + ``/etc/fb.modes``. + + *NOTE*: VESA framebuffer does not support mode changing. + +--fbmodeconfig=<filename> + (``--vo=fbdev`` only) + Override framebuffer mode configuration file (default: ``/etc/fb.modes``). + +--ffactor=<number> + 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=<pattern-or-filename> + 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=<format> + Select the sample format used for output from the audio filter layer to + the sound card. The values that <format> can adopt are listed below in the + description of the ``format`` audio filter. + +--fps=<float> + 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=<number> + Play/convert only first <number> frames, then quit. + +--fribidi-charset=<name> + 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=<type1,type2,...> + (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=<x[%][:y[%]]>, --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 |