SYNOPSIS

       mplayer [options] [ file | URL | playlist | - ]
       mplayer [global options] file1 [specific options] [file2]
               [specific options]
       mplayer [global options] {group of files and options}
               [group specific options]
       mplayer [dvd|vcd|cdda|cddb|tv]://title [options]
       mplayer [mms[t]|http|http_proxy|rt[s]p]://
               [user:passwd@]URL[:port] [options]
       mencoder [options] [ file | URL | - ] [-o file]
       gmplayer [options] [-skin skin]



DESCRIPTION

       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, sup­
       ported 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 sup­
       ported  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 soft­
       ware or hardware scaling,  so  you  can  enjoy  movies  in
       fullscreen.

       MPlayer  has an onscreen display (OSD) for status informa­
       tion, nice big antialiased  shaded  subtitles  and  visual
       feedback  for  keyboard  controls.   European/ISO 8859-1,2
       (Hungarian, English,  Czech,  etc),  Cyrillic  and  Korean
       fonts  are  supported  along with 10 subtitle formats (Mi­
       croDVD, SubRip, SubViewer, Sami, VPlayer, RT,  SSA,  AQTi­
       tle,  JACOsub  and  our own: MPsub) and DVD subtitles (SPU
       streams, VobSub and Closed Captions).

       mencoder (MPlayer's Movie Encoder) is a simple  movie  en­
       coder,  designed  to  encode  MPlayer-playable movies (see
       above) to other MPlayer-playable formats (see below).   It
       encodes  to  DivX4, XviD, one of the libavcodec codecs and
       PCM/MP3/VBRMP3 audio in 1, 2 or 3 passes.  Furthermore  it
       has  stream  copying  abilities,  a powerful plugin system
       (crop, expand, flip, postprocess,  rotate,  scale,  noise,
       rgb/yuv conversion) and more.
       wide configuration file 'mplayer.conf' is in your configu­
       ration 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 op­
       tions given on the command line override either.  The syn­
       tax of the configuration files is 'option=<value>', every­
       thing  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.

       EXAMPLE:
       # Use Matrox driver by default.
       vo=xmga
       # I love practicing handstands while watching videos.
       flip=yes
       # Decode/encode multiple files from png, start with -mf on
       mf= type=png:fps=25

       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.



PLAYER OPTIONS (MPLAYER ONLY)

       -, -use-stdin
              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 de­
              pending  on  available  spare CPU time.  The number
              you specify will be the maximum level used.  Usual­
              ly  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 au­
              dio  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,
              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.  Cur­
              rently  the  following drivers are fixed-vo compli­
              ant: 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.

       -h, -help, --help
              Show short summary of options.

       -hardframedrop
              More  intense  frame  dropping  (breaks  decoding).
              Leads to image distortion!

       -identify
              Show file parameters in easy parsable format.   The
              wrapper script TOOLS/midentify suppresses the other
              mplayer output  and  (hopefully)  shellescapes  the
              filenames.

       -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 joy­
              sticks.
              Available commands are:
                                     vice  to  use  (default   is
                                     /dev/input/js0).
                 file                Read commands from the given
                                     file.  Mostly useful with  a
                                     fifo.

       -lircconf <file>
              Specifies  a configuration file for LIRC (Linux In­
              frared Remote Control, see http://www.lirc.org)  if
              you don't like the default ~/.lircrc.

       -loop <number>
              Loops  movie playback <number> times.  0 means for­
              ever.

       -menu (BETA CODE)
              Turn on OSD menu support.

       -menu-root <value> (BETA CODE)
              Specify the main menu.

       -menu-cfg <file> (BETA CODE)
              Use an alternative menu.conf.

       -nojoystick
              Turns off joystick support.  Default is on, if com­
              piled in.

       -nolirc
              Turns off LIRC support.

       -nortc
              Turns off usage of the Linux RTC (real-time clock -
              /dev/rtc) as timing mechanism.

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

              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.

       -speed <0.01-100>
              Set playback speed rate.

       -sstep <sec>
              Specifies seconds between displayed frames.  Useful
              for slideshows.




DEMUXER/STREAM OPTIONS

       -aid <id> (also see -alang option)
              Select audio channel [MPEG: 0-31 AVI/OGM: 1-99 ASF/
              RM: 0-127  VOB(AC3):  128-159  VOB(LPCM):  160-191]
              MPlayer  prints  the  available IDs when running in
              verbose (-v) mode.

       -alang <two letter country code> (also see -aid option)
              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.

       -audio-demuxer <number> (-audiofile only)
              Force audio demuxer type for -audiofile.  Give  the
              demuxer  ID  as  defined  in  demuxers.h.  Use -au­
              dio-demuxer 17 to force .mp3 detection.

       -audiofile <filename>
              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  dif­
              ferent  bitrates).   Usefull  if  you want to watch
              live streamed media behind a slow connection.


                 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 <val­
                                     ue> sectors.

                 toc-bias            Assume  that  the  beginning
                                     offset of track 1 as report­
                                     ed in the TOC  will  be  ad­
                                     dressed   as   LBA 0.   Some
                                     Toshiba drives need this for
                                     getting   track   boundaries
                                     correct.

                 toc-offset=<value>  Add <value> sectors  to  the
                                     values   reported  when  ad­
                                     dressing  tracks.   May   be
                                     negative.

                 (no)skip            (never) accept imperfect da­
                                     ta 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  chan­
              nels  empty  channels  are  inserted (unless mixing
              from mono to stereo, then the mono channel  is  re­
              peated  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 au­
              dio  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 usu­
              ally  only  important  when playing videos with AC3
              audio (like DVDs).  In that case  liba52  does  the
              decoding by default and correctly downmixes the au­
              dio into the requested number of channels.

       -csslib <filename>
              (old-style DVD option) This option is used to over­
              ride 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.

       -demuxer <number>
              Force demuxer type.  Give the demuxer ID as defined
              in demuxers.h.  Use -demuxer 17 to force  .mp3  de­
              tection.

       -dumpaudio (MPLAYER only)
              Dumps  raw compressed audio stream to ./stream.dump
              (useful with mpeg/ac3).

       -dumpfile <filename> (MPLAYER only)
              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  play­
              back, 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.

              coder (see the documentation).

       -fps <value>
              Override video framerate (if value is wrong/missing
              in the header) (float number).

       -frames <number>
              Play/convert only first <number> frames, then quit.

       -hr-mp3-seek (.MP3 only)
              Hi-res mp3 seeking.  Default is: enabled when play­
              ing  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/incom­
              plete 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 (autode­
                                     tect)
                 h=<value>           height  of  the  output (au­
                                     todetect)
                 fps=<value>         fps of the output  (default:
                                     25)
                 type=<value>        type  of input files (avail­
                                     able 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 head­
              er.

       -noextbased
              Disables  filename-extension  based  demuxer selec­
              tion.  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
                 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 re­
              sulting 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  In­
              ternet  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 begin­
              ning.

       -srate <Hz>
              Forces the  given  audio  playback  rate,  changing
              video speed to keep a-v sync.  MEncoder passes this
              value to lame for resampling.

       -ss <time> (see -sb option too)
              Seek to given time position.

              EXAMPLE:
                 -ss 56              seeks to 56 seconds
                 -ss 01:10:00        seeks to 1 hour 10 min

       -tv <option1:option2:...>
              This option enables  the  TV  grabbing  feature  of
              MPlayer.

              NOTE:
                                     dbt848

                 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.

                 outfmt=<value>      output  format  of the tuner
                                     (yv12, rgb32, rgb24,  rgb16,
                                     rgb15, uyvy, yuy2, i420)

                 width=<value>       width of the output window

                 height=<value>      height of the output window

                 fps=<value>         framerate  at  which to cap­
                                     ture video (frames per  sec­
                                     ond)

                 buffersize=<value>  maximum  size of the capture
                                     buffer  in  megabytes   (de­
                                     fault: dynamical)

                 norm=<value>        available: PAL, SECAM, NTSC

                 channel=<value>     Set  tuner  to <value> chan­
                                     nel.

                 chanlist=<value>    available: europe-east,  eu­
                                     rope-west,  us-bcast, us-ca­
                                     ble, etc

                 channels=<channel>-<name>,<channel>-<name>,...
                                     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.   Warn­
                                     ing: The channel number will

                 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 men­
                                     coder).  A value of  1  (de­
                                     fault  for mplayer) means to
                                     do video  capture  only  and
                                     let  the  audio go through a
                                     loopback cable from  the  TV
                                     card to the soundcard.

       -user <user name> (see -passwd option too)
              Specify user name for http authentication.

       -vcd <track>
              Play  video  CD  track  from a device or image file

       -dumpmicrodvdsub (MPLAYER only)
              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.   Cre­
              ates 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 directo­
              ry.

       -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 di­
              rectory (default for normal fonts: ~/.mplayer/font/
              font.desc,  default for FreeType fonts: ~/.mplayer/
              subfont.ttf).

              NOTE:
              titles formats.

       -nooverlapsub
              Disables overlapping subtitles support for all sub­
              titles 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 + per­
                                     centage
                 3                   volume + seek + timer + per­
                                     centage + total time

       -sid <id> (also see -slang option)
              Turns  on  DVD subtitle displaying.  Also, you MUST
              specify a number which corresponds to a DVD  subti­
              tle  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  sub­
              titles, use with the -v option and look at the out­
              put.

              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 transparen­
              cy.  The 0 value is an exception and means complet­
              ly transparent.

       -sub-bg-color <0-255>
              Specify the color value for subtitles and OSD back­
              grounds.  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

       -sub-demuxer <number> (BETA CODE)
              Force subtitle demuxer type for -subfile.

       -subdelay <sec>
              Delays subtitles by <sec> seconds.   Can  be  nega­
              tive.

       -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 diago­
                                     nal (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).

       -subfont-osd-scale <0-100>
              Sets the osd elements  autoscale  coefficient  (de­
              fault: 6).

       -subfont-outline <0-8>
              Sets the font outline thickness (default: 2).

       -subfont-text-scale <0-100>
              Sets  the subtitle text autoscale coefficient (per­
              centage of the screen size) (default: 5).

       -subfps <rate>
              Specify frame/sec rate of subtitle file (float num­
              ber), 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?).

              of the subtitle in % of the screen width.

       -unicode
              Tells MPlayer to handle the subtitle file  as  UNI­
              CODE.

       -utf8
              Tells  MPlayer to handle the subtitle file as UTF8.

       -sub-no-text-pp
              Disables any kind of text post processing done  af­
              ter  loading the subtitles.  Used for debug purpos­
              es.

       -vobsub <vobsub file without extension>
              Specify the VobSub files that are to  be  used  for
              subtitle.  This is the full pathname without exten­
              sions, 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 scal­
              ing even when original and scaled  frame  size  al­
              ready  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.




AUDIO OUTPUT OPTIONS (MPLAYER ONLY)

       -abs <value> (OBSOLETE)
              Override  audio  driver/card buffer size detection,
              -ao oss only

                                     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  chan­
                                     nel  is  repeated in both of
                                     the  output  channels).   If
                                     the  number  of output chan­
                                     nels  is  smaller  than  the
                                     number of input channels the
                                     exceeding channels are trun­
                                     cated.

                 format[=bps,f]      Select the format f and bits
                                     per sample bps used for out­
                                     put  from  the filter layer.
                                     The option bps is an integer
                                     and  denotes  bytes per sam­
                                     ple.   The  format  f  is  a
                                     string containing a concate­
                                     nated mix of:
                                     alaw, mulaw or imaadpcm
                                     float or int
                                     unsigned or signed
                                     le or be (little or big  en­
                                     dian)

                 volume[=v:sc]       Select   the  output  volume
                                     level.  This filter  is  not
                                     reentrant  and can therefore
                                     only be enabled once for ev­
                                     ery 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  de­
                                     tails.
                                        n: number of output chan­
                                        nels (1 - 6).
                                        lij: how  much  of  input
                                        channel  j  is mixed into
                                        output channel i.

                 delay[=ch1:ch2:...] Delays  the  sound   output.
                                     Specify the delay separately
                                     for  each  channel  in  mil­
                                     liseconds   (floating  point
                                     number between 0 and  1000).

       -af-adv <force=(0-3):list=(filters)> (see -af option too)
              Specify advanced audio filter options:

                 force=<0-3>         Forces  the insertion of au­
                                     dio filters to  one  of  the
                                     following:
                                        0:  Completely  automatic
                                        insertion of filters (de­
                                        fault)
                                        1: Optimize for speed
                                        2: Optimize for accuracy
                                        3: Turn off auto

                 list=<filters>      Same  as  -af  (see  -af op­
                                     tion).

       -ao <driver1[:device],driver2,...[,]>
              Specify a priority list  of  audio  output  drivers
              (optionally  with  device) to be used.  ´device' is
              valid with SDL, too, it means subdriver then.

              NOTE:
              To get a full list of available  drivers,  see  -ao
              help.
              If  the list has a trailing ',' it will fallback to
              drivers not listed.

              EXAMPLE
                 -ao oss:/dev/dsp2,oss:/dev/dsp1,
                                     try  to  use  OSS  with  the
                                     specified  sound devices and
                                     fallback  to  others  if  it
                                     fails
                 -ao sdl:esd         specify the SDL subdriver

       -aofile <filename>
              Filename for -ao pcm.

       -aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
              Specify audio plugin(s) and their options (see doc­
              umentation too).
              Available options are:

                 list=[plugins]      comma separated list of plu­
                                     gins   (resample,  surround,
                                     2.5) (extrastereo plugin on­
                                     ly)

                 softclip            compressor / 'soft-clipping'
                                     capabilities  (volume plugin
                                     only)

       -delay <sec>
              Audio delay in seconds (may be +/- float value).

       -format <0-8192>
              Select the format used for output from  the  filter
              layer (according to the defines in libao2/afmt.h):

                 1                   Mu-Law
                 2                   A-Law
                 4                   Ima-ADPCM
                 8                   Signed 8-bit
                 16                  Unsigned 8-bit
                 32                  Unsigned  16-bit (Little-En­
                                     dian)
                 64                  Unsigned 16-bit (Big-Endian)
                 128                 Signed  16-bit (Little-Endi­
                                     an)
                 256                 Signed 16-bit (Big-Endian)
                 512                 MPEG (2) Audio
                 1024                AC3
                 4096                Signed 32-bit  (Little-Endi­
                                     an)
                 8192                Signed 32-bit (Big-Endian)

       -mixer <device>
              This  option  will  tell MPlayer to use a different
              device for mixing than /dev/mixer.

       -nowaveheader (-ao pcm only)
              Don't include wave header.  Used for RAW PCM.




