mplayer.1

Mplayer源码

.\" $Revision: 20369 $
.\" MPlayer (C) 2000-2006 MPlayer Team
.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
.
.\" --------------------------------------------------------------------------
.\" Macro definitions
.\" --------------------------------------------------------------------------
.
.\" define indentation for suboptions
.nr SS 5
.\" add new suboption
.de IPs
.IP "\\$1" \n(SS
..
.\" begin of first level suboptions, end with .RE
.de RSs
.RS 10
..
.\" begin of 2nd level suboptions
.de RSss
.PD 0
.RS \n(SS+3
..
.\" end of 2nd level suboptions
.de REss
.RE
.PD 1
..
.
.\" --------------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------------
.
.TH MPlayer 1 "2006-10-15" "The MPlayer Project" "The Movie Player"
.
.SH NAME
mplayer  \- movie player
.br
mencoder \- movie encoder
.
.\" --------------------------------------------------------------------------
.\" Synopsis
.\" --------------------------------------------------------------------------
.
.SH SYNOPSIS
.na
.nh
.B mplayer
[options] [file|URL|playlist|\-]
.
.br
.B mplayer
[options] file1
[specific options] [file2] [specific options]
.
.br
.B mplayer
[options]
{group of files and options}
[group-specific options]
.
.br
.B mplayer
[dvd|dvdnav]://[title|[start_title]\-end_title]
[options]
.
.br
.B mplayer
vcd://track[/device]
.
.br
.B mplayer
tv://[channel]
[options]
.
.br
.B mplayer
radio://[channel|frequency][/capture]
[options]
.
.br
.B mplayer
pvr://
[options]
.
.br
.B mplayer
dvb://[card_number@]channel
[options]
.
.br
.B mplayer
mf://filemask
[\-mf options] [options]
.
.br
.B mplayer
[cdda|cddb]://track[-endtrack][:speed][/device]
[options]
.
.br
.B mplayer
cue://file[:track]
[options]
.
.br
.B mplayer
[file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv]://
[user:pass@]URL[:port] [options]
.
.br
.B mplayer
sdp://file
[options]
.
.br
.B mplayer
mpst://host[:port]/URL
[options]
.
.br
.B mplayer
tivo://host/[list|llist|fsid]
[options]
.
.br
.B gmplayer
[options]
[\-skin\ skin]
.
.br
.B mencoder
[options] file
[file|URL|\-] [\-o file]
.
.br
.B mencoder
[options] file1
[specific options] [file2] [specific options]
.ad
.hy
.
.\" --------------------------------------------------------------------------
.\" Description
.\" --------------------------------------------------------------------------
.
.SH DESCRIPTION
.B mplayer
is a movie player for Linux (runs on many other platforms and CPU
architectures, see the documentation).
It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
native and binary codecs.
You can watch Video CD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV movies,
too.
.PP
MPlayer supports a wide range of video and audio output drivers.
It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and 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, Hauppauge PVR (IVTV), DXR2 and DXR3/\:Hollywood+.
Most of them support software or hardware scaling, so you can enjoy movies in
fullscreen mode.
.PP
MPlayer has an onscreen display (OSD) for status information, nice big
antialiased shaded subtitles and visual feedback for keyboard controls.
European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
DVD subtitles (SPU streams, VOBsub and Closed Captions).
.PP
.B mencoder
(MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
MPlayer-playable movies (see above) to other MPlayer-playable formats (see
below).
It encodes to MPEG-4 (DivX/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 filter system (crop,
expand, flip, postprocess, rotate, scale, noise, RGB/\:YUV conversion) and
more.
.PP
.B gmplayer
is MPlayer with a graphical user interface.
It has the same options as MPlayer.
.PP
Usage examples to get you started quickly can be found at the end
of this man page.
.PP
.B Also see the HTML documentation!
.
.
.\" --------------------------------------------------------------------------
.\" interactive control
.\" --------------------------------------------------------------------------
.
.SH "INTERACTIVE CONTROL"
MPlayer has a fully configurable, command-driven control layer
which allows you to control MPlayer using keyboard, mouse, joystick
or remote control (with LIRC).
See the \-input option for ways to customize it.
.
.TP
.B keyboard control
.PD 0
.RS
.IPs "<\- and \->"
Seek backward/\:forward 10 seconds.
.IPs "up and down"
Seek forward/\:backward 1 minute.
.IPs "pgup and pgdown"
Seek forward/\:backward 10 minutes.
.IPs "[ and ]"
Decrease/increase current playback speed by 10%.
.IPs "{ and }"
Halve/double current playback speed.
.IPs "backspace"
Reset playback speed to normal.
.IPs "< and >"
Go backward/\:forward in the playlist.
.IPs "ENTER"
Go forward in the playlist, even over the end.
.IPs "HOME and END"
next/\:previous playtree entry in the parent list
.IPs "INS and DEL (ASX playlist only)"
next/\:previous alternative source.
.IPs "p / SPACE"
Pause (pressing again unpauses).
.IPs ".\ \ \ \ "
Step forward.
Pressing once will pause movie, every consecutive press will play one frame
and then go into pause mode again (any other key unpauses).
.IPs "q / ESC"
Stop playing and quit.
.IPs "+ and -"
Adjust audio delay by +/- 0.1 seconds.
.IPs "/ and *"
Decrease/\:increase volume.
.IPs "9 and 0"
Decrease/\:increase volume.
.IPs "m\ \ \ \ "
Mute sound.
.IPs "# (MPEG and Matroska only)"
Cycle through the available audio tracks.
.IPs "f\ \ \ \ "
Toggle fullscreen (also see \-fs).
.IPs "T\ \ \ \ "
Toggle stay-on-top (also see \-ontop).
.IPs "w and e"
Decrease/\:increase pan-and-scan range.
.IPs "o\ \ \ \ "
Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
.IPs "d\ \ \ \ "
Toggle frame dropping states: none / skip display / skip decoding
(see \-framedrop and \-hardframedrop).
.IPs "v\ \ \ \ "
Toggle subtitle visibility.
.IPs "b / j"
Cycle through the available subtitles.
.IPs "y and g"
Step forward/backward in the subtitle list.
.IPs "F\ \ \ \ "
Toggle displaying "forced subtitles".
.IPs "a\ \ \ \ "
Toggle subtitle alignment: top / middle / bottom.
.IPs "x and z"
Adjust subtitle delay by +/- 0.1 seconds.
.IPs "r and t"
Move subtitles up/down.
.IPs "i (\-edlout mode only)"
Set start or end of an EDL skip and write it out to the given file.
.IPs "s (\-vf screenshot only)"
Take a screenshot.
.IPs "S (\-vf screenshot only)"
Start/stop taking screenshots.
.IPs "I\ \ \ \ "
Show filename on the OSD.
.IPs "! and @"
Seek to the beginning of the previous/next chapter.
.RE
.PD 1
.PP
.RS
(The following keys are valid only when using a hardware accelerated video
output (xv, (x)vidix, (x)mga, etc), the software equalizer
(\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
.RE
.PP
.PD 0
.RS
.IPs "1 and 2"
Adjust contrast.
.IPs "3 and 4"
Adjust brightness.
.IPs "5 and 6"
Adjust hue.
.IPs "7 and 8"
Adjust saturation.
.RE
.PD 1
.PP
.RS
(The following keys are valid only when using the quartz or macosx
video output driver.)
.RE
.PP
.PD 0
.RS
.IPs "command + 0"
Resize movie window to half its original size.
.IPs "command + 1"
Resize movie window to its original size.
.IPs "command + 2"
Resize movie window to double its original size.
.IPs "command + f"
Toggle fullscreen (also see \-fs).
.IPs "command + [ and command + ]"
Set movie window alpha.
.RE
.PD 1
.PP
.RS
(The following keys are valid only when using the sdl
video output driver.)
.RE
.PP
.PD 0
.RS
.IPs "c\ \ \ \ "
Cycle through available fullscreen modes.
.IPs "n\ \ \ \ "
Restore original mode.
.RE
.PD 1
.PP
.RS
(The following keys are valid if you have a keyboard
with multimedia keys.)
.RE
.PP
.PD 0
.RS
.IPs PAUSE
Pause.
.IPs "STOP\ "
Stop playing and quit.
.IPs "PREVIOUS and NEXT"
Seek backward/\:forward 1 minute.
.RE
.PD 1
.PP
.RS
(The following keys are only valid if GUI support is compiled in
and will take precedence over the keys defined above.)
.RE
.PP
.PD 0
.RS
.IPs ENTER
Start playing.
.IPs "ESC\ \ "
Stop playing.
.IPs "l\ \ \ \ "
Load file.
.IPs "t\ \ \ \ "
Load subtitle.
.IPs "c\ \ \ \ "
Open skin browser.
.IPs "p\ \ \ \ "
Open playlist.
.IPs "r\ \ \ \ "
Open preferences.
.RE
.PD 1
.PP
.RS
(The following keys are only valid if you compiled with TV or DVB input
support and will take precedence over the keys defined above.)
.RE
.PP
.PD 0
.RS
.IPs "h and k"
Select previous/\:next channel.
.IPs "n\ \ \ \ "
Change norm.
.IPs "u\ \ \ \ "
Change channel list.
.RE
.PD 1
.PP
.RS
(The following keys are only valid if you compiled with dvdnav
support: they are used to navigate the menus)
.RE
.PP
.PD 0
.RS
.IPs "keypad 8"
Select button up.
.IPs "keypad 2"
Select button down.
.IPs "keypad 4"
Select button left.
.IPs "keypad 6"
Select button right.
.IPs "keypad 5"
Return to main menu.
.IPs "keypad 7"
Return to nearest menu (the order of preference is: chapter->title->root).
.IPs "keypad ENTER"
Confirm choice.
.RE
.PD 1
.PP
.RS
.
.TP
.B mouse control
.PD 0
.RS
.IPs "button 3 and button 4"
Seek backward/\:forward 1 minute.
.IPs "button 5 and button 6"
Decrease/\:increase volume.
.RE
.PD 1
.
.TP
.B joystick control
.PD 0
.RS
.IPs "left and right"
Seek backward/\:forward 10 seconds.
.IPs "up and down"
Seek forward/\:backward 1 minute.
.IPs "button 1"
Pause.
.IPs "button 2"
Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
.IPs "button 3 and button 4"
Decrease/\:increase volume.
.RE
.PD 1
.
.
.\" --------------------------------------------------------------------------
.\" Usage
.\" --------------------------------------------------------------------------
.
.SH "USAGE"
Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
\-fs option is \-nofs.
.PP
If an option is marked as (XXX only), it will only work in combination with
the XXX option or if XXX is compiled in.
.PP
.I NOTE:
The suboption parser (used for example for \-ao pcm suboptions) supports
a special kind of string-escaping intended for use with external GUIs.
.br
It has the following format:
.br
%n%string_of_length_n
.br
.I EXAMPLES:
.br
mplayer \-ao pcm:file=%10%C:test.wav test.avi
.br
Or in a script:
.br
mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
.PP
.
.\" --------------------------------------------------------------------------
.\" Configuration files
.\" --------------------------------------------------------------------------
.
.SH "CONFIGURATION FILES"