mplayer is a movie player
for LINUX (runs on many other Unices and non-x86 CPUs, see the documentation).
It plays most MPEG/:VOB, AVI, ASF/:WMA/:WMV, RM, QT/:MOV/:MP4, OGG/:OGM,
VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
native, XAnim, and Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx,
DivX 3/:4/:5 and even WMV movies, too (without using the avifile library).

Another great feature of MPlayer is the wide range of supported output
drivers. It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB,
but you can also use GGI, SDL (and this way all their drivers), VESA (on
every VESA compatible card, even without X11), some low level card-specific
drivers (for Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards,
such as the Siemens DVB, DXR2 and DXR3/:Hollywood+. Most of them support
software or hardware scaling, so you can enjoy movies in fullscreen.

Every 'flag' option has a 'noflag' counterpart, e.g. the opposite
of the -fs option is -nofs.

You can put all of the options in a configuration
file which will be read every time mplayer is run. The system-wide configuration
file 'mplayer.conf' is in your configuration directory (e.g. /etc/:mplayer or
/usr/:local/:etc/:mplayer), the user specific one is '~/:.mplayer/:config'.
User specific options override system-wide options and options given on
the command line override either. The syntax of the configuration files
is 'option=<value>', everything after a '#' is considered a comment. Options that
work without values can be enabled by setting them to 'yes' or '1' and disabled
by setting them to 'no' or '0'. Even suboptions can be specified in this way.

You can also write file-specific configuration files.
If you wish to have a config file for a file called 'movie.avi', create a
file named 'movie.avi.conf' with the file-specific options in it and put it
in ~/.mplayer or in the same directory as the file.

Read data from stdin. The -idx option does not work in conjunction
with this.

-autoq <quality> (use with -vop pp)

Dynamically changes the level
of postprocessing depending on 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 -vop pp without parameters in order to use this.

-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 used. An uneven video
frame rate 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. Use in combination with -nosound and -vo null for benchmarking
only the video codec.

-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 DOCS/documentation.html#edl
for details on how to use this.

-edlout <filename>

Creates a new file and writes
edit decision list (EDL) records to that file. During playback, when the
user hits 'i', an entry to skip over the last two seconds of playback will
be written to the file. This provides a starting point from which the user
can fine-tune EDL entries later. See DOCS/documentation.html#edl for details.

-enqueue (GUI only)

Enqueue files given on the command line in the playlist
instead of playing them immediately.

-fixed-vo (BETA CODE!)

Enforces a fixed
video system for multiple files (one (un)initialisation for all files).
Therefore only one window will be opened for all files. Currently the following
drivers are fixed-vo compliant: x11, xv, xvidix, xmga, gl2, and svga.

-framedrop
(also see -hardframedrop)

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.

Play files according to a playlist (1 file per row or Winamp or ASX
format).

-quiet

Display less output and status messages.

-really-quiet

Display
even less output and status messages.

-sdp

Specifies that the input file
is a SDP ('Session Description Protocol') file that describes an RTP session
(see http://www.live.com/mplayer/).

-shuffle

Play files in random order.

-skin
<skin directory> (BETA CODE)

Load skin from the given directory (WITHOUT path
name).

EXAMPLE:

-skin fittyfene

tries Skin/fittyfene. It first checks /usr/local/share/mplayer/
and afterwards ~/.mplayer/.

-slave

This option switches on slave mode. This
is intended for use of MPlayer as a backend to other programs. Instead of
intercepting keyboard events, MPlayer will read simplistic command lines
from its stdin. The section SLAVE MODE PROTOCOL explains the syntax.

-softsleep

Uses high quality software timers. As precise as the RTC without requiring
special privileges. Comes at the price of higher CPU consumption.

Works only for
DVD playback. It selects the DVD audio language and always tries to play
audio streams whose language matches the given code. For the list of available
languages, use with the -v option and look at the output.

EXAMPLE:

-alang
hu,en

Plays Hungarian and falls back to English if Hungarian is not available.

Play audio from an external file (WAV,
MP3 or Ogg Vorbis) while viewing a movie.

-bandwidth <value>

Specify the maximum
bandwidth for network streaming (for servers that are able to send content
in different bitrates). Usefull if you want to watch live streamed media
behind a slow connection.

-cdrom-device <path to device>

Override default CDROM
drive name /dev/:cdrom.

-cache <kbytes>

This option specifies how much memory
(in kbytes) to use when precaching a file/:URL. Especially useful on slow
media (default is -nocache).

-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

0: disable checking
1: overlap checking only (default)
2:

full data correction and verification

generic-dev=<value>

use specified
generic SCSI device

sector-size=<value>

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.

-channels <number>

Change the number of playback channels, defaults to '2'
if not specified. If the number of output channels is bigger than the number
of input channels empty channels are inserted (unless mixing from mono
to stereo, then the mono channel is repeated in both output channels). If
the number of output channels is smaller than the number of input channels,
results depend on the audio decoder (-afm). MPlayer asks the decoder to decode
the audio into as many channels as specified. Now it's up to the decoder
to fulfill the requirement. If the decoder outputs more channels than requested,
the exceeding channels are truncated. This is usually only important when
playing videos with AC3 audio (like DVDs). In that case liba52 does the
decoding by default and correctly downmixes the audio into the requested
number of channels.

NOTE:
This option is honored by codecs (AC3 only) filters (surround) and ao drivers
(OSS at least).
Available options are:

2

Stereo

4

Surround

6

Full 5.1

-chapter <chapter id>[-<end chapter id>]

Specify which chapter to start playing at. Optionally specify which chapter
to end playing at (default: 1). Examples can be found below.

-csslib <filename>

(old-style DVD option) This option is used to override the default location
of libcss.so.

-cuefile <filename> (see -vcd too)

Play (S)VCD from CDRwin's (bin/cue
fileformat) disk image, described by the specified file.

Specify which file MPlayer should dump to. Should be used
together with -dumpaudio / -dumpvideo / -dumpstream.

-dumpstream (MPLAYER only)

Dumps the raw stream to ./:stream.dump. Useful when ripping from DVD or network.

-dumpvideo (MPLAYER only)

Dump raw compressed video stream to ./:stream.dump
(not very usable).

-dvd <title id>

Tell MPlayer which movies (specified by title
id) to play. For example sometimes '1' is a trailer, and '2' is the real movie.

NOTE:
Sometimes deinterlacing is required for DVD playback, see the -vop pp=0x20000
option.

-dvd-device <path to device>

Override default DVD device name /dev/:dvd.

-dvdangle <angle id>

Some DVD discs contain scenes that can be viewed from
multiple angles. Here you can tell MPlayer which angles to use (default:
1). Examples can be found below.

-dvdauth <DVD device>

(old-style DVD option)
Turns on DVD authentication using the given device.

-dvdkey <CSS key>

(old-style
DVD option) When decoding a VOB file copied undecrypted from DVD, this
option gives the CSS key needed to decrypt the VOB (the key is printed
when authenticating with the DVD drive using -dvdauth).

-dvdnav (BETA CODE!)

Force usage of libdvdnav.

-forceidx

Force rebuilding of INDEX. Useful for
files with broken index (desyncs, etc). Seeking will be possible. You can
fix the index permanently with MEncoder (see the documentation).

Hi-res mp3 seeking. Default is: enabled when playing
from external MP3 file, as we need to seek to the very exact position to
keep A/:V sync. It can be slow especially when seeking backwards - it has
to rewind to the beginning to find the exact frame.

-idx (also see -forceidx)

Rebuilds INDEX of the AVI if no INDEX was found, thus allowing seeking.
Useful with broken/:incomplete downloads, or badly created AVIs.

-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:

on

turns on multifile support

w=<value>

width of
the output (autodetect)

h=<value>

height of the output (autodetect)

fps=<value>

fps of the output (default: 25)

type=<value>

type of input files (available
types: jpeg, png, tga)

-ni (.AVI only)

Force usage of non-interleaved AVI
parser (fixes playing of some bad AVI files).

-nobps (.AVI only)

Do not use
average byte/:sec value for A-V sync (AVI). Helps with some AVI files with
broken header.

-noextbased

Disables filename-extension based demuxer selection.
By default, when 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 demuxer. It always falls back to content-based demuxer selection.

This option lets you play raw audio files. It
may also be used to play audio CDs which are not 44KHz 16Bit stereo.
Available options are:

on

use raw audio demuxer

channels=<value>

number
of channels

rate=<value>

rate in samples per second

samplesize=<value>

sample
size in byte

format=<value>

fourcc in hex

-rawvideo <option1:option2:...>

This
option lets you play raw video files.
Available options are:

on

use raw video demuxer

fps=<value>

rate in frames
per second, default 25.0

sqcif|qcif|cif|4cif|pal|ntsc

set standard image size

w=<value>

image width in pixels

h=<value>

image height in pixels

y420|yv12|yuy2|y8

set colorspace

format=<value>

colorspace (fourcc) in hex

size=<value>

frame
size in bytes

-rtsp-stream-over-tcp

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.live.com/mplayer/).

