mplayer.1

Mplayer源码

.br
vcd:   Video CD compatible stream
.br
svcd:  Super Video CD compatible stream
.br
dvd:   DVD compatible stream
.REss
.RE
.PD 1
.
.TP
.B \-rawaudio <option1:option2:...>
This option lets you play raw audio files.
You have to use \-demuxer rawaudio as well.
It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
For playing raw AC3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs channels=<value>
number of channels
.IPs rate=<value>
rate in samples per second
.IPs samplesize=<value>
sample size in bytes
.IPs bitrate=<value>
bitrate for rawaudio files
.IPs format=<value>
fourcc in hex
.RE
.PD 1
.
.TP
.B \-rawvideo <option1:option2:...>
This option lets you play raw video files.
You have to use \-demuxer rawvideo as well.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs fps=<value>
rate in frames per second (default: 25.0)
.IPs sqcif|qcif|cif|4cif|pal|ntsc
set standard image size
.IPs w=<value>
image width in pixels
.IPs h=<value>
image height in pixels
.IPs i420|yv12|yuy2|y8
set colorspace
.IPs format=<value>
colorspace (fourcc) in hex
.IPs size=<value>
frame size in Bytes
.REss
.sp 1
.RS
.I EXAMPLE:
.RE
.PD 0
.RSs
.IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
Play the famous "foreman" sample video.
.IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
Play a raw YUV sample.
.RE
.PD 1
.
.TP
.B \-rtsp-port
Used with 'rtsp://' URLs to force the client's port number.
This option may be useful if you are behind a router and want to forward
the RTSP stream from the server to a specific client.
.
.TP
.B \-rtsp-destination
Used with 'rtsp://' URLs to force the destination IP address to be bound.
This option may be useful with some RTSP server which do not
send RTP packets to the right interface.
If the connection to the RTSP server fails, use \-v to see
which IP address MPlayer tries to bind to and try to force
it to one assigned to your computer instead.
.
.TP
.B \-rtsp-stream-over-tcp (LIVE555 only)
Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
packets be streamed over TCP (using the same TCP connection as RTSP).
This option may be useful if you have a broken internet connection that does
not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
.
.TP
.B \-saveidx <filename>
Force index rebuilding and dump the index to <filename>.
Currently this only works with AVI files.
.br
.I NOTE:
This option is obsolete now that MPlayer has OpenDML support.
.
.TP
.B \-sb <byte position> (also see \-ss)
Seek to byte position.
Useful for playback from CD-ROM images or VOB files with junk at the beginning.
.
.TP
.B \-speed <0.01\-100>
Slow down or speed up playback by the factor given as parameter.
Not guaranteed to work correctly with \-oac copy.
.
.TP
.B \-srate <Hz>
Selects the output sample rate to be used
(of course sound cards have limits on this).
If the sample frequency selected is different from that
of the current media, the resample or lavcresample audio filter will be inserted
into the audio filter layer to compensate for the difference.
The type of resampling can be controlled by the \-af-adv option.
The default is fast resampling that may cause distortion.
.
.TP
.B \-ss <time> (also see \-sb)
Seek to given time position.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ss 56"
Seeks to 56 seconds.
.IPs "\-ss 01:10:00"
Seeks to 1 hour 10 min.
.RE
.PD 1
.
.TP
.B \-tskeepbroken
Tells MPlayer not to discard TS packets reported as broken in the stream.
Sometimes needed to play corrupted MPEG-TS files.
.
.TP
.B \-tsprobe <byte position>
When playing an MPEG-TS stream, this option lets you specify how many
bytes in the stream you want MPlayer to search for the desired
audio and video IDs.
.
.TP
.B \-tsprog <1\-65534>
When playing an MPEG-TS stream, you can specify with this option which
program (if present) you want to play.
Can be used with \-vid and \-aid.
.
.TP
.B \-radio <option1:option2:...> (radio only)
These options set various parameters of the radio capture module.
For listening to radio with MPlayer use 'radio://<frequency>'
(if channels option is not given) or 'radio://<channel_number>'
(if channels option is given) as a movie URL.
To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
If the capture keyword is not given you can listen to radio
using the line-in cable only.
Using capture to listen is not recommended due to synchronization
problems, which makes this process uncomfortable.
.sp 1
Available options are:
.RSs
.IPs device=<value>
Radio device to use (default: /dev/radio0).
.IPs driver=<value>
Radio driver to use (default: v4l2 if available, otherwise v4l).
Currently, v4l and v4l2 drivers are supported.
.IPs volume=<0..100>
sound volume for radio device (default 100)
.IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
Set channel list.
Use _ for spaces in names (or play with quoting ;-).
The channel names will then be written using OSD and the slave commands
radio_step_channel and radio_set_channel will be usable for
a remote control (see LIRC).
If given, number in movie URL will be treated as channel position in
channel list.
.br
.I EXAMPLE:
radio://1, radio://104.4, radio_set_channel 1
.IPs adevice=<value> (with radio capture enabled)
Name of device to capture sound from.
Without such a name capture will be disabled,
even if the capture keyword appears in the URL.
For ALSA devices use it in the form hw=<card>.<device>.
If the device name contains a '=', the module will use
ALSA to capture, otherwise OSS.
.IPs arate=<value> (with radio capture enabled)
Rate in samples per second (default: 44100).
.br
.I NOTE:
When using audio capture set also \-rawaudio rate=<value> option
with the same value as arate.
If you have problems with sound speed (runs too quickly), try to play
with different rate values (e.g.\& 48000,44100,32000,...).
.IPs achannels=<value> (with radio capture enabled)
Number of audio channels to capture.
.RE
.
.TP
.B \-tv <option1:option2:...> (TV/\:PVR only)
This option tunes various properties of the TV capture module.
For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
or even 'tv://<channel_name> (see option channels for channel_name below)
as a movie URL.
.sp 1
Available options are:
.RSs
.IPs noaudio
no sound
.IPs driver=<value>
available: dummy, v4l, v4l2, bsdbt848
.IPs device=<value>
Specify TV device (default: /dev/\:video0).
.IPs input=<value>
Specify input (default: 0 (TV), see console output for available inputs).
.IPs freq=<value>
Specify the frequency to set the tuner to (e.g.\& 511.250).
Not compatible with the channels parameter.
.IPs outfmt=<value>
Specify the output format of the tuner with a preset value supported by the
V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
arbitrary format given as hex value.
Try outfmt=help for a list of all available formats.
.IPs width=<value>
output window width
.IPs height=<value>
output window height
.IPs fps=<value>
framerate at which to capture video (frames per second)
.IPs buffersize=<value>
maximum size of the capture buffer in megabytes (default: dynamical)
.IPs norm=<value>
For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
For v4l2, see the console output for a list of all available norms,
also see the normid option below.
.IPs "normid=<value> (v4l2 only)"
Sets the TV norm to the given numeric ID.
The TV norm depends on the capture card.
See the console output for a list of available TV norms.
.IPs channel=<value>
Set tuner to <value> channel.
.IPs chanlist=<value>
available: europe-east, europe-west, us-bcast, us-cable, etc
.IPs channels=<channel>\-<name>,<channel>\-<name>,...
Set names for channels.
Use _ for spaces in names (or play with quoting ;-).
The channel names will then be written using OSD, and the slave commands
tv_step_channel, tv_set_channel and tv_last_channel will be usable for
a remote control (see LIRC).
Not compatible with the frequency parameter.
.br
.I NOTE:
The channel number will then be the position in the 'channels' list,
beginning with 1.
.br
.I EXAMPLE:
tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
.IPs [brightness|contrast|hue|saturation]=<-100\-100>
Set the image equalizer on the card.
.IPs audiorate=<value>
Set audio capture bitrate.
.IPs forceaudio
Capture audio even if there are no audio sources reported by v4l.
.IPs "alsa\ "
Capture from ALSA.
.IPs amode=<0\-3>
Choose an audio mode:
.RSss
0: mono
.br
1: stereo
.br
2: language 1
.br
3: language 2
.REss
.IPs forcechan=<1\-2>
By default, the count of recorded audio channels is determined automatically
by querying the audio mode from the TV card.
This option allows forcing stereo/\:mono recording regardless of the amode
option and the values returned by v4l.
This can be used for troubleshooting when the TV card is unable to report the
current audio mode.
.IPs adevice=<value>
Set an audio device.
<value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
You must replace any ':' by a '.' in the hardware ID for ALSA.
.IPs audioid=<value>
Choose an audio output of the capture card, if it has more than one.
.IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
.IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
These options set parameters of the mixer on the video capture card.
They will have no effect, if your card does not have one.
For v4l2 50 maps to the default value of the
control, as reported by the driver.
.IPs immediatemode=<bool>
A value of 0 means capture and buffer audio and video together
(default for MEncoder).
A value of 1 (default for MPlayer) means to do video capture only and let the
audio go through a loopback cable from the TV card to the sound card.
.IPs mjpeg
Use hardware MJPEG compression (if the card supports it).
When using this option, you do not need to specify the width and height
of the output window, because MPlayer will determine it automatically
from the decimation value (see below).
.IPs decimation=<1|2|4>
choose the size of the picture that will be compressed by hardware
MJPEG compression:
.RSss
1: full size
    704x576    PAL
    704x480    NTSC
