DEMUXER/STREAM OPTIONS †
-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 con- tains the required range compression information.
-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.
-alang <language code[,language code,...]> (also see -aid) †
Specify a priority list of audio languages to use. Different container formats employ different lan- guage codes. DVDs use ISO 639-1 two letter lan- guage 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.
EXAMPLE:
mplayer dvd://1 -alang hu,en
Chooses the Hungarian language track on a DVD and falls back on English if Hungarian is not available.
mplayer -alang jpn exam- ple.mkv
Plays a Matroska file in Japanese.
-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 -au- dio-demuxer help. For backward compatibility it also accepts the demuxer ID as defined in libmpde- mux/demuxer.h. -audio-demuxer audio or -audio-de- muxer 17 forces MP3.
-audiofile <filename> †
Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a movie.
-audiofile-cache <kBytes> †
Enables caching for the stream used by -audiofile, using the specified amount of memory.
-bandwidth <value> (network only) †
Specify the maximum bandwidth for network streaming (for servers that are able to send content in dif- ferent bitrates). Useful if you want to watch live streamed media behind a slow connection.
-cache <kBytes> †
This option specifies how much memory (in kBytes) to use when precaching a file or URL. Especially useful on slow media.
-cache-min <percentage> †
Playback will start when the cache has been filled up to <percentage> of the total.
-cache-seek-min <percentage> (not yet implement- ed) †
If a seek is to be made to a position within <per- centage> of the cache size from the current posi- tion, MPlayer will wait for the cache to be filled to this position rather than performing a stream seek (default: 50).
-cdda <option1:option2> (CDDA only) †
This option can be used to tune the CD Audio read- ing feature of MPlayer.
Available options are:
speed=<value>
Set CD spin speed.
paranoia=<0-2>
Set paranoia level.
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>
Set atomic read size.
overlap=<value>
Force minimum overlap search during verifi- cation 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 reconstruc- tion.
-cdrom-device <path to device> †
Specify the CD-ROM device (default: /dev/cdrom).
-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 au- dio into the requested number of channels. To di- rectly control the number of output channels inde- pendently of how many channels are decoded, use the channels filter.
NOTE: This option is honored by codecs (AC3 only), filters (surround) and audio output drivers (OSS at least).
Available options are:
2
stereo
4
surround
6
full 5.1
-chapter <chapter ID>[-<end chapter ID>] (DVD on- ly) †
Specify which chapter to start playing at. Option- ally specify which chapter to end playing at (de- fault: 1).
-cookies (network only) †
Send cookies when making HTTP requests.
-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.
-delay <sec> †
audio delay in seconds (positive or negative float value)
NOTE: When used with MEncoder, this is not guaran- teed to work correctly with -ovc copy.
-demuxer <[+]name> †
Force demuxer type. Use a '+' before the name to force it, this will skip some checks! Give the de- muxer name as printed by -demuxer help. For back- ward compatibility it also accepts the demuxer ID as defined in libmpdemux/demuxer.h. -demuxer audio or -demuxer 17 forces MP3.
-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 com- mand line only the last one will work.
-dumpfile <filename> (MPlayer only) †
Specify which file MPlayer should dump to. Should be used together with -dumpaudio / -dumpvideo / -dumpstream.
-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.
-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.
-dvbin <options> (DVB only) †
Pass the following parameters to the DVB input mod- ule, in order to override the default ones:
card=<1-4>
Specifies using card number 1-4 (default: 1).
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.
-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).
-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).
-edl <filename> (EDL only) †
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 DOCS/HTML/en/edl.html for details on how to use this.
-forceidx †
Force index rebuilding. Useful for files with bro- ken 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).
NOTE: This option only works if the underlying me- dia supports seeking (i.e. not with stdin, pipe, etc).
-fps <float value> †
Override video framerate. Useful if the original value is wrong or missing.
-frames <number> †
Play/convert only first <number> frames, then quit.
-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 espe- cially when seeking backwards since it has to rewind to the beginning to find an exact frame po- sition.
-idx (also see -forceidx) †
Rebuilds index of files if no index was found, al- lowing seeking. Useful with broken/incomplete downloads, or badly created files.
NOTE: This option only works if the underlying me- dia supports seeking (i.e. not with stdin, pipe, etc).
-ipv4-only-proxy (network only) †
Skip the proxy for IPv6 addresses. It will still be used for IPv4 connections.
-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.
NOTE: This option is obsolete now that MPlayer has OpenDML support.
-mc <seconds/frame> †
maximum A-V sync correction per frame (in seconds)
-mf <option1:option2:...> †
Used when decoding from multiple PNG or JPEG files.
Available options are:
w=<value>
output width (default: autodetect)
h=<value>
output height (default: autodetect)
fps=<value>
output fps (default: 25)
type=<value>
input file type (available: jpeg, png, tga, sgi)
-ni (AVI only) †
Force usage of non-interleaved AVI parser (fixes playback of some bad AVI files).
-nobps (AVI only) †
Do not use average byte/second value for A-V sync. Helps with some AVI files with broken header.
-noextbased †
Disables extension-based demuxer selection. By de- fault, when the file type (demuxer) cannot be de- tected 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.
-passwd <password> (also see -user) (network on- ly) †
Specify password for HTTP authentication.
-prefer-ipv4 (network only) †
Use IPv4 on network connections. Falls back on IPv6 automatically.
-prefer-ipv6 (IPv6 network only) †
Use IPv6 on network connections. Falls back on IPv4 automatically.
-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.
Available options are:
channels=<value>
number of channels
rate=<value>
rate in samples per second
samplesize=<value>
sample size in bytes
bitrate=<value>
bitrate for rawaudio files
format=<value>
fourcc in hex
-rawvideo <option1:option2:...> †
This option lets you play raw video files. You have to use -demuxer rawvideo as well.
Available options are:
fps=<value>
rate in frames per second (default: 25.0)
sqcif|qcif|cif|4cif|pal|ntsc
set standard image size
w=<value>
image width in pixels
h=<value>
image height in pixels
i420|yv12|yuy2|y8
set colorspace
format=<value>
colorspace (fourcc) in hex
size=<value>
frame size in Bytes
-rtsp-stream-over-tcp (LIVE.COM only) †
Used with 'rtsp://' URLs to specify that the re- sulting 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 in- ternet connection that does not pass incoming UDP packets (see http://www.live.com/mplayer/).
-saveidx <filename> †
Force index rebuilding and dump the index to <file- name>. Currently this only works with AVI files.
NOTE: This option is obsolete now that MPlayer has OpenDML support.
-sb <byte position> (also see -ss) †
Seek to byte position. Useful for playback from CD-ROM images or VOB files with junk at the begin- ning.
-speed <0.01-100> †
Slow down or speed up playback by the factor given as parameter. Not guaranteed to work correctly with -oac copy.
-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 au- dio 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 op- tion. The default is fast resampling that may cause distortion.
-ss <time> (also see -sb) †
Seek to given time position.
EXAMPLE:
-ss 56
Seeks to 56 seconds.
-ss 01:10:00
Seeks to 1 hour 10 min.
-tskeepbroken †
Tells MPlayer not to discard TS packets reported as broken in the stream. Sometimes needed to play corrupted MPEG-TS files.
-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.
-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.
-tv <option1:option2:...> (TV only) †
This option tunes various properties of the TV cap- ture module. For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>' or even 'tv://<channel_name> (see option channels for chan- nel_name below) as a movie URL.
Available options are:
noaudio
no sound
driver=<value>
available: dummy, v4l, v4l2, bsdbt848
device=<value>
Specify TV device (default: /dev/video0).
input=<value>
Specify input (default: 0 (TV), see console output for available inputs).
freq=<value>
Specify the frequency to set the tuner to (e.g. 511.250). Not compatible with the channels parameter.
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.
width=<value>
output window width
height=<value>
output window height
fps=<value>
framerate at which to capture video (frames per second)
buffersize=<value>
maximum size of the capture buffer in megabytes (default: dynamical)
norm=<value>
For bsdbt848 and v4l, PAL, SECAM, NTSC are available. For v4l2, see the console out- put for a list of all available norms, also see the normid option below.
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 avail- able TV norms.
channel=<value>
Set tuner to <value> channel.
chanlist=<value>
available: europe-east, europe-west, us-bcast, us-cable, etc
channels=<chan- nel>-<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_chan- nel, tv_set_channel and tv_last_channel will be usable for a remote control (see LIRC). Not compatible with the frequency parameter.
NOTE: The channel number will then be the position in the 'channels' list, beginning with 1.
EXAMPLE: tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
[brightness|con- trast|hue|saturation]=<-100-100>
Set the image equalizer on the card.
audiorate=<value>
Set audio capture bitrate.
forceaudio
Capture audio even if there are no audio sources reported by v4l.
alsa
Capture from ALSA.
amode=<0-3>
Choose an audio mode:
0: mono
1: stereo
2: language 1
3: language 2
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.
adevice=<value>
Set an audio device. <value> should be /dev/xxx for OSS and a hardware ID for AL- SA. You must replace any ':' by a '.' in the hardware ID for ALSA.
audioid=<value>
Choose an audio output of the capture card, if it has more than one.
[volume|bass|treble|bal- ance]=<0-65535> (v4l1)
[volume|bass|treble|bal- ance]=<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.
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.
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 decima- tion value (see below).
decimation=<1|2|4>
choose the size of the picture that will be compressed by hardware MJPEG compression:
1: full size 704x576 PAL 704x480 NTSC
2: medium size 352x288 PAL 352x240 NTSC
4: small size 176x144 PAL 176x120 NTSC
quality=<0-100>
Choose the quality of the JPEG compression (< 60 recommended for full size).
-user <username> (also see -passwd) (network on- ly) †
Specify username for HTTP authentication.
-user-agent <string> †
Use <string> as user agent for HTTP streaming.
-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.
-vivo <sub-options> (DEBUG CODE) †
Force audio parameters for the VIVO demuxer (for debugging purposes).