-skipopening

Skip DVD opening (dvdnav only).

-sb <byte position> (see -ss option too)

Seek to byte position. Useful for playback
from CDROM images / .VOB files with junk at the beginning.

NOTE:
MPlayer doesn't accept colons so type dots instead in the device ID (e.g.
hw.0,0 instead of hw:0,0).
Be advised that although you can select any samplerate when using ALSA,
the LAME audio codec is able to encode only the 'standard' samplerates. You'll
get an .avi file with no sound when you choose an odd samplerate and use
this codec.
Available options are:

on

use TV input

noaudio

no sound

driver=<value>

available: dummy, v4l, bsdbt848

device=<value>

Specify other device than
the default /dev/:video0.

input=<value>

Specify other input than the default
0 (Television) (see output for a list)

freq=<value>

Specify the frequency
to set the tuner to (e.g. 511.250). Not compatible with channels parameter.

Set names for channels.
Use _ for spaces in names (or play with quoting ;-). The channel names will
then be written using OSD, and the commands tv_step_channel, tv_set_channel
and tv_last_channel will then be usable using a remote (see lirc). Not compatible
with frequency parameter. Warning: The channel number will then be the position
in the 'channels' list, beginning with 1. Example: use tv://1, tv://2, tv_set_channel
1, tv_set_channel 2, etc.