.br
2: medium size
    352x288    PAL
    352x240    NTSC
.br
4: small size
    176x144    PAL
    176x120    NTSC
.REss
.IPs quality=<0\-100>
Choose the quality of the JPEG compression
(< 60 recommended for full size).
.RE
.
.TP
.B \-user <username> (also see \-passwd) (network only)
Specify username for HTTP authentication.
.
.TP
.B \-user-agent <string>
Use <string> as user agent for HTTP streaming.
.
.TP
.B \-vid <ID>
Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
(if present) with the chosen video stream.
.
.TP
.B \-vivo <sub-options> (DEBUG CODE)
Force audio parameters for the VIVO demuxer (for debugging purposes).
.
.
.
.SH "OSD/SUBTITLE OPTIONS"
.I NOTE:
Also see \-vf expand.
.
.TP
.B \-ass (FreeType only)
Turn on SSA/ASS subtitle rendering.
With this option, libass will be used for SSA/ASS
external subtitles and Matroska tracks.
You may also want to use \-embeddedfonts.
.
.TP
.B \-ass-border-color <value>
Sets the border (outline) color for text subtitles.
The color format is RRGGBBAA.
.
.TP
.B \-ass-bottom-margin <value>
Adds a black band at the bottom of the frame.
The SSA/ASS renderer can place subtitles there (with \-ass-use-margins).
.
.TP
.B \-ass-color <value>
Sets the color for text subtitles.
The color format is RRGGBBAA.
.
.TP
.B \-ass-font-scale <value>
Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
.
.TP
.B \-ass-force-style <[Style.]Param=Value[,...]>
Override some style parameters.
.sp
.I EXAMPLE:
.PD 0
.RSs
\-ass-force-style FontName=Arial,Default.Bold=1
.RE
.PD 1
.
.TP
.B \-ass-line-spacing <value>
Set line spacing value for SSA/ASS renderer.
.
.TP
.B \-ass-styles <filename>
Load all SSA/ASS styles found in the specified file and use them for
rendering text subtitles.
The syntax of the file is exactly like the
[V4 Styles] / [V4+ Styles] section of SSA/ASS.
.
.TP
.B \-ass-top-margin <value>
Adds a black band at the top of the frame.
The SSA/ASS renderer can place toptitles there (with \-ass-use-margins).
.
.TP
.B \-(no)ass-use-margins
Enables/disables placing toptitles and subtitles in black borders when they
are available (default: no).
.
.TP
.B \-dumpjacosub (MPlayer only)
Convert the given subtitle (specified with the \-sub option) to the time-based
JACOsub subtitle format.
Creates a dumpsub.js file in the current directory.
.
.TP
.B \-dumpmicrodvdsub (MPlayer only)
Convert the given subtitle (specified with the \-sub option) to the
MicroDVD subtitle format.
Creates a dumpsub.sub file in the current directory.
.
.TP
.B \-dumpmpsub (MPlayer only)
Convert the given subtitle (specified with the \-sub option) to MPlayer's
subtitle format, MPsub.
Creates a dump.mpsub file in the current directory.
.
.TP
.B \-dumpsami (MPlayer only)
Convert the given subtitle (specified with the \-sub option) to the time-based
SAMI subtitle format.
Creates a dumpsub.smi file in the current directory.
.
.TP
.B \-dumpsrtsub (MPlayer only)
Convert the given subtitle (specified with the \-sub option) to the time-based
SubViewer (SRT) subtitle format.
Creates a dumpsub.srt file in the current directory.
.br
.I NOTE:
Some broken hardware players choke on SRT subtitle files with Unix
line endings.
If you are unlucky enough to have such a box, pass your subtitle
files through unix2dos or a similar program to replace Unix line
endings with DOS/Windows line endings.
.
.TP
.B \-dumpsub (MPlayer only) (BETA CODE)
Dumps the subtitle substream from VOB streams.
Also see the \-dump*sub and \-vobsubout* options.
.
.TP
.B \-embeddedfonts (FreeType only)
Enables extraction of Matroska embedded fonts.
These fonts can be used for SSA/ASS subtitle
rendering (\-ass option).
.
.TP
.B \-ffactor <number> (OSD only)
Resample the font alphamap.
Can be:
.PD 0
.RSs
.IPs 0
plain white fonts
.IPs 0.75
very narrow black outline (default)
.IPs 1
narrow black outline
.IPs 10
bold black outline
.RE
.PD 1
.
.TP