mirror of https://github.com/mpv-player/mpv
803 lines
24 KiB
Groff
803 lines
24 KiB
Groff
.\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users>
|
|
.\" This manpage was/is done by Gabucino
|
|
.\"
|
|
.TH MPlayer
|
|
.SH NAME
|
|
mplayer \- Movie Player for Linux
|
|
.SH SYNOPSIS
|
|
.B mplayer
|
|
.RB [ \-gui ]
|
|
.RB [ \-v ]
|
|
.RB [ \-help / -h / --help ]
|
|
.RB [ \-quiet ]
|
|
.RB [ \-vo\ <driver>[:<device>] ]
|
|
.RB [ \-ao\ <driver>[:<device>] ]
|
|
.RB [ \-vcd\ <track\ number> ]
|
|
.RB [ \-sb\ <byte\ position> ]
|
|
.RB [ \-nosound ]
|
|
.RB [ \-abs\ <bytes> ]
|
|
.RB [ \-delay\ <secs> ]
|
|
.RB [ \-nobps ]
|
|
.RB [ \-aid\ <id> ]
|
|
.RB [ \-alang\ <audio\ stream\ languages> ]
|
|
.RB [ \-vid\ <id> ]
|
|
.RB [ \-fps\ <rate> ]
|
|
.RB [ \-mc\ <seconds/5f> ]
|
|
.RB [ \-fs ]
|
|
.RB [ \-vm ]
|
|
.RB [ \-zoom ]
|
|
.RB [ \-x\ <x> ]
|
|
.RB [ \-y\ <y> ]
|
|
.RB [ \-sws\ <software\ scaler\ type> ]
|
|
.RB [ \-xy\ <factor> ]
|
|
.RB [ \-pp\ <quality> ]
|
|
.RB [ \-include\ <config\ file> ]
|
|
.RB [ \-lircconf\ <config\ file> ]
|
|
.RB [ \-ffactor\ <number> ]
|
|
.RB [ \-sub\ <filename> ]
|
|
.RB [ \-subfps\ <rate> ]
|
|
.RB [ \-subdelay\ <seconds> ]
|
|
.RB [ \-vobsub\ <vobsub\ file\ without\ extention> ]
|
|
.RB [ \-vobsubid\ <vobsub\ subtitle\ id> ]
|
|
.RB [ \-z\ <0-9> ]
|
|
.RB [ \-idx ]
|
|
.RB [ \-forceidx ]
|
|
.RB [ \-nodshow ]
|
|
.RB [ \-noxv ]
|
|
.RB [ \-forcexv ]
|
|
.RB [ \-ss\ <time> ]
|
|
.RB [ \-dumpaudio ]
|
|
.RB [ \-dumpvideo ]
|
|
.RB [ \-dumpstream ]
|
|
.RB [ \-noframedrop ]
|
|
.RB [ \-framedrop ]
|
|
.RB [ \-nodouble ]
|
|
.RB [ \-double ]
|
|
.RB [ \-stereo\ <mode> ]
|
|
.RB [ \-channels\ <n> ]
|
|
.RB [ \-srate\ <Hz> ]
|
|
.RB [ \-osdlevel\ <level> ]
|
|
.RB [ \-config\ <file> ]
|
|
.RB [ \-display\ <name> ]
|
|
.RB [ \-xineramascreen\ <screen\ number> ]
|
|
.RB [ \-wid\ <window\ id> ]
|
|
.RB [ \-unicode ]
|
|
.RB [ \-utf8 ]
|
|
.RB [ \-fsmode\ <mode> ]
|
|
.RB [ \-vc\ <video\ codec\ name> ]
|
|
.RB [ \-ac\ <audio\ codec\ name> ]
|
|
.RB [ \-vfm\ <video\ codec\ family> ]
|
|
.RB [ \-afm\ <audio\ codec\ family> ]
|
|
.RB [ \-frames\ <number> ]
|
|
.RB [ \-autoq\ <quality> ]
|
|
.RB [ \-fb\ <device> ]
|
|
.RB [ \-fbmode\ <modename> ]
|
|
.RB [ \-fbmodeconfig\ <filename> ]
|
|
.RB [ \-monitor_hfreq\ <horizontal\ frequency\ range> ]
|
|
.RB [ \-monitor_vfreq\ <vertical\ frequency\ range> ]
|
|
.RB [ \-monitor_dotclock\ <dotclock\ (or\ pixelclock)\ range> ]
|
|
.RB [ \-benchmark ]
|
|
.RB [ \-dvd\ <title\ id> ]
|
|
.RB [ \-chapter\ <chapter\ id> ]
|
|
.RB [ \-dvdangle\ <angle\ id> ]
|
|
.RB [ \-alang\ <country\ code> ]
|
|
.RB [ \-slang\ <country\ code> ]
|
|
.RB [ \-sid\ <subtitle \id> ]
|
|
.RB [ \-dvdkey\ <key> ]
|
|
.RB [ \-skin\ <skin\ name> ]
|
|
.RB [ \-aspect\ <ratio> ]
|
|
.RB [ \-monitoraspect\ <ratio> ]
|
|
.RB [ \-subcp\ <codepage> ]
|
|
.RB [ \-dumpmpsub ]
|
|
.RB [ \-dumpfile ]
|
|
.RB [ \-dumpsub ]
|
|
.RB [ \-screenw\ <pixels> ]
|
|
.RB [ \-screenh\ <pixels> ]
|
|
.RB [ \-cache\ <kbytes> ]
|
|
.RB [ \-bpp\ <depth> ]
|
|
.RB [ \-flip ]
|
|
.RB [ \-playlist\ <filename> ]
|
|
.RB [ \-slave ]
|
|
.RB [ \-loop\ <num> ]
|
|
.RB [ \-mixer\ <device> ]
|
|
.RB [ \-master\ yes/no ]
|
|
.RB [ \-tv\ <suboptions> ]
|
|
.RB [ \-dapsync ]
|
|
.RB [ \-softsleep ]
|
|
.RB [ \-rootwin ]
|
|
.RB [ \-font\ <path\ to\ font.desc\ file> ]
|
|
.I < - | file | URL | device >
|
|
.PP
|
|
.SH DESCRIPTION
|
|
.I mplayer
|
|
MPlayer is a movie player for LINUX (runs on many other Unices, and non-x86
|
|
CPUs, see section 6). It plays most MPEG, AVI, MOV/QT and ASF/WMV files, supported by
|
|
many native and Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, and even
|
|
DivX movies too (and you don't need the avifile library at all!).
|
|
|
|
Another big feature of mplayer is the wide range of supported output drivers :
|
|
X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, GGI, SDL (and all the drivers
|
|
they support), VESA (on every VESA compatible card, even without X!), and some
|
|
lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! Most of them
|
|
supports software or hardware scaling, so you can enjoy movies in fullscreen.
|
|
|
|
Several subtitles types are supported (curently 9 !) and the fonts are
|
|
rendered with nice big antialiased shaded fonts ! Of course there is support
|
|
for european/ISO 8859-1,2 (hungarian, english, czech, etc), cyrillic, korean
|
|
fonts.
|
|
.LP
|
|
.SH "GUI OPTIONS"
|
|
.I NOTE:
|
|
The GUI code has to be compiled in *explicitly*, for details see the
|
|
documentation.
|
|
.TP
|
|
.B \-gui
|
|
start MPlayer in GUI mode.
|
|
.TP
|
|
.B \-skin <skin\ directory>
|
|
load skin from this directory (WITHOUT path name!). For example '-skin fittyfene' tries these :
|
|
|
|
/usr/local/share/mplayer/Skin/fittyfene
|
|
~/.mplayer/Skin/fittyfene
|
|
.LP
|
|
.SH "DVD OPTIONS"
|
|
.I NOTE:
|
|
These options are valid only with DVD support compiled in. For details,
|
|
see the documentation.
|
|
.I NOTE:
|
|
DVD playback sometimes requires deinterlacing: see '-pp 0x20000' or '-npp lb' options.
|
|
.TP
|
|
.B \-dvd\ titleid
|
|
tell MPlayer which movies (marked with titleid) to play. For example
|
|
sometimes '1' are trailers, and '2' is the real movie.
|
|
.TP
|
|
.B \-chapter\ <chapter\ id>
|
|
specify which chapter to start playing at. Optionally specify which chapter to
|
|
end playing at. Examples can be found below.
|
|
.TP
|
|
.B \-dvdangle\ <angle\ id>
|
|
some DVD discs contain scenes that can be viewed from multiple angles.
|
|
Here you can tell MPlayer which angles to use. Examples can be found below.
|
|
.TP
|
|
.B \-alang\ <audio\ stream\ language>
|
|
Used when playing DVD disks. Expects a two-letter country code(s) as
|
|
parameter, and always tries to play back audio streams those language
|
|
matches the given code. For example: -alang hu,en will always try to play
|
|
hungarian or if it's non-existant then english audio streams if there are any.
|
|
.TP
|
|
.B \-slang\ <subtitle\ language>
|
|
See the -sid option, but this one needs a two-letter parameter, a country code.
|
|
Like: -slang hu,en will always select hungarian or if it's non existant then
|
|
english subtitles, if there are any. For the list of available subtitles, use
|
|
with the -v switch and look at the output.
|
|
.TP
|
|
.B \-sid\ <id>
|
|
Turns on DVD subtitle displaying. Also, you MUST specify a number which
|
|
corresponds to a DVD subtitle language (0-31). For the list of available
|
|
subtitles, use with the -v switch and look at the output.
|
|
.LP
|
|
.SH "GENERAL OPTIONS"
|
|
.TP
|
|
.I NOTE
|
|
Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
|
|
.TP
|
|
.B \-vo\ <driver>[:<device>]
|
|
select video output driver and optinaly device. "device" is valid with
|
|
SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib).
|
|
|
|
you can get the list of available drivers executing
|
|
.I mplayer -vo help
|
|
|
|
.TP
|
|
.B \-ao\ <driver>[:<device>]
|
|
select audio output driver and optinaly device. "device" is valid with
|
|
SDL too, it means sub-driver then (for example: -vo sdl:esd).
|
|
|
|
If using OSS, you can specify which sound device to use like this :
|
|
-ao oss:/dev/dsp1 (replaces the old -dsp option)
|
|
|
|
you can get the list of available drivers executing
|
|
.I mplayer -ao help
|
|
|
|
.TP
|
|
.B \-vcd\ <track>
|
|
play video cd track from device instead of plain file
|
|
.TP
|
|
.B \-nosound
|
|
don't play sound
|
|
.TP
|
|
.B \-fs
|
|
fullscreen playing (centers movie, and makes black
|
|
bands around it)
|
|
.TP
|
|
.B \-vm
|
|
try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl
|
|
output drivers support it.
|
|
.TP
|
|
.B \-zoom
|
|
use software scaling, where available (use with -nofs). svga, x11, vesa
|
|
output drivers support it.
|
|
.TP
|
|
.B \-flip
|
|
flip image (useful for example for old Indeo codecs). Supported only(?)
|
|
by the 'sdl' and 'x11' outputs.
|
|
.TP
|
|
.B \-x\ <x>
|
|
scale image to x width (if driver suppports)
|
|
.TP
|
|
.B \-y\ <y>
|
|
scale image to y height (if driver supports)
|
|
.TP
|
|
.B \-sws\ <software\ scaler\ type>
|
|
this option sets the quality (and speed, respectively) of the software scaler,
|
|
with the -zoom option. For example with x11 or other outputs which lack
|
|
hardware acceleration. Possible settings are :
|
|
|
|
0 - fast bilinear (default)
|
|
1 - bilinear
|
|
2 - bicubic (best quality)
|
|
.TP
|
|
.B \-xy\ <factor>
|
|
scale image by <factor>
|
|
.TP
|
|
.B \-autoq\ <quality>
|
|
dynamically changes the level of postprocess, depending on spare CPU time
|
|
available. The number you specify will be the maximum level used. Usually you
|
|
can use some big number. You may not use together with -pp but it's ok with
|
|
-npp !
|
|
.TP
|
|
.B \-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
|
|
.TP
|
|
.B \-sub\ <subtitle\ file>
|
|
use/display this subtitle file
|
|
.TP
|
|
.B \-subfps\ <rate>
|
|
specify frame/sec rate of subtitle file (float number)
|
|
(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!)
|
|
(default: the same fps as the movie)
|
|
.TP
|
|
.B \-subdelay\ <sec>
|
|
delays subtitles by <sec> seconds. Can be negative.
|
|
.TP
|
|
.B \-vobsub\ <vobsub\ file\ without\ extention>
|
|
specify the VobSub files that are to be used for subtitle. This is
|
|
the full pathname without extensions, i.e. without the ".idx", ".ifo"
|
|
or ".sub".
|
|
.TP
|
|
.B \-vobsubid\ <vobsub\ subtitle\ id>
|
|
specify the VobSub subtitle id. Valid values range from 0 to 31.
|
|
.TP
|
|
.B \-osdlevel\ <level>
|
|
specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer)
|
|
(default = 2)
|
|
.TP
|
|
.B \-lircconf\ <config\ file>
|
|
specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc
|
|
.TP
|
|
.B \-v
|
|
enable verbose output (more -v means more verbosity)
|
|
.TP
|
|
.B \-quiet
|
|
display less output, status messages.
|
|
.TP
|
|
.B \-benchmark
|
|
used in combination with -nosound and -vo null for benchmarking.
|
|
.TP
|
|
.B \-aspect <ratio>
|
|
set aspect ratio of movies. It's autodetected on MPEG files, and can't be
|
|
autodetected on AVI files. Examples:
|
|
|
|
-aspect 4:3 or -aspect 1.3333
|
|
-aspect 16:9 or -aspect 1.7777
|
|
|
|
.TP
|
|
.B \-monitoraspect <ratio>
|
|
set aspect ratio of your screen. Examples:
|
|
|
|
-monitoraspect 4:3 or 1.3333
|
|
-monitoraspect 16:9 or 1.7777
|
|
|
|
.TP
|
|
.B \-playlist <file>
|
|
play files according to this filelist (1 file/row).
|
|
.TP
|
|
.B \-ss\ <time>
|
|
seek to given time position. For example :
|
|
|
|
-ss 56 seeks to 56 seconds
|
|
-ss 01:10:00 seeks to 1 hour 10 min
|
|
|
|
.TP
|
|
.B \-loop\ <num>
|
|
loops movie playback <num> times. 0 means forever.
|
|
.TP
|
|
.B \-mixer\ <device>
|
|
this option will tell MPlayer to use a different device for mixing than
|
|
/dev/mixer.
|
|
.TP
|
|
.B \-master\ yes/no
|
|
Setting this option to "yes" will instruct MPlayer to change the MASTER
|
|
mixer channel when setting the volume, and "no" means the PCM channel.
|
|
.TP
|
|
.B \-tv\ <suboptions>
|
|
this option enables the TV grabbing feature of MPlayer. For complete
|
|
documentation, please see documentation.html chapter 2.5
|
|
.TP
|
|
.B \-rootwin
|
|
play movie in the root window (desktop background) instead of opening
|
|
a new one. Works only with the xv and xmga drivers.
|
|
.TP
|
|
.B \-font\ <path\ to\ font.desc\ file>
|
|
search for the OSD/SUB fonts in an alternative directory (default :
|
|
~/.mplayer/font/font.desc). For example:
|
|
|
|
-font ~/.mplayer/arial-14/font.desc
|
|
.IP
|
|
.SH "ADVANCED OPTIONS"
|
|
.TP
|
|
.I NOTE
|
|
These options can help you solve your particular problem.. Also, see the
|
|
documentation !
|
|
.TP
|
|
.B \-vc <name>
|
|
force usage of a specific video codec, according to its name in codecs.conf,
|
|
for example :
|
|
|
|
-vc divx use VFW DivX codec
|
|
-vc divxds use DirectShow DivX codec
|
|
-vc ffdivx use libavcodec's DivX codec
|
|
-vc ffmpeg12 use libavcodec's MPEG1/2 codec
|
|
-vc divx4 use ProjectMayo's DivX codec
|
|
|
|
See '-vc help' for FULL list !
|
|
.TP
|
|
.B \-ac <name>
|
|
force usage of a specific audio codec, according to its name in codecs.conf,
|
|
for example :
|
|
|
|
-ac mp3 use libmp3 MP3 codec
|
|
-ac mp3acm use l3codeca.acm MP3 codec
|
|
-ac ac3 use AC3 codec
|
|
-ac hwac3 enable Hardware AC3 passthrough
|
|
(see documentation)
|
|
-ac vorbis use libvorbis
|
|
-ac ffmp3 use ffmpeg's MP3 decoder (SLOW)
|
|
|
|
See '-ac help' for FULL list !
|
|
.TP
|
|
.B \-vfm <1-12>
|
|
force usage of a specific codec FAMILY, and FALLBACK to default if failed.
|
|
For example:
|
|
|
|
-vfm 2 use VFW (Win32) codecs
|
|
-vfm 3 use OpenDivX/DivX4 codec (YV12)
|
|
(same as -vc odivx but fallback)
|
|
-vfm 4 use DirectShow (Win32) codecs
|
|
-vfm 5 use libavcodec codecs
|
|
-vfm 7 use DivX4 codec (YUY2)
|
|
(same as -vc divx4 but fallback)
|
|
-vfm 10 use XAnim codecs
|
|
|
|
See -vc help for FULL list !
|
|
|
|
.I NOTE:
|
|
if libdivxdecore support was compiled in, then type 3 and 7 now contains
|
|
just the same DivX4 codec, but different APIs to reach it. For difference
|
|
between them and when to use which, check the DivX4 section in the
|
|
documentation.
|
|
.TP
|
|
.B \-afm <1-12>
|
|
force usage of a specific audio format. For example:
|
|
|
|
-afm 1 use libmp3 (mp2/mp3, but not mp1)
|
|
-afm 2 suppose raw PCM audio
|
|
-afm 3 use libac3
|
|
-afm 4 use a matching Win32 codec
|
|
-afm 5 use aLaw/uLaw driver
|
|
-afm 10 use libvorbis
|
|
-afm 11 use ffmpeg's MP3 decoder (even mp1)
|
|
|
|
See -ac help for FULL list !
|
|
.TP
|
|
.B \-sb\ <byte\ position>
|
|
seek to byte position
|
|
.TP
|
|
.B \-bpp\ <depth>
|
|
use different color depth than autodetect. Not all -vo drivers support
|
|
it (fbdev, dga2, svga, vesa).
|
|
.TP
|
|
.B \-pp\ <quality> (see -npp option too !)
|
|
apply postprocess filter on decoded image
|
|
|
|
Postprocessing effect depends on the codec and works only for MPEG1/2,
|
|
libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs.
|
|
|
|
This is the numerical mode to use postprocessing. The '-npp' option described
|
|
below has the same effects but with letters. To have several filters at the
|
|
same time, simply add the hexadecimal values.
|
|
|
|
.I EXAMPLE:
|
|
The following values are known to give good results:
|
|
\-pp 0x20000 <=> \-npp lb (deinterlacing - for DVD/MPEG2 playback e.g.)
|
|
\-pp 0x7f <=> \-npp hb,vb,dr,al (smooth the images)
|
|
.TP
|
|
.B \-npp\ <options>
|
|
This option allows to give more litterate options for postprocessing, and is
|
|
another way of calling it (not with -pp).
|
|
|
|
.I EXAMPLE:
|
|
'-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
|
|
'-pp 0x7f' <=> '-npp hb,vb,dr,al'
|
|
|
|
The options for -npp are a coma separated list of the keywords below:
|
|
help : display the options available and exit MPlayer
|
|
de or default : hdeblock:a,vdeblock:a,
|
|
dering:a,autolevels,tmpnoise:a:150:200:400
|
|
fa or fast : x1hdeblock:a,x1vdeblock:a,
|
|
dering:a,autolevels,tmpnoise:a:150:200:400
|
|
hb or hdeblock : horizontal deblocking filter
|
|
(luminance: 0x2 chrominance: 0x20)
|
|
+ 1st threshold : default is 1, higher means stronger deblocking
|
|
+ 2nd threshold : default is 40, lower means stronger deblocking
|
|
vb or vdeblock : vertical deblocking filter
|
|
(luminance: 0x1 chrominance: 0x10)
|
|
+ 2 thresholds : shared with hdeblock thresholds
|
|
hr or rkhdeblock : Ramkishor & Karandikar's horizontal deblock
|
|
filter (0x1000)
|
|
vr or rkvdeblock : R&K's vertical deblock filter (0x100)
|
|
h1 or x1hdeblock : x1 horizontal deblock filter (0x2000)
|
|
v1 or x1vdeblock : y1 horizontal deblock filter (0x200)
|
|
dr or dering : dering
|
|
(luminance: 0x4 chrominance: 0x40)
|
|
al or autolevels : auto brightness/contrast correction (0x8)
|
|
lb or linblenddeint : linear blend deinterlacing (0x20000)
|
|
li or linipoldeint : linear interpolation deinterlacing (0x10000)
|
|
ci or cubicipoldeint : cubic interpolation deinterlacing (0x40000)
|
|
md or mediandeint : median deinterlacing (0x80000)
|
|
tn or tmpnoise : temporal noise reducer (0x100000)
|
|
+ 3 thresholds : t1 <= t2 <= t3 (larger means stronger filtering)
|
|
fq or forcequant : force quantizer [for low-quality movies
|
|
reencoded at high bitrates] (0x200000)
|
|
|
|
These keywords accept a '-' prefix to disable the option.
|
|
|
|
.I EXAMPLE:
|
|
'-npp de,-al' means 'default filters without brightness/contrast correction'
|
|
|
|
A ':' followed by a letter may be appended to the option to indicate its
|
|
scope:
|
|
a : automatically switches the filter off if the cpu is too slow
|
|
c : do chrominance filtering too
|
|
y : do not do chrominance filtering (that is only luminance filtering)
|
|
|
|
Each filter defaults to 'c' (chrominance).
|
|
|
|
.I EXAMPLE:
|
|
'-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser'
|
|
'-npp hb:y,vb:a -autoq 6' means 'deblock horizontal only luminance, and
|
|
automatically switch vertical deblocking on/off depending on available
|
|
cpu time'
|
|
.TP
|
|
.B \-slave
|
|
This option switches on slave mode. This is intended for use
|
|
of MPlayer as a backend to other programs. Instead of intercepting keyboard
|
|
events, MPlayer will read simplistic command lines from its stdin.
|
|
See section
|
|
.B SLAVE MODE PROTOCOL
|
|
for the syntax.
|
|
.TP
|
|
.B \-abs\ <bytes>
|
|
sound card audio buffer size (in bytes, default: measuring)
|
|
.TP
|
|
.B \-delay\ <secs>
|
|
audio delay in seconds (may be +/- float value)
|
|
.TP
|
|
.B \-nobps
|
|
don't use avg. byte/sec value for A-V sync (AVI)
|
|
.TP
|
|
.B \-aid\ <id>
|
|
select audio channel [MPG: 0-31 AVI: 1-99 ASF: 0-127 VOB: 128-...]
|
|
.TP
|
|
.B \-vid\ <id>
|
|
select video channel [MPG: 0-15 AVI: -- ]
|
|
.TP
|
|
.B \-fps\ <value>
|
|
force frame rate (if value is wrong in the header) (float number)
|
|
.TP
|
|
.B \-mc\ <seconds/5frame>
|
|
maximum sync correction per 5 frames (in seconds)
|
|
.TP
|
|
.B \-ni
|
|
force usage of non-interleaved AVI parser (fixes playing
|
|
of some bad AVI files)
|
|
.TP
|
|
.B \-include configfile
|
|
specify config file to be parsed after the default
|
|
.TP
|
|
.B \-z\ <0-9>
|
|
specifies compression level for PNG output
|
|
0 : no compression
|
|
9 : max compression
|
|
.TP
|
|
.B \-idx
|
|
rebuilds INDEX of the AVI. Useful with broken downloads, or badly
|
|
created AVIs.
|
|
.TP
|
|
.B \-forceidx
|
|
force rebuilding of INDEX. Useful for testing, or AVIs with bad
|
|
indexes.
|
|
.TP
|
|
.B \-nodshow
|
|
disables usage of DirectShow video codecs
|
|
.TP
|
|
.B \-noxv (SDL only)
|
|
disable XVideo hardware acceleration
|
|
.TP
|
|
.B \-forcexv (SDL only)
|
|
force using XVideo
|
|
.TP
|
|
.B \-dumpaudio
|
|
writes audio stream of the file to ./stream.dump (mostly usable
|
|
with mpeg/ac3)
|
|
.TP
|
|
.B \-dumpstream
|
|
dumps the file to ./stream.dump . Useful for example
|
|
when ripping from DVD.
|
|
.TP
|
|
.B \-noframedrop
|
|
no frame dropping : every frame is played, audio and video may be out of
|
|
sync (default)
|
|
.TP
|
|
.B \-framedrop
|
|
frame dropping : decode all frames, video may skip
|
|
.TP
|
|
.B \-nodouble
|
|
disables doublebuffering.
|
|
With the DGA driver this also disables OSD support but yields some speed gain.
|
|
.TP
|
|
.B \-dvdkey key
|
|
key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699
|
|
(this is NOT for DVD playing! For DVD use the -dvd option!)
|
|
.TP
|
|
.B \-stereo mode
|
|
select type of MP2/MP3 stereo output.
|
|
|
|
Stereo 0
|
|
Left channel 1
|
|
Right channel 2
|
|
.TP
|
|
.B \-channels n
|
|
select number of audio output channels to be used
|
|
|
|
Stereo 2
|
|
Surround 4
|
|
Full 5.1 6
|
|
|
|
Currently this option is only honoured for AC3 audio.
|
|
.TP
|
|
.B \-srate <Hz>
|
|
specifies Hz to playback audio on. Has effect on playback speed!
|
|
.TP
|
|
.B \-config <config\ file>
|
|
specifies where to search for config file
|
|
.TP
|
|
.B \-display <name>
|
|
specify the hostname and display number of the X server you want
|
|
to display on. For example : -display xtest.localdomain:0
|
|
.TP
|
|
.B \-xineramascreen <screen number>
|
|
in Xinerama configurations (i.e. a single desktop that spans across multiple
|
|
displays) this option tells MPlayer which screen to display movie on. Range
|
|
0 - ...
|
|
.TP
|
|
.B \-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)
|
|
.TP
|
|
.B \-unicode
|
|
tells MPlayer to handle the subtitle file as UNICODE.
|
|
Contrary: -nounicode
|
|
.TP
|
|
.B \-utf8
|
|
tells MPlayer to handle the subtitle file as UTF8.
|
|
.TP
|
|
.B \-fsmode\ mode
|
|
This option workarounds some problems when using specific windowmanagers and
|
|
fullscreen mode. If you experience fullscreen problems, try changing this
|
|
value between 0 and 7.
|
|
|
|
-fsmode 0 new method
|
|
-fsmode 1 ICCCWM patch
|
|
(for KDE2/icewm)
|
|
-fsmode 2 old method
|
|
-fsmode 3 ICCCWM patch
|
|
plus Motif method
|
|
.TP
|
|
.B \-frames\ number
|
|
MPlayer plays <number> frames, then quits.
|
|
.TP
|
|
.B \-fb\ <device> (FBdev or DirectFB only)
|
|
Specifies the framebuffer device to use. By default it uses /dev/fb0 .
|
|
.TP
|
|
.B \-fbmode\ <modename> (FBdev only)
|
|
Change videomode to the one that is labelled as <modename> in /etc/fb.modes .
|
|
.TP
|
|
.I NOTE
|
|
VESA framebuffer doesn't support mode changing.
|
|
.TP
|
|
.B \-fbmodeconfig\ <filename> (FBdev only)
|
|
Use this config file instead of the default /etc/fb.modes .
|
|
Only valid for the fbdev driver.
|
|
.TP
|
|
.B \-monitor_hfreq <horizontal frequency range> (FBdev only)
|
|
.TP
|
|
.B \-monitor_vfreq <vertical frequency range> (FBdev only)
|
|
.TP
|
|
.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (FBdev only)
|
|
Look into etc/example.conf for further information and in DOCS/video.html.
|
|
.TP
|
|
.B \-subcp\ codepage
|
|
If your system supports iconv(3), you can use this option to
|
|
specify codepage of the subtitle. Examples:
|
|
|
|
-subcp latin2
|
|
-subcp cp1250
|
|
|
|
.TP
|
|
.B \-dumpmpsub
|
|
Convert the given subtitle (specified with the -sub switch) to MPlayer's
|
|
subtitle format, MPsub. Dumps a dump.mpsub file to current directory.
|
|
.TP
|
|
.B \-screenw\ <pixels>
|
|
If you use an output driver which can't know the resolution of the screen
|
|
(mga/fbdev/x11 and/or TVout) this is where you can specify the horizontal
|
|
resolution.
|
|
.TP
|
|
.B \-screenh\ <pixels>
|
|
If you use an output driver which can't know the resolution of the screen
|
|
(mga/fbdev/x11 and/or TVout) this is where you can specify the vertical
|
|
resolution.
|
|
.TP
|
|
.B \-cache\ <kbytes>
|
|
This option specifies how much memory to use when precaching a file/URL.
|
|
Especially useful on slow media. Default is off.
|
|
.TP
|
|
.B \-softsleep
|
|
uses high quality software timers. Efficient as the RTC, doesn't need root,
|
|
but requires more CPU.
|
|
.IP
|
|
.SH "ALPHA/BETA CODE"
|
|
.TP
|
|
.I NOTE
|
|
These are included in this manpage just for completeness! These may or may NOT
|
|
work! If you don't know what are these, you DON'T need these! In either case,
|
|
double-check the documentation !
|
|
.TP
|
|
.B \-dumpvideo
|
|
dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
|
|
.TP
|
|
.B \-dapsync
|
|
use alternative A/V sync method. Where is it useful?
|
|
.IP
|
|
.SH KEYBOARD CONTROL
|
|
.TP
|
|
.I NOTE
|
|
These keys may/may not work, depending on your video output driver.
|
|
.TP
|
|
<- or -> seek backward/forward 10 seconds
|
|
|
|
up or down seek backward/forward 1 minute
|
|
|
|
pgup/pgdown seek backward/forward 10 minutes
|
|
|
|
p or SPACE pause movie (press any key)
|
|
|
|
q or ESC stop playing and quit program
|
|
|
|
+ or - adjust audio delay by +/- 0.1 second
|
|
|
|
/ or * decrease/increase volume
|
|
|
|
o toggle OSD: none / seek / seek+timer
|
|
|
|
m toggle using master/pcm volume
|
|
|
|
z or x adjust subtitle delay by +/- 0.1 second
|
|
|
|
(the following keys are valid only when using -vo xv OR -vo [vesa|fbdev]:vidix
|
|
OR -vo xvidix OR -vc divxds. The latter is slow!)
|
|
|
|
1 or 2 adjust contrast
|
|
|
|
3 or 4 adjust brightness
|
|
|
|
5 or 6 adjust hue
|
|
|
|
7 or 8 adjust saturation
|
|
|
|
.IP
|
|
.SH SLAVE MODE PROTOCOL
|
|
If the -slave switch is given, playback is controlled by a
|
|
line-based protocol with the following tokens:
|
|
.TP
|
|
stop pause playback
|
|
|
|
play resume playback
|
|
|
|
seek <NUM> continue at second NUM
|
|
|
|
skip <NUM> skip NUM seconds (may be negative)
|
|
|
|
quit exit MPlayer
|
|
|
|
.IP
|
|
.SH FILES AND DIRECTORIES
|
|
.TP
|
|
.I CONFIG FILES
|
|
Settings are stored system-wide in the /etc/mplayer.conf file,
|
|
and per-user in $HOME/.mplayer/config. The directory
|
|
$HOME/.mplayer and the 'config' are created if doesn't exist.
|
|
.TP
|
|
.I FONTS
|
|
Fonts are searched in $HOME/.mplayer/font. There must be a font.desc
|
|
file, and files with .RAW extension.
|
|
.TP
|
|
.I SUBTITLE FILES
|
|
MPlayer currently supports 10 subtitle formats : MicroDVD, SubRip, unnamed,
|
|
SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, VobSub, and our own: MPsub.
|
|
Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi)
|
|
/mnt/cdrom/movie.sub
|
|
(utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
|
|
$HOME/.mplayer/sub/movie.sub
|
|
(utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
|
|
$HOME/.mplayer/default.sub
|
|
.IP
|
|
.SH "EXAMPLES"
|
|
.B Quickstart DVD playing
|
|
mplayer -dvd 1
|
|
.TP
|
|
.B Play only chapters 5, 6, 7
|
|
mplayer -dvd 1 -chapter 5-7
|
|
.TP
|
|
.B Multiangle DVD playing
|
|
mplayer -dvd 1 -dvdangle 2
|
|
.TP
|
|
.B Playing from a different DVD device
|
|
mplayer -dvd 1 /dev/dvd2
|
|
.TP
|
|
.B Stream from HTTP
|
|
mplayer http://mplayer.hq/example.avi
|
|
.TP
|
|
.B Convert subtitle to MPsub (to ./dump.mpsub)
|
|
mplayer dummy.avi -sub source.sub -dumpmpsub
|
|
.LP
|
|
.SH BUGS
|
|
Probably. Check the documentation.
|
|
|
|
Bugreports should be addressed to the MPlayer-users mailing list
|
|
(mplayer-users@mplayerhq.hu) ! If you want to submit a bugreport
|
|
(which we love to receive!), please double-check the bugreports.html, and
|
|
tell us all that we need to know to identify your problem.
|
|
|
|
.LP
|
|
.SH AUTHORS
|
|
Check documentation !
|
|
|
|
MPlayer is (C) 2000-2002
|
|
.I Arpad Gereoffy <sendmail@to.mplayer-users>
|
|
|
|
This manpage is written and maintained by
|
|
.I Gabucino .
|
|
.LP
|
|
.SH STANDARD DISCLAIMER
|
|
Use only at your own risk! There may be errors and inaccuracies that could
|
|
be damaging to your system or your eye. Proceed with caution, and although
|
|
this is highly unlikely, the author doesn't take any responsibility for that!
|
|
.\" end of file
|