audiorate=<value>

set audio capture bitrate

forceaudio

capture audio even if there are no audio sources reported by v4l

alsa

capture
from ALSA

amode=<0-3>

choose an audio mode:

0: mono
1: stereo
2: language 1
3:

language 2

forcechan=<1-2>

By default, the count of recorded audio channels
is determined automatically by querying the audio mode from the tv card.
This option allows to force stereo/:mono recording regardless of the amode
option and the values returned by v4l. This can be used for troubleshooting
when the tv card is unable to report the current audio mode.

adevice=<value>

set an audio device

/dev/:... for OSS

hardware ID for ALSA

audioid=<value>

choose an audio output of the capture
card, if it has more of them

[volume|bass|treble|balance]=<0-65535>

These options
set parameters of the mixer on the video capture card. They will have no
effect, if your card doesn't have one.

immediatemode=<bool>

A value of 0 means
capture and buffer audio and video together (default for mencoder). A value
of 1 (default for mplayer) means to do video capture only and let the audio
go through a loopback cable from the TV card to the soundcard.

Convert the given subtitle
(specified with the -sub option) to the MicroDVD subtitle format. Creates
a dumpsub.sub file in the current directory.

-dumpmpsub (MPLAYER only)

Convert
the given subtitle (specified with the -sub option) to MPlayer's subtitle
format, MPsub. Creates a dump.mpsub file in the current directory.

-dumpsrtsub
(MPLAYER only)

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.

-dumpjacosub (MPLAYER only)

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.

-dumpsami (MPLAYER only)

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.

-dumpsub (MPLAYER only) (BETA CODE)

Dumps the subtitle substream from VOB
streams. See -dump*sub and -vobsubout* options too.

-ifo <vobsub ifo file>

Indicate
the file that will be used to load palette and frame size for VOBSUB subtitles.

-ffactor <number>

Resample alphamap of the font. Can be:

0

plain white fonts

0.75

very narrow black outline (default)

1

narrow black outline

10

bold
black outline

-font <path to font.desc file>

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 path to the text font file.
The -subfont-* options are available only with FreeType support compiled
in.

EXAMPLE:

-font ~/:.mplayer/:arial-14/:font.desc

-font ~/:.mplayer/:arialuni.ttf

-noautosub

Turns off automatic loading of
subtitle files.

-overlapsub

Enables overlapping subtitles support for all
subtitles formats.

-nooverlapsub

Disables overlapping subtitles support for
all subtitles formats (default behaviour is to enable the support only
for specific formats).

-osdlevel <0-3> (MPLAYER only)

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

-sid <id> (also see -slang option)

Turns on DVD subtitle displaying.
Also, you MUST specify a number which corresponds to a DVD subtitle language
(0-31). For the list of available subtitles, use with the -v option and look
at the output.

-slang <two letter country code> (also see -sid option)

Works only
for DVD playback. Turns on/:selects DVD subtitle language. For the list of
available subtitles, use with the -v option and look at the output.

EXAMPLE:

-slang hu,en

Selects Hungarian and falls back to English if Hungarian
is not available.

-sub <subtitle file>

Use/:display this subtitle file.

-sub-bg-alpha
<0-255>

Specify the alpha channel value for subtitles and OSD backgrounds.
Big values mean more transparency. The 0 value is an exception and means
completly transparent.

-sub-bg-color <0-255>

Specify the color value for subtitles
and OSD backgrounds. Currently subtitles are grayscale so this value is
equivalente to the intensity of the color. The 255 value means white and
0 black.

-subcc

Display DVD Closed Caption (CC) subtitles. 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>

If your
system supports iconv(3)
, you can use this option to specify codepage of
the subtitle.

EXAMPLE:

-subcp latin2

-subcp cp1250

-sub-demuxer <number> (BETA CODE)

Force subtitle demuxer type
for -subfile.

-subdelay <sec>

Delays subtitles by <sec> seconds. Can be negative.

-subfont-autoscale <0-3>

Sets the autoscale mode.

NOTE:
Zero 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>

Sets the font blur radius (default: 2).

-subfont-encoding <value>

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).

Specify frame/:sec rate of subtitle file (float
number), default: the same fps as the movie.

NOTE:
ONLY for frame-based SUB files, i.e. NOT MicroDVD format.