VIDEO OUTPUT OPTIONS (MPLAYER ONLY)

       -aa* (-vo aa only)
              You can get a list and an explanation of  available
              options executing mplayer -aahelp

       -bpp <depth>
              Use different color depth than autodetect.  Not all
              -vo drivers support it (fbdev, dga2, svga, vesa).

       -brightness <-100-100>
              Adjust brightness of video output (default 0).   It
              changes intensity of RGB components of video signal
                 -display xtest.localdomain:0

       -double
              Enables doublebuffering.  Fixes flicker by  storing
              two  frames in memory, and displaying one while de­
              coding 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).  Warn­
              ing: 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.

                 ar-mode=<value>     aspect  ratio mode (0 = nor­
                                     mal, 1 = pan scan, 2 =  let­
                                     terbox (default))

                 iec958-encoded/decoded
                                     iec958 output mode

                 mute                mute sound output

                 ucode=<value>       path to the microcode

              TV Out

                 75ire               enable 7.5 IRE

                 bw                  b/w TV output

                 color               color TV output

                 interlaced          interlaced TV output

                 macrovision=<value> macrovision  mode  (0  = off

                 ck-[rgb]min=<0-255> minimum  value for the color
                                     key

                 ck-[rgb]max=<0-255> maximum value for the  color
                                     key

                 ck-[rgb]=<0-255>    color key values

                 ignore-cache        do not use the VGA cache

                 ol-osd              enable  the  osd hack on the
                                     overlay

                 ol[hwxy]-cor=<value>
                                     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 de­
              fault 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
              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 percent­
              age 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.

       -icelayer <0-15> (icewm only)
              Sets the layer of the fullscreen window of  mplayer
              for icewm.

                 0                   Desktop
                 2                   Below
                 4                   Normal
                 6                   OnTop
                 8                   Dock
                 10                  AboveDock
                 12                  Menu (default)

       -jpeg <option1:option2:...> (-vo jpeg only)
       and vesa only)
              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, xm­
              ga  and xvidix and your window manager needs to un­
              derstand 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 libav­
              codec 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>
              Try to change to a better video mode.  dga,  x11/xv
              (XF86VidMode) and sdl output drivers support it.

       -vo <driver1[:device],driver2,...[,]>
              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  perfor­
              mance, this option can be combined with the 'decode
              only in black and white' option for codecs  belong­
              ing to the FFmpeg family).

       -zrcrop  <[width]x[height]+[x  offset]+[y offset]> (-vo zr
       only)
              Select  a part of the input image for display, mul­
              tiple 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 larg­
              er  screen.   Options appearing after the n-th -zr­
              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  encod­
              ing 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.

       -zrxdoff <x display offset>, -zrydoff <y  display  offset>
       (-vo zr only)
              If the movie is smaller than the TV  screen,  these
              options  control the position of the movie relative
              to the upper left corner of the screen.  The  movie
              is centered by default.




