mplayer.1

Mplayer源码

Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
and afterwards ~/.mplayer/\:skins/\:fittyfene.
.RE
.PD 1
.
.TP
.B \-slave (also see \-input)
Switches on slave mode, in which MPlayer works as a backend for other programs.
Instead of intercepting keyboard events, MPlayer will read commands separated
by a newline (\\n) from stdin.
.br
.I NOTE:
See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
for their description.
.
.TP
.B \-softsleep
Time frames by repeatedly checking the current time instead of asking the
kernel to wake up MPlayer at the correct time.
Useful if your kernel timing is imprecise and you cannot use the RTC either.
Comes at the price of higher CPU consumption.
.
.TP
.B \-sstep <sec>
Skip <sec> seconds after every frame.
The normal framerate of the movie is kept, so playback is accelerated.
Since MPlayer can only seek to the next keyframe this may be inexact.
.
.
.
.SH "DEMUXER/STREAM OPTIONS"
.
.TP
.B \-a52drc <level>
Select the Dynamic Range Compression level for AC3 audio streams.
<level> is a float value ranging from 0 to 1, where 0 means no compression
and 1 (which is the default) means full compression (make loud passages more
silent and vice versa).
This option only shows an effect if the AC3 stream contains the required range
compression information.
.
.TP
.B \-aid <ID> (also see \-alang)
Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
MPlayer prints the available audio IDs when run in verbose (\-v) mode.
When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
(if present) with the chosen audio stream.
.
.TP
.B \-alang <language code[,language code,...]> (also see \-aid)
Specify a priority list of audio languages to use.
Different container formats employ different language codes.
DVDs use ISO 639-1 two letter language codes, Matroska and NUT use ISO 639-2
three letter language codes while OGM uses a free-form identifier.
MPlayer prints the available languages when run in verbose (\-v) mode.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "mplayer dvd://1 \-alang hu,en"
Chooses the Hungarian language track on a DVD and falls back on English if
Hungarian is not available.
.IPs "mplayer \-alang jpn example.mkv"
Plays a Matroska file in Japanese.
.RE
.PD 1
.
.TP
.B \-audio-demuxer <[+]name> (\-audiofile only)
Force audio demuxer type for \-audiofile.
Use a '+' before the name to force it, this will skip some checks!
Give the demuxer name as printed by \-audio-demuxer help.
For backward compatibility it also accepts the demuxer ID as defined in
libmpdemux/\:demuxer.h.
\-audio-demuxer audio or \-audio-demuxer 17 forces MP3.
.
.TP
.B \-audiofile <filename>
Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
movie.
.
.TP
.B \-audiofile-cache <kBytes>
Enables caching for the stream used by \-audiofile, using the specified
amount of memory.
.
.TP
.B \-bandwidth <value> (network only)
Specify the maximum bandwidth for network streaming (for servers that are
able to send content in different bitrates).
Useful if you want to watch live streamed media behind a slow connection.
With Real RTSP streaming, it is also used to set the maximum delivery
bandwidth allowing faster cache filling and stream dumping.
.
.TP
.B \-cache <kBytes>
This option specifies how much memory (in kBytes) to use when precaching a
file or URL.
Especially useful on slow media.
.
.TP
.B \-nocache
Turns off caching.
.
.TP
.B \-cache-min <percentage>
Playback will start when the cache has been filled up to <percentage>
of the total.
.
.TP
.B \-cache-seek-min <percentage>
If a seek is to be made to a position within <percentage> of the cache size
from the current position, MPlayer will wait for the cache to be filled to
this position rather than performing a stream seek (default: 50).
.
.TP
.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
.sp 1
Available options are:
.RSs
.IPs speed=<value>
Set CD spin speed.
.IPs paranoia=<0\-2>
Set paranoia level.
Values other than 0 seem to break playback of anything but the first track.
.RSss
0: disable checking (default)
.br
1: overlap checking only
.br
2: full data correction and verification
.REss
.IPs generic-dev=<value>
Use specified generic SCSI device.
.IPs sector-size=<value>
Set atomic read size.
.IPs overlap=<value>
Force minimum overlap search during verification to <value> sectors.
.IPs 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.
.IPs toc-offset=<value>
Add <value> sectors to the values reported when addressing tracks.
May be negative.
.IPs (no)skip
(Never) accept imperfect data reconstruction.
.RE
.
.TP
.B \-cdrom-device <path to device>
Specify the CD-ROM device (default: /dev/\:cdrom).
.
.TP
.B \-channels <number> (also see \-af channels)
Request the number of playback channels (default: 2).
MPlayer asks the decoder to decode the audio into as many channels as
specified.
Then it is up to the decoder to fulfill the requirement.
This is usually only important when playing videos with AC3 audio (like DVDs).
In that case liba52 does the decoding by default and correctly downmixes the
audio into the requested number of channels.
To directly control the number of output channels independently of how many
channels are decoded, use the channels filter.
.br
.I NOTE:
This option is honored by codecs (AC3 only), filters (surround) and audio
output drivers (OSS at least).
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs 2
stereo
.IPs 4
surround
.IPs 6
full 5.1
.RE
.PD 1
.
.TP
.B \-chapter <chapter ID>[\-<endchapter ID>] (DVD only)
Specify which chapter to start playing at.
Optionally specify which chapter to end playing at (default: 1).
.
.TP
.B \-cookies (network only)
Send cookies when making HTTP requests.
.
.TP
.B \-cookies-file <filename> (network only)
Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
and skip reading from default locations.
The file is assumed to be in Netscape format.
.
.TP
.B \-delay <sec>
audio delay in seconds (positive or negative float value)
.br
.I NOTE:
When used with MEncoder, this is not guaranteed to work correctly
with \-ovc copy; use \-audio-delay instead.
.
.TP
.B \-ignore-start
Ignore the specified starting time for streams in AVI files.
In MPlayer, this nullifies stream delays in files encoded with
the \-audio-delay option.
During encoding, this option prevents MEncoder from transferring
original stream start times to the new file; the \-audio-delay option is
not affected.
Note that MEncoder sometimes adjusts stream starting times
automatically to compensate for anticipated decoding delays, so don't
use this option for encoding without testing it first.
.
.TP
.B \-demuxer <[+]name>
Force demuxer type.
Use a '+' before the name to force it, this will skip some checks!
Give the demuxer name as printed by \-demuxer help.
For backward compatibility it also accepts the demuxer ID as defined in
libmpdemux/\:demuxer.h.
\-demuxer audio or \-demuxer 17 forces MP3.
.
.TP
.B \-dumpaudio (MPlayer only)
Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3).
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.TP
.B \-dumpfile <filename> (MPlayer only)
Specify which file MPlayer should dump to.
Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
.
.TP
.B \-dumpstream (MPlayer only)
Dumps the raw stream to ./stream.dump.
Useful when ripping from DVD or network.
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.TP
.B \-dumpvideo (MPlayer only)
Dump raw compressed video stream to ./stream.dump (not very usable).
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.TP
.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
the default ones:
.sp 1
.PD 0
.RSs
.IPs card=<1\-4>
Specifies using card number 1\-4 (default: 1).
.IPs file=<filename>
Instructs MPlayer to read the channels list from <filename>.
Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
or ~/.mplayer/\:channels.conf as a last resort.
.IPs timeout=<1\-30>
Maximum number of seconds to wait when trying to tune a
frequency before giving up (default: 30).
.RE
.PD 1
.
.TP
.B \-dvd-device <path to device> (DVD only)
Specify the DVD device (default: /dev/\:dvd).
You can also specify a directory that contains files previously copied directly
from a DVD (with e.g.\& vobcopy).
Note that using \-dumpstream is usually a better way to
copy DVD titles in the first place (see the examples).
.
.TP
.B \-dvdangle <angle ID> (DVD only)
Some DVD discs contain scenes that can be viewed from multiple angles.
Here you can tell MPlayer which angles to use (default: 1).
.
.TP
.B \-edl <filename>
Enables edit decision list (EDL) actions during playback.
Video will be skipped over and audio will be muted and unmuted according to
the entries in the given file.
See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
on how to use this.
.
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
Stop at given time or byte position.
.br
.I NOTE:
Byte position is enabled only for MEncoder and will not be accurate, as it can
only stop at a frame boundary.
When used in conjunction with \-ss option, \-endpos time will shift forward by
seconds specified with \-ss.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-endpos 56"
Stop at 56 seconds.
.IPs "\-endpos 01:10:00"
Stop at 1 hour 10 minutes.
.IPs "\-ss 10 \-endpos 56"
Stop at 1 minute 6 seconds.
.IPs "\-endpos 100mb"
Encode only 100 MB.
.RE
.PD 1
.
.TP
.B \-forceidx
Force index rebuilding.
Useful for files with broken index (A/V desync, etc).
This will enable seeking in files where seeking was not possible.
You can fix the index permanently with MEncoder (see the documentation).
.br
.I NOTE:
This option only works if the underlying media supports seeking
(i.e.\& not with stdin, pipe, etc).
.
.TP
.B \-fps <float value>
Override video framerate.
Useful if the original value is wrong or missing.
.
.TP
.B \-frames <number>
Play/\:convert only first <number> frames, then quit.
.
.TP
.B \-hr-mp3-seek (MP3 only)
Hi-res MP3 seeking.
Enabled when playing from an external MP3 file, as we need to seek
to the very exact position to keep A/V sync.
Can be slow especially when seeking backwards since it has to rewind
to the beginning to find an exact frame position.
.
.TP
.B \-idx (also see \-forceidx)
Rebuilds index of files if no index was found, allowing seeking.
Useful with broken/\:incomplete downloads, or badly created files.
.br
.I NOTE:
This option only works if the underlying media supports seeking
(i.e.\& not with stdin, pipe, etc).
.
.TP
.B \-ipv4-only-proxy (network only)
Skip the proxy for IPv6 addresses.
It will still be used for IPv4 connections.
.
.TP
.B \-loadidx <index file>
The file from which to read the video index data saved by \-saveidx.
This index will be used for seeking, overriding any index data
contained in the AVI itself.
MPlayer will not prevent you from loading an index file generated
from a different AVI, but this is sure to cause unfavorable results.
.br
.I NOTE:
This option is obsolete now that MPlayer has OpenDML support.
.
.TP
.B \-mc <seconds/frame>
maximum A-V sync correction per frame (in seconds)
.
.TP
.B \-mf <option1:option2:...>
Used when decoding from multiple PNG or JPEG files.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs w=<value>
input file width (default: autodetect)
.IPs h=<value>
input file height (default: autodetect)
.IPs fps=<value>
output fps (default: 25)
.IPs type=<value>
input file type (available: jpeg, png, tga, sgi)
.RE
.PD 1
.
.TP
.B \-ni (AVI only)
Force usage of non-interleaved AVI parser (fixes playback
of some bad AVI files).
.
.TP
.B \-nobps (AVI only)
Do not use average byte/\:second value for A-V sync.
Helps with some AVI files with broken header.
.
.TP
.B \-noextbased
Disables extension-based demuxer selection.
By default, when the file type (demuxer) cannot be detected reliably
(the file has no header or it is not reliable enough), the filename
extension is used to select the demuxer.
Always falls back on content-based demuxer selection.
.
.TP
.B \-passwd <password> (also see \-user) (network only)
Specify password for HTTP authentication.
.
.TP
.B \-prefer-ipv4 (network only)
Use IPv4 on network connections.
Falls back on IPv6 automatically.
.
.TP
.B \-prefer-ipv6 (IPv6 network only)
Use IPv6 on network connections.
Falls back on IPv4 automatically.
.
.TP
.B \-pvr <option1:option2:...> (PVR only)
This option tunes various encoding properties of the PVR capture module.
It has to be used with any hardware MPEG encoder based card supported by the
V4L2 driver.
The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
cards are known as PVR capture cards.
Be aware that only Linux 2.6.18 kernel
and above is able to handle MPEG stream through V4L2 layer.
For hardware capture of an MPEG stream and watching it with
MPlayer/MEncoder, use 'pvr://' as a movie URL.
.sp 1
Available options are:
.RSs
.IPs aspect=<0\-3>
Specify input aspect ratio:
.RSss
0: 1:1
.br
1: 4:3 (default)
.br
2: 16:9
.br
3: 2.21:1
.REss
.IPs arate=<32000\-48000>
Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
and 48000 Hz).
.IPs alayer=<1\-3>
Specify MPEG audio layer encoding (default: 2).
.IPs abitrate=<32\-448>
Specify audio encoding bitrate in kbps (default: 384).
.IPs amode=<value>
Specify audio encoding mode.
Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
.IPs vbitrate=<value>
Specify average video bitrate encoding in Mbps (default: 6).
.IPs vmode=<value>
Specify video encoding mode:
.RSss
vbr: Variable BitRate (default)
.br
cbr: Constant BitRate
.REss
.IPs vpeak=<value>
Specify peak video bitrate encoding in Mbps
(only useful for VBR encoding, default: 9.6).
.IPs fmt=<value>
Choose an MPEG format for encoding:
.RSss
ps:    MPEG-2 Program Stream (default)
.br
ts:    MPEG-2 Transport Stream
.br
mpeg1: MPEG-1 System Stream