-subfile <filename>
(BETA CODE)

Currently useless. Same as -audiofile, but for subtitle streams
(OggDS?).

-subpos <0-100> (useful with -vop expand)

Specify the position of subtitles
on the screen. The value is the vertical position of the subtitle in % of
the screen height.

-subalign <0-2>

Specify how subtitles should be aligned with
subpos. 0 means align at top (original/default behavior), 1 means align
at center, and 2 means align at bottom.

-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.

-unicode

Tells MPlayer to handle
the subtitle file as UNICODE.

-utf8

Tells MPlayer to handle the subtitle
file as UTF8.

-sub-no-text-pp

Disables any kind of text post processing done
after loading the subtitles. Used for debug purposes.

-vobsub <vobsub file without extension>

Specify the VobSub files that are to be used for subtitle. This is the full
pathname without extensions, i.e. without the '.idx', '.ifo' or '.sub'.

-vobsubid <0-31>

Specify the VobSub subtitle id.

-spualign <-1-2>

Specify how spu (DVD/VobSub)
subtitles should be aligned. Values are the same as for -subpos, with the
extra choice -1 for original position.

-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, for example to
smooth subtitles with the gaussian blur. The 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)

-spugauss <0.0-3.0>

Variance parameter of gaussian used by -spuaa 4. Higher means
more blur. The default is 1.0.

Activate a comma separated list of
audio filters and their options.
Available filters are:

resample[=srate[:sloppy][:type]]

Changes the sample
rate of the audio stream to an integer srate (Hz). It only supports the
16 bit little endian format.

channels[=nch]

Change the number of channels
to nch output channels. If the number of output channels is bigger than
the number of input channels empty channels are inserted (except mixing
from mono to stereo, then the mono channel is repeated in both of the output
channels). If the number of output channels is smaller than the number of
input channels the exceeding channels are truncated.

format[=bps,f]

Select
the format f and bits per sample bps used for output from the filter layer.
The option bps is an integer and denotes bytes per sample. The format f
is a string containing a concatenated mix of:
alaw, mulaw or imaadpcm
float or int
unsigned or signed
le or be (little or big endian)

volume[=v:sc]

Select the output volume level. This filter is not reentrant
and can therefore only be enabled once for every audio stream.

v: desired
gain in dB for all channels in the stream. The gain can be set from -200dB
to +40dB (where -200dB mutes the sound completely and +40dB equals a gain
of 1000).
sc: enable soft clipping.

pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]

Mixes
channels arbitrarily, see DOCS/sound.html for details.

n: number of output
channels (1 - 6).
lij: how much of input channel j is mixed into output channel i.

sub[=fc:ch]

Add sub-woofer channel.

fc: Cutoff frequency for low-pass filter (20Hz to
300Hz) default is 60Hz.
ch: channel number for the sub-channel.

surround[=d]

Decoder for matrix
encoded surround sound, works on many 2 channel files.

d: delay time in
ms for the rear speakers (0ms to 1000ms) default is 15ms.

delay[=ch1:ch2:...]

Delays the sound output. Specify the delay separately for each channel in
milliseconds (floating point number between 0 and 1000).

Adjust contrast of video
output (default 0). Works in similar manner as brightness.

-dfbopts <value>
(-vo directfb2 only)

Specify a parameter list for the directfb driver.

-display
<name>

Specify the hostname and display number of the X server you want to
display on.

EXAMPLE:

-display xtest.localdomain:0

-double

Enables doublebuffering.
Fixes flicker by storing two frames in memory, and displaying one while
decoding another. Can affect OSD. Needs twice the memory of a single buffer,
so it won't work on cards with very little video memory.

-dr

Turns on direct
rendering (not supported by all codecs and video outputs) (default is off).
Warning: may cause OSD/:SUB corruption!

-dxr2 <option1:option2:...>

This option
is used to control the dxr2 driver. Note: The lavc filter is now auto inserted
if you try to play a non MPEG1/2 format so all formats supported by MPlayer
should play out of the box (if you have the CPU power needed to encode
on the fly). The overlay chipset used on the dxr2 is of pretty bad quality
but the default settings should work for everybody. The OSD may be usable
with the overlay (not on TV) by drawing it in the colorkey. With the default
colorkey settings you may get variable results, usually you will see the
colorkey around the characters or some other funny effect. But if you properly
adjust the colorkey settings you should be able to get acceptable results.

adjust the overlay size and position in case it doesn't match the window
perfectly

overlay

enable the overlay

overlay-ratio=<1-2500>

tune the overlay
(default 1000)

update-cache

recreate the VGA cache

-fb <device> (fbdev or
DirectFB only)

Specifies the framebuffer device to use. By default it uses
/dev/:fb0.

-fbmode <modename> (fbdev only)

Change video mode to the one that
is labelled as <modename> in /etc/:fb.modes.

NOTE:
VESA framebuffer doesn't support mode changing.