DECODING/FILTERING OPTIONS

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

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

              EXAMPLE:
                 -ac mp3acm          force l3codeca.acm MP3 codec
                 -ac mad,            try libmad first, then fall­
                                     back to others
                 -ac hwac3,a52,      try       hardware       AC3
                                     passthrough,  then  software
                                     AC3 codec, then others
                 -ac -ffmp3,         try other codecs except FFm­
                                     peg's MP3 decoder

       -afm <driver1,driver2,...>
              Override aspect ratio of movies.  It's autodetected
              on  MPEG  files,  but can't be autodetected on most
              AVI files.

              EXAMPLE:
                 -aspect 4:3  or -aspect 1.3333
                 -aspect 16:9 or -aspect 1.7777

       -flip
              Flip image upside-down.

       -lavdopts <option1:option2:...> (DEBUG CODE)
              If decoding with a codec from libavcodec,  you  can
              specify its parameters here.

              EXAMPLE:
                 -lavdopts bug=1

              NOTE:
              Just  add  the values of the things you want to en­
              able.
              Available options are:

                 ec                  error concealment:
                                        1:  use  strong   deblock
                                        filter for damaged MBs
                                        2:  iterative  MV  search
                                        (slow)
                                        3: all (default)

                 er=<value>          error resilience:
                                        0: disabled
                                        1: careful  (should  work
                                        with broken encoders)
                                        2:    normal    (default)
                                        (works with compliant en­
                                        coders)
                                        3: agressive (more checks
                                        but might cause  problems
                                        even   for   valid   bit­
                                        streams)
                                        4: very agressive

                 bug=<value>         manually work around encoder
                                     bugs:
                                        0: nothing
                                        1:  autodetect  bugs (de­
                                        fault)
                                        2 (msmpeg4v3):  some  old
                                        lavc  generated msmpeg4v3
                                        files (no autodetect)
                                        4 (mpeg4): xvid interlac­

                                     bit faster than with color)

       -noaspect
              Disable  automatic movie aspect ratio compensation.

       -nosound
              Do not play/encode sound.

       -pp <quality> (see -vop pp option too!)
              Set postprocess level of the DLL.  This  option  is
              NO LONGER USABLE with MPlayer's postprocess filter,
              but only with Win32 DirectShow DLLs which have  in­
              ternal postprocessing routine.

              The valid range of -pp value vary on codecs, mostly
              0-6, where 0=disable 6=slowest/best.

       -pphelp (see -vop pp option too)
              Show a summary about the available postprocess fil­
              ters 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 (chro­
                                     ma)
                 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,  respec­
              tively)  of the software scaler, with the -zoom op­
              tion.  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
                 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 odi­
              vx  and  divx4  now  contains  just  the same DivX4
              codec, but different APIs to reach it.  For differ­
              ence  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 Di­
                                     rectshow,  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
                                     ping parameters  and  prints
                                     the  recommended  parameters
                                     to  stdout.   The  threshold
                                     can  be optionally specified
                                     from nothing (0)  to  every­
                                     thing (255).  (default: 24)

                 rectangle[=w:h:x:y] Draws a rectangle of the re­
                                     quested 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 val­
                                     ue and places  the  unscaled
                                     original at coordinates x y.
                                     Negative values for w and  h
                                     are  treated  as  offsets to
                                     the original size. For exam­
                                     ple, expand=0:-50:0:0 adds a
                                     50 pixel border to the  bot­
                                     tom  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=dis­
                                     abled).

                 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  col­
                                     orspace conversion (see -sws
                                     option too).  The value 0 is
                                     used   for  scaled  (aspect)
                                     destination w/h.   (default:
                                     original w/h, destination w/
                                     colorspace conversion  using
                                     palette.

                 format[=fourcc]     Restricts the colorspace for
                                     next filter.  It does not do
                                     any conversion.  Use togeth­
                                     er with the scale filter for
                                     a real conversion.

                 pp[=filter1[:option1[:option2...]]/[-]fil­
                 ter2...]
                                     This option enables usage of
                                     MPlayer's internal  postpro­
                                     cessing   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  op­
                                     tion.
                                     A  ':'  followed by a letter
                                     may be appended to  the  op­
                                     tion to indicate its scope:
                                        a: Automatically switches
                                        the filter off if the CPU
                                        is too slow.
                                        c: Do chrominance filter­
                                        ing, too.
                                        y: Do not do  chrominance
                                        filtering (only luminance
                                        filtering).

                                     EXAMPLES:
                                        -vop pp=hb/vb/dr/al/lb
                                        -vop pp=hb/vb/dr/al
                                        Default  filters  without
                                        brightness/contrast  cor­
                                        rection:
                                        -vop pp=de/-al
                                        Enable default filters  &
                                        temporal denoiser:
                                        -vop pp=de/tn:1:2:3
                                        Deblock  horizontal  only
                                        luminance and switch ver­
                                        tical  deblocking  on  or

                                     DVB    cards.    (aspect   =
                                     DVB_HEIGHT*ASPECTRATIO,  de­
                                     fault: 768)

                 noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
                                     Adds noise
                                        <0-100>: luma noise
                                        <0-100>: chroma noise
                                        u: uniform noise
                                        t: temporal noise
                                        a:    averaged   temporal
                                        noise
                                        h: high quality
                                        p: mix random noise  with
                                        a (semi)regular pattern

                 denoise3d[=luma:chroma:time]
                                     This  filter  aims to reduce
                                     image noise producing smooth
                                     images  and making still im­
                                     ages  really   still   (This
                                     should enhance compressibil­
                                     ity.).  It can be given from
                                     0  to 3 parameters.   If you
                                     omit a parameter, a  reason­
                                     able value will be inferred.
                                        luma:     spatial    luma
                                        strength (default = 4)
                                        chroma:   spatial  chroma
                                        strength (default = 3)
                                        time:     temporal
                                        strength (default = 6)

                 eq[=bright:cont]    Activates    the    software
                                     equalizer  with  interactive
                                     controls  like  the hardware
                                     eq controls.  The values can
                                     be from -100 to 100.

                 eq2[=gamma:contrast:brightness:satura­
                 tion:rg:gg:bg]
                                     Alternative  software equal­
                                     izer 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 val­

                 halfpack[=f]        Convert  planar YUV 4:2:0 to
                                     half-height  packed   4:2:2,
                                     downsampling  luma but keep­
                                     ing  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) be­
                                     havior.

                 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.

                 lavcdeint           Use libavcodec's deinterlace
                                     filter.

                 unsharp=l|cWxH:amount[:l|cWxH:amount]
                                     Unsharp  mask   /   gaussian
                                     blur.
                                        l:  apply  effect on luma
                                        component
                                        c: apply effect on chroma
                                        components
                                        WxH:  width and height of
                                        the matrix, odd sized  in
                                        both  directions  (min  =
                                        3x3,  max  =   13x11   or
                                        11x13,  usually something
                                        between 3x3 and 7x7)
                                        amount:  relative  amount
                                        of  sharpness  /  blur to
                                        add to the image  (amount
                                        <  0 = blur, amount > 0 =

                                     without  breaking the inter­
                                     lacing.  While deinterlacing
                                     (with  the  post  processing
                                     filter) removes  the  inter­
                                     lacing    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.
                                        d: deinterleave
                                        i: interleave
                                        s: swap fields  (exchange
                                        even & odd lines)

                 field[=n]           Extracts a single field from
                                     interlaced    image    using
                                     stride  arithmetic  to avoid
                                     wasting cpu  time.  The  op­
                                     tional  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 fil­
                                        ter
                                        power: how often the fil­
                                        ter 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)

                 smart­
                 blur=rad:strength:thresh[:rad:strength:thresh]
                                     smart blur
                                        rad: blur filter strength
                                        (~0.1-5.0)   (slower   if
                                        larger)

                 2xsai               Use the 2x scale and  inter­
                                     polate algorithm for scaling
                                     and smoothing images.

                 1bpp                1bpp   bitmap   to   YUV/BGR
                                     8/15/16/32 conversion

                 bmovl=hidden:opaque:<fifo>
                                     Read bitmaps from a FIFO and
                                     display them in window.
                                        hidden: sets the  default
                                        value   of  the  'hidden'
                                        flag (boolean)
                                        opaque:  flag   switching
                                        between      alphablended
                                        (transparent) and  opaque
                                        (fast) mode
                                        fifo:  path/filename  for
                                        the FIFO (named pipe con­
                                        necting    mplayer   -vop
                                        bmovl to the  controlling
                                        application)

                                     FIFO commands are:
                                        RGBA32  width height xpos
                                        ypos alpha clear
                                        followed               by
                                        width*height*4  bytes  of
                                        raw RGBA32 data.

                                        ABGR32 width height  xpos
                                        ypos alpha clear
                                        followed               by
                                        width*height*4  bytes  of
                                        raw ABGR32 data.

                                        RGB24  width  height xpos
                                        ypos alpha clear
                                        followed               by
                                        width*height*3  bytes  of
                                        raw RGB32 data.

                                        BGR24 width  height  xpos
                                        ypos alpha clear
                                        followed               by
                                        width*height*3  bytes  of
                                        raw BGR32 data.

                                        ALPHA  width  height xpos
                                        ypos alpha
                                        change alpha for area
                                        SHOW
                                        show bitmap

                                     Arguments are:
                                        width,  height:  size  of
                                        image/area
                                        xpos,  ypos:  start blit­
                                        ting at X/Y position
                                        alpha: set alpha  differ­
                                        ence.   0  means  same as
                                        original, 255  makes  ev­
                                        erything   opaque,   -255
                                        makes  everything  trans­
                                        parent.   If you set this
                                        to -255 you can then send
                                        a  sequence of ALPHA-com­
                                        mands to set the area  to
                                        -225,  -200, -175 etc for
                                        a nice fade-in-effect! ;)
                                        clear:  clear  the frame­
                                        buffer  before  blitting.
                                        1  means clear, if 0, the
                                        image will just be  blit­
                                        ted  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.

       -x <x> (MPLAYER only)
              Scale  image  to  x  width (if sw/hw scaling avail­
              able).  Disables aspect calculations.

       -xvidopts <option1:option2:...>
              Specify additional parameters  when  decoding  with
              XviD.

                 dr2                 Activate   direct  rendering
                                     method 2.
                 nodr2               Deactivate direct  rendering
                                     method 2.

       -xy <x>
                 x<=8                Scale image by factor <x>.
                 x>8                 Set  width to <x> and calcu­
                                     late height to keep  correct
                                     aspect ratio.

       -y <y> (MPLAYER only)
              Scale  image  to  y height (if sw/hw scaling avail­
              able).  Disables aspect calculations.


              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 parame­
              ters 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
                                        /dev/null.
                                        2: Final (second) pass of
                                        two pass encoding.

       -endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see -ss and -sb
       option too)
              Stop encoding at given time or byte position.   Can
              be specified in many ways:

              NOTE:
              Byte  position  won't  be  accurate, as it can only
              stop at a frame boundary.

              EXAMPLE:
                 -endpos 56          encode only 56 seconds
                 -endpos 01:10:00    encode only 1 hour  10  min­
                                     utes
                 -endpos 100mb       encode only 100 MBytes

       -ffourcc <fourcc>
              Can  be  used  to  override the video fourcc of the
              output file.

              EXAMPLE:
                 -ffourcc div3       will have  the  output  file
                                     contain   'div3'   as  video
                                     fourcc.

       -include <configuration file>
              Specify configuration file to be parsed  after  the
              default ones.

       -info <option1:option2:...> (.AVI only)
              Specify the info header of the resulting .AVI file.
              Available options are:

                 help                show this description

                 name=<value>        title of the subject of  the
                                     file

                 artist=<value>      artist   or  author  of  the
                                     original subject of the file

                 genre=<value>       original work category

                 subject=<value>     contents of the file

                 copyright=<value>   copyright   information  for
                                     the file

                 srcform=<value>     original form of the materi­
                                        0: cbr
                                        1: mt
                                        2: rh(default)
                                        3: abr
                                        4: mtrh

                 abr                 average bitrate

                 cbr                 constant bitrate.
                                     Forces also CBR mode  encod­
                                     ing  on  subsequent ABR pre­
                                     sets modes

                 br=<0-1024>         specify bitrate in kBit (CBR
                                     and ABR only)

                 q=<0-9>             quality  (0-highest,  9-low­
                                     est) (only for VBR)

                 aq=<0-9>            algorithmic quality (0-best/
                                     slowest, 9-worst/fastest)

                 ratio=<1-100>       compression ratio

                 vol=<0-10>          set audio input gain

                 mode=<0-3>          (default: auto)
                                        0: stereo
                                        1: joint-stereo
                                        2: dualchannel
                                        3: mono

                 padding=<0-2>
                                        0: no
                                        1: all
                                        2: adjust

                 fast                switch on faster encoding on
                                     subsequent    VBR    presets
                                     modes, slightly lower quali­
                                     ty and higher bitrates.

                 preset=<value>      provide the highest possible
                                     quality settings.
                                        medium:   VBR   encoding,
                                        good   quality,   150-180
                                        kbps bitrate range.
                                        standard:  VBR  encoding,
                                        high   quality,   170-210
                                        kbps bitrate range.
                                        extreme:   VBR  encoding,
                                        very    high     quality,

                 -lameopts  cbr:preset=192
                                     encode with ABR presets at a
                                     192 kbps forced constant bi­
                                     trate.
                 -lameopts      preset=172
                                     encode with ABR presets at a
                                     172 kbps average bitrate.
                 -lameopts      preset=extreme
                                     for  people  with  extremely
                                     good  hearing  and   similar
                                     equipment.
                 -lameopts preset=help
                                     print additional options and
                                     informations on presets set­
                                     tings.

       -lavcopts <option1:option2:...>
              If  encoding  with a codec from libavcodec, you can
              specify its parameters here.

              EXAMPLE:
                 -lavcopts                    vcodec=msmpeg4:vbi­
                 trate=1800:vhq:keyint=250

              Available options are:

                 vcodec=<value>      use   the   specified  codec
                                     (there is  no  default,  you
                                     must specify it):
                                        mjpeg: Motion JPEG
                                        h263: H263
                                        h263p: H263 Plus
                                        mpeg4: DivX 4/5
                                        msmpeg4: DivX 3
                                        rv10:  an  old  RealVideo
                                        codec
                                        mpeg1video:  MPEG1  video
                                        :)

                 vqmin=<1-31>        minimum quantizer (pass 1/2)
                                     (default: 2)

                 vqscale=<1-31>      constant quantizer  (selects
                                     fixed  quantizer  mode) (de­
                                     fault: 0 (disabled))

                 vqmax=<1-31>        maximum quantizer (pass 1/2)
                                     (default: 31)

                 mbqmin=<1-31>       minimum macroblock quantizer
                                     (pass 1/2) (default: 2)

                                        1: full (slow)
                                        2: log (lq)
                                        3: phods (lq)
                                        4: EPZS (default)
                                        5: X1 (experimental)

                 vhq                 high  quality  mode,  encode
                                     each   macro  block  in  all
                                     modes an choose the smallest
                                     (slow).   (default:  HQ dis­
                                     abled)

                 v4mv                4 motion  vectors  per  mac­
                                     roblock   (slightly   better
                                     quality).   (default:   dis­
                                     abled)

                 keyint=<0-300>      interval  between  keyframes
                                     in frames.   Larger  numbers
                                     mean slightly smaller files,
                                     but less precise seeking,  0
                                     means no key frames and val­
                                     ues >300 aren't recommended.
                                     For  a strict mpeg1/2/4 com­
                                     pliance this would  have  to
                                     be  <=132.  (default: 250 or
                                     one key frame every ten sec­
                                     onds 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 (de­
                                        fault)
                                        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 internal­
                                     ly, just  like  MPEG  files.
                                     Much   nicer  solution  than
                                     rescaling,  because  quality
                                     isn't    decreased.     Only
                                     MPlayer  will   play   these
                                     files correctly, other play­
                                     ers will display  them  with
                                     wrong  aspect.   The  aspect
                                     ance   in  kbit.   (warning:
                                     1kBit = 1000 Bits) (default:
                                     8000)

                 vrc_maxrate=<value> maximum  bitrate in kbit/sec
                                     (pass 1/2)

                 vrc_minrate=<value> minimum bitrate in  kbit/sec
                                     (pass 1/2)

                 vrc_buf_size=<value>
                                     buffer size in kbit (pass 1/
                                     2).  Note:  vratetol  should
                                     not  be too large during the
                                     second pass or  there  might
                                     be        problems        if
                                     vrc_(min|max)rate is used.

                 vb_qfactor=<-31.0-31.0>
                                     quantizer factor  between  B
                                     and  non B frames (pass 1/2)
                                     (default: 1.25)

                 vi_qfactor=<-31.0-31.0>
                                     (pass 1/2) (default: 0.8)

                 vb_qoffset=<-31.0-31.0>
                                     quantizer offset  between  B
                                     and  non B frames (pass 1/2)
                                     (default: 1.25)

                 vi_qoffset=<-31.0-31.0>
                                     (pass 1/2) (default: 0.0)
                                     if v{b|i}_qfactor > 0
                                     I/B-Frame  quantizer  =   P-
                                     Frame       quantizer      *
                                     v{b|i}_qfactor             +
                                     v{b|i}_qoffset
                                     else
                                     do  normal ratecontrol (dont
                                     lock to next P  frame  quan­
                                     tizer)   and  set  q=  -q  *
                                     v{b|i}_qfactor             +
                                     v{b|i}_qoffset

                 vqblur=<0.0-1.0>    quantizer blur (pass1):
                                        0.0: qblur disabled
                                        0.5 (default)
                                        1.0: average the quantiz­
                                        er  over   all   previous
                                        frames,   larger   values
                                        will

                 vrc_eq=<equation>   main  ratecontrol   equation
                                     (pass 1/2):

                                     1: constant bitrate
                                     tex: constant quality
                                     1+(tex/avgTex-1)*qComp:  ap­
                                     proximately the equation  of
                                     the old ratecontrol code
                                     tex^qComp: with qcomp 0.5 or
                                     something  like  that   (de­
                                     fault)

                                     infix operators: +,-,*,/,^

                                     variables:
                                     tex:                 texture
                                     complexity
                                     iTex,pTex:       intra,  non
                                     intra texture complexity
                                     avgTex:              average
                                     texture complexity
                                     avgIITexaverage: intra  tex­
                                     ture complexity in I frames
                                     avgPITexaverage:  intra tex­
                                     ture complexity in P frames
                                     avgPPTexaverage:  non  intra
                                     texture   complexity   in  P
                                     frames
                                     avgBPTexaverage:  non  intra
                                     texture   complexity   in  B
                                     frames
                                     mv:               bits  used
                                     for MVs
                                     fCode:               maximum
                                     length of MV in log2 scale
                                     iCount:           number  of
                                     intra MBs / number of MBs
                                     var:                 spatial
                                     complexity
                                     mcVar:              temporal
                                     complexity
                                     qComp:            qcomp from
                                     the command line
                                     isI, isP,  isB:    is  1  if
                                     picture type is I/P/B else 0
                                     Pi,E:             see   your
                                     favorite math book

                                     functions:
                                     max(a,b),min(a,b): maximum /
                                     minimum
                                     gt(a,b): is 1 if a>b, 0 oth­
                                     quality[/...]]>:
                                        quality 2-31: quantizer
                                        quality  -500-0:  quality
                                        correcture in %

                 vrc_init_cplx=<0-1000>
                                     initial complexity (pass 1)

                 vqsquish=<0-1>      specify  how  to  keep   the
                                     quantizer  between  qmin and
                                     qmax (pass 1/2):
                                        0: use cliping
                                        1: use a  nice  differen­
                                        tiable function (default)

                 vlelim=<-1000-1000> single coefficient  elimina­
                                     tion   threshold  for  lumi­
                                     nance.  Negative values will
                                     also consider the dc coeffi­
                                     cient (should be at least -4
                                     or  lower  for  encoding  at
                                     quant=1):
                                        0: disabled (default)
                                        -4 (JVT recommendation)

                 vcelim=<-1000-1000> single coefficient  elimina­
                                     tion  threshold  for chromi­
                                     nance.  Negative values will
                                     also consider the dc coeffi­
                                     cient (should be at least -4
                                     or  lower  for  encoding  at
                                     quant=1):
                                        0 disabled (default)
                                        7 (JVT recommendation)

                 vstrict=<-1-1>      (strict)  standard   compli­
                                     ance.
                                        0: disabled (default)
                                        1:  only  recommended  if
                                        you want to feed the out­
                                        put into the mpeg4 refer­
                                        ence decoder
                                        -1:  allows  non-standard
                                        YV12   huffyuv   encoding
                                        (20% smaller  files,  but
                                        can't  be  played back by
                                        the   official    huffyuv
                                        codec)

                 vdpart              data  partitioning.   Adds 2
                                     byte per video  packet,  im­
                                     proves error-resistance when
                                        0: automatically select a
                                        good one (default)
                                        1: fast integer
                                        2: accurate integer
                                        3: mmx
                                        4: mlib

                 idct=<0-99>         idct  algorithm.   Note: all
                                     these  IDCTs  do  pass   the
                                     IEEE1180 tests afaik:
                                        0: automatically select a
                                        good one (default)
                                        1: jpeg reference integer
                                        2: simple
                                        3: simplemmx
                                        4:  libmpeg2mmx  (inaccu­
                                        rate, DONT USE for encod­
                                        ing with keyint >100)
                                        5: ps2
                                        6: mlib
                                        7: arm

                 lumi_mask=<0.0-1.0> 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.
                                     proper average.

                 ildct               use interlaced dct

                 format=<value>
                                        YV12: default
                                        422P: for huffyuv

                 pred                (for huffyuv)
                                        0: left prediction
                                        1: plane/gradient predic­
                                        tion
                                        2: median prediction

                 qpel                use quarter pel motion  com­
                                     pensation

                 precmp=<0-2000>     comparison  function for mo­
                                     tion estimation pre pass

                 cmp=<0-2000>        comparison function for full
                                     pel motion estimation

                 subcmp=<0-2000>     comparison  function for sub
                                     pel motion estimation
                                        0 (SAD): sum of  absolute
                                        differences,   fast  (de­
                                        fault)
                                        1 (SSE): sum  of  squared
                                        errors
                                        2 (SATD): sum of absolute
                                        hadamard transformed dif­
                                        ferences
                                        3  (DCT): sum of absolute
                                        dct  transformed  differ­
                                        ences
                                        4   (PSNR):  sum  of  the
                                        squared quantization  er­
                                        rors
                                        5  (BIT):  number of bits
                                        needed for the block
                                        6 (RD): rate  distoration
                                        optimal, slow
                                        7 (ZERO): 0
                                        +256:   use  chroma  too,
                                        doesnt work with b frames
                                        currently

                 predia=<-99-6>      Diamond  type  and  size for
                                     motion estimation pre pass

                 dia=<-99-6>         Diamond type & size for  mo­
                                              0
                                         2: normal size=2 diamond
                                              0
                                             000
                                            00000
                                             000
                                              0

                 trell               Trellis  quantization.  This
                                     will find the optimal encod­
                                     ing   for  each  8x8  block.
                                     Trellis   quantization    is
                                     quite simple a optimal quan­
                                     tization in the PSNR vs  bi­
                                     trate  sense  (assuming that
                                     there would be  no  rounding
                                     errors introduced by the ID­
                                     CT, which is  obviously  not
                                     the  case) it simply finds a
                                     block for the minimum of er­
                                     ror and lambda*bits.
                                        lambda: qp dependant con­
                                        stant
                                        bits:  amount   of   bits
                                        needed   to   encode  the
                                        block
                                        error: sum of squared er­
                                        rors of the quantization

                 last_pred=<0-99>    Amount  of motion predictors
                                     from the previous frame
                                        0: (default)
                                        a: will use 2a+1  x  2a+1
                                        MB  square  of MV predic­
                                        tors  from  the  previous
                                        frame

                 preme=<0-2>         motion estimation pre-pass
                                        0: disabled
                                        1:  only  after  I frames
                                        (default)
                                        2: always

                 subq=<1-8>          subpel  refinement   quality
                                     (for   qpel)  (default:  8).
                                     Note: this has a significant
                                     effect on the speed

                 psnr                print  the psnr (peak signal
                                     to  noise  ratio)  for   the
                                     whole  video  after encoding
                                     and store the per frame psnr

       -oac <codec name>
              Encode with the given audio codec.  Use  -ovc  help
              to  get  a  list  of available codecs.  (no default
              set)

              EXAMPLE:
                 -oac copy           no encoding, just streamcopy
                 -oac pcm            encode to uncompressed PCM
                 -oac mp3lame        encode to MP3 (using Lame)

       -of <format> (BETA CODE!)
              Encode  to  the  specified format.  Use -of help to
              get a list of available formats.

              EXAMPLE:
                 -of avi             encode to avi (default)
                 -of mpeg            encode to mpeg

       -ofps <fps>
              The output file will have different frame/sec  than
              the source.  You MUST set it for variable fps (asf,
              some mov) and progressive (29.97fps telecined mpeg)
              files.

       -ovc <codec name>
              Encode  with  the given video codec.  Use -ovc help
              to get a list of  available  codecs.   (no  default
              set)

              EXAMPLE:
                 -ovc copy           no encoding, just streamcopy
                 -ovc divx4          encode to DivX4/DivX5
                 -ovc rawrgb         encode to uncompressed RGB24
                 -ovc lavc           encode   with  a  libavcodec
                                     codecs

       -passlogfile <filename>
              When encoding in 2pass mode, MEncoder  dumps  first
              pass' informations to the given file instead of the
              default divx2pass.log.

       -skiplimit <value>
              Maximal  skipable  frames  after  non-skipped   one
              (-noskiplimit for unlimited number).

       -v, --verbose
              Increment  verbose  level  (more -v means more ver­
              bosity).

                 0                   only  some  informal  output
                                     (default)

       -vobsuboutindex <index>
              Specify the index of the subtitles  in  the  output
              files.  (default: 0)

       -vobsuboutid <langid>
              Specify the language two letter code for the subti­
              tles.  This overrides what is read from the DVD  or
              the .ifo file.

       -xvidencopts <option1:option2:...>
              If encoding to XviD, you can specify its parameters
              here.
              There's three  modes  available:  constant  bitrate
              (CBR), fixed quantizer and 2pass.
              Available options are:

                 pass=<1|2>          specify  the  pass  in 2pass
                                     mode

                 bitrate=<value>     sets the bitrate to be  used
                                     in kbits/second if <16000 or
                                     in  bits/second  if   >16000
                                     (CBR   or  2pass  mode,  de­
                                     fault=687 kbits/s)

                 fixed_quant=<1-31>  switch  to  fixed  quantizer
                                     mode  and  specify the quan­
                                     tizer to be used

                 me_quality=<0-6>    specify the motion detection
                                     quality (default=4)

                 4mv                 use  4  motion  vectors  per
                                     macro-block, might give bet­
                                     ter  compression at the cost
                                     of a  slower  encoding  (de­
                                     fault=off)

                 rc_reaction_delay_factor=<value>
                                     specify  how  fast  the rate
                                     control reacts, lower values
                                     are faster

                 rc_averaging_period=<value>
                                     period to reach the required
                                     average

                 rc_buffer=<value>   size  of  the  rate  control
                                     buffer

                 quant_range=<1-31>-<1-31>[/<1-31>-<1-31>]
                                     frames (default=10*fps)

                 mpeg_quant          use MPEG quantizers  instead
                                     of H.263 (default=off)

                 mod_quant           decide  whether  to use MPEG
                                     or  H.263  quantizers  on  a
                                     frame-by-frame  basis.  (de­
                                     fault=off, 2pass mode only)

                 lumi_mask           use a lumimasking  algorithm
                                     (default=off, seems buggy)

                 hintedme            save  Motion Estimation vec­
                                     tors to a  file  during  the
                                     first  pass  and  reuse this
                                     file during the second  (de­
                                     fault=off,  2pass mode only,
                                     seems buggy)

                 hintfile            specify the  temporary  file
                                     to be used by the 'hintedme'
                                     option             (default=
                                     ./xvid_hint_me.dat,    2pass
                                     mode only)

                 debug               save per-frame statistics in
                                     xvid.dbg (default=off)
                                     this is *not* the 2pass con­
                                     trol file

                 keyframe_boost=<0-1000>
                                     (default=0, 2pass mode only)

                 kfthreshold=<value> (default=10,  2pass mode on­
                                     ly)

                 kfreduction=<0-100> (default=30, 2pass mode  on­
                                     ly)




