mirror of https://github.com/mpv-player/mpv
550 lines
15 KiB
Groff
550 lines
15 KiB
Groff
.\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu>
|
|
.\" 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 [ \-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 [ \-vid\ id ]
|
|
.RB [ \-fps\ rate ]
|
|
.RB [ \-mc\ seconds/5f ]
|
|
.RB [ \-fs ]
|
|
.RB [ \-vm ]
|
|
.RB [ \-zoom ]
|
|
.RB [ \-x\ x ]
|
|
.RB [ \-y\ y ]
|
|
.RB [ \-xy\ factor ]
|
|
.RB [ \-pp\ quality ]
|
|
.RB [ \-include\ configfile ]
|
|
.RB [ \-lircconf\ configfile ]
|
|
.RB [ \-ffactor\ number ]
|
|
.RB [ \-sub\ file ]
|
|
.RB [ \-subfps\ rate ]
|
|
.RB [ \-subdelay\ sec ]
|
|
.RB [ \-z\ <0-8> ]
|
|
.RB [ \-idx ]
|
|
.RB [ \-forceidx ]
|
|
.RB [ \-nodshow ]
|
|
.RB [ \-noxv ]
|
|
.RB [ \-forcexv ]
|
|
.RB [ \-ss\ time ]
|
|
.RB [ \-dumpaudio ]
|
|
.RB [ \-dumpvideo ]
|
|
.RB [ \-noframedrop ]
|
|
.RB [ \-framedrop ]
|
|
.RB [ \-nodouble ]
|
|
.RB [ \-double ]
|
|
.RB [ \-stereo\ mode ]
|
|
.RB [ \-srate\ Hz ]
|
|
.RB [ \-osdlevel\ level ]
|
|
.RB [ \-config\ file ]
|
|
.RB [ \-display\ name ]
|
|
.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 [ \-benchmark ]
|
|
.RB [ \-dvd\ titleid ]
|
|
.RB [ \-chapter\ chapterid ]
|
|
.RB [ \-dvdangle\ angleid ]
|
|
.RB [ \-dvdkey\ key ]
|
|
.RB [ \-skin\ skin ]
|
|
.RB [ \-aspect\ ratio ]
|
|
.RB [ \-monitoraspect\ ratio ]
|
|
.I - or file or 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 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!). The another big feature of mplayer is the wide range of
|
|
supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
|
|
fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) 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. And what about the nice big antialiased shaded
|
|
subtitles (7 supported types!!!) with european/ISO 8859-1,2 (hungarian,
|
|
english, czech, etc), cyrillic, korean fonts, and OSD?
|
|
.LP
|
|
.SH "GENERAL OPTIONS"
|
|
.TP
|
|
.I NOTE
|
|
Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
|
|
.TP
|
|
.B \-gui
|
|
start MPlayer with the GUI mode. You have to compile it in, for details
|
|
see the documentation.
|
|
.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\ chapterid
|
|
specify which chapter to start playing at. Examples can be found below.
|
|
.TP
|
|
.B \-dvdangle\ angleid
|
|
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 \-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
|
|
use XF86VidMode extension for mode changing
|
|
.TP
|
|
.B \-zoom
|
|
use software scaling, where available (use with -nofs)
|
|
.TP
|
|
.B \-x\ x
|
|
scale image to x width [if driver suppports!]
|
|
.TP
|
|
.B \-y\ y
|
|
scale image to y height
|
|
.TP
|
|
.B \-xy\ factor
|
|
scale image by <factor>
|
|
.TP
|
|
.B \-pp\ quality
|
|
apply postprocess filter on decoded image.
|
|
You need a STRONG CPU in order to use this!
|
|
The supported formats and settings are:
|
|
|
|
MPEG 1/2 0 (none), 1, 3, 7, 15, 31, 63
|
|
OpenDivX 0 (none), 1, 3, 7, 15, 31, 63
|
|
DivX4 0 (none) - 60
|
|
DivX 0 (none), 1, 2, 3, 4
|
|
|
|
.TP
|
|
.B \-autoq\ quality
|
|
dynamically changes the level of postprocess, depending on spare CPU
|
|
time available. Uses the same value ranges as -pp . The number you
|
|
specify will be the maximum level used. Usually you can use some big
|
|
number. You don't have to (and don't) use together with -pp !
|
|
.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\ file
|
|
use/display this subtitle file
|
|
.TP
|
|
.B \-subfps\ rate
|
|
specify frame/sec rate of subtitle file
|
|
(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!)
|
|
(default: the same as the movie)
|
|
.TP
|
|
.B \-subdelay\ sec
|
|
delays subtitles by <sec> seconds. Can be negative.
|
|
.TP
|
|
.B \-osdlevel\ level
|
|
specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer)
|
|
(default = 2)
|
|
.TP
|
|
.B \-lircconf\ configfile
|
|
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 verbose)
|
|
.TP
|
|
.B \-quiet
|
|
display less output, status messages.
|
|
.TP
|
|
.B \-benchmark
|
|
used in combination with -nosound and -vo null for benchmarking.
|
|
.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
|
|
.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
|
|
|
|
(has -noaspect pair)
|
|
.TP
|
|
.B \-monitoraspect ratio
|
|
set aspect ratio of your screen. Examples:
|
|
|
|
-aspect 4:3 or -aspect 1.3333
|
|
-aspect 16:9 or -aspect 1.7777
|
|
|
|
.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-5>
|
|
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)
|
|
|
|
See -vc help for FULL list !
|
|
|
|
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-5>
|
|
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
|
|
|
|
See -ac help for FULL list !
|
|
.TP
|
|
.B \-sb\ position
|
|
seek to byte position
|
|
.TP
|
|
.B \-ss\ time
|
|
seek to given time position. For example :
|
|
|
|
-ss 56
|
|
-ss 01:10:00
|
|
|
|
.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]
|
|
.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)
|
|
.TP
|
|
.B \-mc\ seconds/5frame
|
|
maximum sync correction per 5 frames (in seconds)
|
|
.TP
|
|
.B \-ni
|
|
force usage of non-interleaved AVI parser
|
|
.TP
|
|
.B \-include configfile
|
|
specify config file to be parsed after the default
|
|
.TP
|
|
.B \-z\ <0-8>
|
|
specifies compression level for PNG output
|
|
0 : no compression
|
|
8 : 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
|
|
disable XVideo hardware acceleration (with SDL only!)
|
|
.TP
|
|
.B \-forcexv
|
|
force using XVideo (SDL!)
|
|
.TP
|
|
.B \-dumpaudio
|
|
writes audio stream of the file to ./stream.dump (mostly usable
|
|
with mpeg/ac3)
|
|
.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
|
|
disable doublebuffering (default). Currently this is only honoured by the DGA driver.
|
|
With the DGA driver this also disables OSD support but yields some speed gain.
|
|
.TP
|
|
.B \-double
|
|
enable doublebuffering. Currently this is only honoured by the Xv and the DGA driver.
|
|
.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 MPEG1 stereo output.
|
|
|
|
Stereo 0
|
|
Left channel 1
|
|
Right channel 2
|
|
|
|
.TP
|
|
.B \-srate Hz
|
|
specifies Hz to playback audio on. Has effect on playback speed!
|
|
.TP
|
|
.B \-config configfile
|
|
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 \-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
|
|
Specifies the framebuffer device to use. By default it uses /dev/fb0 .
|
|
Only valid for the fbdev driver.
|
|
.TP
|
|
.B \-fbmode\ modename
|
|
Change videomode to the one that is labelled as <modename> in /etc/fb.modes .
|
|
Only valid for the fbdev driver.
|
|
.TP
|
|
.I NOTE
|
|
VESA framebuffer doesn't support mode changing.
|
|
.TP
|
|
.B \-fbmodeconfig\ filename
|
|
Use this config file instead of the default /etc/fb.modes .
|
|
Only valid for the fbdev driver.
|
|
.IP
|
|
.SH "ALPHA/BETA CODE"
|
|
.TP
|
|
.I NOTE
|
|
These are included in this manpage just for completeness! If you don't
|
|
know what are these, you DON'T need these! In either case, double-check the
|
|
documentation !
|
|
.TP
|
|
.B \-br\ rate
|
|
used with '-vo odivx' .
|
|
Specifies the bitrate to encode OpenDivx at
|
|
(in bits! e.g: 780000).
|
|
.TP
|
|
.I NOTE
|
|
You CAN'T encode sound, only video right now! Don't ask for it,
|
|
it's on the TODO list.
|
|
.TP
|
|
.B \-encode\ file
|
|
used with '-vo odivx' .
|
|
Specifies the output OpenDivX file. Won't overwrite.
|
|
.TP
|
|
.B \-dumpvideo
|
|
dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
|
|
.TP
|
|
.B \-sid
|
|
specify DVD subtitle (?)
|
|
.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 DirectShow DivX codec)
|
|
|
|
1 or 2 adjust contrast
|
|
|
|
3 or 4 adjust brightness
|
|
|
|
5 or 6 adjust hue
|
|
|
|
7 or 8 adjust saturation
|
|
|
|
.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 7 subtitle formats : MicroDVD, SubRip, unnamed,
|
|
SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha).
|
|
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 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
|
|
.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-2001
|
|
.I Arpad Gereoffy <arpi@thot.banki.hu>
|
|
|
|
This manpage is 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
|