-fbmodeconfig <filename> (fbdev
only)

Use this configuration file instead of the default /etc/:fb.modes.
Only valid for the fbdev driver.

-forcexv (SDL only)

Force using XVideo.

-fs

Fullscreen playing (centers movie, and makes black bands around it). Toggle
it with the 'f' key (not all video outputs support it). See also -zoom.

-fsmode-dontuse
<0-31> (OBSOLETE) (use -fs option)

Try this option if you still experience
fullscreen problems.

-fstype <type1,type2,...>

Specify a priority list of fullscreen
layer setting modes to be used.

The default order is "layer,stays_on_top,above,fullscreen".
It will be used as a fallback in case of specifying incorrect or unsupported
modes.
If you experience problems with fullscreen window being covered by other
windows try using different order.

NOTE:
See -fstype help for a full list of available modes.

-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-right of the screen
to the top-right 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 option format
to the standard X -geometry option. The values given must be integers.

Note:
This option is only supported by a few vo's, including tdfxfb, fbdev and
xv.

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 top left
corner of the screen

100%:100%

Places the window at the bottom left corner
of the screen

-guiwid <window id>

This tells the GUI to also use an X11 window
and stick itself to the bottom of the video, which is useful to embed a
mini-GUI in a browser (with the mplayerplug-in for instance).

-hue <-100-100>

Adjust
hue of video signal (default: 0). You can get colored negative of image
with this option.

Look into etc/:example.conf
for further information and in DOCS/:video.html.

-monitor_hfreq <horizontal
frequency range> (fbdev and vesa only)

-monitor_vfreq <vertical frequency
range> (fbdev and vesa only)

-monitoraspect <ratio>

Set aspect ratio of your
monitor or TV screen. See also -aspect for movie aspect.

EXAMPLE:

-monitoraspect
4:3 or 1.3333

-monitoraspect 16:9 or 1.7777

-nograbpointer

Do not grab mouse pointer after
VidMode change (-vm), useful for multihead setup.

-nokeepaspect

Do not keep
window aspect ratio when resizing X11 windows (Works currently only with
-vo x11, xv, xmga and xvidix and your window manager needs to understand
window aspect hints.).

-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 card/:cache. It has effect only with libmpeg2 and
libavcodec codecs.

-panscan <0.0-1.0>

Enables Pan & Scan functionality, i.e. in order
to display a 16:9 movie on a 4:3 display, the sides of the movie are cropped
to get a 4:3 image which fits the screen. This function works only with
the xv, xmga, mga and xvidix video out drivers.
The range controls how much of the image is cropped.

-rootwin

Play movie
in the root window (desktop background) instead of opening a new one. Works
only with x11, xv, xmga and xvidix drivers.

-saturation <-100-100>

Adjust saturation
of video output (default: 0). You can get grayscale output with this option.

-screenw <pixels> -screenh <pixels>

If you use an output driver which can't know
the resolution of the screen (fbdev/:x11 and/:or TVout) this is where you
can specify the horizontal and vertical resolution.

Specify a priority list of video
output drivers (optionally with device) to be used. 'device' is valid with
SDL and GGI, too, it means subdriver then.

NOTE:
See -vo help for a full list of available drivers.
If the list has a trailing ',' it will fallback to drivers not listed.

EXAMPLE:

-vo xmga,xv,

Try Matrox kernel driver, then Xv driver, then others

-vo sdl:aalib

specify the SDL subdriver

-vsync

Enables VBI for vesa.

-wid
<window id>

This tells MPlayer to use a X11 window, which is useful to embed
MPlayer in a browser (with the plugger extension for instance).

-xineramascreen
<0-...>

In Xinerama configurations (i.e. a single desktop that spans across multiple
displays) this option tells MPlayer which screen to display movie on.

-z
<0-9>

Specifies compression level for PNG output (-vo png)

0

no compression

9

max compression

-zrbw (-vo zr only)