KEYBOARD CONTROL

       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 out­
       put driver.
                 p / SPACE           pause movie (any key unpaus­
                                     es)
                 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).)

                 1 and 2             adjust contrast
                 3 and 4             adjust brightness
                 5 and 6             adjust hue
                 7 and 8             adjust saturation

       GUI keyboard control
                 ENTER               start playing
                 s                   stop playing
                 l                   load file
                 c                   skin browser
                 p                   toggle playlist

       TV input control
                 h and k             select previous/next channel
                 n                   change norm
                 u                   change channel list

       DVDNAV input control
                 K,J,H,L             browse up/down/left/right
                 M                   jump to main menu
                 S                   select




SLAVE MODE PROTOCOL


                 audio_delay <value> Adjust the  audio  delay  of
                                     value seconds

                 quit                Quit MPlayer

                 pause               Pause/unpause the playback

                 grap_frames         Somebody know ?

                 pt_step <value> [force=<value>]
                                     Go to next/previous entry in
                                     the playtree.

                 pt_up_step <value> [force=<value>]
                                     Like pt_step but it jumps to
                                     next/previous  in the parent
                                     list.

                 alt_src_step <value>
                                     When more than one source is
                                     available   it  selects  the
                                     next/previous one (only sup­
                                     ported by asx playlist).

                 sub_delay <value> [abs=<value>]
                                     Adjust  the  subtitles delay
                                     of +/-  <value>  seconds  or
                                     set  it  to  <value> seconds
                                     when abs is non zero.

                 osd [level=<value>] Toggle osd mode or set it to
                                     level when level > 0.

                 volume <dir>        Increase/decrease volume

                 [contrast|brightness|hue|saturation]  <-100-100>
                 [abs=<value>]
                                     Set/Adjust video parameters.

                 frame_drop [type=<value>]
                                     Toggle/Set  frame   dropping
                                     mode.

                 sub_visibility      Toggle  subtitle visibility.

                 sub_pos <value>     Adjust subtitles position.

                 vo_fullscreen       Switch to fullscreen mode.

                 tv_step_channel <dir>
                                     Select   next/previous    tv

       ~/.mplayer/config
              user settings

       ~/.mplayer/input.conf
              input  bindings  (see  '-input  keylist'  for  full
              keylist)

       ~/.mplayer/gui.conf
              GUI configuration file

       ~/.mplayer/gui.pl
              GUI playlist

       ~/.mplayer/font/
              font directory (There must be a font.desc file  and
              files with .RAW extension.)

       ~/.mplayer/DVDkeys/
              cracked CSS keys
       Sub files
              are  searched  for  in  this  priority (for example
              /mnt/movie/movie.avi):
                 /mnt/cdrom/movie.sub
                 ~/.mplayer/sub/movie.sub
                 ~/.mplayer/default.sub




