-codecpath <dir>
Specify a directory for binary codecs.
-codecs-file <filename> (also see -afm, -ac, -vfm, -vc)
Override the standard search path and use the specified file instead of the builtin codecs.conf.
|
-include <configuration file>
Specify configuration file to be parsed after the default ones.
|
-list-options
Prints all available options.
|
-msgcharset <charset>
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 <all=<level>:<module>=<level>:...>
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.
|
-noconfig <options>
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
|
-quiet
Make console output less verbose; in particular, prevents the status line (i.e. A: 0.7 V: 0.6
A-V: 0.068 ...) from being displayed. Particularly useful on slow terminals or broken ones which
do not properly handle carriage return (i.e. \r).
-priority <prio> (Windows and OS/2 only)
Set process priority for MPlayer according to the predefined priorities available under Windows
and OS/2. Possible values of <prio>:
idle|belownormal|normal|abovenormal|high|realtime
WARNING: Using realtime priority can cause system lockup.
|
-profile <profile1,profile2,...>
Use the given profile(s), -profile help displays a list of the defined profiles.
|
-really-quiet (also see -quiet)
Display even less output and status messages than with -quiet.
|
-show-profile <profile>
Show the description and content of a profile.
|
-use-filedir-conf
Look for a file-specific configuration file in the same directory as the file that is being
played.
WARNING: May be dangerous if playing from untrusted media.
|
-v
Increment verbosity level, one level for each -v found on the command line.
|
-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.
|
-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).
|
-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.
|
-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.
|
-nocolorkey
Disables colorkeying. Only supported by the fbdev, svga, vesa, xmga, xover, xv (see -vo xv:ck)
and directx video output drivers.
|
-correct-pts, -nocorrect-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.
|
-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).
|
-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.
|
-fixed-vo, -nofixed-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 -nofixed-vo
to disable and create a new window whenever the video stream changes. Some of the older drivers
may not be fixed-vo compliant.
-framedrop (also see -hardframedrop, experimental without -nocorrect-pts)
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.
|
-h, -help, --help
Show short summary of options.
|
-hardframedrop (experimental without -nocorrect-pts)
More intense frame dropping (breaks decoding). Leads to image distortion! Note that especially
the libmpeg2 decoder may crash with this, so consider using "-vc ffmpeg12,".
|
-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 (also see
-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
|
-hr-seek off|absolute|always
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.
|
-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 (also see -slave)
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.
|
-input <commands>
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:
|
-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.
|
-lircconf <filename> (LIRC only)
Specifies a configuration file for LIRC (default: ~/.lircrc).
|
-list-properties
Print a list of the available properties.
|
-loop <number>
Loops movie playback <number> times. 0 means forever.
|
-menu (OSD menu only)
Turn on OSD menu support.
|
-menu-cfg <filename> (OSD menu only)
Use an alternative menu.conf.
|
-menu-chroot <path> (OSD menu only)
Chroot the file selection menu to a specific location.
EXAMPLE:
-menu-chroot /home
Will restrict the file selection menu to /home and downward (i.e. no access to / will be
possible, but /home/user_name will).
|
-menu-keepdir (OSD menu only)
File browser starts from the last known location instead of current directory.
|
-menu-root <value> (OSD menu only)
Specify the main menu.
|
-menu-startup (OSD menu only)
Display the main menu at MPlayer startup.
|
-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, gl2, direct3d
and corevideo VOs.
|
-noar Turns off AppleIR remote support.
|
-noconsolecontrols
Prevent MPlayer 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.
|
-noinitial-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. This option disables that functionality and 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.
|
-nojoystick
Turns off joystick support.
|
-nolirc
Turns off LIRC support.
|
-nomouseinput
Disable mouse button press/release input (mozplayerxp's context menu relies on this option).
|
-noordered-chapters
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.
|
-pts-association-mode auto|decode|sort
Select the method used to determine which container packet timestamp corresponds to a particular
output frame from the video decoder. Normally you shouldn't need to change this option.
auto Try to pick a working mode from the ones below automatically (default)
decoder
Use decoder reordering functionality.
sort Maintain a buffer of unused pts values and use the lowest value for the frame.
|
-rtc (RTC only)
Turns on usage of the Linux RTC (realtime clock - /dev/rtc) as timing mechanism. This wakes up
the process every 1/1024 seconds to check the current time. Useless with modern Linux kernels
configured for desktop use as they already wake up the process with similar accuracy when using
normal timed sleep.
|
-playing-msg <string>
Print out a string before starting playback. The following expansions are supported:
${NAME}
Expand to the value of the property NAME.
?(NAME:TEXT)
Expand TEXT only if the property NAME is available.
?(!NAME:TEXT)
Expand TEXT only if the property NAME is not available.
|
-playlist <filename>
Play files according to a playlist file (ASX, Winamp, SMIL, or one-file-per-line format).
WARNING: The way MPlayer parses and uses playlist files is not safe against maliciously
constructed files. Such files may trigger harmful actions. This has been the case for all
MPlayer versions, but unfortunately this fact was not well documented earlier, and some people
have even misguidedly recommended use of -playlist with untrusted sources. Do NOT use -playlist
with random internet sources or files you don't trust!
NOTE: This option is considered an entry so options found after it will apply only to the elements
of this playlist.
FIXME: This needs to be clarified and documented thoroughly.
|
-rtc-device <device>
Use the specified device for RTC timing.
|
-shuffle
Play files in random order.
|
-slave (also see -input)
Switches on slave mode, in which MPlayer works as a backend for other programs. Instead of
intercepting keyboard events, MPlayer will read commands separated by a newline (\n) from stdin.
NOTE: See -input cmdlist for a list of slave commands and DOCS/tech/slave.txt for their
description. Also, this is not intended to disable other inputs, e.g. via the video window, use
some other method like -input nodefault-bindings:conf=/dev/null for that.
|
-softsleep
Time frames by repeatedly checking the current time instead of asking the kernel to wake up
MPlayer at the correct time. Useful if your kernel timing is imprecise and you cannot use the RTC
either. Comes at the price of higher CPU consumption.
|
-sstep <sec>
Skip <sec> seconds after every frame. The normal framerate of the movie is kept, so playback is
accelerated. Since MPlayer can only seek to the next keyframe this may be inexact.
|
-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.
|
-aid <ID> (also see -alang)
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.
|
-ausid <ID> (also see -alang)
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.
-alang <language code[,language code,...]> (also see -aid)
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.
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.
|
-audio-demuxer <[+]name> (-audiofile only)
Force audio demuxer type for -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.
|
-reuse-socket (udp:// only)
Allows a socket to be reused by other processes as soon as it is closed.
|
-bandwidth <Bytes> (network only)
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.
-bluray-angle <angle ID> (Blu-ray only)
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 <chapter ID> (Blu-ray only)
Tells MPlayer which Blu-ray chapter to start the current title from (default: 1).
|
-bluray-device <path to disc> (Blu-ray only)
Specify the Blu-ray disc location. Must be a directory with Blu-ray structure.
|
-cache <kBytes>
This option specifies how much memory (in kBytes) to use when precaching a file or URL.
Especially useful on slow media.
|
-nocache
Turns off caching.
|
-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> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
Available options are:
|
-cdrom-device <path to device>
Specify the CD-ROM device (default: /dev/cdrom).
|
-cookies (network only)
Send cookies when making HTTP requests.
|
-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.
|
-delay <sec>
audio delay in seconds (positive or negative float value)
Negative values delay the audio, and positive values delay the video.
|
-ignore-start
Ignore the specified starting time for streams in AVI files. This nullifies stream delays.
|
-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.
|
-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.
|
-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.
|
-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> (DVB only)
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 to device> (DVD only)
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 <factor or speed in KB/s> (DVD only)
Try to limit DVD speed (default: 0, no change). DVD base speed is about 1350KB/s, so a 8x drive
can read at speeds up to 10800KB/s. Slower speeds make the drive more quiet, for watching DVDs
2700KB/s should be quiet and fast enough. MPlayer resets the speed to the drive default value on
close. Values less than 100 mean multiples of 1350KB/s, i.e. -dvd-speed 8 selects 10800KB/s.
NOTE: You need write access to the DVD device to change the speed.
|
-dvdangle <angle ID> (DVD only)
Some DVD discs contain scenes that can be viewed from multiple angles. Here you can tell MPlayer
which angles to use (default: 1).
|
-edl <filename>
Enables edit decision list (EDL) actions during playback. Video will be skipped over and audio
will be muted and unmuted according to the entries in the given file. See
http://www.mplayerhq.hu/DOCS/HTML/en/edl.html for details on how to use this.
-endpos <[[hh:]mm:]ss[.ms]> (also see -ss and -sb)
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.
|
-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).
|
-fps <float value>
Override video framerate. Useful if the original value is wrong or missing.
|
-frames <number>
Play/convert only first <number> frames, then quit.
|
-hr-mp3-seek (MP3 only)
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.
|
-http-header-fields <field1,field2>
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
|
-idx (also see -forceidx)
Rebuilds index of files if no index was found, allowing seeking. Useful with broken/incomplete
downloads, or badly created files.
NOTE: This option only works if the underlying media supports seeking (i.e. not with stdin, pipe,
etc).
|
-noidx Skip rebuilding index file.
|
-ipv4-only-proxy (network only)
Skip the proxy for IPv6 addresses. It will still be used for IPv4 connections.
|
-lavfdopts <option1:option2:...>
Specify parameters for libavformat demuxers (-demuxer lavf). Separate multiple options with a
colon.
Available suboptions are:
|
-loadidx <index file>
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.
|
-mc <seconds/frame>
maximum A-V sync correction per frame (in seconds)
|
-mf <option1:option2:...>
Used when decoding from multiple PNG or JPEG files.
Available options are:
|
-ni (AVI only)
Force usage of non-interleaved AVI parser (fixes playback of some bad AVI files).
|
-nobps (AVI only)
Do not use average byte/second value for A-V sync. Helps with some AVI files with broken header.
|
-noextbased
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.
|
-passwd <password> (also see -user) (network only)
Specify password for HTTP authentication.
|
-prefer-ipv4 (network only)
Use IPv4 on network connections. Falls back on IPv6 automatically.
|
-prefer-ipv6 (IPv6 network only)
Use IPv6 on network connections. Falls back on IPv4 automatically.
|
-psprobe <byte position>
When playing an MPEG-PS or MPEG-PES streams, this option lets you specify how many bytes in the
stream you want MPlayer to scan in order to identify the video codec used. This option is needed
to play EVO or VDR files containing H.264 streams.
|
-pvr <option1:option2:...> (PVR only)
This option tunes various encoding properties of the PVR capture module. It has to be used with
any hardware MPEG encoder based card supported by the V4L2 driver. The Hauppauge WinTV
PVR-150/250/350/500 and all IVTV based cards are known as PVR capture cards. Be aware that only
Linux 2.6.18 kernel and above is able to handle MPEG stream through V4L2 layer. For hardware
capture of an MPEG stream and watching it with MPlayer, use 'pvr://' as a movie URL.
Available options are:
|
-radio <option1:option2:...> (radio only)
These options set various parameters of the radio capture module. For listening to radio with
MPlayer use 'radio://<frequency>' (if channels option is not given) or 'radio://<channel_number>'
(if channels option is given) as a movie URL. You can see allowed frequency range by running
MPlayer with '-v'. To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
If the capture keyword is not given you can listen to radio using the line-in cable only. Using
capture to listen is not recommended due to synchronization problems, which makes this process
uncomfortable.
Available options are:
|
-rawaudio <option1:option2:...>
This option lets you play raw audio files. You have to use -demuxer rawaudio as well. It may
also be used to play audio CDs which are not 44kHz 16-bit stereo. For playing raw AC-3 streams
use -rawaudio format=0x2000 -demuxer rawaudio.
Available options are:
|
-rawvideo <option1:option2:...>
This option lets you play raw video files. You have to use -demuxer rawvideo as well.
Available options are:
|
-referrer <string> (network only)
Specify a referrer path or URL for HTTP requests.
|
-rtsp-port
Used with 'rtsp://' URLs to force the client's port number. This option may be useful if you are
behind a router and want to forward the RTSP stream from the server to a specific client.
|
-rtsp-destination
Used with 'rtsp://' URLs to force the destination IP address to be bound. This option may be
useful with some RTSP server which do not send RTP packets to the right interface. If the
connection to the RTSP server fails, use -v to see which IP address MPlayer tries to bind to and
try to force it to one assigned to your computer instead.
-rtsp-stream-over-tcp (LIVE555 and NEMESI only)
Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP packets be streamed
over TCP (using the same TCP connection as RTSP). This option may be useful if you have a broken
internet connection that does not pass incoming UDP packets (see http://www.live555.com/mplayer/).
|
-rtsp-stream-over-http (LIVE555 only)
Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP packets be streamed
over HTTP.
|
-saveidx <filename>
Force index rebuilding and dump the index to <filename>. Currently this only works with AVI
files.
NOTE: This option is obsolete now that MPlayer has OpenDML support.
|
-sb <byte position> (also see -ss)
Seek to byte position. Useful for playback from CD-ROM images or VOB files with junk at the
beginning.
|
-speed <0.01-100>
Slow down or speed up playback by the factor given as parameter.
|
-srate <Hz>
Select the output sample rate to be used (of course sound cards have limits on this). If the
sample frequency selected is different from that of the current media, the resample or
lavcresample audio filter will be inserted into the audio filter layer to compensate for the
difference. The type of resampling can be controlled by the -af-adv option. The default is fast
resampling that may cause distortion.
|
-ss <time> (also see -sb)
Seek to given time position.
EXAMPLE:
-ss 56
Seeks to 56 seconds.
-ss 01:10:00
Seeks to 1 hour 10 min.
|
-tskeepbroken
Tells MPlayer not to discard TS packets reported as broken in the stream. Sometimes needed to
play corrupted MPEG-TS files.
|
-tsprobe <byte position>
When playing an MPEG-TS stream, this option lets you specify how many bytes in the stream you want
MPlayer to search for the desired audio and video IDs.
|
-tsprog <1-65534>
When playing an MPEG-TS stream, you can specify with this option which program (if present) you
want to play. Can be used with -vid and -aid.
|
-tv <option1:option2:...> (TV/PVR only)
This option tunes various properties of the TV capture module. For watching TV with MPlayer, use
'tv://' or 'tv://<channel_number>' or even 'tv://<channel_name> (see option channels for
channel_name below) as a movie URL. You can also use 'tv:///<input_id>' to start watching a movie
from a composite or S-Video input (see option input for details).
Available options are:
noaudio
no sound
automute=<0-255> (v4l and v4l2 only)
If signal strength reported by device is less than this value, audio and video will be
muted. In most cases automute=100 will be enough. Default is 0 (automute disabled).
|
-tvscan <option1:option2:...> (TV only)
Tune the TV channel scanner. MPlayer will also print value for "-tv channels=" option, including
existing and just found channels.
Available suboptions are:
autostart
Begin channel scanning immediately after startup (default: disabled).
|
-user <username> (also see -passwd) (network only)
Specify username for HTTP authentication.
|
-user-agent <string>
Use <string> as user agent for HTTP streaming.
|
-vid <ID>
Select video channel (MPG: 0-15, ASF: 0-255, MPEG-TS: 17-8190). When playing an MPEG-TS stream,
MPlayer will use the first program (if present) with the chosen video stream.
|
-vivo <suboption> (DEBUG CODE)
Force audio parameters for the VIVO demuxer (for debugging purposes). FIXME: Document this.
|
-ass, -noass (FreeType only)
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 5 (use light hinter for unscaled OSD and no hinting otherwise).
|
-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.
|
-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.
|
-dumpsub (BETA CODE)
Dumps the subtitle substream from VOB streams. Also see the -dump*sub options.
|
-noembeddedfonts
Disables use of fonts embedded in Matroska containers and ASS scripts (default: enabled). These
fonts can be used for SSA/ASS subtitle rendering (-ass option).
|
-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
|
-flip-hebrew (FriBiDi only)
Turns on flipping subtitles using FriBiDi.
|
-noflip-hebrew-commas
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 <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
Search for the OSD/SUB fonts in an alternative directory (default for normal fonts: ~/.mplayer/
font/font.desc, default for FreeType fonts: ~/.mplayer/subfont.ttf).
NOTE: With FreeType, this option determines the path to the text font file. With Fontconfig, this
option determines the Fontconfig font pattern.
EXAMPLE:
-font ~/.mplayer/arial-14/font.desc
-font ~/.mplayer/arialuni.ttf
-font 'Bitstream Vera Sans'
-font 'Bitstream Vera Sans:style=Bold'
|
-fontconfig, -nofontconfig (fontconfig only)
Enables the use of fontconfig managed fonts. Enabled by default.
|
-forcedsubsonly
Display only forced subtitles for the DVD subtitle stream selected by e.g. -slang.
-fribidi-charset <charset name> (FriBiDi only)
Specifies the character set that will be passed to FriBiDi when decoding non-UTF-8 subtitles
(default: ISO8859-8).
|
-ifo <VOBsub IFO file>
Indicate the file that will be used to load palette and frame size for VOBsub subtitles.
|
-noautosub
Turns off automatic subtitle file loading.
|
-osd-duration <time>
Set the duration of the OSD messages in ms (default: 1000).
|
-osd-fractions <0-2>
Set how fractions of seconds of the current timestamp are printed on the OSD:
0 Do not display fractions (default).
1 Show the first two decimals.
2 Show approximate frame count within current second. This frame count is not accurate but
only an approximation. For variable fps, the approximation is known to be far off the
correct frame count.
|
-osdlevel <0-3>
Specifies which mode the OSD should start in.
0 subtitles only
1 volume + seek (default)
2 volume + seek + timer + percentage
3 volume + seek + timer + percentage + total time
|
-overlapsub
Allows the next subtitle to be displayed while the current one is still visible (default is to
enable the support only for specific formats).
-sid <ID> (also see -slang, -vobsubid)
Display the subtitle stream specified by <ID> (0-31). MPlayer prints the available subtitle IDs
when run in verbose (-v) mode. If you cannot select one of the subtitles on a DVD, also try
-vobsubid.
|
-nosub Disables any otherwise auto-selected internal subtitles (as e.g. the Matroska/mkv demuxer
supports). Use -noautosub to disable the loading of external subtitle files.
-slang <language code[,language code,...]> (also see -sid)
Specify a priority list of subtitle languages to use. Different container formats employ
different language codes. DVDs use ISO 639-1 two letter language codes, Matroska uses 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.
EXAMPLE:
mplayer dvd://1 -slang hu,en
Chooses the Hungarian subtitle track on a DVD and falls back on English if Hungarian is
not available.
mplayer -slang jpn example.mkv
Plays a Matroska file with Japanese subtitles.
|
-spuaa <mode>
Antialiasing/scaling mode for DVD/VOBsub. A value of 16 may be added to <mode> in order to force
scaling even when original and scaled frame size already match. This can be employed to e.g.
smooth subtitles with gaussian blur. Available modes are:
0 none (fastest, very ugly)
1 approximate (broken?)
2 full (slow)
3 bilinear (default, fast and not too bad)
4 uses swscaler gaussian blur (looks very good)
|
-spualign <-1-2>
Specify how SPU (DVD/VOBsub) subtitles should be aligned.
-1 original position
0 Align at top (original behavior, default).
1 Align at center.
2 Align at bottom.
|
-spugauss <0.0-3.0>
Variance parameter of gaussian used by -spuaa 4. Higher means more blur (default: 1.0).
|
-sub <subtitlefile1,subtitlefile2,...>
Use/display these subtitle files. Only one file can be displayed at the same time.
|
-sub-bg-alpha <0-255>
Specify the alpha channel value for subtitles and OSD backgrounds. Big values mean more
transparency. 0 means completely transparent.
|
-sub-bg-color <0-255>
Specify the color value for subtitles and OSD backgrounds. Currently subtitles are grayscale so
this value is equivalent to the intensity of the color. 255 means white and 0 black.
-sub-demuxer <[+]name> (-subfile only) (BETA CODE)
Force subtitle demuxer type for -subfile. Use a '+' before the name to force it, this will skip
some checks! Give the demuxer name as printed by -sub-demuxer help.
|
-sub-fuzziness <mode>
Adjust matching fuzziness when searching for subtitles:
0 exact match
1 Load all subs containing movie name.
2 Load all subs in the current and -sub-paths directories.
|
-sub-no-text-pp
Disables any kind of text post processing done after loading the subtitles. Used for debug
purposes.
|
-subalign <0-2>
Specify which edge of the subtitles should be aligned at the height given by -subpos.
0 Align subtitle top edge (original behavior).
1 Align subtitle center.
2 Align subtitle bottom edge (default).
|
-subcc <1-4>
Display DVD Closed Caption (CC) subtitles from the specified channel. These are not the VOB
subtitles, these are special ASCII subtitles for the hearing impaired encoded in the VOB userdata
stream on most region 1 DVDs. CC subtitles have not been spotted on DVDs from other regions so
far.
|
-subcp <codepage> (iconv only)
If your system supports iconv(3), you can use this option to specify the subtitle codepage.
EXAMPLE:
-subcp latin2
-subcp cp1250
-subcp enca:<language>:<fallback codepage> (ENCA only)
You can specify your language using a two letter language code to make ENCA detect the codepage
automatically. If unsure, enter anything and watch mplayer -v output for available languages.
Fallback codepage specifies the codepage to use, when autodetection fails.
EXAMPLE:
-subcp enca:cs:latin2
Guess the encoding, assuming the subtitles are Czech, fall back on latin 2, if the
detection fails.
-subcp enca:pl:cp1250
Guess the encoding for Polish, fall back on cp1250.
|
-sub-paths <path1:path2:...>
Specify extra directories where to search for subtitles matching the video. Multiple directories
can be separated by ":" (";" on Windows). Paths can be relative or absolute. Relative paths are
interpreted relative to video file directory.
EXAMPLE: Assuming that /path/to/movie/movie.avi is played and -sub-paths sub:subtitles:/tmp/subs
is specified, MPlayer searches for subtitle files in these directories:
/path/to/movie/
/path/to/movie/sub/
/path/to/movie/subtitles/
/tmp/subs/
~/.mplayer/sub/
|
-subdelay <sec>
Delays subtitles by <sec> seconds. Can be negative.
|
-subfile <filename> (BETA CODE)
Currently useless. Same as -audiofile, but for subtitle streams (OggDS?).
-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
Sets the subtitle font (see -font). If no -subfont is given, -font is used.
|
-subfont-autoscale <0-3> (FreeType only)
Sets the autoscale mode.
NOTE: 0 means that text scale and OSD scale are font heights in points.
The mode can be:
0 no autoscale
1 proportional to movie height
2 proportional to movie width
3 proportional to movie diagonal (default)
|
-subfont-blur <0-8> (FreeType only)
Sets the font blur radius (default: 2).
|
-subfont-encoding <value> (FreeType only)
Sets the font encoding. When set to 'unicode', all the glyphs from the font file will be rendered
and unicode will be used (default: unicode).
|
-subfont-osd-scale <0-100> (FreeType only)
Sets the autoscale coefficient of the OSD elements (default: 6).
|
-subfont-outline <0-8> (FreeType only)
Sets the font outline thickness (default: 2).
|
-subfont-text-scale <0-100> (FreeType only)
Sets the subtitle text autoscale coefficient as percentage of the screen size (default: 5).
|
-subfps <rate>
Specify the framerate of the subtitle file (default: movie fps).
NOTE: <rate> > movie fps speeds the subtitles up for frame-based subtitle files and slows them
down for time-based ones.
|
-subpos <0-100> (useful with -vf expand)
Specify the position of subtitles on the screen. The value is the vertical position of the
subtitle in % of the screen height.
|
-subwidth <10-100>
Specify the maximum width of subtitles on the screen. Useful for TV-out. The value is the width
of the subtitle in % of the screen width.
|
-noterm-osd
Disable the display of OSD messages on the console when no video output is available.
|
-term-osd-esc <escape sequence>
Specify the escape sequence to use before writing an OSD message on the console. The escape
sequence should move the pointer to the beginning of the line used for the OSD and clear it
(default: ^[[A\r^[[K).
|
-unicode
Tells MPlayer to handle the subtitle file as unicode.
-unrarexec <path to unrar executable> (not supported on MingW)
Specify the path to the unrar executable so MPlayer can use it to access rar-compressed VOBsub
files (default: not set, so the feature is off). The path must include the executable's filename,
i.e. /usr/local/bin/unrar.
|
-utf8
Tells MPlayer to handle the subtitle file as UTF-8.
|
-vobsub <VOBsub file without extension>
Specify a VOBsub file to use for subtitles. Has to be the full pathname without extension, i.e.
without the '.idx', '.ifo' or '.sub'.
|
-vobsubid <0-31>
Specify the VOBsub subtitle ID.
|
-abs <value> (-ao oss only) (OBSOLETE)
Override audio driver/card buffer size detection.
-format <format> (also see the format audio filter)
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.
|
-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.
|
-mixer <device>
Use a mixer device different from the default /dev/mixer. For ALSA this is the mixer name.
-mixer-channel <mixer line>[,mixer index] (-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 <name,number> format,
i.e. a channel labeled 'PCM 1' in alsamixer must be converted to PCM,1.
|
-softvol
Force the use of the software mixer, instead of using the sound card mixer.
|
-softvol-max <10.0-10000.0>
Set the maximum amplification level in percent (default: 110). A value of 200 will allow you to
adjust the volume up to a maximum of double the current level. With values below 100 the initial
volume (which is 100%) will be above the maximum, which e.g. the OSD cannot display correctly.
|
-volstep <0-100>
Set the step size of mixer volume changes in percent of the whole range (default: 3).
|
-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.
|
-bpp <depth>
Override the autodetected color depth. Only supported by the fbdev, dga, svga, vesa video output
drivers.
|
-border
Play movie with window border and decorations. Since this is on by default, use -noborder 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.
|
-contrast <-100-100>
Adjust the contrast of the video signal (default: 0). Not supported by all video output drivers.
|
-display <name> (X11 only)
Specify the hostname and display number of the X server you want to display on.
EXAMPLE:
-display xtest.localdomain:0
|
-dr
Turns on direct rendering (not supported by all codecs and video outputs)
WARNING: May cause OSD/SUB corruption!
|
-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).
|
-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.
|
-fs (also see -zoom)
Fullscreen playback (centers movie, and paints black bands around it). Not supported by all video
output drivers.
-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:
layer,stays_on_top,above,fullscreen
Default order, will be used as a fallback if incorrect or unsupported modes are specified.
-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.
|
-geometry x[%][:y[%]] or [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, gl2, 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.
|
-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.
|
-name (X11 only)
Set the window class name.
|
-nodouble
Disables double buffering, mostly for debugging purposes. Double buffering fixes flicker by
storing two frames in memory, and displaying one while decoding another. It can affect OSD
negatively, but often removes OSD flickering.
|
-nograbpointer
Do not grab the mouse pointer after a video mode change (-vm). Useful for multihead setups.
|
-nokeepaspect
Do not keep window aspect ratio when resizing windows. 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.
|
-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, quartz, ggi and gl2.
|
-panscan <0.0-1.0>
Enables pan-and-scan functionality (cropping the sides of e.g. a 16:9 movie to make it fit a 4:3
display without black bands). The range controls how much of the image is cropped. May not work
with all video output drivers.
NOTE: Values between -1 and 0 are allowed as well, but highly experimental and may crash or worse.
Use at your own risk!
|
-panscanrange <-19.0-99.0> (experimental)
Change the range of the pan-and-scan functionality (default: 1). Positive values mean multiples
of the default range. Negative numbers mean you can zoom in up to a factor of -panscanrange+1.
E.g. -panscanrange -3 allows a zoom factor of up to 4. This feature is experimental. Do not
report bugs unless you are using -vo gl.
|
-refreshrate <Hz>
Set the monitor refreshrate in Hz. Currently only supported by -vo directx combined with the -vm
option.
|
-rootwin
Play movie in the root window (desktop background). Desktop background images may cover the movie
window, though. May not work with all video output drivers.
|
-saturation <-100-100>
Adjust the saturation of the video signal (default: 0). You can get grayscale output with this
option. Not supported by all video output drivers.
|
-screenh <pixels>
Specify the screen height for video output drivers which do not know the screen resolution like
fbdev, x11 and TV-out.
|
-screenw <pixels>
Specify the screen width for video output drivers which do not know the screen resolution like
fbdev, x11 and TV-out.
|
-stop-xscreensaver (X11 only)
Turns off xscreensaver at startup and turns it on again on exit. If your screensaver supports
neither the XSS nor XResetScreenSaver API please use -heartbeat-cmd instead.
|
-title (also see -use-filename-title)
Set the window title. Supported by X11-based video output drivers.
|
-use-filename-title (also see -title)
Set the window title using the media filename, when not set with -title. Supported by X11-based
video output drivers.
|
-vm
Try to change to a different video mode. Supported by the dga, x11, xv, sdl and directx video
output drivers. If used with the directx video output driver the -screenw, -screenh, -bpp and
-refreshrate options can be used to set the new display mode.
|
-vsync
Enables VBI for the vesa, dfbmga and svga video output drivers.
-wid <window ID> (X11, OpenGL and DirectX only)
This tells MPlayer to attach to an existing window. Useful to embed MPlayer in a browser (e.g.
the plugger extension). This option fills the given window completely, thus aspect scaling,
panscan, etc are no longer handled by MPlayer but must be managed by the application that created
the window.
|
-xineramascreen <-2-...>
In Xinerama configurations (i.e. a single desktop that spans across multiple displays) this option
tells MPlayer which screen to display the movie on. A value of -2 means fullscreen across the
whole virtual display (in this case Xinerama information is completely ignored), -1 means
fullscreen on the display the window currently is on. The initial position set via the -geometry
option is relative to the specified screen. Will usually only work with "-fstype -fullscreen" or
"-fstype none". This option is not suitable to only set the startup screen (because it will
always display on the given screen in fullscreen mode), -geometry is the best that is available
for that purpose currently. Supported by at least the direct3d, gl, gl2, x11, xv and corevideo
video output drivers.
|
-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.
|
-af-adv <force=(0-7):list=(filters)> (also see -af)
Specify advanced audio filter options:
|
-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.
|
-aspect <ratio> (also see -zoom)
Override movie aspect ratio, in case aspect information is incorrect or missing in the file being
played.
EXAMPLE:
-aspect 4:3 or -aspect 1.3333
-aspect 16:9 or -aspect 1.7777
|
-noaspect
Disable automatic movie aspect ratio compensation.
|
-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
|
-flip
Flip image upside-down.
|
-lavdopts <option1:option2:...> (DEBUG CODE)
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).
|
-noslices
Disable drawing video by 16-pixel height slices/bands, instead draws the whole frame in a single
run. May be faster or slower, depending on video card and available cache. It has effect only
with libmpeg2 and libavcodec codecs.
|
-nosound
Do not play sound. Useful for benchmarking.
|
-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.
-pp <quality> (also see -vf pp)
Set the DLL postprocess level. This option is no longer usable with -vf pp. It only works with
Win32 DirectShow DLLs with internal postprocessing routines. The valid range of -pp values varies
by codec, it is mostly 0-6, where 0=disable, 6=slowest/best.
|
-pphelp (also see -vf pp)
Show a summary about the available postprocess filters and their usage.
|
-ssf <mode>
Specifies software scaler parameters.
EXAMPLE:
-vf scale -ssf lgb=3.0
lgb=<0-100>
gaussian blur filter (luma)
cgb=<0-100>
gaussian blur filter (chroma)
ls=<-100-100>
sharpen filter (luma)
cs=<-100-100>
sharpen filter (chroma)
chs=<h>
chroma horizontal shifting
cvs=<v>
chroma vertical shifting
|
-stereo <mode>
Select type of MP2/MP3 stereo output.
0 stereo
1 left channel
2 right channel
-sws <software scaler type> (also see -vf scale and -zoom)
Specify the software scaler algorithm to be used with the -zoom option. This affects video output
drivers which lack hardware acceleration, e.g. x11.
Available types are:
0 fast bilinear
1 bilinear
2 bicubic (good quality) (default)
3 experimental
4 nearest neighbor (bad quality)
5 area
6 luma bicubic / chroma bilinear
7 gauss
8 sincR
9 lanczos
10 natural bicubic spline
NOTE: Some -sws options are tunable. The description of the scale video filter has further
information.
|
-vc <[-|+]codec1,[-|+]codec2,...[,]>
Specify a priority list of video 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 -vc help for a full list of available codecs.
EXAMPLE:
-vc divx
Force Win32/VfW DivX codec, no fallback.
-vc -divxds,-divx,
Skip Win32 DivX codecs.
-vc ffmpeg12,mpeg12,
Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
|
-vfm <driver1,driver2,...>
Specify a priority list of video codec families to be used, according to their names in
codecs.conf. Falls back on the default codecs if none of the given codec families work.
NOTE: See -vfm help for a full list of available codec families.
EXAMPLE:
-vfm ffmpeg,dshow,vfw
Try the libavcodec, then Directshow, then VfW codecs and fall back on others, if they do
not work.
-vfm xanim
Try XAnim codecs first.
|
-x <x> (also see -zoom)
Scale image to width <x> (if software/hardware scaling is available). Disables aspect
calculations.
|
-xvidopts <option1:option2:...>
Specify additional parameters when decoding with Xvid.
NOTE: Since libavcodec is faster than Xvid you might want to use the libavcodec postprocessing
filter (-vf pp) and decoder (-vfm ffmpeg) instead.
Xvid's internal postprocessing filters:
deblock-chroma (also see -vf pp)
chroma deblock filter
deblock-luma (also see -vf pp)
luma deblock filter
dering-luma (also see -vf pp)
luma deringing filter
dering-chroma (also see -vf pp)
chroma deringing filter
filmeffect (also see -vf noise)
Adds artificial film grain to the video. May increase perceived quality, while lowering
true quality.
rendering methods:
dr2
Activate direct rendering method 2.
nodr2
Deactivate direct rendering method 2.
|
-xy <value> (also see -zoom)
value<=8
Scale image by factor <value>.
value>8
Set width to value and calculate height to keep correct aspect ratio.
|
-y <y> (also see -zoom)
Scale image to height <y> (if software/hardware scaling is available). Disables aspect
calculations.
|
-zoom
Allow software scaling, where available. This will allow scaling with output drivers (like x11,
fbdev) that do not support hardware scaling where MPlayer disables scaling by default for
performance reasons.
|
-vf <filter>=help
Prints the parameter names and parameter value ranges for a particular filter.
|