Display in black and white (for optimal
performance, this option can be combined with the 'decode only in black
and white' option for codecs belonging to the FFmpeg family).

-zrcrop <[width]x[height]+[x
offset]+[y offset]> (-vo zr only)

Select a part of the input image for display,
multiple occurences of this option switch on cinerama mode. In cinerama
mode the movie is distributed over more than one TV (or beamer) to create
a larger screen. Options appearing after the n-th -zrcrop apply to the n-th
MJPEG card, each card should at least have a -zrdev in addition to the -zrcrop.
For examples, see the output of -zrhelp and the Zr section of the documentation.

-zrdev <device> (-vo zr only)

Specify the device special file that belongs
to your MJPEG card, by default this driver takes the first v4l device it
can find.

-zrfd (-vo zr only)

Force decimation: Decimation, as specified by
-zrhdec and -zrvdec, only happens if the hardware scaler can stretch the
image to its original size. Use this option to force decimation.

-zrhelp (-vo
zr only)

Display a list of all -zr* options, their default values and an
example of cinerama mode.

-zrnorm <norm> (-vo zr only)

Specify norm PAL/:NTSC,
the default is 'no change'.

-zrquality <1-20> (-vo zr only)

A number from 1 to
20 representing the jpeg encoding quality. 1 gives the best quality and
20 gives very bad quality.

-zrvdec <1,2,4> -zrhdec <1,2,4> (-vo zr only)

Vertical/:horizontal
decimation: Ask the driver to send only every 2nd or 4th line/:pixel of
the input image to the MJPEG card and use the scaler of the MJPEG card
to strech the image to its original size.

Show a summary about the available postprocess
filters and their usage.

-ssf <mode>

Specifies SwScaler parameters.

EXAMPLE

-vop scale -ssf lgb=3.0

lgb=<0-100>

Gaussian blur filter (luma)

cgb=<0-100>

Gaussian blur filter (chroma)

ls=<0-100>

sharpen filter (luma)

cs=<0-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> (see -vop scale
option too)

This option sets the quality (and speed, respectively) of the
software scaler, with the -zoom option. For example with x11 or other outputs
which lack hardware acceleration. Possible settings are:

NOTE:
For -sws 2 and 7, the sharpness can be set with the scaling parameter (p)
of -vop scale (0 (soft) - 100 (sharp)), for -sws 9, it specifies the filter
length (1 - 10).

0

fast bilinear (default)

1

bilinear

2

bicubic (good
quality)

3

experimental

4

nearest neighbour (bad quality)

5

area

6

luma
bicubic / chroma bilinear

7

gauss

8

sincR

9

lanczos

10

bicubic spline

-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.

NOTE:
See -vc help for a full list of available codecs.
If the list has a trailing ',' it will fallback to codecs not listed.

EXAMPLE:

-vc divx

force Win32/:VFW DivX codec, no fallback

-vc divx4,

try divx4linux
codec first, then fallback to others

-vc -divxds,-divx,

try other codecs except
Win32 DivX codecs

-vc ffmpeg12,mpeg12,

try libavcodec's MPEG1/:2 codec, then
libmpeg2,

then others

-vfm <driver1,driver2,...>

Specify a priority list of
video drivers to be used, according to their driver name in codecs.conf.
It falls back to default if none is ok.

NOTE:
If libdivxdecore support was compiled in, then odivx and divx4 now contains
just the same DivX4 codec, but different APIs to reach it. For difference
between them and when to use which, check the DivX4 section in the documentation.
See -vfm help for a full list of available drivers.

EXAMPLE:

-vfm ffmpeg,dshow,vfw

try the libavcodec, then Directshow, then VFW codecs and fallback to the
others, if still none is ok

-vfm xanim

try XAnim codecs first

-vop <...,filter3[=options],filter2,filter1>

Activate a comma separated list of video filters and their options in reverse
order.

NOTE:
The parameters are optional and if omitted, some of them are set to default
values. Use -1 to keep the default value. Parameters w:h means width x height
in pixels, x:y means x;y position counted from the upper left corner of
the bigger image.
To get a full list of available plugins, see -vop help.
Available filters are:

crop[=w:h:x:y]

Crops the given part of the image
and discards the rest. Useful to remove black bands from widescreen movies.

cropdetect[=0-255]

Calculates necessary cropping parameters and prints the
recommended parameters to stdout. The threshold can be optionally specified
from nothing (0) to everything (255). (default: 24)

rectangle[=w:h:x:y]

Draws a rectangle of the requested width and height at the specified coordinates
over the image (used to test crop). (default: maximum w/:h, upper left x/:y
position)

expand[=w:h:x:y:o]

Expands (not scales) movie resolution to the
given value and places the unscaled original at coordinates x y. Negative
values for w and h are treated as offsets to the original size. For example,
expand=0:-50:0:0 adds a 50 pixel border to the bottom of the picture. Can
be used for placing subtitles/:OSD in the resulting black bands (default:
original w/:h, centered x/:y). The last parameter (de)activates OSD rendering
(default: 0=disabled).

flip

Flips the image upside down. See also option
-flip.

mirror

Flips the image on Y axis.

rotate[=<0-7>]

Rotates and flips (optional)
the image +/:- 90 degrees. For parameters between 4-7 rotation is only done
if the movie's geometry is portrait and not landscape.

scale[=w:h[:c[:p]]]

Scales the image with the software scaler (slow) and performs a YUV<->RGB
colorspace conversion (see -sws option too). The value 0 is used for scaled
(aspect) destination w/:h. (default: original w/:h, destination w/:h with
-zoom) Optionaly chroma skipping (c from 0-3) and scaling parameters can
be specified. (see the -sws option for details)

Restricts the colorspace
for next filter. It does not do any conversion. Use together with the scale
filter for a real conversion.

pp[=filter1[:option1[:option2...]]/[-]filter2...]

This option enables usage of MPlayer's internal postprocessing filter, and
also gives an interface where you can pass options to the named filter.
To get a list of available filters, use -pphelp.
Note that each sub-filter must be separated with a / sign.
Each filter defaults to 'c' (chrominance).
The keywords accept a '-' prefix to disable the option.
A ':' followed by a letter may be appended to the option to indicate its
scope:

a: Automatically switches the filter off if the CPU is too slow.
c: Do chrominance filtering, too.
y: Do not do chrominance filtering (only luminance filtering).

This filter aims to reduce image noise producing smooth images and making
still images really still (This should enhance compressibility.). It can
be given from 0 to 3 parameters. If you omit a parameter, a reasonable
value will be inferred.

Activates the software
equalizer with interactive controls like the hardware eq controls. The values
can be from -100 to 100.

eq2[=gamma:contrast:brightness:saturation:rg:gg:bg]

Alternative software equalizer that uses lookup tables (very slow), allowing
gamma correction in addition to simple brightness, contrast and saturation
adjustment. Note that it uses the same MMX optimized code as -vop eq if all
gamma values are 1.0! The parameters are given as floating point values.
Defaults are gamma=1.0, contrast=1.0, brightness=0.0 and saturation=1.0. Parameters
rg, gg, bg are the independent gamma values for the Red, Green and Blue
components, all default to 1.0. The values are 0.1-10 for gammas, -2-2 for contrast
(negative values result in negative image) -1-1 for brightness and 0-3 for
saturation.

halfpack[=f]

Convert planar YUV 4:2:0 to half-height packed 4:2:2,
downsampling luma but keeping all chroma samples. Useful for output to low-resolution
display devices when hardware downscaling is poor quality or is not available.
Can also be used as a primitive luma-only deinterlacer with very low cpu
usage. By default, halfpack averages pairs of lines when downsampling. The
optional parameter f can be 0 to only use even lines, or 1 to only use
odd lines. Any other value for f gives the default (averaging) behavior.

dint[=sense:level]

Detects and drops first of interlaced frames in video
stream. Values can be from 0.0 to 1.0 - first (default 0.1) is relative difference
between neighbor pixels, second (default 0.15) is what part of image have
to be detected as interlaced to drop the frame.

(de)interleaves lines. The goal
of this filter is to add ability of processing interlaced images pre-field
without deinterlacing it. You can filter your interlaced dvd and playback
on TV without breaking the interlacing. While deinterlacing (with the post
processing filter) removes the interlacing permamently (by smoothing averaging
etc) deinterleaving splits the frame into 2 fields (so called half pictures),
so you can process (filter) them independently and then re-interleave them.

Extracts a single
field from interlaced image using stride arithmetic to avoid wasting cpu
time. The optional argument n specifies whether to extract the even or the
odd field (depending on whether n is even or odd).

boxblur=radius:power[:radius:power]

box blur

radius: size of the filter
power:

how often the filter should be applied

sab=rad:pfilter:cDiff[:rad:pfilter:cDiff]

shape adaptive blur

rad: blur filter strength (~0.1-4.0) (slower if larger)
pfilter: prefilter strength (~0.1-2.0)
cDiff: how different the pixels are allowed to be to be considered (~0.1-100.0)

width, height: size of image/area
xpos, ypos: start blitting at X/Y position
alpha: set alpha difference. 0 means same as original, 255 makes everything
opaque, -255 makes everything transparent. If you set this to -255 you can
then send a sequence of ALPHA-commands to set the area to -225, -200, -175
etc for a nice fade-in-effect! ;)
clear: clear the framebuffer before blitting. 1 means clear, if 0, the image
will just be blitted on top of the old one, so you don't need to send 1,8MB
of RGBA32 data everytime a small part of the screen is updated.

