.\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users>
.\" This man page was/is done by Gabucino <sendmail@to.mplayer-users>
.\" (Patches done by Jonas Jermann <sendmail@to.mplayer-users>)
.\"
.TH "MPlayer" "1" "2002-06-24"
.SH "NAME"
mplayer \- Movie Player for Linux
.br
mencoder \- Movie Encoder for Linux
.SH "SYNOPSIS"
.B mplayer
.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]
.br
.B mplayer
.RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options]
.br
.B mplayer
.RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options]
.br
.B mplayer
.RB [dvd|vcd|cdda|cddb|tv]://[title]\ [options]
.br
.B mplayer
.RB [mms|mmst|http|http_proxy|rtp]://[user:pass@]URL[:port]\ [options]
.br
.B mencoder
.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \-\ ]\ [\-o\ file]
.br
.B gmplayer
.RB [options]\ [\-skin\ skin]
.SH "DESCRIPTION"
.B 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, OGG, VIVO, ASF/WMV, QT/MOV,
FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and
Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV
movies, too (without the avifile library).
Another great feature of mplayer is the wide range of supported output drivers.
It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use
GGI, SDL (and this way all their drivers), VESA (on every VESA compatible card, even
without X11!) and some low level card-specific drivers (for Matrox, 3Dfx and Radeon), too!
.br
Most of them support software or hardware scaling, so you can enjoy movies in fullscreen.
MPlayer supports displaying through some hardware MPEG decoder boards, such as the Siemens
DVB, DXR2 and DXR3/Hollywood+!
MPlayer has an onscreen display (OSD) for status information, 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 (VobSub, MicroDVD, SubRip,
SubViewer, Sami, VPlayer, RT, SSA, AQTitle and our own: MPsub).
.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 DivX4 (1, 2 or 3 passes), XviD, codecs of libavcodec,
PCM/MP3/VBRMP3 audio. It also has stream copying abilities, a powerful plugin system
(crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more.
.B gmplayer
is MPlayer with a graphical user interface.
It has the same options as MPlayer.
.SH GENERAL NOTES
Every "flag" option has a "noflag" counterpart, e.g. the opposite of the \-fs
option is \-nofs.
.br
.B Check the HTML documentation, too!
.SH "DEMUXER/STREAM OPTIONS"
.TP
.B \-aid <id> (also see \-alang option)
Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...]
.TP
.B \-alang <two letter\ country\ code> (also see \-aid option)
Works only for DVD playback! Selects DVD audio language. It always tries
to play audio streams whose language matches the given code.
.I EXAMPLE:
\-alang hu,en Plays Hungarian and falls back to
English if Hungarian is not
available.
.TP
.B \-audio\-demuxer <number> (\-audiofile only)
Force audio demuxer type for \-audiofile.
Give the demuxer ID as defined in demuxers.h.
Use \-audio\-demuxer 17 to force .mp3 detection.
.TP
.B \-audiofile <filename>
Play audio from an external file (WAV, MP3 or Ogg Vorbis).
.TP
.B \-cdrom\-device <path\ to\ device>
Override default CDROM drive name /dev/cdrom.
.TP
.B \-cache <kbytes>
This option specifies how much memory (in kbytes) to use when precaching a file/URL.
Especially useful on slow media (default is \-nocache).
.TP
.B \-cdda <option1:option2>
This option can be used to tune the CD Audio reading feature of MPlayer.
Available options are:
speed=<value> set CD spin speed
paranoia=<value> set paranoia level (0-2)
0: disable checking
1: overlap checking only
(default)
2: full data correction
and verification
generic-dev=<value> use specified generic SCSI
device
sector-size=<value> atomic read size
overlap=<value> force minimum overlap
search during verification
to <value> sectors.
toc-bias Assume that the beginning
offset of track 1 as
reported in the TOC will be
addressed as LBA 0. Some
Toshiba drives need this
for getting track
boundaries correct.
toc-offset=<value> Add <value> sectors to the
values reported when
addressing tracks. May be
negative.
(no)skip (never) accept imperfect
data reconstruction.
.TP
.B \-chapter <chapter\ id>[-<end\ chapter\ id>]
Specify which chapter to start playing at. Optionally specify which chapter to
end playing at. Examples can be found below.
.TP
.B \-csslib <filename>
(old-style DVD option) This option is used to override the default location of libcss.so.
.TP
.B \-demuxer <number>
Force demuxer type. Give the demuxer I
|