EXAMPLES

       Quickstart DVD playing
              mplayer -dvd 1

       Play in japanese with english subtitles
              mplayer -dvd 1 -alang ja -slang en

       Play only chapters 5, 6, 7
              mplayer -dvd 1 -chapter 5-7

       Multiangle DVD playing
              mplayer -dvd 1 -dvdangle 2

       Playing from a different DVD device
              mplayer -dvd 1 -dvd-device /dev/dvd2

       Old style DVD (VOB) playing
              mplayer   -dvdauth   /dev/dvd    /mnt/dvd/VIDEO_TS/
              VTS_02_4.VOB

       Stream from HTTP
              mplayer http://mplayer.hq/example.avi


       Encoding DVD title #2, resizing to 640x480
              mencoder -dvd 2 -vop  scale=640:480  -o  title2.avi
              -oac copy -ovc divx4

       Encoding  DVD  title  #2, resizing to 512xHHH (keep aspect
       ratio)
              mencoder  -dvd  2  -vop  scale -zoom -xy 512 -o ti­
              tle2.avi -oac copy -ovc divx4

       The same, but with libavcodec family, MPEG4  (Divx5)  com­
       pression
              mencoder -dvd 2 -o title2.avi -ovc  lavc  -lavcopts
              vcodec=mpeg4:vhq:vbitrate=1800 -oac copy

       The same, but with libavcodec family, MJPEG compression
              mencoder  -dvd  2 -o titel2.avi -ovc lavc -lavcopts
              vcodec=mjpeg:vhq:vbitrate=1800 -oac copy

       Encoding all *.jpg files in the current dir
              mencoder \*.jpg -mf on:fps=25  -o  output.avi  -ovc
              divx4

       Encoding from tuner
              mencoder  -tv on:driver=v4l:width=640:height=480 -o
              tv.avi -ovc rawrgb

       Encoding from a pipe
              rar p test-SVCD.rar  |  mencoder  -ovc  divx4  -di­
              vx4opts br=800 -ofps 24 -- -

       Encoding multiple *.vob files
              cat *.vob | mencoder <options> -




BUGS

       Probably.   PLEASE,  double-check the documentation (espe­
       cially bugreports.html), the FAQ and the mail archive  be­
       fore!
       Send  your complete bug reports to the MPlayer-users mail­
       ing list at <mplayer-users@mplayerhq.hu>.   We  love  com­
       plete bug reports :)




AUTHORS

       Check documentation.

       MPlayer is (C) 2000-2003
              Arpad Gereoffy

       unlikely,  the  authors  don't take any responsibility for
       that!



                            2003-01-11                 MPlayer(1)

Man(1) output converted with man2html