Number of audio chunks per second
(default is 2 for 0.5s long audio chunks).

NOTE:
CBR only, VBR ignores this as it puts each packet in a new chunk.

-audio-delay
<0.0-...>

Sets the audio delay field in the header. Default is 0.0, negative values
do not work. This does not delay the audio while encoding, but the player
will see the default audio delay, sparing you the use of the -delay option.

-audio-preload <0.0-2.0>

Sets up audio buffering time interval (default: 0.5s).

-divx4opts <option1:option2:...>

If encoding to DivX4, you can specify its parameters
here.
Available options are:

help

get help

br=<value>

specify bitrate in

kbit
<4-16000> or
bit <16001-24000000>

key=<value>

maximum keyframe interval (in frames)

deinterlace

enable deinterlacing (avoid it, DivX4 is buggy)

q=<1-5>

quality (1-fastest,
5-best)

min_quant=<1-31>

minimum quantizer

max_quant=<1-31>

maximum quantizer

rc_period=<value>

rate control period

rc_reaction_period=<value>

rate control
reaction period

rc_reaction_ratio=<value>

rate control reaction ratio

crispness=<0-100>

specify crispness/:smoothness

pass=<1-2>

With this you can encode 2pass DivX4
files. First encode with pass=1, then with the same parameters, encode with
pass=2.

vbrpass=<0-2>

Override the pass argument and use XviD VBR Library instead
of DivX4 VBR. Available options are:

0: one pass encoding (as in not
putting pass on the command line)
1: Analysis (first) pass of two pass encoding. The resulting AVI file can
be directed to /dev/null.
2: Final (second) pass of two pass encoding.

interval between keyframes in frames. Larger numbers mean slightly smaller
files, but less precise seeking, 0 means no key frames and values >300 aren't
recommended. For a strict mpeg1/:2/:4 compliance this would have to be <=132.
(default: 250 or one key frame every ten seconds in a 25fps movie)

vb_strategy=<0-1>

strategy to choose between I/:P/:B frames (pass 2):

0: always use the
maximum number of B frames (default)
1: avoid B frames in high motion scenes (bitrate mispredictions)

vpass=<1-2>

Activates internal 2pass mode (default: disabled):

1: first pass
2:

second pass

aspect=<x/y>

Store movie aspect internally, just like MPEG
files. Much nicer solution than rescaling, because quality isn't decreased.
Only MPlayer will play these files correctly, other players will display
them with wrong aspect. The aspect parameter can be given as a ratio or
a floating point number. Example:

single
coefficient elimination threshold for luminance. Negative values will also
consider the dc coefficient (should be at least -4 or lower for encoding
at quant=1):

0: disabled (default)
-4 (JVT recommendation)

vcelim=<-1000-1000>

single coefficient elimination
threshold for chrominance. Negative values will also consider the dc coefficient
(should be at least -4 or lower for encoding at quant=1):

0 disabled (default)
7 (JVT recommendation)

vstrict=<-1-1>

(strict) standard compliance.

0: disabled
(default)
1: only recommended if you want to feed the output into the mpeg4 reference
decoder
-1: allows non-standard YV12 huffyuv encoding (20% smaller files, but can't
be played back by the official huffyuv codec)

luminance masking. Warning: be careful, too large
values can cause disasterous things. Warning2: large values might look good
on some monitors but may look horrible on other monitors:

0.0: disabled
(default)
0.0-0.3:

sane range

dark_mask=<0.0-1.0>

darkness masking. Warning: be careful,
too large values can cause disasterous things. Warning2: large values might
look good on some monitors but may look horrible on other monitors / TV
/ TFT:

0.0: disabled (default)
0.0-0.3:

sane range

tcplx_mask=<0.0-1.0>

temporal complexity masking (default:
0.0 (disabled))

scplx_mask=<0.0-1.0>

spatial complexity masking. Larger values
help against blockiness, if no deblocking filter is used for decoding. Crop
any black borders to get better quality:

0.0: disabled (default)
0.0-0.5:

sane range

naq

Normalize adaptive quantization (experimental). When
using adaptive quantization (*_mask), the average per-MB quantizer may no
longer match the requested frame-level quantizer. Naq will attempt to adjust
the per-MB quantizers to maintain the proper average.

Trellis quantization. This will find the optimal encoding for each
8x8 block. Trellis quantization is quite simple a optimal quantization in
the PSNR vs bitrate sense (assuming that there would be no rounding errors
introduced by the IDCT, which is obviously not the case) it simply finds
a block for the minimum of error and lambda*bits.

NOTE:
MPlayer has a fully configurable, command driven, control layer which allow
you to control MPlayer using keyboard, mouse, joystick or remote control
(using lirc).
The default configuration file for the input system is ~/.mplayer/:input.conf
but it can be overriden using the -input conf option.
These keys may/:may not work, depending on your video output driver.

general
control

<- and ->

seek backward/:forward 10 seconds

up and down

seek backward/:forward
1 minute

pgup and pgdown

seek backward/:forward 10 minutes

< and >

backward/:forward
in playlist

HOME and END

go to next/:previous playtree entry in the parent
list

INS and DEL

go to next/:previous alternative source (asx playlist
only)

p / SPACE

pause movie (any key unpauses)

q / ESC

stop playing and
quit

+ and -

adjust audio delay by +/:- 0.1 second

/ and *

decrease/:increase
volume

9 and 0

decrease/:increase volume

m

mute sound

f

toggle fullscreen

w and e

decrease/:increase panscan range

o

toggle between OSD states: none
/ seek / seek+timer

d

toggle frame dropping

v

toggle subtitle visibility

j

switch subtitle language

a

toggle subtitle aligment: top/middle/bottom

z and x

adjust subtitle delay by +/:- 0.1 second

r and t

adjust subtitle
position

i

set EDL mark

(The following keys are valid only when using
-vo xv or -vo [vesa|fbdev]:vidix or -vo xvidix -vo (x)mga or -vc divxds (slow).)

Use only at your own risk! There may be errors and
inaccuracies that could be damaging to your system or your eye. Proceed
with caution, and although this is highly unlikely, the authors don't take
any responsibility for that!