4d0257463426ad7dc7dd88d82d7558ec0265ff83
[mplayer.git] / DOCS / man / en / mplayer.1
1 .\" $Revision$
2 .\" MPlayer (C) 2000-2006 MPlayer Team
3 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
4 .
5 .\" --------------------------------------------------------------------------
6 .\" Macro definitions
7 .\" --------------------------------------------------------------------------
8 .
9 .\" define indentation for suboptions
10 .nr SS 5
11 .\" add new suboption
12 .de IPs
13 .IP "\\$1" \n(SS
14 ..
15 .\" begin of first level suboptions, end with .RE
16 .de RSs
17 .RS 10
18 ..
19 .\" begin of 2nd level suboptions
20 .de RSss
21 .PD 0
22 .RS \n(SS+3
23 ..
24 .\" end of 2nd level suboptions
25 .de REss
26 .RE
27 .PD 1
28 ..
29 .
30 .\" --------------------------------------------------------------------------
31 .\" Title
32 .\" --------------------------------------------------------------------------
33 .
34 .TH MPlayer 1 "2006-10-15" "The MPlayer Project" "The Movie Player"
35 .
36 .SH NAME
37 mplayer  \- movie player
38 .br
39 mencoder \- movie encoder
40 .
41 .\" --------------------------------------------------------------------------
42 .\" Synopsis
43 .\" --------------------------------------------------------------------------
44 .
45 .SH SYNOPSIS
46 .na
47 .nh
48 .B mplayer
49 [options] [file|URL|playlist|\-]
50 .
51 .br
52 .B mplayer
53 [options] file1
54 [specific options] [file2] [specific options]
55 .
56 .br
57 .B mplayer
58 [options]
59 {group of files and options}
60 [group-specific options]
61 .
62 .br
63 .B mplayer
64 [dvd|dvdnav]://[title|[start_title]\-end_title]
65 [options]
66 .
67 .br
68 .B mplayer
69 vcd://track[/device]
70 .
71 .br
72 .B mplayer
73 tv://[channel]
74 [options]
75 .
76 .br
77 .B mplayer
78 radio://[channel|frequency][/capture]
79 [options]
80 .
81 .br
82 .B mplayer
83 pvr://
84 [options]
85 .
86 .br
87 .B mplayer
88 dvb://[card_number@]channel
89 [options]
90 .
91 .br
92 .B mplayer
93 mf://filemask
94 [\-mf options] [options]
95 .
96 .br
97 .B mplayer
98 [cdda|cddb]://track[-endtrack][:speed][/device]
99 [options]
100 .
101 .br
102 .B mplayer
103 cue://file[:track]
104 [options]
105 .
106 .br
107 .B mplayer
108 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv]://
109 [user:pass@]URL[:port] [options]
110 .
111 .br
112 .B mplayer
113 sdp://file
114 [options]
115 .
116 .br
117 .B mplayer
118 mpst://host[:port]/URL
119 [options]
120 .
121 .br
122 .B mplayer
123 tivo://host/[list|llist|fsid]
124 [options]
125 .
126 .br
127 .B gmplayer
128 [options]
129 [\-skin\ skin]
130 .
131 .br
132 .B mencoder
133 [options] file
134 [file|URL|\-] [\-o file]
135 .
136 .br
137 .B mencoder
138 [options] file1
139 [specific options] [file2] [specific options]
140 .ad
141 .hy
142 .
143 .\" --------------------------------------------------------------------------
144 .\" Description
145 .\" --------------------------------------------------------------------------
146 .
147 .SH DESCRIPTION
148 .B mplayer
149 is a movie player for Linux (runs on many other platforms and CPU
150 architectures, see the documentation).
151 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
152 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
153 native and binary codecs.
154 You can watch Video CD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV movies,
155 too.
156 .PP
157 MPlayer supports a wide range of video and audio output drivers.
158 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
159 Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
160 VESA (on every VESA-compatible card, even without X11), some low-level
161 card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
162 boards, such as the Siemens DVB, Hauppauge PVR (IVTV), DXR2 and DXR3/\:Hollywood+.
163 Most of them support software or hardware scaling, so you can enjoy movies in
164 fullscreen mode.
165 .PP
166 MPlayer has an onscreen display (OSD) for status information, nice big
167 antialiased shaded subtitles and visual feedback for keyboard controls.
168 European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
169 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
170 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
171 DVD subtitles (SPU streams, VOBsub and Closed Captions).
172 .PP
173 .B mencoder
174 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
175 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
176 below).
177 It encodes to MPEG-4 (DivX/Xvid), one of the libavcodec codecs and
178 PCM/\:MP3/\:VBRMP3 audio in 1, 2 or 3 passes.
179 Furthermore it has stream copying abilities, a powerful filter system (crop,
180 expand, flip, postprocess, rotate, scale, noise, RGB/\:YUV conversion) and
181 more.
182 .PP
183 .B gmplayer
184 is MPlayer with a graphical user interface.
185 It has the same options as MPlayer.
186 .PP
187 Usage examples to get you started quickly can be found at the end
188 of this man page.
189 .PP
190 .B Also see the HTML documentation!
191 .
192 .
193 .\" --------------------------------------------------------------------------
194 .\" interactive control
195 .\" --------------------------------------------------------------------------
196 .
197 .SH "INTERACTIVE CONTROL"
198 MPlayer has a fully configurable, command-driven control layer
199 which allows you to control MPlayer using keyboard, mouse, joystick
200 or remote control (with LIRC).
201 See the \-input option for ways to customize it.
202 .
203 .TP
204 .B keyboard control
205 .PD 0
206 .RS
207 .IPs "<\- and \->"
208 Seek backward/\:forward 10 seconds.
209 .IPs "up and down"
210 Seek forward/\:backward 1 minute.
211 .IPs "pgup and pgdown"
212 Seek forward/\:backward 10 minutes.
213 .IPs "[ and ]"
214 Decrease/increase current playback speed by 10%.
215 .IPs "{ and }"
216 Halve/double current playback speed.
217 .IPs "backspace"
218 Reset playback speed to normal.
219 .IPs "< and >"
220 Go backward/\:forward in the playlist.
221 .IPs "ENTER"
222 Go forward in the playlist, even over the end.
223 .IPs "HOME and END"
224 next/\:previous playtree entry in the parent list
225 .IPs "INS and DEL (ASX playlist only)"
226 next/\:previous alternative source.
227 .IPs "p / SPACE"
228 Pause (pressing again unpauses).
229 .IPs ".\ \ \ \ "
230 Step forward.
231 Pressing once will pause movie, every consecutive press will play one frame
232 and then go into pause mode again (any other key unpauses).
233 .IPs "q / ESC"
234 Stop playing and quit.
235 .IPs "+ and -"
236 Adjust audio delay by +/- 0.1 seconds.
237 .IPs "/ and *"
238 Decrease/\:increase volume.
239 .IPs "9 and 0"
240 Decrease/\:increase volume.
241 .IPs "m\ \ \ \ "
242 Mute sound.
243 .IPs "# (MPEG and Matroska only)"
244 Cycle through the available audio tracks.
245 .IPs "f\ \ \ \ "
246 Toggle fullscreen (also see \-fs).
247 .IPs "T\ \ \ \ "
248 Toggle stay-on-top (also see \-ontop).
249 .IPs "w and e"
250 Decrease/\:increase pan-and-scan range.
251 .IPs "o\ \ \ \ "
252 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
253 .IPs "d\ \ \ \ "
254 Toggle frame dropping states: none / skip display / skip decoding
255 (see \-framedrop and \-hardframedrop).
256 .IPs "v\ \ \ \ "
257 Toggle subtitle visibility.
258 .IPs "b / j"
259 Cycle through the available subtitles.
260 .IPs "y and g"
261 Step forward/backward in the subtitle list.
262 .IPs "F\ \ \ \ "
263 Toggle displaying "forced subtitles".
264 .IPs "a\ \ \ \ "
265 Toggle subtitle alignment: top / middle / bottom.
266 .IPs "x and z"
267 Adjust subtitle delay by +/- 0.1 seconds.
268 .IPs "r and t"
269 Move subtitles up/down.
270 .IPs "i (\-edlout mode only)"
271 Set start or end of an EDL skip and write it out to the given file.
272 .IPs "s (\-vf screenshot only)"
273 Take a screenshot.
274 .IPs "S (\-vf screenshot only)"
275 Start/stop taking screenshots.
276 .IPs "I\ \ \ \ "
277 Show filename on the OSD.
278 .IPs "! and @"
279 Seek to the beginning of the previous/next chapter.
280 .RE
281 .PD 1
282 .PP
283 .RS
284 (The following keys are valid only when using a hardware accelerated video
285 output (xv, (x)vidix, (x)mga, etc), the software equalizer
286 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
287 .RE
288 .PP
289 .PD 0
290 .RS
291 .IPs "1 and 2"
292 Adjust contrast.
293 .IPs "3 and 4"
294 Adjust brightness.
295 .IPs "5 and 6"
296 Adjust hue.
297 .IPs "7 and 8"
298 Adjust saturation.
299 .RE
300 .PD 1
301 .PP
302 .RS
303 (The following keys are valid only when using the quartz or macosx
304 video output driver.)
305 .RE
306 .PP
307 .PD 0
308 .RS
309 .IPs "command + 0"
310 Resize movie window to half its original size.
311 .IPs "command + 1"
312 Resize movie window to its original size.
313 .IPs "command + 2"
314 Resize movie window to double its original size.
315 .IPs "command + f"
316 Toggle fullscreen (also see \-fs).
317 .IPs "command + [ and command + ]"
318 Set movie window alpha.
319 .RE
320 .PD 1
321 .PP
322 .RS
323 (The following keys are valid only when using the sdl
324 video output driver.)
325 .RE
326 .PP
327 .PD 0
328 .RS
329 .IPs "c\ \ \ \ "
330 Cycle through available fullscreen modes.
331 .IPs "n\ \ \ \ "
332 Restore original mode.
333 .RE
334 .PD 1
335 .PP
336 .RS
337 (The following keys are valid if you have a keyboard
338 with multimedia keys.)
339 .RE
340 .PP
341 .PD 0
342 .RS
343 .IPs PAUSE
344 Pause.
345 .IPs "STOP\ "
346 Stop playing and quit.
347 .IPs "PREVIOUS and NEXT"
348 Seek backward/\:forward 1 minute.
349 .RE
350 .PD 1
351 .PP
352 .RS
353 (The following keys are only valid if GUI support is compiled in
354 and will take precedence over the keys defined above.)
355 .RE
356 .PP
357 .PD 0
358 .RS
359 .IPs ENTER
360 Start playing.
361 .IPs "ESC\ \ "
362 Stop playing.
363 .IPs "l\ \ \ \ "
364 Load file.
365 .IPs "t\ \ \ \ "
366 Load subtitle.
367 .IPs "c\ \ \ \ "
368 Open skin browser.
369 .IPs "p\ \ \ \ "
370 Open playlist.
371 .IPs "r\ \ \ \ "
372 Open preferences.
373 .RE
374 .PD 1
375 .PP
376 .RS
377 (The following keys are only valid if you compiled with TV or DVB input
378 support and will take precedence over the keys defined above.)
379 .RE
380 .PP
381 .PD 0
382 .RS
383 .IPs "h and k"
384 Select previous/\:next channel.
385 .IPs "n\ \ \ \ "
386 Change norm.
387 .IPs "u\ \ \ \ "
388 Change channel list.
389 .RE
390 .PD 1
391 .PP
392 .RS
393 (The following keys are only valid if you compiled with dvdnav
394 support: they are used to navigate the menus)
395 .RE
396 .PP
397 .PD 0
398 .RS
399 .IPs "keypad 8"
400 Select button up.
401 .IPs "keypad 2"
402 Select button down.
403 .IPs "keypad 4"
404 Select button left.
405 .IPs "keypad 6"
406 Select button right.
407 .IPs "keypad 5"
408 Return to main menu.
409 .IPs "keypad 7"
410 Return to nearest menu (the order of preference is: chapter->title->root).
411 .IPs "keypad ENTER"
412 Confirm choice.
413 .RE
414 .PD 1
415 .PP
416 .RS
417 .
418 .TP
419 .B mouse control
420 .PD 0
421 .RS
422 .IPs "button 3 and button 4"
423 Seek backward/\:forward 1 minute.
424 .IPs "button 5 and button 6"
425 Decrease/\:increase volume.
426 .RE
427 .PD 1
428 .
429 .TP
430 .B joystick control
431 .PD 0
432 .RS
433 .IPs "left and right"
434 Seek backward/\:forward 10 seconds.
435 .IPs "up and down"
436 Seek forward/\:backward 1 minute.
437 .IPs "button 1"
438 Pause.
439 .IPs "button 2"
440 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
441 .IPs "button 3 and button 4"
442 Decrease/\:increase volume.
443 .RE
444 .PD 1
445 .
446 .
447 .\" --------------------------------------------------------------------------
448 .\" Usage
449 .\" --------------------------------------------------------------------------
450 .
451 .SH "USAGE"
452 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
453 \-fs option is \-nofs.
454 .PP
455 If an option is marked as (XXX only), it will only work in combination with
456 the XXX option or if XXX is compiled in.
457 .PP
458 .I NOTE:
459 The suboption parser (used for example for \-ao pcm suboptions) supports
460 a special kind of string-escaping intended for use with external GUIs.
461 .br
462 It has the following format:
463 .br
464 %n%string_of_length_n
465 .br
466 .I EXAMPLES:
467 .br
468 mplayer \-ao pcm:file=%10%C:test.wav test.avi
469 .br
470 Or in a script:
471 .br
472 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
473 .PP
474 .
475 .\" --------------------------------------------------------------------------
476 .\" Configuration files
477 .\" --------------------------------------------------------------------------
478 .
479 .SH "CONFIGURATION FILES"
480 You can put all of the options in configuration files which will be read
481 every time MPlayer/MEncoder is run.
482 The system-wide configuration file 'mplayer.conf' is in your configuration
483 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
484 specific one is '~/\:.mplayer/\:config'.
485 The configuration file for MEncoder is 'mencoder.conf' in your configuration
486 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the
487 user specific one is '~/\:.mplayer/\:mencoder.conf.
488 User specific options override system-wide options and options given on the
489 command line override either.
490 The syntax of the configuration files is 'option=<value>', everything after
491 a '#' is considered a comment.
492 Options that work without values can be enabled by setting them to 'yes'
493 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
494 Even suboptions can be specified in this way.
495 .PP
496 You can also write file-specific configuration files.
497 If you wish to have a configuration file for a file called 'movie.avi', create a file
498 named 'movie.avi.conf' with the file-specific options in it and put it in
499 ~/.mplayer/.
500 You can also put the configuration file in the same directory as the file to
501 be played, as long as you give the \-use-filedir-conf option (either on the
502 command line or in your global config file).
503 .PP
504 .I EXAMPLE MPLAYER CONFIGURATION FILE:
505 .sp 1
506 .nf
507 # Use Matrox driver by default.
508 vo=xmga
509 # I love practicing handstands while watching videos.
510 flip=yes
511 # Decode/encode multiple files from PNG,
512 # start with mf://filemask
513 mf=type=png:fps=25
514 # Eerie negative images are cool.
515 vf=eq2=1.0:-0.8
516 .fi
517 .PP
518 .I "EXAMPLE MENCODER CONFIGURATION FILE:"
519 .sp 1
520 .nf
521 # Make MEncoder output to a default filename.
522 o=encoded.avi
523 # The next 4 lines allow mencoder tv:// to start capturing immediately.
524 oac=pcm=yes
525 ovc=lavc=yes
526 lavcopts=vcodec=mjpeg
527 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
528 # more complex default encoding option set
529 lavcopts=vcodec=mpeg4:autoaspect=1
530 lameopts=aq=2:vbr=4
531 ovc=lavc=1
532 oac=lavc=1
533 passlogfile=pass1stats.log
534 noautoexpand=1
535 subfont-autoscale=3
536 subfont-osd-scale=6
537 subfont-text-scale=4
538 subalign=2
539 subpos=96
540 spuaa=20
541 .fi
542 .
543 .\" --------------------------------------------------------------------------
544 .\" Profiles
545 .\" --------------------------------------------------------------------------
546 .
547 .SH "PROFILES"
548 To ease working with different configurations profiles can be defined in the
549 configuration files.
550 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
551 All following options will be part of the profile.
552 A description (shown by \-profile help) can be defined with the profile-desc
553 option.
554 To end the profile, start another one or use the profile name 'default'
555 to continue with normal options.
556 .fi
557 .PP
558 .I "EXAMPLE MENCODER PROFILE:"
559 .sp 1
560 .nf
561
562 [mpeg4]
563 profile-desc="MPEG4 encoding"
564 ovc=lacv=yes
565 lavcopts=vcodec=mpeg4:vbitrate=1200
566
567 [mpeg4-hq]
568 profile-desc="HQ MPEG4 encoding"
569 profile=mpeg4
570 lavcopts=mbd=2:trell=yes:v4mv=yes
571 .fi
572 .
573 .\" --------------------------------------------------------------------------
574 .\" Options
575 .\" --------------------------------------------------------------------------
576 .
577 .SH "GENERAL OPTIONS"
578 .
579 .TP
580 .B \-codecs-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
581 Override the standard search path and use the specified file
582 instead of the builtin codecs.conf.
583 .
584 .TP
585 .B \-include <configuration file>
586 Specify configuration file to be parsed after the default ones.
587 .
588 .TP
589 .B \-list-options
590 Prints all available options.
591 .
592 .TP
593 .B \-msgcharset <charset>
594 Convert console messages to the specified character set (default: autodetect).
595 Text will be in the encoding specified with the \-\-charset configure option.
596 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
597 .br
598 .I NOTE:
599 The option takes effect after command line parsing has finished.
600 The MPLAYER_CHARSET environment variable can help you get rid of
601 the first lines of garbled output.
602 .
603 .TP
604 .B \-msglevel <all=<level>:<module>=<level>:...>
605 Control verbosity directly for each module.
606 The 'all' module changes the verbosity of all the modules not
607 explicitly specified on the command line.
608 See '\-msglevel help' for a list of all modules.
609 .br
610 .I NOTE:
611 Messages printed before the command line is parsed can be controlled only
612 by the MPLAYER_VERBOSE environment variable, which applies to all modules.
613 .br
614 Available levels:
615 .PD 0
616 .RSs
617 .IPs "-1"
618 complete silence
619 .IPs " 0"
620 fatal messages only
621 .IPs " 1"
622 error messages
623 .IPs " 2"
624 warning messages
625 .IPs " 3"
626 short hints
627 .IPs " 4"
628 informational messages
629 .IPs " 5"
630 status messages (those hidden by \-quiet)
631 .IPs " 6"
632 verbose messages
633 .IPs " 7"
634 debug level 2
635 .IPs " 8"
636 debug level 3
637 .IPs " 9"
638 debug level 4
639 .RE
640 .PD 1
641 .
642 .TP
643 .B "\-quiet\ "
644 Make console output less verbose; in particular, prevents the status line
645 (i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
646 Particularly useful on slow terminals or broken ones which do not properly
647 handle carriage return (i.e.\& \\r).
648 .
649 .TP
650 .B \-priority <prio> (Windows only)
651 Set process priority for MPlayer according to the predefined
652 priorities available under Windows.
653 Possible values of <prio>:
654 .RSs
655 idle|belownormal|normal|abovenormal|high|realtime
656 .RE
657 .sp 1
658 .RS
659 .I WARNING:
660 Using realtime priority can cause system lockup.
661 .RE
662 .
663 .TP
664 .B \-profile <profile1,profile2,...>
665 Use the given profile(s), \-profile help displays a list of the defined profiles.
666 .
667 .TP
668 .B \-really-quiet (also see \-quiet)
669 Display even less output and status messages than with \-quiet.
670 .
671 .TP
672 .B \-show-profile <profile>
673 Show the description and content of a profile.
674 .
675 .TP
676 .B \-use-filedir-conf
677 Look for a file-specific configuration file in the same directory as
678 the file that is being played.
679 .br
680 .I WARNING:
681 May be dangerous if playing from untrusted media.
682 .
683 .TP
684 .B "\-v\ \ \ \ \ "
685 Increment verbosity level, one level for each \-v
686 found on the command line.
687 .
688 .
689 .
690 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
691 .
692 .TP
693 .B \-autoq <quality> (use with \-vf [s]pp)
694 Dynamically changes the level of postprocessing depending on the available spare
695 CPU time.
696 The number you specify will be the maximum level used.
697 Usually you can use some big number.
698 You have to use \-vf [s]pp without parameters in order for this to work.
699 .
700 .TP
701 .B \-autosync <factor>
702 Gradually adjusts the A/V sync based on audio delay measurements.
703 Specifying \-autosync 0, the default, will cause frame timing to be based
704 entirely on audio delay measurements.
705 Specifying \-autosync 1 will do the same, but will subtly change the A/V
706 correction algorithm.
707 An uneven video framerate in a movie which plays fine with \-nosound can
708 often be helped by setting this to an integer value greater than 1.
709 The higher the value, the closer the timing will be to \-nosound.
710 Try \-autosync 30 to smooth out problems with sound drivers which do
711 not implement a perfect audio delay measurement.
712 With this value, if large A/V sync offsets occur, they will only take about
713 1 or 2 seconds to settle out.
714 This delay in reaction time to sudden A/V offsets should be the only
715 side-effect of turning this option on, for all sound drivers.
716 .
717 .TP
718 .B \-benchmark
719 Prints some statistics on CPU usage and dropped frames at the end of playback.
720 Use in combination with \-nosound and \-vo null for benchmarking only the
721 video codec.
722 .br
723 .I NOTE:
724 With this option MPlayer will also ignore frame duration when playing
725 only video (you can think of that as infinite fps).
726 .
727 .TP
728 .B \-colorkey <number>
729 Changes the colorkey to an RGB value of your choice.
730 0x000000 is black and 0xffffff is white.
731 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
732 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
733 drivers.
734 .
735 .TP
736 .B \-nocolorkey
737 Disables colorkeying.
738 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
739 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
740 drivers.
741 .
742 .TP
743 .B \-correct-pts (experimental)
744 Switches MPlayer to an experimental mode where timestamps for video frames
745 are calculated differently and video filters which add new frames or
746 modify timestamps of existing ones are supported.
747 The more accurate timestamps can be visible for example when playing
748 subtitles timed to scene changes with the \-ass option.
749 Without \-correct-pts the subtitle timing will typically be off by some frames.
750 This option does not work correctly with some demuxers and codecs.
751 .
752 .TP
753 .B \-crash-debug (DEBUG CODE)
754 Automatically attaches gdb upon crash or SIGTRAP.
755 Support must be compiled in by configuring with \-\-enable-crash-debug.
756 .
757 .TP
758 .B \-edlout <filename>
759 Creates a new file and writes edit decision list (EDL) records to it.
760 During playback, the user hits 'i' to mark the start or end of a skip block.
761 This provides a starting point from which the user can fine-tune EDL entries
762 later.
763 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
764 .
765 .TP
766 .B \-enqueue (GUI only)
767 Enqueue files given on the command line in the playlist instead of playing them
768 immediately.
769 .
770 .TP
771 .B \-fixed-vo
772 Enforces a fixed video system for multiple files (one (un)initialization for
773 all files).
774 Therefore only one window will be opened for all files.
775 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
776 xmga, xv, xvidix and dfbmga.
777 .
778 .TP
779 .B \-framedrop (also see \-hardframedrop)
780 Skip displaying some frames to maintain A/V sync on slow systems.
781 Video filters are not applied to such frames.
782 For B-frames even decoding is skipped completely.
783 .
784 .TP
785 .B \-(no)gui
786 Enable or disable the GUI interface (default depends on binary name).
787 Only works as the first argument on the command line.
788 Does not work as a config-file option.
789 .
790 .TP
791 .B \-h, \-help, \-\-help
792 Show short summary of options.
793 .
794 .TP
795 .B \-hardframedrop
796 More intense frame dropping (breaks decoding).
797 Leads to image distortion!
798 .
799 .TP
800 .B \-identify
801 Shorthand for \-msglevel identify=4.
802 Show file parameters in an easily parseable format.
803 Also prints more detailed information about subtitle and audio
804 track languages and IDs.
805 In some cases you can get more information by using \-msglevel identify=6.
806 For example, for a DVD it will list the time length of each title, as well
807 as a disk ID.
808 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
809 (hopefully) shellescapes the filenames.
810 .
811 .TP
812 .B \-idle (also see \-slave)
813 Makes MPlayer wait idly instead of quitting when there is no file to play.
814 Mostly useful in slave mode where MPlayer can be controlled
815 through input commands.
816 .
817 .TP
818 .B \-input <commands>
819 This option can be used to configure certain parts of the input system.
820 Paths are relative to ~/.mplayer/.
821 .br
822 .I NOTE:
823 Autorepeat is currently only supported by joysticks.
824 .sp 1
825 Available commands are:
826 .sp 1
827 .PD 0
828 .RSs
829 .IPs conf=<filename>
830 Specify input configuration file other than the default
831 ~/\:.mplayer/\:input.conf.
832 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
833 .IPs ar-delay
834 Delay in milliseconds before we start to autorepeat a key (0 to disable).
835 .IPs ar-rate
836 Number of key presses to generate per second on autorepeat.
837 .IPs keylist
838 Prints all keys that can be bound to commands.
839 .IPs cmdlist
840 Prints all commands that can be bound to keys.
841 .IPs js-dev
842 Specifies the joystick device to use (default: /dev/\:input/\:js0).
843 .IPs file=<filename>
844 Read commands from the given file.
845 Mostly useful with a FIFO.
846 .br
847 .I NOTE:
848 When the given file is a FIFO MPlayer opens both ends so you can do
849 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
850 .RE
851 .PD 1
852 .
853 .TP
854 .B \-key-fifo-size <2\-65000>
855 Specify the size of the FIFO that buffers key events (default: 10).
856 A FIFO of size n can buffer (n-1) events.
857 If it is too small some events may be lost
858 (leading to "stuck mouse buttons" and similar effects).
859 If it is too big, MPlayer may seem to hang while it
860 processes the buffered events.
861 To get the same behavior as before this option was introduced,
862 set it to 2 for Linux or 1024 for Windows.
863 .
864 .TP
865 .B \-lircconf <filename> (LIRC only)
866 Specifies a configuration file for LIRC (default: ~/.lircrc).
867 .
868 .TP
869 .B \-list-properties
870 Print a list of the available properties.
871 .
872 .TP
873 .B \-loop <number>
874 Loops movie playback <number> times.
875 0 means forever.
876 .
877 .TP
878 .B \-menu (OSD menu only)
879 Turn on OSD menu support.
880 .
881 .TP
882 .B \-menu-cfg <filename> (OSD menu only)
883 Use an alternative menu.conf.
884 .
885 .TP
886 .B \-menu-root <value> (OSD menu only)
887 Specify the main menu.
888 .
889 .TP
890 .B \-menu-startup (OSD menu only)
891 Display the main menu at MPlayer startup.
892 .
893 .TP
894 .B \-mouse-movements
895 Permit MPlayer to receive pointer events reported by the video
896 output driver (currently only derivatives of X11 are supported).
897 Necessary to select the buttons in DVD menus.
898 .
899 .TP
900 .B \-noconsolecontrols
901 Prevent MPlayer from reading key events from standard input.
902 Useful when reading data from standard input.
903 This is automatically enabled when \- is found on the command line.
904 There are situations where you have to set it manually, e.g.\&
905 if you open /dev/\:stdin (or the equivalent on your system), use stdin
906 in a playlist or intend to read from stdin later on via the loadfile or
907 loadlist slave commands.
908 .
909 .TP
910 .B \-nojoystick
911 Turns off joystick support.
912 .
913 .TP
914 .B \-nolirc
915 Turns off LIRC support.
916 .
917 .TP
918 .B \-nomouseinput (X11 only)
919 Disable mouse button press/\:release input (mozplayerxp's context menu relies
920 on this option).
921 .
922 .TP
923 .B \-rtc (RTC only)
924 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
925 mechanism.
926 This wakes up the process every 1/1024 seconds to check the current time.
927 Useless with modern Linux kernels configured for desktop use as they already
928 wake up the process with similar accuracy when using normal timed sleep.
929 .
930 .TP
931 .B \-playing-msg <string>
932 Print out a string before starting playback.
933 The following expansions are supported:
934 .RSs
935 .IPs ${NAME}
936 Expand to the value of the property NAME.
937 .IPs $(NAME:TEXT)
938 Expand TEXT only if the property NAME is available.
939 .RE
940 .
941 .TP
942 .B \-playlist <filename>
943 Play files according to a playlist file (ASX, Winamp, SMIL, or
944 one-file-per-line format).
945 .br
946 .I NOTE:
947 This option is considered an entry so options found after it will apply
948 only to the elements of this playlist.
949 .br
950 FIXME: This needs to be clarified and documented thoroughly.
951 .
952 .TP
953 .B \-rtc-device <device>
954 Use the specified device for RTC timing.
955 .
956 .TP
957 .B \-shuffle
958 Play files in random order.
959 .
960 .TP
961 .B \-skin <name> (GUI only)
962 Loads a skin from the directory given as parameter below the default skin
963 directories, /usr/\:local/\:share/\:mplayer/\:skins/\: and ~/.mplayer/\:skins/.
964 .sp 1
965 .I EXAMPLE:
966 .PD 0
967 .RSs
968 .IPs "\-skin fittyfene"
969 Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
970 and afterwards ~/.mplayer/\:skins/\:fittyfene.
971 .RE
972 .PD 1
973 .
974 .TP
975 .B \-slave (also see \-input)
976 Switches on slave mode, in which MPlayer works as a backend for other programs.
977 Instead of intercepting keyboard events, MPlayer will read commands separated
978 by a newline (\\n) from stdin.
979 .br
980 .I NOTE:
981 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
982 for their description.
983 .
984 .TP
985 .B \-softsleep
986 Time frames by repeatedly checking the current time instead of asking the
987 kernel to wake up MPlayer at the correct time.
988 Useful if your kernel timing is imprecise and you cannot use the RTC either.
989 Comes at the price of higher CPU consumption.
990 .
991 .TP
992 .B \-sstep <sec>
993 Skip <sec> seconds after every frame.
994 The normal framerate of the movie is kept, so playback is accelerated.
995 Since MPlayer can only seek to the next keyframe this may be inexact.
996 .
997 .
998 .
999 .SH "DEMUXER/STREAM OPTIONS"
1000 .
1001 .TP
1002 .B \-a52drc <level>
1003 Select the Dynamic Range Compression level for AC3 audio streams.
1004 <level> is a float value ranging from 0 to 1, where 0 means no compression
1005 and 1 (which is the default) means full compression (make loud passages more
1006 silent and vice versa).
1007 This option only shows an effect if the AC3 stream contains the required range
1008 compression information.
1009 .
1010 .TP
1011 .B \-aid <ID> (also see \-alang)
1012 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1013 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1014 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1015 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1016 (if present) with the chosen audio stream.
1017 .
1018 .TP
1019 .B \-alang <language code[,language code,...]> (also see \-aid)
1020 Specify a priority list of audio languages to use.
1021 Different container formats employ different language codes.
1022 DVDs use ISO 639-1 two letter language codes, Matroska and NUT use ISO 639-2
1023 three letter language codes while OGM uses a free-form identifier.
1024 MPlayer prints the available languages when run in verbose (\-v) mode.
1025 .sp 1
1026 .I EXAMPLE:
1027 .PD 0
1028 .RSs
1029 .IPs "mplayer dvd://1 \-alang hu,en"
1030 Chooses the Hungarian language track on a DVD and falls back on English if
1031 Hungarian is not available.
1032 .IPs "mplayer \-alang jpn example.mkv"
1033 Plays a Matroska file in Japanese.
1034 .RE
1035 .PD 1
1036 .
1037 .TP
1038 .B \-audio-demuxer <[+]name> (\-audiofile only)
1039 Force audio demuxer type for \-audiofile.
1040 Use a '+' before the name to force it, this will skip some checks!
1041 Give the demuxer name as printed by \-audio-demuxer help.
1042 For backward compatibility it also accepts the demuxer ID as defined in
1043 libmpdemux/\:demuxer.h.
1044 \-audio-demuxer audio or \-audio-demuxer 17 forces MP3.
1045 .
1046 .TP
1047 .B \-audiofile <filename>
1048 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1049 movie.
1050 .
1051 .TP
1052 .B \-audiofile-cache <kBytes>
1053 Enables caching for the stream used by \-audiofile, using the specified
1054 amount of memory.
1055 .
1056 .TP
1057 .B \-bandwidth <value> (network only)
1058 Specify the maximum bandwidth for network streaming (for servers that are
1059 able to send content in different bitrates).
1060 Useful if you want to watch live streamed media behind a slow connection.
1061 With Real RTSP streaming, it is also used to set the maximum delivery
1062 bandwidth allowing faster cache filling and stream dumping.
1063 .
1064 .TP
1065 .B \-cache <kBytes>
1066 This option specifies how much memory (in kBytes) to use when precaching a
1067 file or URL.
1068 Especially useful on slow media.
1069 .
1070 .TP
1071 .B \-nocache
1072 Turns off caching.
1073 .
1074 .TP
1075 .B \-cache-min <percentage>
1076 Playback will start when the cache has been filled up to <percentage>
1077 of the total.
1078 .
1079 .TP
1080 .B \-cache-seek-min <percentage>
1081 If a seek is to be made to a position within <percentage> of the cache size
1082 from the current position, MPlayer will wait for the cache to be filled to
1083 this position rather than performing a stream seek (default: 50).
1084 .
1085 .TP
1086 .B \-cdda <option1:option2> (CDDA only)
1087 This option can be used to tune the CD Audio reading feature of MPlayer.
1088 .sp 1
1089 Available options are:
1090 .RSs
1091 .IPs speed=<value>
1092 Set CD spin speed.
1093 .IPs paranoia=<0\-2>
1094 Set paranoia level.
1095 Values other than 0 seem to break playback of anything but the first track.
1096 .RSss
1097 0: disable checking (default)
1098 .br
1099 1: overlap checking only
1100 .br
1101 2: full data correction and verification
1102 .REss
1103 .IPs generic-dev=<value>
1104 Use specified generic SCSI device.
1105 .IPs sector-size=<value>
1106 Set atomic read size.
1107 .IPs overlap=<value>
1108 Force minimum overlap search during verification to <value> sectors.
1109 .IPs toc-bias
1110 Assume that the beginning offset of track 1 as reported in the TOC will be
1111 addressed as LBA 0.
1112 Some Toshiba drives need this for getting track boundaries correct.
1113 .IPs toc-offset=<value>
1114 Add <value> sectors to the values reported when addressing tracks.
1115 May be negative.
1116 .IPs (no)skip
1117 (Never) accept imperfect data reconstruction.
1118 .RE
1119 .
1120 .TP
1121 .B \-cdrom-device <path to device>
1122 Specify the CD-ROM device (default: /dev/\:cdrom).
1123 .
1124 .TP
1125 .B \-channels <number> (also see \-af channels)
1126 Request the number of playback channels (default: 2).
1127 MPlayer asks the decoder to decode the audio into as many channels as
1128 specified.
1129 Then it is up to the decoder to fulfill the requirement.
1130 This is usually only important when playing videos with AC3 audio (like DVDs).
1131 In that case liba52 does the decoding by default and correctly downmixes the
1132 audio into the requested number of channels.
1133 To directly control the number of output channels independently of how many
1134 channels are decoded, use the channels filter.
1135 .br
1136 .I NOTE:
1137 This option is honored by codecs (AC3 only), filters (surround) and audio
1138 output drivers (OSS at least).
1139 .sp 1
1140 Available options are:
1141 .sp 1
1142 .PD 0
1143 .RSs
1144 .IPs 2
1145 stereo
1146 .IPs 4
1147 surround
1148 .IPs 6
1149 full 5.1
1150 .RE
1151 .PD 1
1152 .
1153 .TP
1154 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1155 Specify which chapter to start playing at.
1156 Optionally specify which chapter to end playing at (default: 1).
1157 .
1158 .TP
1159 .B \-cookies (network only)
1160 Send cookies when making HTTP requests.
1161 .
1162 .TP
1163 .B \-cookies-file <filename> (network only)
1164 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1165 and skip reading from default locations.
1166 The file is assumed to be in Netscape format.
1167 .
1168 .TP
1169 .B \-delay <sec>
1170 audio delay in seconds (positive or negative float value)
1171 .br
1172 .I NOTE:
1173 When used with MEncoder, this is not guaranteed to work correctly
1174 with \-ovc copy; use \-audio-delay instead.
1175 .
1176 .TP
1177 .B \-ignore-start
1178 Ignore the specified starting time for streams in AVI files.
1179 In MPlayer, this nullifies stream delays in files encoded with
1180 the \-audio-delay option.
1181 During encoding, this option prevents MEncoder from transferring
1182 original stream start times to the new file; the \-audio-delay option is
1183 not affected.
1184 Note that MEncoder sometimes adjusts stream starting times
1185 automatically to compensate for anticipated decoding delays, so do not
1186 use this option for encoding without testing it first.
1187 .
1188 .TP
1189 .B \-demuxer <[+]name>
1190 Force demuxer type.
1191 Use a '+' before the name to force it, this will skip some checks!
1192 Give the demuxer name as printed by \-demuxer help.
1193 For backward compatibility it also accepts the demuxer ID as defined in
1194 libmpdemux/\:demuxer.h.
1195 \-demuxer audio or \-demuxer 17 forces MP3.
1196 .
1197 .TP
1198 .B \-dumpaudio (MPlayer only)
1199 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3,
1200 in most other cases the resulting file will not be playable).
1201 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1202 on the command line only the last one will work.
1203 .
1204 .TP
1205 .B \-dumpfile <filename> (MPlayer only)
1206 Specify which file MPlayer should dump to.
1207 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
1208 .
1209 .TP
1210 .B \-dumpstream (MPlayer only)
1211 Dumps the raw stream to ./stream.dump.
1212 Useful when ripping from DVD or network.
1213 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1214 on the command line only the last one will work.
1215 .
1216 .TP
1217 .B \-dumpvideo (MPlayer only)
1218 Dump raw compressed video stream to ./stream.dump (not very usable).
1219 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1220 on the command line only the last one will work.
1221 .
1222 .TP
1223 .B \-dvbin <options> (DVB only)
1224 Pass the following parameters to the DVB input module, in order to override
1225 the default ones:
1226 .sp 1
1227 .PD 0
1228 .RSs
1229 .IPs card=<1\-4>
1230 Specifies using card number 1\-4 (default: 1).
1231 .IPs file=<filename>
1232 Instructs MPlayer to read the channels list from <filename>.
1233 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1234 or ~/.mplayer/\:channels.conf as a last resort.
1235 .IPs timeout=<1\-30>
1236 Maximum number of seconds to wait when trying to tune a
1237 frequency before giving up (default: 30).
1238 .RE
1239 .PD 1
1240 .
1241 .TP
1242 .B \-dvd-device <path to device> (DVD only)
1243 Specify the DVD device (default: /dev/\:dvd).
1244 You can also specify a directory that contains files previously copied directly
1245 from a DVD (with e.g.\& vobcopy).
1246 Note that using \-dumpstream is usually a better way to
1247 copy DVD titles in the first place (see the examples).
1248 .
1249 .TP
1250 .B \-dvdangle <angle ID> (DVD only)
1251 Some DVD discs contain scenes that can be viewed from multiple angles.
1252 Here you can tell MPlayer which angles to use (default: 1).
1253 .
1254 .TP
1255 .B \-edl <filename>
1256 Enables edit decision list (EDL) actions during playback.
1257 Video will be skipped over and audio will be muted and unmuted according to
1258 the entries in the given file.
1259 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1260 on how to use this.
1261 .
1262 .TP
1263 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1264 Stop at given time or byte position.
1265 .br
1266 .I NOTE:
1267 Byte position is enabled only for MEncoder and will not be accurate, as it can
1268 only stop at a frame boundary.
1269 When used in conjunction with \-ss option, \-endpos time will shift forward by
1270 seconds specified with \-ss.
1271 .sp 1
1272 .I EXAMPLE:
1273 .PD 0
1274 .RSs
1275 .IPs "\-endpos 56"
1276 Stop at 56 seconds.
1277 .IPs "\-endpos 01:10:00"
1278 Stop at 1 hour 10 minutes.
1279 .IPs "\-ss 10 \-endpos 56"
1280 Stop at 1 minute 6 seconds.
1281 .IPs "\-endpos 100mb"
1282 Encode only 100 MB.
1283 .RE
1284 .PD 1
1285 .
1286 .TP
1287 .B \-forceidx
1288 Force index rebuilding.
1289 Useful for files with broken index (A/V desync, etc).
1290 This will enable seeking in files where seeking was not possible.
1291 You can fix the index permanently with MEncoder (see the documentation).
1292 .br
1293 .I NOTE:
1294 This option only works if the underlying media supports seeking
1295 (i.e.\& not with stdin, pipe, etc).
1296 .
1297 .TP
1298 .B \-fps <float value>
1299 Override video framerate.
1300 Useful if the original value is wrong or missing.
1301 .
1302 .TP
1303 .B \-frames <number>
1304 Play/\:convert only first <number> frames, then quit.
1305 .
1306 .TP
1307 .B \-hr-mp3-seek (MP3 only)
1308 Hi-res MP3 seeking.
1309 Enabled when playing from an external MP3 file, as we need to seek
1310 to the very exact position to keep A/V sync.
1311 Can be slow especially when seeking backwards since it has to rewind
1312 to the beginning to find an exact frame position.
1313 .
1314 .TP
1315 .B \-idx (also see \-forceidx)
1316 Rebuilds index of files if no index was found, allowing seeking.
1317 Useful with broken/\:incomplete downloads, or badly created files.
1318 .br
1319 .I NOTE:
1320 This option only works if the underlying media supports seeking
1321 (i.e.\& not with stdin, pipe, etc).
1322 .
1323 .TP
1324 .B \-ipv4-only-proxy (network only)
1325 Skip the proxy for IPv6 addresses.
1326 It will still be used for IPv4 connections.
1327 .
1328 .TP
1329 .B \-loadidx <index file>
1330 The file from which to read the video index data saved by \-saveidx.
1331 This index will be used for seeking, overriding any index data
1332 contained in the AVI itself.
1333 MPlayer will not prevent you from loading an index file generated
1334 from a different AVI, but this is sure to cause unfavorable results.
1335 .br
1336 .I NOTE:
1337 This option is obsolete now that MPlayer has OpenDML support.
1338 .
1339 .TP
1340 .B \-mc <seconds/frame>
1341 maximum A-V sync correction per frame (in seconds)
1342 .
1343 .TP
1344 .B \-mf <option1:option2:...>
1345 Used when decoding from multiple PNG or JPEG files.
1346 .sp 1
1347 Available options are:
1348 .sp 1
1349 .PD 0
1350 .RSs
1351 .IPs w=<value>
1352 input file width (default: autodetect)
1353 .IPs h=<value>
1354 input file height (default: autodetect)
1355 .IPs fps=<value>
1356 output fps (default: 25)
1357 .IPs type=<value>
1358 input file type (available: jpeg, png, tga, sgi)
1359 .RE
1360 .PD 1
1361 .
1362 .TP
1363 .B \-ni (AVI only)
1364 Force usage of non-interleaved AVI parser (fixes playback
1365 of some bad AVI files).
1366 .
1367 .TP
1368 .B \-nobps (AVI only)
1369 Do not use average byte/\:second value for A-V sync.
1370 Helps with some AVI files with broken header.
1371 .
1372 .TP
1373 .B \-noextbased
1374 Disables extension-based demuxer selection.
1375 By default, when the file type (demuxer) cannot be detected reliably
1376 (the file has no header or it is not reliable enough), the filename
1377 extension is used to select the demuxer.
1378 Always falls back on content-based demuxer selection.
1379 .
1380 .TP
1381 .B \-passwd <password> (also see \-user) (network only)
1382 Specify password for HTTP authentication.
1383 .
1384 .TP
1385 .B \-prefer-ipv4 (network only)
1386 Use IPv4 on network connections.
1387 Falls back on IPv6 automatically.
1388 .
1389 .TP
1390 .B \-prefer-ipv6 (IPv6 network only)
1391 Use IPv6 on network connections.
1392 Falls back on IPv4 automatically.
1393 .
1394 .TP
1395 .B \-pvr <option1:option2:...> (PVR only)
1396 This option tunes various encoding properties of the PVR capture module.
1397 It has to be used with any hardware MPEG encoder based card supported by the
1398 V4L2 driver.
1399 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1400 cards are known as PVR capture cards.
1401 Be aware that only Linux 2.6.18 kernel
1402 and above is able to handle MPEG stream through V4L2 layer.
1403 For hardware capture of an MPEG stream and watching it with
1404 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1405 .sp 1
1406 Available options are:
1407 .RSs
1408 .IPs aspect=<0\-3>
1409 Specify input aspect ratio:
1410 .RSss
1411 0: 1:1
1412 .br
1413 1: 4:3 (default)
1414 .br
1415 2: 16:9
1416 .br
1417 3: 2.21:1
1418 .REss
1419 .IPs arate=<32000\-48000>
1420 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1421 and 48000 Hz).
1422 .IPs alayer=<1\-3>
1423 Specify MPEG audio layer encoding (default: 2).
1424 .IPs abitrate=<32\-448>
1425 Specify audio encoding bitrate in kbps (default: 384).
1426 .IPs amode=<value>
1427 Specify audio encoding mode.
1428 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1429 .IPs vbitrate=<value>
1430 Specify average video bitrate encoding in Mbps (default: 6).
1431 .IPs vmode=<value>
1432 Specify video encoding mode:
1433 .RSss
1434 vbr: Variable BitRate (default)
1435 .br
1436 cbr: Constant BitRate
1437 .REss
1438 .IPs vpeak=<value>
1439 Specify peak video bitrate encoding in Mbps
1440 (only useful for VBR encoding, default: 9.6).
1441 .IPs fmt=<value>
1442 Choose an MPEG format for encoding:
1443 .RSss
1444 ps:    MPEG-2 Program Stream (default)
1445 .br
1446 ts:    MPEG-2 Transport Stream
1447 .br
1448 mpeg1: MPEG-1 System Stream
1449 .br
1450 vcd:   Video CD compatible stream
1451 .br
1452 svcd:  Super Video CD compatible stream
1453 .br
1454 dvd:   DVD compatible stream
1455 .REss
1456 .RE
1457 .PD 1
1458 .
1459 .TP
1460 .B \-rawaudio <option1:option2:...>
1461 This option lets you play raw audio files.
1462 You have to use \-demuxer rawaudio as well.
1463 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1464 For playing raw AC3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1465 .sp 1
1466 Available options are:
1467 .sp 1
1468 .PD 0
1469 .RSs
1470 .IPs channels=<value>
1471 number of channels
1472 .IPs rate=<value>
1473 rate in samples per second
1474 .IPs samplesize=<value>
1475 sample size in bytes
1476 .IPs bitrate=<value>
1477 bitrate for rawaudio files
1478 .IPs format=<value>
1479 fourcc in hex
1480 .RE
1481 .PD 1
1482 .
1483 .TP
1484 .B \-rawvideo <option1:option2:...>
1485 This option lets you play raw video files.
1486 You have to use \-demuxer rawvideo as well.
1487 .sp 1
1488 Available options are:
1489 .sp 1
1490 .PD 0
1491 .RSs
1492 .IPs fps=<value>
1493 rate in frames per second (default: 25.0)
1494 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1495 set standard image size
1496 .IPs w=<value>
1497 image width in pixels
1498 .IPs h=<value>
1499 image height in pixels
1500 .IPs i420|yv12|yuy2|y8
1501 set colorspace
1502 .IPs format=<value>
1503 colorspace (fourcc) in hex
1504 .IPs size=<value>
1505 frame size in Bytes
1506 .REss
1507 .sp 1
1508 .RS
1509 .I EXAMPLE:
1510 .RE
1511 .PD 0
1512 .RSs
1513 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1514 Play the famous "foreman" sample video.
1515 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1516 Play a raw YUV sample.
1517 .RE
1518 .PD 1
1519 .
1520 .TP
1521 .B \-rtsp-port
1522 Used with 'rtsp://' URLs to force the client's port number.
1523 This option may be useful if you are behind a router and want to forward
1524 the RTSP stream from the server to a specific client.
1525 .
1526 .TP
1527 .B \-rtsp-destination
1528 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1529 This option may be useful with some RTSP server which do not
1530 send RTP packets to the right interface.
1531 If the connection to the RTSP server fails, use \-v to see
1532 which IP address MPlayer tries to bind to and try to force
1533 it to one assigned to your computer instead.
1534 .
1535 .TP
1536 .B \-rtsp-stream-over-tcp (LIVE555 only)
1537 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1538 packets be streamed over TCP (using the same TCP connection as RTSP).
1539 This option may be useful if you have a broken internet connection that does
1540 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1541 .
1542 .TP
1543 .B \-saveidx <filename>
1544 Force index rebuilding and dump the index to <filename>.
1545 Currently this only works with AVI files.
1546 .br
1547 .I NOTE:
1548 This option is obsolete now that MPlayer has OpenDML support.
1549 .
1550 .TP
1551 .B \-sb <byte position> (also see \-ss)
1552 Seek to byte position.
1553 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1554 .
1555 .TP
1556 .B \-speed <0.01\-100>
1557 Slow down or speed up playback by the factor given as parameter.
1558 Not guaranteed to work correctly with \-oac copy.
1559 .
1560 .TP
1561 .B \-srate <Hz>
1562 Selects the output sample rate to be used
1563 (of course sound cards have limits on this).
1564 If the sample frequency selected is different from that
1565 of the current media, the resample or lavcresample audio filter will be inserted
1566 into the audio filter layer to compensate for the difference.
1567 The type of resampling can be controlled by the \-af-adv option.
1568 The default is fast resampling that may cause distortion.
1569 .
1570 .TP
1571 .B \-ss <time> (also see \-sb)
1572 Seek to given time position.
1573 .sp 1
1574 .I EXAMPLE:
1575 .PD 0
1576 .RSs
1577 .IPs "\-ss 56"
1578 Seeks to 56 seconds.
1579 .IPs "\-ss 01:10:00"
1580 Seeks to 1 hour 10 min.
1581 .RE
1582 .PD 1
1583 .
1584 .TP
1585 .B \-tskeepbroken
1586 Tells MPlayer not to discard TS packets reported as broken in the stream.
1587 Sometimes needed to play corrupted MPEG-TS files.
1588 .
1589 .TP
1590 .B \-tsprobe <byte position>
1591 When playing an MPEG-TS stream, this option lets you specify how many
1592 bytes in the stream you want MPlayer to search for the desired
1593 audio and video IDs.
1594 .
1595 .TP
1596 .B \-tsprog <1\-65534>
1597 When playing an MPEG-TS stream, you can specify with this option which
1598 program (if present) you want to play.
1599 Can be used with \-vid and \-aid.
1600 .
1601 .TP
1602 .B \-radio <option1:option2:...> (radio only)
1603 These options set various parameters of the radio capture module.
1604 For listening to radio with MPlayer use 'radio://<frequency>'
1605 (if channels option is not given) or 'radio://<channel_number>'
1606 (if channels option is given) as a movie URL.
1607 You can see allowed frequency range by running MPlayer with '\-v'.
1608 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1609 If the capture keyword is not given you can listen to radio
1610 using the line-in cable only.
1611 Using capture to listen is not recommended due to synchronization
1612 problems, which makes this process uncomfortable.
1613 .sp 1
1614 Available options are:
1615 .RSs
1616 .IPs device=<value>
1617 Radio device to use (default: /dev/radio0).
1618 .IPs driver=<value>
1619 Radio driver to use (default: v4l2 if available, otherwise v4l).
1620 Currently, v4l and v4l2 drivers are supported.
1621 .IPs volume=<0..100>
1622 sound volume for radio device (default 100)
1623 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1624 Set channel list.
1625 Use _ for spaces in names (or play with quoting ;-).
1626 The channel names will then be written using OSD and the slave commands
1627 radio_step_channel and radio_set_channel will be usable for
1628 a remote control (see LIRC).
1629 If given, number in movie URL will be treated as channel position in
1630 channel list.
1631 .br
1632 .I EXAMPLE:
1633 radio://1, radio://104.4, radio_set_channel 1
1634 .IPs adevice=<value> (with radio capture enabled)
1635 Name of device to capture sound from.
1636 Without such a name capture will be disabled,
1637 even if the capture keyword appears in the URL.
1638 For ALSA devices use it in the form hw=<card>.<device>.
1639 If the device name contains a '=', the module will use
1640 ALSA to capture, otherwise OSS.
1641 .IPs arate=<value> (with radio capture enabled)
1642 Rate in samples per second (default: 44100).
1643 .br
1644 .I NOTE:
1645 When using audio capture set also \-rawaudio rate=<value> option
1646 with the same value as arate.
1647 If you have problems with sound speed (runs too quickly), try to play
1648 with different rate values (e.g.\& 48000,44100,32000,...).
1649 .IPs achannels=<value> (with radio capture enabled)
1650 Number of audio channels to capture.
1651 .RE
1652 .
1653 .TP
1654 .B \-tv <option1:option2:...> (TV/\:PVR only)
1655 This option tunes various properties of the TV capture module.
1656 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
1657 or even 'tv://<channel_name> (see option channels for channel_name below)
1658 as a movie URL.
1659 .sp 1
1660 Available options are:
1661 .RSs
1662 .IPs noaudio
1663 no sound
1664 .IPs driver=<value>
1665 available: dummy, v4l, v4l2, bsdbt848
1666 .IPs device=<value>
1667 Specify TV device (default: /dev/\:video0).
1668 .IPs input=<value>
1669 Specify input (default: 0 (TV), see console output for available inputs).
1670 .IPs freq=<value>
1671 Specify the frequency to set the tuner to (e.g.\& 511.250).
1672 Not compatible with the channels parameter.
1673 .IPs outfmt=<value>
1674 Specify the output format of the tuner with a preset value supported by the
1675 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1676 arbitrary format given as hex value.
1677 Try outfmt=help for a list of all available formats.
1678 .IPs width=<value>
1679 output window width
1680 .IPs height=<value>
1681 output window height
1682 .IPs fps=<value>
1683 framerate at which to capture video (frames per second)
1684 .IPs buffersize=<value>
1685 maximum size of the capture buffer in megabytes (default: dynamical)
1686 .IPs norm=<value>
1687 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
1688 For v4l2, see the console output for a list of all available norms,
1689 also see the normid option below.
1690 .IPs "normid=<value> (v4l2 only)"
1691 Sets the TV norm to the given numeric ID.
1692 The TV norm depends on the capture card.
1693 See the console output for a list of available TV norms.
1694 .IPs channel=<value>
1695 Set tuner to <value> channel.
1696 .IPs chanlist=<value>
1697 available: europe-east, europe-west, us-bcast, us-cable, etc
1698 .IPs channels=<channel>\-<name>,<channel>\-<name>,...
1699 Set names for channels.
1700 Use _ for spaces in names (or play with quoting ;-).
1701 The channel names will then be written using OSD, and the slave commands
1702 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
1703 a remote control (see LIRC).
1704 Not compatible with the frequency parameter.
1705 .br
1706 .I NOTE:
1707 The channel number will then be the position in the 'channels' list,
1708 beginning with 1.
1709 .br
1710 .I EXAMPLE:
1711 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
1712 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
1713 Set the image equalizer on the card.
1714 .IPs audiorate=<value>
1715 Set audio capture bitrate.
1716 .IPs forceaudio
1717 Capture audio even if there are no audio sources reported by v4l.
1718 .IPs "alsa\ "
1719 Capture from ALSA.
1720 .IPs amode=<0\-3>
1721 Choose an audio mode:
1722 .RSss
1723 0: mono
1724 .br
1725 1: stereo
1726 .br
1727 2: language 1
1728 .br
1729 3: language 2
1730 .REss
1731 .IPs forcechan=<1\-2>
1732 By default, the count of recorded audio channels is determined automatically
1733 by querying the audio mode from the TV card.
1734 This option allows forcing stereo/\:mono recording regardless of the amode
1735 option and the values returned by v4l.
1736 This can be used for troubleshooting when the TV card is unable to report the
1737 current audio mode.
1738 .IPs adevice=<value>
1739 Set an audio device.
1740 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
1741 You must replace any ':' by a '.' in the hardware ID for ALSA.
1742 .IPs audioid=<value>
1743 Choose an audio output of the capture card, if it has more than one.
1744 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
1745 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
1746 These options set parameters of the mixer on the video capture card.
1747 They will have no effect, if your card does not have one.
1748 For v4l2 50 maps to the default value of the
1749 control, as reported by the driver.
1750 .IPs immediatemode=<bool>
1751 A value of 0 means capture and buffer audio and video together
1752 (default for MEncoder).
1753 A value of 1 (default for MPlayer) means to do video capture only and let the
1754 audio go through a loopback cable from the TV card to the sound card.
1755 .IPs mjpeg
1756 Use hardware MJPEG compression (if the card supports it).
1757 When using this option, you do not need to specify the width and height
1758 of the output window, because MPlayer will determine it automatically
1759 from the decimation value (see below).
1760 .IPs decimation=<1|2|4>
1761 choose the size of the picture that will be compressed by hardware
1762 MJPEG compression:
1763 .RSss
1764 1: full size
1765     704x576    PAL
1766     704x480    NTSC
1767 .br
1768 2: medium size
1769     352x288    PAL
1770     352x240    NTSC
1771 .br
1772 4: small size
1773     176x144    PAL
1774     176x120    NTSC
1775 .REss
1776 .IPs quality=<0\-100>
1777 Choose the quality of the JPEG compression
1778 (< 60 recommended for full size).
1779 .RE
1780 .
1781 .TP
1782 .B \-user <username> (also see \-passwd) (network only)
1783 Specify username for HTTP authentication.
1784 .
1785 .TP
1786 .B \-user-agent <string>
1787 Use <string> as user agent for HTTP streaming.
1788 .
1789 .TP
1790 .B \-vid <ID>
1791 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
1792 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1793 (if present) with the chosen video stream.
1794 .
1795 .TP
1796 .B \-vivo <sub-options> (DEBUG CODE)
1797 Force audio parameters for the VIVO demuxer (for debugging purposes).
1798 .
1799 .
1800 .
1801 .SH "OSD/SUBTITLE OPTIONS"
1802 .I NOTE:
1803 Also see \-vf expand.
1804 .
1805 .TP
1806 .B \-ass (FreeType only)
1807 Turn on SSA/ASS subtitle rendering.
1808 With this option, libass will be used for SSA/ASS
1809 external subtitles and Matroska tracks.
1810 You may also want to use \-embeddedfonts.
1811 .
1812 .TP
1813 .B \-ass-border-color <value>
1814 Sets the border (outline) color for text subtitles.
1815 The color format is RRGGBBAA.
1816 .
1817 .TP
1818 .B \-ass-bottom-margin <value>
1819 Adds a black band at the bottom of the frame.
1820 The SSA/ASS renderer can place subtitles there (with \-ass-use-margins).
1821 .
1822 .TP
1823 .B \-ass-color <value>
1824 Sets the color for text subtitles.
1825 The color format is RRGGBBAA.
1826 .
1827 .TP
1828 .B \-ass-font-scale <value>
1829 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
1830 .
1831 .TP
1832 .B \-ass-force-style <[Style.]Param=Value[,...]>
1833 Override some style parameters.
1834 .sp
1835 .I EXAMPLE:
1836 .PD 0
1837 .RSs
1838 \-ass-force-style FontName=Arial,Default.Bold=1
1839 .RE
1840 .PD 1
1841 .
1842 .TP
1843 .B \-ass-line-spacing <value>
1844 Set line spacing value for SSA/ASS renderer.
1845 .
1846 .TP
1847 .B \-ass-styles <filename>
1848 Load all SSA/ASS styles found in the specified file and use them for
1849 rendering text subtitles.
1850 The syntax of the file is exactly like the
1851 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
1852 .
1853 .TP
1854 .B \-ass-top-margin <value>
1855 Adds a black band at the top of the frame.
1856 The SSA/ASS renderer can place toptitles there (with \-ass-use-margins).
1857 .
1858 .TP
1859 .B \-(no)ass-use-margins
1860 Enables/disables placing toptitles and subtitles in black borders when they
1861 are available (default: no).
1862 .
1863 .TP
1864 .B \-dumpjacosub (MPlayer only)
1865 Convert the given subtitle (specified with the \-sub option) to the time-based
1866 JACOsub subtitle format.
1867 Creates a dumpsub.js file in the current directory.
1868 .
1869 .TP
1870 .B \-dumpmicrodvdsub (MPlayer only)
1871 Convert the given subtitle (specified with the \-sub option) to the
1872 MicroDVD subtitle format.
1873 Creates a dumpsub.sub file in the current directory.
1874 .
1875 .TP
1876 .B \-dumpmpsub (MPlayer only)
1877 Convert the given subtitle (specified with the \-sub option) to MPlayer's
1878 subtitle format, MPsub.
1879 Creates a dump.mpsub file in the current directory.
1880 .
1881 .TP
1882 .B \-dumpsami (MPlayer only)
1883 Convert the given subtitle (specified with the \-sub option) to the time-based
1884 SAMI subtitle format.
1885 Creates a dumpsub.smi file in the current directory.
1886 .
1887 .TP
1888 .B \-dumpsrtsub (MPlayer only)
1889 Convert the given subtitle (specified with the \-sub option) to the time-based
1890 SubViewer (SRT) subtitle format.
1891 Creates a dumpsub.srt file in the current directory.
1892 .br
1893 .I NOTE:
1894 Some broken hardware players choke on SRT subtitle files with Unix
1895 line endings.
1896 If you are unlucky enough to have such a box, pass your subtitle
1897 files through unix2dos or a similar program to replace Unix line
1898 endings with DOS/Windows line endings.
1899 .
1900 .TP
1901 .B \-dumpsub (MPlayer only) (BETA CODE)
1902 Dumps the subtitle substream from VOB streams.
1903 Also see the \-dump*sub and \-vobsubout* options.
1904 .
1905 .TP
1906 .B \-embeddedfonts (FreeType only)
1907 Enables extraction of Matroska embedded fonts.
1908 These fonts can be used for SSA/ASS subtitle
1909 rendering (\-ass option).
1910 .
1911 .TP
1912 .B \-ffactor <number> (OSD only)
1913 Resample the font alphamap.
1914 Can be:
1915 .PD 0
1916 .RSs
1917 .IPs 0
1918 plain white fonts
1919 .IPs 0.75
1920 very narrow black outline (default)
1921 .IPs 1
1922 narrow black outline
1923 .IPs 10
1924 bold black outline
1925 .RE
1926 .PD 1
1927 .
1928 .TP
1929 .B \-flip-hebrew (FriBiDi only)
1930 Turns on flipping subtitles using FriBiDi.
1931 .
1932 .TP
1933 .B \-noflip-hebrew-commas
1934 Change FriBiDi's assumptions about the placements of commas in subtitles.
1935 Use this if commas in subtitles are shown at the start of a sentence
1936 instead of at the end.
1937 .
1938 .TP
1939 .B \-font <path to font.desc file> (OSD only)
1940 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
1941 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
1942 ~/.mplayer/\:subfont.ttf).
1943 .br
1944 .I NOTE:
1945 With FreeType, this option determines the path to the text font file.
1946 With fontconfig, this option determines the fontconfig font name.
1947 .sp 1
1948 .I EXAMPLE:
1949 .PD 0
1950 .RSs
1951 \-font ~/\:.mplayer/\:arial-14/\:font.desc
1952 .br
1953 \-font ~/\:.mplayer/\:arialuni.ttf
1954 .br
1955 \-font 'Bitstream Vera Sans'
1956 .RE
1957 .PD 1
1958 .
1959 .TP
1960 .B \-fontconfig (fontconfig only)
1961 Enables the usage of fontconfig managed fonts.
1962 .
1963 .TP
1964 .B \-forcedsubsonly
1965 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
1966 \-slang.
1967 .
1968 .TP
1969 .B \-fribidi-charset <charset name> (FriBiDi only)
1970 Specifies the character set that will be passed to FriBiDi when
1971 decoding non-UTF-8 subtitles (default: ISO8859-8).
1972 .
1973 .TP
1974 .B \-ifo <VOBsub IFO file>
1975 Indicate the file that will be used to load palette and frame size for VOBsub
1976 subtitles.
1977 .
1978 .TP
1979 .B \-noautosub
1980 Turns off automatic subtitle file loading.
1981 .
1982 .TP
1983 .B \-osd-duration <time>
1984 Set the duration of the OSD messages in ms (default: 1000).
1985 .
1986 .TP
1987 .B \-osdlevel <0\-3> (MPlayer only)
1988 Specifies which mode the OSD should start in.
1989 .PD 0
1990 .RSs
1991 .IPs 0
1992 subtitles only
1993 .IPs 1
1994 volume + seek (default)
1995 .IPs 2
1996 volume + seek + timer + percentage
1997 .IPs 3
1998 volume + seek + timer + percentage + total time
1999 .RE
2000 .PD 1
2001 .
2002 .TP
2003 .B \-overlapsub
2004 Allows the next subtitle to be displayed while the current one is
2005 still visible (default is to enable the support only for specific
2006 formats).
2007 .
2008 .TP
2009 .B \-sid <ID> (also see \-slang, \-vobsubid)
2010 Display the subtitle stream specified by <ID> (0\-31).
2011 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2012 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2013 .
2014 .TP
2015 .B \-slang <language code[,language code,...]> (also see \-sid)
2016 Specify a priority list of subtitle languages to use.
2017 Different container formats employ different language codes.
2018 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2019 three letter language codes while OGM uses a free-form identifier.
2020 MPlayer prints the available languages when run in verbose (\-v) mode.
2021 .sp 1
2022 .I EXAMPLE:
2023 .PD 0
2024 .RSs
2025 .IPs "mplayer dvd://1 \-slang hu,en"
2026 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2027 Hungarian is not available.
2028 .IPs "mplayer \-slang jpn example.mkv"
2029 Plays a Matroska file with Japanese subtitles.
2030 .RE
2031 .PD 1
2032 .
2033 .TP
2034 .B \-spuaa <mode> (OSD only)
2035 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2036 A value of 16 may be added to <mode> in order to force scaling even
2037 when original and scaled frame size already match.
2038 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2039 Available modes are:
2040 .PD 0
2041 .RSs
2042 .IPs 0
2043 none (fastest, very ugly)
2044 .IPs 1
2045 approximate (broken?)
2046 .IPs 2
2047 full (slow)
2048 .IPs 3
2049 bilinear (default, fast and not too bad)
2050 .IPs 4
2051 uses swscaler gaussian blur (looks very good)
2052 .RE
2053 .PD 1
2054 .
2055 .TP
2056 .B \-spualign <-1\-2> (OSD only)
2057 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2058 .PD 0
2059 .RSs
2060 .IPs "-1"
2061 original position
2062 .IPs " 0"
2063 Align at top (original behavior, default).
2064 .IPs " 1"
2065 Align at center.
2066 .IPs " 2"
2067 Align at bottom.
2068 .RE
2069 .PD 1
2070 .
2071 .TP
2072 .B \-spugauss <0.0\-3.0> (OSD only)
2073 Variance parameter of gaussian used by \-spuaa 4.
2074 Higher means more blur (default: 1.0).
2075 .
2076 .TP
2077 .B \-sub <subtitlefile1,subtitlefile2,...>
2078 Use/\:display these subtitle files.
2079 Only one file can be displayed at the same time.
2080 .
2081 .TP
2082 .B \-sub-bg-alpha <0\-255>
2083 Specify the alpha channel value for subtitles and OSD backgrounds.
2084 Big values mean more transparency.
2085 0 means completely transparent.
2086 .
2087 .TP
2088 .B \-sub-bg-color <0\-255>
2089 Specify the color value for subtitles and OSD backgrounds.
2090 Currently subtitles are grayscale so this value is equivalent to the
2091 intensity of the color.
2092 255 means white and 0 black.
2093 .
2094 .TP
2095 .B \-sub-demuxer <[+]name> (\-subfile only) (BETA CODE)
2096 Force subtitle demuxer type for \-subfile.
2097 Use a '+' before the name to force it, this will skip some checks!
2098 Give the demuxer name as printed by \-sub-demuxer help.
2099 For backward compatibility it also accepts the demuxer ID as defined in
2100 libmpdemux/\:demuxer.h.
2101 .
2102 .TP
2103 .B \-sub-fuzziness <mode>
2104 Adjust matching fuzziness when searching for subtitles:
2105 .PD 0
2106 .RSs
2107 .IPs 0
2108 exact match
2109 .IPs 1
2110 Load all subs containing movie name.
2111 .IPs 2
2112 Load all subs in the current directory.
2113 .RE
2114 .PD 1
2115 .
2116 .TP
2117 .B \-sub-no-text-pp
2118 Disables any kind of text post processing done after loading the subtitles.
2119 Used for debug purposes.
2120 .
2121 .TP
2122 .B \-subalign <0\-2> (OSD only)
2123 Specify which edge of the subtitles should be aligned at the height
2124 given by \-subpos.
2125 .PD 0
2126 .RSs
2127 .IPs 0
2128 Align subtitle top edge (original behavior).
2129 .IPs 1
2130 Align subtitle center.
2131 .IPs 2
2132 Align subtitle bottom edge (default).
2133 .RE
2134 .PD 1
2135 .
2136 .TP
2137 .B "\-subcc \ "
2138 Display DVD Closed Caption (CC) subtitles.
2139 These are
2140 .B not
2141 the VOB subtitles, these are special ASCII subtitles for the
2142 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2143 CC subtitles have not been spotted on DVDs from other regions so far.
2144 .
2145 .TP
2146 .B \-subcp <codepage> (iconv only)
2147 If your system supports iconv(3), you can use this option to
2148 specify the subtitle codepage.
2149 .sp 1
2150 .I EXAMPLE:
2151 .PD 0
2152 .RSs
2153 \-subcp latin2
2154 .br
2155 \-subcp cp1250
2156 .RE
2157 .PD 1
2158 .
2159 .TP
2160 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2161 You can specify your language using a two letter language code to
2162 make ENCA detect the codepage automatically.
2163 If unsure, enter anything and watch mplayer \-v output for available
2164 languages.
2165 Fallback codepage specifies the codepage to use, when autodetection fails.
2166 .sp 1
2167 .I EXAMPLE:
2168 .PD 0
2169 .RSs
2170 .IPs "\-subcp enca:cs:latin2"
2171 Guess the encoding, assuming the subtitles are Czech, fall back on
2172 latin 2, if the detection fails.
2173 .IPs "\-subcp enca:pl:cp1250"
2174 Guess the encoding for Polish, fall back on cp1250.
2175 .RE
2176 .PD 1
2177 .
2178 .TP
2179 .B \-subdelay <sec>
2180 Delays subtitles by <sec> seconds.
2181 Can be negative.
2182 .
2183 .TP
2184 .B \-subfile <filename> (BETA CODE)
2185 Currently useless.
2186 Same as \-audiofile, but for subtitle streams (OggDS?).
2187 .
2188 .TP
2189 .B \-subfont-autoscale <0\-3> (FreeType only)
2190 Sets the autoscale mode.
2191 .br
2192 .I NOTE:
2193 0 means that text scale and OSD scale are font heights in points.
2194 .sp 1
2195 The mode can be:
2196 .sp 1
2197 .PD 0
2198 .RSs
2199 .IPs 0
2200 no autoscale
2201 .IPs 1
2202 proportional to movie height
2203 .IPs 2
2204 proportional to movie width
2205 .IPs 3
2206 proportional to movie diagonal (default)
2207 .RE
2208 .PD 1
2209 .
2210 .TP
2211 .B \-subfont-blur <0\-8> (FreeType only)
2212 Sets the font blur radius (default: 2).
2213 .
2214 .TP
2215 .B \-subfont-encoding <value> (FreeType only)
2216 Sets the font encoding.
2217 When set to 'unicode', all the glyphs from the font file will be rendered and
2218 unicode will be used (default: unicode).
2219 .
2220 .TP
2221 .B \-subfont-osd-scale <0\-100> (FreeType only)
2222 Sets the autoscale coefficient of the OSD elements (default: 6).
2223 .
2224 .TP
2225 .B \-subfont-outline <0\-8> (FreeType only)
2226 Sets the font outline thickness (default: 2).
2227 .
2228 .TP
2229 .B \-subfont-text-scale <0\-100> (FreeType only)
2230 Sets the subtitle text autoscale coefficient as percentage of the
2231 screen size (default: 5).
2232 .
2233 .TP
2234 .B \-subfps <rate>
2235 Specify the framerate of the subtitle file (default: movie fps).
2236 .br
2237 .I NOTE:
2238 Only for frame-based subtitle files, i.e.\& MicroDVD format.
2239 .
2240 .TP
2241 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
2242 Specify the position of subtitles on the screen.
2243 The value is the vertical position of the subtitle in % of the screen height.
2244 .
2245 .TP
2246 .B \-subwidth <10\-100> (OSD only)
2247 Specify the maximum width of subtitles on the screen.
2248 Useful for TV-out.
2249 The value is the width of the subtitle in % of the screen width.
2250 .
2251 .TP
2252 .B \-noterm-osd
2253 Disable the display of OSD messages on the console when no video output is
2254 available.
2255 .
2256 .TP
2257 .B \-term-osd-esc <escape sequence>
2258 Specify the escape sequence to use before writing an OSD message on the
2259 console.
2260 The escape sequence should move the pointer to the beginning of the line
2261 used for the OSD and clear it (default: ^[[A\\r^[[K).
2262 .
2263 .TP
2264 .B \-unicode
2265 Tells MPlayer to handle the subtitle file as unicode.
2266 .
2267 .TP
2268 .B "\-utf8 \ \ "
2269 Tells MPlayer to handle the subtitle file as UTF-8.
2270 .
2271 .TP
2272 .B \-vobsub <VOBsub file without extension>
2273 Specify a VOBsub file to use for subtitles.
2274 Has to be the full pathname without extension, i.e.\& without
2275 the '.idx', '.ifo' or '.sub'.
2276 .
2277 .TP
2278 .B \-vobsubid <0\-31>
2279 Specify the VOBsub subtitle ID.
2280 .
2281 .
2282 .
2283 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
2284 .
2285 .TP
2286 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2287 Override audio driver/\:card buffer size detection.
2288 .
2289 .TP
2290 .B \-format <format> (also see the format audio filter)
2291 Select the sample format used for output from the audio filter
2292 layer to the sound card.
2293 The values that <format> can adopt are listed below in the
2294 description of the format audio filter.
2295 .
2296 .TP
2297 .B \-mixer <device>
2298 Use a mixer device different from the default /dev/\:mixer.
2299 For ALSA this is the mixer name.
2300 .
2301 .TP
2302 .B \-mixer-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2303 This option will tell MPlayer to use a different channel for controlling
2304 volume than the default PCM.
2305 Options for OSS include
2306 .B vol, pcm, line.
2307 For a complete list of options look for SOUND_DEVICE_NAMES in
2308 /usr/\:include/\:linux/\:soundcard.h.
2309 For ALSA you can use the names e.g.\& alsamixer displays, like
2310 .B Master, Line, PCM.
2311 .br
2312 .I NOTE:
2313 ALSA mixer channel names followed by a number must be specified in the
2314 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2315 be converted to
2316 .BR PCM,1 .
2317 .
2318 .TP
2319 .B \-softvol
2320 Force the use of the software mixer, instead of using the sound card
2321 mixer.
2322 .
2323 .TP
2324 .B \-softvol-max <10.0\-10000.0>
2325 Set the maximum amplification level in percent (default: 110).
2326 A value of 200 will allow you to adjust the volume up to a maximum of
2327 double the current level.
2328 With values below 100 the initial volume (which is 100%) will be above
2329 the maximum, which e.g.\& the OSD cannot display correctly.
2330 .
2331 .TP
2332 .B \-volstep <0\-100>
2333 Set the step size of mixer volume changes in percent of the whole range
2334 (default: 3).
2335 .
2336 .
2337 .
2338 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
2339 Audio output drivers are interfaces to different audio output facilities.
2340 The syntax is:
2341 .
2342 .TP
2343 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2344 Specify a priority list of audio output drivers to be used.
2345 .PP
2346 If the list has a trailing ',' MPlayer will fall back on drivers not
2347 contained in the list.
2348 Suboptions are optional and can mostly be omitted.
2349 .br
2350 .I NOTE:
2351 See \-ao help for a list of compiled-in audio output drivers.
2352 .sp 1
2353 .I EXAMPLE:
2354 .PD 0
2355 .RSs
2356 .IPs "\-ao alsa,oss,"
2357 Try the ALSA driver, then the OSS driver, then others.
2358 .IPs "\-ao alsa:noblock:device=hw=0.3"
2359 Sets noblock-mode and the device-name as first card, fourth device.
2360 .RE
2361 .PD 1
2362 .sp 1
2363 Available audio output drivers are:
2364 .
2365 .TP
2366 .B "alsa\ \ \ "
2367 ALSA 0.9/1.x audio output driver
2368 .PD 0
2369 .RSs
2370 .IPs noblock
2371 Sets noblock-mode.
2372 .IPs device=<device>
2373 Sets the device name.
2374 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2375 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2376 you really know how to set it correctly.
2377 .RE
2378 .PD 1
2379 .
2380 .TP
2381 .B "alsa5\ \ "
2382 ALSA 0.5 audio output driver
2383 .
2384 .TP
2385 .B "oss\ \ \ \ "
2386 OSS audio output driver
2387 .PD 0
2388 .RSs
2389 .IPs <dsp-device>
2390 Sets the audio output device (default: /dev/\:dsp).
2391 .IPs <mixer-device>
2392 Sets the audio mixer device (default: /dev/\:mixer).
2393 .IPs <mixer-channel>
2394 Sets the audio mixer channel (default: pcm).
2395 .RE
2396 .PD 1
2397 .
2398 .TP
2399 .B sdl (SDL only)
2400 highly platform independent SDL (Simple Directmedia Layer) library
2401 audio output driver
2402 .PD 0
2403 .RSs
2404 .IPs <driver>
2405 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2406 .RE
2407 .PD 1
2408 .
2409 .TP
2410 .B "arts\ \ \ "
2411 audio output through the aRts daemon
2412 .
2413 .TP
2414 .B "esd\ \ \ \ "
2415 audio output through the ESD daemon
2416 .PD 0
2417 .RSs
2418 .IPs <server>
2419 Explicitly choose the ESD server to use (default: localhost).
2420 .RE
2421 .PD 1
2422 .
2423 .TP
2424 .B "jack\ \ \ \ "
2425 audio output through JACK (Jack Audio Connection Kit)
2426 .PD 0
2427 .RSs
2428 .IPs port=<name>
2429 Connects to the ports with the given name (default: physical ports).
2430 .IPs name=<client name>
2431 Client name that is passed to JACK (default: MPlayer [<PID>]).
2432 Useful if you want to have certain connections established automatically.
2433 .IPs (no)estimate
2434 Estimate the audio delay, supposed to make the video playback smoother
2435 (default: enabled).
2436 .RE
2437 .PD 1
2438 .
2439 .TP
2440 .B "nas\ \ \ \ "
2441 audio output through NAS
2442 .
2443 .TP
2444 .B macosx (Mac OS X only)
2445 native Mac OS X audio output driver
2446 .
2447 .TP
2448 .B openal
2449 Experimental, unfinished (will downmix to mono) OpenAL audio output driver
2450 .
2451 .TP
2452 .B sgi (SGI only)
2453 native SGI audio output driver
2454 .PD 0
2455 .RSs
2456 .IPs "<output device name>"
2457 Explicitly choose the output device/\:interface to use
2458 (default: system-wide default).
2459 For example, 'Analog Out' or 'Digital Out'.
2460 .RE
2461 .PD 1
2462 .
2463 .TP
2464 .B sun (Sun only)
2465 native Sun audio output driver
2466 .PD 0
2467 .RSs
2468 .IPs <device>
2469 Explicitly choose the audio device to use (default: /dev/\:audio).
2470 .RE
2471 .PD 1
2472 .
2473 .TP
2474 .B win32 (Windows only)
2475 native Windows waveout audio output driver
2476 .
2477 .TP
2478 .B dsound (Windows only)
2479 DirectX DirectSound audio output driver
2480 .PD 0
2481 .RSs
2482 .IPs device=<devicenum>
2483 Sets the device number to use.
2484 Playing a file with \-v will show a list of available devices.
2485 .RE
2486 .PD 1
2487 .
2488 .TP
2489 .B dxr2 (also see \-dxr2) (DXR2 only)
2490 Creative DXR2 specific output driver
2491 .
2492 .TP
2493 .B ivtv (IVTV only)
2494 IVTV specific MPEG audio output driver.
2495 Works with \-ac hwmpa only.
2496 .
2497 .TP
2498 .B mpegpes (DVB only)
2499 Audio output driver for DVB cards that writes the output to an MPEG-PES
2500 file if no DVB card is installed.
2501 .PD 0
2502 .RSs
2503 .IPs card=<1\-4>
2504 DVB card to use if more than one card is present.
2505 .IPs file=<filename>
2506 output filename
2507 .RE
2508 .PD 1
2509 .
2510 .TP
2511 .B "null\ \ \ "
2512 Produces no audio output but maintains video playback speed.
2513 Use \-nosound for benchmarking.
2514 .
2515 .TP
2516 .B "pcm\ \ \ \ "
2517 raw PCM/wave file writer audio output
2518 .PD 0
2519 .RSs
2520 .IPs (no)waveheader
2521 Include or do not include the wave header (default: included).
2522 When not included, raw PCM will be generated.
2523 .IPs file=<filename>
2524 Write the sound to <filename> instead of the default
2525 audiodump.wav.
2526 If nowaveheader is specified, the default is audiodump.pcm.
2527 .IPs "fast\ "
2528 Try to dump faster than realtime.
2529 Make sure the output does not get truncated (usually with
2530 "Too many video packets in buffer" message).
2531 It is normal that you get a "Your system is too SLOW to play this!" message.
2532 .RE
2533 .PD 1
2534 .
2535 .TP
2536 .B "plugin\ \ "
2537 plugin audio output driver
2538 .
2539 .
2540 .
2541 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
2542 .
2543 .TP
2544 .B \-adapter <value>
2545 Set the graphics card that will receive the image.
2546 You can get a list of available cards when you run this option with \-v.
2547 Currently only works with the directx video output driver.
2548 .
2549 .TP
2550 .B \-bpp <depth>
2551 Override the autodetected color depth.
2552 Only supported by the fbdev, dga, svga, vesa video output drivers.
2553 .
2554 .TP
2555 .B \-border
2556 Play movie with window border and decorations.
2557 Since this is on by default, use \-noborder to disable the standard window
2558 decorations.
2559 Supported by the directx video output driver.
2560 .
2561 .TP
2562 .B \-brightness <-100\-100>
2563 Adjust the brightness of the video signal (default: 0).
2564 Not supported by all video output drivers.
2565 .
2566 .TP
2567 .B \-contrast <-100\-100>
2568 Adjust the contrast of the video signal (default: 0).
2569 Not supported by all video output drivers.
2570 .
2571 .TP
2572 .B \-display <name> (X11 only)
2573 Specify the hostname and display number of the X server you want to display
2574 on.
2575 .sp 1
2576 .I EXAMPLE:
2577 .PD 0
2578 .RSs
2579 \-display xtest.localdomain:0
2580 .RE
2581 .PD 1
2582 .
2583 .TP
2584 .B "\-dr \ \ \ "
2585 Turns on direct rendering (not supported by all codecs and video outputs)
2586 .br
2587 .I WARNING:
2588 May cause OSD/SUB corruption!
2589 .
2590 .TP
2591 .B \-dxr2 <option1:option2:...>
2592 This option is used to control the dxr2 video output driver.
2593 .RSs
2594 .IPs ar-mode=<value>
2595 aspect ratio mode (0 = normal, 1 = pan-and-scan, 2 = letterbox (default))
2596 .IPs iec958-encoded
2597 Set iec958 output mode to encoded.
2598 .IPs iec958-decoded
2599 Set iec958 output mode to decoded (default).
2600 .IPs macrovision=<value>
2601 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
2602 3 = agc 4 colorstripe)
2603 .IPs "mute\ "
2604 mute sound output
2605 .IPs unmute
2606 unmute sound output
2607 .IPs ucode=<value>
2608 path to the microcode
2609 .RE
2610 .RS
2611 .sp 1
2612 .I TV output
2613 .RE
2614 .RSs
2615 .IPs 75ire
2616 enable 7.5 IRE output mode
2617 .IPs no75ire
2618 disable 7.5 IRE output mode (default)
2619 .IPs "bw\ \ \ "
2620 b/w TV output
2621 .IPs color
2622 color TV output (default)
2623 .IPs interlaced
2624 interlaced TV output (default)
2625 .IPs nointerlaced
2626 disable interlaced TV output
2627 .IPs norm=<value>
2628 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
2629 .IPs square-pixel
2630 set pixel mode to square
2631 .IPs ccir601-pixel
2632 set pixel mode to ccir601
2633 .RE
2634 .RS
2635 .sp 1
2636 .I overlay
2637 .RE
2638 .RSs
2639 .IPs cr-left=<0\-500>
2640 Set the left cropping value (default: 50).
2641 .IPs cr-right=<0\-500>
2642 Set the right cropping value (default: 300).
2643 .IPs cr-top=<0\-500>
2644 Set the top cropping value (default: 0).
2645 .IPs cr-bottom=<0\-500>
2646 Set the bottom cropping value (default: 0).
2647 .IPs ck-[r|g|b]=<0\-255>
2648 Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.
2649 .IPs ck-[r|g|b]min=<0\-255>
2650 minimum value for the respective color key
2651 .IPs ck-[r|g|b]max=<0\-255>
2652 maximum value for the respective color key
2653 .IPs ignore-cache
2654 Ignore cached overlay settings.
2655 .IPs update-cache
2656 Update cached overlay settings.
2657 .IPs ol-osd
2658 Enable overlay onscreen display.
2659 .IPs nool-osd
2660 Disable overlay onscreen display (default).
2661 .IPs ol[h|w|x|y]-cor=<-20\-20>
2662 Adjust the overlay size (h,w) and position (x,y) in case it does not
2663 match the window perfectly (default: 0).
2664 .IPs overlay
2665 Activate overlay (default).
2666 .IPs nooverlay
2667 Activate TVout.
2668 .IPs overlay-ratio=<1\-2500>
2669 Tune the overlay (default: 1000).
2670 .RE
2671 .
2672 .TP
2673 .B \-fbmode <modename> (\-vo fbdev only)
2674 Change video mode to the one that is labeled as <modename> in
2675 /etc/\:fb.modes.
2676 .br
2677 .I NOTE:
2678 VESA framebuffer does not support mode changing.
2679 .
2680 .TP
2681 .B \-fbmodeconfig <filename> (\-vo fbdev only)
2682 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
2683 .
2684 .TP
2685 .B \-fs (also see \-zoom)
2686 Fullscreen playback (centers movie, and paints black bands around it).
2687 Not supported by all video output drivers.
2688 .
2689 .TP
2690 .B \-fsmode-dontuse <0\-31> (OBSOLETE, use the \-fs option)
2691 Try this option if you still experience fullscreen problems.
2692 .
2693 .TP
2694 .B \-fstype <type1,type2,...> (X11 only)
2695 Specify a priority list of fullscreen modes to be used.
2696 You can negate the modes by prefixing them with '\-'.
2697 If you experience problems like the fullscreen window being covered
2698 by other windows try using a different order.
2699 .br
2700 .I NOTE:
2701 See \-fstype help for a full list of available modes.
2702 .sp 1
2703 The available types are:
2704 .sp 1
2705 .PD 0
2706 .RSs
2707 .IPs above
2708 Use the _NETWM_STATE_ABOVE hint if available.
2709 .IPs below
2710 Use the _NETWM_STATE_BELOW hint if available.
2711 .IPs fullscreen
2712 Use the _NETWM_STATE_FULLSCREEN hint if available.
2713 .IPs layer
2714 Use the _WIN_LAYER hint with the default layer.
2715 .IPs layer=<0...15>
2716 Use the _WIN_LAYER hint with the given layer number.
2717 .IPs netwm
2718 Force NETWM style.
2719 .IPs "none\ "
2720 Do not set fullscreen window layer.
2721 .IPs stays_on_top
2722 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
2723 .REss
2724 .sp 1
2725 .RS
2726 .I EXAMPLE:
2727 .RE
2728 .PD 0
2729 .RSs
2730 .IPs layer,stays_on_top,above,fullscreen
2731 Default order, will be used as a fallback if incorrect or
2732 unsupported modes are specified.
2733 .IPs \-fullscreen
2734 Fixes fullscreen switching on OpenBox 1.x.
2735 .RE
2736 .PD 1
2737 .
2738 .TP
2739 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
2740 Adjust where the output is on the screen initially.
2741 The x and y specifications are in pixels measured from the top-left of the
2742 screen to the top-left of the image being displayed, however if a percentage
2743 sign is given after the argument it turns the value into a percentage of the
2744 screen size in that direction.
2745 It also supports the standard X11 \-geometry option format.
2746 If an external window is specified using the \-wid option, then the x and
2747 y coordinates are relative to the top-left corner of the window rather
2748 than the screen.
2749 .br
2750 .I NOTE:
2751 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
2752 gl, gl2, directx and tdfxfb video output drivers.
2753 .sp 1
2754 .I EXAMPLE:
2755 .PD 0
2756 .RSs
2757 .IPs 50:40
2758 Places the window at x=50, y=40.
2759 .IPs 50%:50%
2760 Places the window in the middle of the screen.
2761 .IPs "100%\ "
2762 Places the window at the middle of the right edge of the screen.
2763 .IPs 100%:100%
2764 Places the window at the bottom right corner of the screen.
2765 .RE
2766 .PD 1
2767 .
2768 .TP
2769 .B \-guiwid <window ID> (also see \-wid) (GUI only)
2770 This tells the GUI to also use an X11 window and stick itself to the bottom
2771 of the video, which is useful to embed a mini-GUI in a browser (with the
2772 MPlayer plugin for instance).
2773 .
2774 .TP
2775 .B \-hue <-100\-100>
2776 Adjust the hue of the video signal (default: 0).
2777 You can get a colored negative of the image with this option.
2778 Not supported by all video output drivers.
2779 .
2780 .TP
2781 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
2782 Specify the dotclock or pixelclock range of the monitor.
2783 .
2784 .TP
2785 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
2786 Specify the horizontal frequency range of the monitor.
2787 .
2788 .TP
2789 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
2790 Specify the vertical frequency range of the monitor.
2791 .
2792 .TP
2793 .B \-monitoraspect <ratio> (also see \-aspect)
2794 Set the aspect ratio of your monitor or TV screen.
2795 .sp 1
2796 .I EXAMPLE:
2797 .PD 0
2798 .RSs
2799 \-monitoraspect 4:3  or 1.3333
2800 .br
2801 \-monitoraspect 16:9 or 1.7777
2802 .RE
2803 .PD 1
2804 .
2805 .TP
2806 .B \-monitorpixelaspect <ratio> (also see \-aspect)
2807 Set the aspect of a single pixel of your monitor or TV screen (default: disabled).
2808 Overrides the \-monitoraspect setting.
2809 A value of 0 disables, a value of 1 means square pixels
2810 (correct for (almost?) all LCDs).
2811 .
2812 .TP
2813 .B \-nodouble
2814 Disables double buffering, mostly for debugging purposes.
2815 Double buffering fixes flicker by storing two frames in memory, and
2816 displaying one while decoding another.
2817 It can affect OSD negatively, but often removes OSD flickering.
2818 .
2819 .TP
2820 .B \-nograbpointer
2821 Do not grab the mouse pointer after a video mode change (\-vm).
2822 Useful for multihead setups.
2823 .
2824 .TP
2825 .B \-nokeepaspect
2826 Do not keep window aspect ratio when resizing windows.
2827 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
2828 Furthermore under X11 your window manager has to honor window aspect hints.
2829 .
2830 .TP
2831 .B "\-ontop\ "
2832 Makes the player window stay on top of other windows.
2833 Supported by video output drivers which use X11, except SDL,
2834 as well as directx, macosx, quartz, ggi and gl2.
2835 .
2836 .TP
2837 .B \-panscan <0.0\-1.0>
2838 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
2839 movie to make it fit a 4:3 display without black bands).
2840 The range controls how much of the image is cropped.
2841 Only works with the xv, xmga, mga, gl, gl2, quartz, macosx and xvidix
2842 video output drivers.
2843 .
2844 .TP
2845 .B \-panscanrange <-19.0\-99.0> (experimental)
2846 Change the range of the pan-and-scan functionality (default: 1).
2847 Positive values mean multiples of the default range.
2848 Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
2849 E.g. \-panscanrange -3 allows a zoom factor of up to 4.
2850 This feature is experimental.
2851 Do not report bugs unless you are using \-vo gl.
2852 .
2853 .TP
2854 .B \-refreshrate <Hz>
2855 Set the monitor refreshrate in Hz.
2856 Currently only supported by \-vo directx combined with the \-vm option.
2857 .
2858 .TP
2859 .B \-rootwin
2860 Play movie in the root window (desktop background).
2861 Desktop background images may cover the movie window, though.
2862 Only works with the x11, xv, xmga, xvidix, quartz, macosx and directx video output drivers.
2863 .
2864 .TP
2865 .B \-saturation <-100\-100>
2866 Adjust the saturation of the video signal (default: 0).
2867 You can get grayscale output with this option.
2868 Not supported by all video output drivers.
2869 .
2870 .TP
2871 .B \-screenh <pixels>
2872 Specify the vertical screen resolution for video output drivers which
2873 do not know the screen resolution like fbdev, x11 and TVout.
2874 .
2875 .TP
2876 .B \-screenw <pixels>
2877 Specify the horizontal screen resolution for video output drivers which
2878 do not know the screen resolution like fbdev, x11 and TVout.
2879 .
2880 .TP
2881 .B \-stop-xscreensaver (X11 only)
2882 Turns off xscreensaver at startup and turns it on again on exit.
2883 .
2884 .TP
2885 .B "\-vm \ \ \ "
2886 Try to change to a different video mode.
2887 Supported by the dga, x11, xv, sdl and directx video output drivers.
2888 If used with the directx video output driver the \-screenw,
2889 \-screenh, \-bpp and \-refreshrate options can be used to set
2890 the new display mode.
2891 .
2892 .TP
2893 .B "\-vsync \ \ "
2894 Enables VBI for the vesa, dfbmga and svga video output drivers.
2895 .
2896 .TP
2897 .B \-wid <window ID> (also see \-guiwid) (X11, OpenGL and DirectX only)
2898 This tells MPlayer to attach to an existing window.
2899 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
2900 .
2901 .TP
2902 .B \-xineramascreen <\-2\-...> (X11 only)
2903 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
2904 displays) this option tells MPlayer which screen to display the movie on.
2905 A value of \-2 means fullscreen across the whole virtual display, \-1 means
2906 fullscreen on the display the window currently is on.
2907 The initial position set via the \-geometry option is relative to the
2908 specified screen.
2909 Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
2910 .
2911 .TP
2912 .B \-zrbw (\-vo zr only)
2913 Display in black and white.
2914 For optimal performance, this can be combined with '\-lavdopts gray'.
2915 .
2916 .TP
2917 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
2918 Select a part of the input image to display, multiple occurrences
2919 of this option switch on cinerama mode.
2920 In cinerama mode the movie is distributed over more than one TV
2921 (or beamer) to create a larger image.
2922 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
2923 card should at least have a \-zrdev in addition to the \-zrcrop.
2924 For examples, see the output of \-zrhelp and the Zr section of the
2925 documentation.
2926 .
2927 .TP
2928 .B \-zrdev <device> (\-vo zr only)
2929 Specify the device special file that belongs to your MJPEG card, by default
2930 the zr video output driver takes the first v4l device it can find.
2931 .
2932 .TP
2933 .B \-zrfd (\-vo zr only)
2934 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
2935 happens if the hardware scaler can stretch the image to its original size.
2936 Use this option to force decimation.
2937 .
2938 .TP
2939 .B \-zrhdec <1|2|4> (\-vo zr only)
2940 Horizontal decimation: Ask the driver to send only every 2nd or 4th
2941 line/\:pixel of the input image to the MJPEG card and use the scaler
2942 of the MJPEG card to stretch the image to its original size.
2943 .
2944 .TP
2945 .B \-zrhelp (\-vo zr only)
2946 Display a list of all \-zr* options, their default values and a
2947 cinerama mode example.
2948 .
2949 .TP
2950 .B \-zrnorm <norm> (\-vo zr only)
2951 Specify the TV norm as PAL or NTSC (default: no change).
2952 .
2953 .TP
2954 .B \-zrquality <1\-20> (\-vo zr only)
2955 A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
2956 .
2957 .TP
2958 .B \-zrvdec <1|2|4> (\-vo zr only)
2959 Vertical decimation: Ask the driver to send only every 2nd or 4th
2960 line/\:pixel of the input image to the MJPEG card and use the scaler
2961 of the MJPEG card to stretch the image to its original size.
2962 .
2963 .TP
2964 .B \-zrxdoff <x display offset> (\-vo zr only)
2965 If the movie is smaller than the TV screen, this option specifies the x
2966 offset from the upper-left corner of the TV screen (default: centered).
2967 .
2968 .TP
2969 .B \-zrydoff <y display offset> (\-vo zr only)
2970 If the movie is smaller than the TV screen, this option specifies the y
2971 offset from the upper-left corner of the TV screen (default: centered).
2972 .
2973 .
2974 .
2975 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
2976 Video output drivers are interfaces to different video output facilities.
2977 The syntax is:
2978 .
2979 .TP
2980 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
2981 Specify a priority list of video output drivers to be used.
2982 .PP
2983 If the list has a trailing ',' MPlayer will fall back on drivers not
2984 contained in the list.
2985 Suboptions are optional and can mostly be omitted.
2986 .br
2987 .I NOTE:
2988 See \-vo help for a list of compiled-in video output drivers.
2989 .sp 1
2990 .I EXAMPLE:
2991 .PD 0
2992 .RSs
2993 .IPs "\-vo xmga,xv,"
2994 Try the Matrox X11 driver, then the Xv driver, then others.
2995 .IPs "\-vo directx:noaccel"
2996 Uses the DirectX driver with acceleration features turned off.
2997 .RE
2998 .PD 1
2999 .sp 1
3000 Available video output drivers are:
3001 .
3002 .TP
3003 .B xv (X11 only)
3004 Uses the XVideo extension of XFree86 4.x to enable hardware
3005 accelerated playback.
3006 If you cannot use a hardware specific driver, this is probably
3007 the best option.
3008 For information about what colorkey is used and how it is drawn run MPlayer
3009 with \-v option and look out for the lines tagged with [xv common] at the
3010 beginning.
3011 .PD 0
3012 .RSs
3013 .IPs port=<number>
3014 Select a specific XVideo port.
3015 .IPs ck=<cur|use|set>
3016 Select the source from which the colorkey is taken (default: cur).
3017 .RSss
3018 .IPs cur
3019 The default takes the colorkey currently set in Xv.
3020 .IPs use
3021 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
3022 it).
3023 .IPs set
3024 Same as use but also sets the supplied colorkey.
3025 .RE
3026 .IPs ck-method=<man|bg|auto>
3027 Sets the colorkey drawing method (default: man).
3028 .RSss
3029 .IPs man
3030 Draw the colorkey manually (reduces flicker in some cases).
3031 .IPs bg
3032 Set the colorkey as window background.
3033 .IPs auto
3034 Let Xv draw the colorkey.
3035 .RE
3036 .RE
3037 .PD 1
3038 .
3039 .TP
3040 .B x11 (X11 only)
3041 Shared memory video output driver without hardware acceleration that
3042 works whenever X11 is present.
3043 .
3044 .TP
3045 .B xover (X11 only)
3046 Adds X11 support to all overlay based video output drivers.
3047 Currently only supported by tdfx_vid.
3048 .PD 0
3049 .RSs
3050 .IPs <vo_driver>
3051 Select the driver to use as source to overlay on top of X11.
3052 .RE
3053 .PD 1
3054 .
3055 .TP
3056 .B xvmc (X11 with \-vc ffmpeg12mc only)
3057 Video output driver that uses the XvMC (X Video Motion Compensation)
3058 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
3059 .PD 0
3060 .RSs
3061 .IPs port=<number>
3062 Select a specific XVideo port.
3063 .IPs (no)benchmark
3064 Disables image display.
3065 Necessary for proper benchmarking of drivers that change
3066 image buffers on monitor retrace only (nVidia).
3067 Default is not to disable image display (nobenchmark).
3068 .IPs (no)bobdeint
3069 Very simple deinterlacer.
3070 Might not look better than \-vf tfields=1,
3071 but it is the only deinterlacer for xvmc (default: nobobdeint).
3072 .IPs (no)queue
3073 Queue frames for display to allow more parallel work of the video hardware.
3074 May add a small (not noticeable) constant A/V desync (default: noqueue).
3075 .IPs (no)sleep
3076 Use sleep function while waiting for rendering to finish
3077 (not recommended on Linux) (default: nosleep).
3078 .IPs ck=cur|use|set
3079 Same as \-vo xv:ck (see \-vo xv).
3080 .IPs ck-method=man|bg|auto
3081 Same as \-vo xv:ck-method (see \-vo xv).
3082 .RE
3083 .PD 1
3084 .
3085 .TP
3086 .B dga (X11 only)
3087 Play video through the XFree86 Direct Graphics Access extension.
3088 Considered obsolete.
3089 .
3090 .TP
3091 .B sdl (SDL only)
3092 Highly platform independent SDL (Simple Directmedia Layer) library
3093 video output driver.
3094 Since SDL uses its own X11 layer, MPlayer X11 options do not have
3095 any effect on SDL.
3096 .PD 0
3097 .RSs
3098 .IPs driver=<driver>
3099 Explicitly choose the SDL driver to use.
3100 .IPs (no)forcexv
3101 Use XVideo through the sdl video output driver (default: forcexv).
3102 .IPs (no)hwaccel
3103 Use hardware accelerated scaler (default: hwaccel).
3104 .RE
3105 .PD 1
3106 .
3107 .TP
3108 .B "vidix\ \ "
3109 VIDIX (VIDeo Interface for *niX) is an interface to the
3110 video acceleration features of different graphics cards.
3111 Very fast video output driver on cards that support it.
3112 .PD 0
3113 .RSs
3114 .IPs <subdevice>
3115 Explicitly choose the VIDIX subdevice driver to use.
3116 Available subdevice drivers are cyberblade_vid.so, mach64_vid.so,
3117 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so,
3118 radeon_vid.so, rage128_vid.so, sis_vid.so and unichrome_vid.so.
3119 .RE
3120 .PD 1
3121 .
3122 .TP
3123 .B xvidix (X11 only)
3124 X11 frontend for VIDIX
3125 .PD 0
3126 .RSs
3127 .IPs <subdevice>
3128 same as vidix
3129 .RE
3130 .PD 1
3131 .
3132 .TP
3133 .B "cvidix\ "
3134 Generic and platform independent VIDIX frontend, can even run in a
3135 text console with nVidia cards.
3136 .PD 0
3137 .RSs
3138 .IPs <subdevice>
3139 same as vidix
3140 .RE
3141 .PD 1
3142 .
3143 .TP
3144 .B winvidix (Windows only)
3145 Windows frontend for VIDIX
3146 .PD 0
3147 .RSs
3148 .IPs <subdevice>
3149 same as vidix
3150 .RE
3151 .PD 1
3152 .
3153 .TP
3154 .B directx (Windows only)
3155 Video output driver that uses the DirectX interface.
3156 .PD 0
3157 .RSs
3158 .IPs noaccel
3159 Turns off hardware acceleration.
3160 Try this option if you have display problems.
3161 .RE
3162 .PD 1
3163 .
3164 .TP
3165 .B quartz (Mac OS X only)
3166 Mac OS X Quartz video output driver.
3167 Under some circumstances, it might be more efficient to force a
3168 packed YUV output format, with e.g.\& \-vf format=yuy2.
3169 .PD 0
3170 .RSs
3171 .IPs device_id=<number>
3172 Choose the display device to use in fullscreen.
3173 .IPs fs_res=<width>:<height>
3174 Specify the fullscreen resolution (useful on slow systems).
3175 .RE
3176 .PD 1
3177 .
3178 .TP
3179 .B macosx (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
3180 Mac OS X CoreVideo video output driver
3181 .PD 0
3182 .RSs
3183 .IPs device_id=<number>
3184 Choose the display device to use in fullscreen.
3185 .RE
3186 .PD 1
3187 .
3188 .TP
3189 .B fbdev (Linux only)
3190 Uses the kernel framebuffer to play video.
3191 .PD 0
3192 .RSs
3193 .IPs <device>
3194 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
3195 name of the VIDIX subdevice if the device name starts with 'vidix'
3196 (e.g.\& 'vidixsis_vid' for the sis driver).
3197 .RE
3198 .PD 1
3199 .
3200 .TP
3201 .B fbdev2 (Linux only)
3202 Uses the kernel framebuffer to play video,
3203 alternative implementation.
3204 .PD 0
3205 .RSs
3206 .IPs <device>
3207 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3208 .RE
3209 .PD 1
3210 .
3211 .TP
3212 .B "vesa\ \ \ "
3213 Very general video output driver that should work on any VESA VBE 2.0
3214 compatible card.
3215 .PD 0
3216 .RSs
3217 .IPs "dga\ \ "
3218 Turns on DGA mode.
3219 .IPs nodga
3220 Turns off DGA mode.
3221 .IPs neotv_pal
3222 Activate the NeoMagic TV out and set it to PAL norm.
3223 .IPs neotv_ntsc
3224 Activate the NeoMagic TV out and set it to NTSC norm.
3225 .IPs vidix
3226 Use the VIDIX driver.
3227 .IPs "lvo:\ \ \ "
3228 Activate the Linux Video Overlay on top of VESA mode.
3229 .RE
3230 .PD 1
3231 .
3232 .TP
3233 .B "svga\ \ \ "
3234 Play video using the SVGA library.
3235 .PD 0
3236 .RSs
3237 .IPs "<video mode>"
3238 Specify video mode to use.
3239 The mode can be given in a <width>x<height>x<colors> format,
3240 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
3241 .IPs bbosd
3242 Draw OSD into black bands below the movie (slower).
3243 .IPs native
3244 Use only native drawing functions.
3245 This avoids direct rendering, OSD and hardware acceleration.
3246 .IPs retrace
3247 Force frame switch on vertical retrace.
3248 Usable only with \-double.
3249 It has the same effect as the \-vsync option.
3250 .IPs "sq\ \ \ "
3251 Try to select a video mode with square pixels.
3252 .IPs vidix
3253 Use svga with VIDIX.
3254 .RE
3255 .PD 1
3256 .
3257 .TP
3258 .B "gl\ \ \ \ \ "
3259 OpenGL video output driver, simple version.
3260 Video size must be smaller than
3261 the maximum texture size of your OpenGL implementation.
3262 Intended to work even with the most basic OpenGL implementations,
3263 but also makes use of newer extensions, which allow support for more
3264 colorspaces and direct rendering.
3265 Please use \-dr if it works with your OpenGL implementation,
3266 since for higher resolutions this provides a
3267 .B big
3268 speedup.
3269 The code performs very few checks, so if a feature does not work, this
3270 might be because it is not supported by your card/OpenGL implementation
3271 even if you do not get any error message.
3272 Use glxinfo or a similar tool to display the supported OpenGL extensions.
3273 .PD 0
3274 .RSs
3275 .IPs (no)manyfmts
3276 Enables support for more (RGB and BGR) color formats (default: enabled).
3277 Needs OpenGL version >= 1.2.
3278 .IPs slice-height=<0\-...>
3279 Number of lines copied to texture in one piece (default: 4).
3280 0 for whole image.
3281 .br
3282 .I NOTE:
3283 If YUV colorspace is used (see yuv suboption), special rules apply:
3284 .RSss
3285 If the decoder uses slice rendering (see \-noslices), this setting
3286 has no effect, the size of the slices as provided by the decoder is used.
3287 .br
3288 If the decoder does not use slice rendering, the default is 16.
3289 .RE
3290 .IPs (no)osd
3291 Enable or disable support for OSD rendering via OpenGL (default: enabled).
3292 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
3293 .IPs (no)scaled-osd
3294 Changes the way the OSD behaves when the size of the
3295 window changes (default: disabled).
3296 When enabled behaves more like the other video output drivers,
3297 which is better for fixed-size fonts.
3298 Disabled looks much better with FreeType fonts and uses the
3299 borders in fullscreen mode.
3300 Does not work correctly with ass subtitles (see \-ass).
3301 .IPs osdcolor=<0xRRGGBB>
3302 Color for OSD (default: 0xffffff, corresponds to white).
3303 .IPs (no)aspect
3304 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
3305 Disabling might increase speed.
3306 .IPs rectangle=<0,1,2>
3307 Select usage of rectangular textures which saves video RAM, but often is
3308 slower (default: 0).
3309 .RSss
3310 0: Use power-of-two textures (default).
3311 .br
3312 1: Use the GL_ARB_texture_rectangle extension.
3313 .br
3314 2: Use the GL_ARB_texture_non_power_of_two extension.
3315 In some cases only supported in software and thus very slow.
3316 .RE
3317 .IPs (no)glfinish
3318 Call glFinish() before swapping buffers.
3319 Slower but in some cases more correct output (default: disabled).
3320 .IPs swapinterval=<n>
3321 Minimum interval between two buffer swaps, counted in
3322 displayed frames (default: 1).
3323 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
3324 Values below 0 will leave it at the system default.
3325 This limits the framerate to (horizontal refresh rate / n).
3326 Requires GLX_SGI_swap_control support to work.
3327 With some (most/all?) implementations this only works in fullscreen mode.
3328 .IPs yuv=<n>
3329 Select the type of YUV to RGB conversion.
3330 .RSss
3331 0: Use software conversion (default).
3332 Compatible with all OpenGL versions.
3333 Provides brightness, contrast and saturation control.
3334 .br
3335 1: Use register combiners.
3336 This uses an nVidia-specific extension (GL_NV_register_combiners).
3337 At least three texture units are needed.
3338 Provides saturation and hue control.
3339 This method is fast but inexact.
3340 .br
3341 2: Use a fragment program.
3342 Needs the GL_ARB_fragment_program extension and at least three texture units.
3343 Provides brightness, contrast, saturation and hue control.
3344 .br
3345 3: Use a fragment program using the POW instruction.
3346 Needs the GL_ARB_fragment_program extension and at least three texture units.
3347 Provides brightness, contrast, saturation, hue and gamma control.
3348 Gamma can also be set independently for red, green and blue.
3349 Method 4 is usually faster.
3350 .br
3351 4: Use a fragment program with additional lookup.
3352 Needs the GL_ARB_fragment_program extension and at least four texture units.
3353 Provides brightness, contrast, saturation, hue and gamma control.
3354 Gamma can also be set independently for red, green and blue.
3355 .br
3356 5: Use ATI-specific method (for older cards).
3357 This uses an ATI-specific extension (GL_ATI_fragment_shader - not
3358 GL_ARB_fragment_shader!).
3359 At least three texture units are needed.
3360 Provides saturation and hue control.
3361 This method is fast but inexact.
3362 .br
3363 6: Use a 3D texture to do conversion via lookup.
3364 Needs the GL_ARB_fragment_program extension and at least four texture units.
3365 Extremely slow (software emulation) on some (all?) ATI cards since it uses
3366 a texture with border pixels.
3367 Provides brightness, contrast, saturation, hue and gamma control.
3368 Gamma can also be set independently for red, green and blue.
3369 Speed depends more on GPU memory bandwidth than other methods.
3370 .RE
3371 .IPs lscale=<n>
3372 Select the scaling function to use for luminance scaling.
3373 Only valid for yuv modes 2, 3, 4 and 6.
3374 .RSss
3375 0: Use simple linear filtering (default).
3376 .br
3377 1: Use bicubic filtering (better quality).
3378 Needs one additional texture unit.
3379 Older cards will not be able to handle this for chroma at least in fullscreen mode.
3380 .RE
3381 .IPs cscale=<n>
3382 Select the scaling function to use for chrominance scaling.
3383 For details see lscale.
3384 .IPs customprog=<filename>
3385 Load a custom fragment program from <filename>.
3386 See TOOLS/edgedect.fp for an example.
3387 .IPs customtex=<filename>
3388 Load a custom "gamma ramp" texture from <filename>.
3389 This can be used in combination with yuv=4 or with the customprog option.
3390 .IPs (no)customtlin
3391 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
3392 for customtex texture.
3393 .IPs (no)customtrect
3394 If enabled, use texture_rectangle for customtex texture.
3395 Default is disabled.
3396 .REss
3397 .RE
3398 .PD 1
3399 .
3400 .TP
3401 .B "gl2\ \ \ \ "
3402 OpenGL video output driver, second generation.
3403 Supports OSD and videos larger than the maximum texture size.
3404 .PD 0
3405 .RSs
3406 .IPs (no)glfinish
3407 same as gl (default: enabled)
3408 .IPs yuv=<n>
3409 Select the type of YUV to RGB conversion.
3410 If set to anything except 0 OSD will be disabled and brightness, contrast and
3411 gamma setting is only available via the global X server settings.
3412 Apart from this the values have the same meaning as for \-vo gl.
3413 .REss
3414 .
3415 .TP
3416 .B "null\ \ \ "
3417 Produces no video output.
3418 Useful for benchmarking.
3419 .
3420 .TP
3421 .B "aa\ \ \ \ \ "
3422 ASCII art video output driver that works on a text console.
3423 You can get a list and an explanation of available suboptions executing
3424 .I mplayer \-vo aa:help
3425 .
3426 .TP
3427 .B "caca\ \ \ "
3428 Color ASCII art video output driver that works on a text console.
3429 .
3430 .TP
3431 .B "bl\ \ \ \ \ "
3432 Video playback using the Blinkenlights UDP protocol.
3433 This driver is highly hardware specific.
3434 .PD 0
3435 .RSs
3436 .IPs <subdevice>
3437 Explicitly choose the Blinkenlights subdevice driver to use.
3438 It is something like arcade:host=localhost:2323 or
3439 hdl:file=name1,file=name2.
3440 You must specify a subdevice.
3441 .RE
3442 .PD 1
3443 .
3444 .TP
3445 .B "ggi\ \ \ \ "
3446 GGI graphics system video output driver
3447 .PD 0
3448 .RSs
3449 .IPs <driver>
3450 Explicitly choose the GGI driver to use.
3451 Replace any ',' that would appear in the driver string by a '.'.
3452 .RE
3453 .PD 1
3454 .
3455 .TP
3456 .B directfb
3457 Play video using the DirectFB library.
3458 .PD 0
3459 .RSs
3460 .IPs (no)input
3461 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
3462 .IPs buffermode=single|double|triple
3463 Double and triple buffering give best results if you want to avoid tearing issues.
3464 Triple buffering is more efficient than double buffering as it does
3465 not block MPlayer while waiting for the vertical retrace.
3466 Single buffering should be avoided (default: single).
3467 .IPs fieldparity=top|bottom
3468 Control the output order for interlaced frames (default: disabled).
3469 Valid values are top = top fields first, bottom = bottom fields first.
3470 This option does not have any effect on progressive film material
3471 like most MPEG movies are.
3472 You need to enable this option if you have tearing issues or unsmooth
3473 motions watching interlaced film material.
3474 .IPs layer=N
3475 Will force layer with ID N for playback (default: -1 - auto).
3476 .IPs dfbopts=<list>
3477 Specify a parameter list for DirectFB.
3478 .RE
3479 .PD 1
3480 .
3481 .TP
3482 .B "dfbmga\ "
3483 Matrox G400/\:G450/\:G550 specific video output driver that uses the
3484 DirectFB library to make use of special hardware features.
3485 Enables CRTC2 (second head), displaying video independently of the first head.
3486 .PD 0
3487 .RSs
3488 .IPs (no)input
3489 same as directfb (default: disabled)
3490 .IPs buffermode=single|double|triple
3491 same as directfb (default: triple)
3492 .IPs fieldparity=top|bottom
3493 same as directfb
3494 .IPs (no)bes
3495 Enable the use of the Matrox BES (backend scaler) (default: disabled).
3496 Gives very good results concerning speed and output quality as interpolated
3497 picture processing is done in hardware.
3498 Works only on the primary head.
3499 .IPs (no)spic
3500 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
3501 .IPs (no)crtc2
3502 Turn on TV-out on the second head (default: enabled).
3503 The output quality is amazing as it is a full interlaced picture
3504 with proper sync to every odd/\:even field.
3505 .IPs tvnorm=pal|ntsc|auto
3506 Will set the TV norm of the Matrox card without the need
3507 for modifying /etc/\:directfbrc (default: disabled).
3508 Valid norms are pal = PAL, ntsc = NTSC.
3509 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
3510 which norm to use by looking at the framerate of the movie.
3511 .RE
3512 .PD 1
3513 .
3514 .TP
3515 .B mga (Linux only)
3516 Matrox specific video output driver that makes use of the YUV back
3517 end scaler on Gxxx cards through a kernel module.
3518 If you have a Matrox card, this is the fastest option.
3519 .PD 0
3520 .RSs
3521 .IPs <device>
3522 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
3523 .RE
3524 .PD 1
3525 .
3526 .TP
3527 .B xmga (Linux, X11 only)
3528 The mga video output driver, running in an X11 window.
3529 .PD 0
3530 .RSs
3531 .IPs <device>
3532 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
3533 .RE
3534 .PD 1
3535 .
3536 .TP
3537 .B "syncfb\ "
3538 Video output driver for the SyncFB kernel module, which provides
3539 special hardware features of Matrox Gxxx cards like hardware
3540 deinterlacing, scaling and synchronizing your video output to
3541 the vertical retrace of your monitor.
3542 .
3543 .TP
3544 .B 3dfx (Linux only)
3545 3dfx specific video output driver.
3546 This driver directly uses the 3dfx hardware on top of X11.
3547 Only 16 bpp are supported.
3548 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3549 .
3550 .TP
3551 .B tdfxfb (Linux only)
3552 This driver employs the tdfx framebuffer driver to play movies with
3553 YUV acceleration on 3dfx cards.
3554 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3555 .PD 0
3556 .RSs
3557 .IPs <device>
3558 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3559 .RE
3560 .PD 1
3561 .
3562 .TP
3563 .B tdfx_vid (Linux only)
3564 3dfx specific video output driver.
3565 This driver directly uses the tdfx_vid kernel module.
3566 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3567 .PD 0
3568 .RSs
3569 .IPs <device>
3570 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
3571 .RE
3572 .PD 1
3573 .
3574 .TP
3575 .B dxr2 (also see \-dxr2) (DXR2 only)
3576 Creative DXR2 specific video output driver.
3577 .PD 0
3578 .RSs
3579 .IPs <vo_driver>
3580 Output video subdriver to use as overlay (x11, xv).
3581 .RE
3582 .PD 1
3583 .
3584 .TP
3585 .B dxr3 (DXR3 only)
3586 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
3587 Hollywood Plus) specific video output driver.
3588 Also see the lavc video filter.
3589 .PD 0
3590 .RSs
3591 .IPs overlay
3592 Activates the overlay instead of TVOut.
3593 .IPs prebuf
3594 Turns on prebuffering.
3595 .IPs "sync\ "
3596 Will turn on the new sync-engine.
3597 .IPs norm=<norm>
3598 Specifies the TV norm.
3599 .RSss
3600 0: Does not change current norm (default).
3601 .br
3602 1: Auto-adjust using PAL/\:NTSC.
3603 .br
3604 2: Auto-adjust using PAL/\:PAL-60.
3605 .br
3606 3: PAL
3607 .br
3608 4: PAL-60
3609 .br
3610 5: NTSC
3611 .REss
3612 .IPs <0\-3>
3613 Specifies the device number to use if you have more than one em8300 card.
3614 .RE
3615 .PD 1
3616 .
3617 .TP
3618 .B ivtv (IVTV only)
3619 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
3620 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
3621 specific video output driver for TV-Out.
3622 Also see the lavc video filter.
3623 .PD 0
3624 .RSs
3625 .IPs device
3626 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
3627 .IPs output
3628 Explicitly choose the TV-Out output to be used for the video signal.
3629 .RE
3630 .PD 1
3631 .
3632 .TP
3633 .B mpegpes (DVB only)
3634 Video output driver for DVB cards that writes the output to an MPEG-PES file
3635 if no DVB card is installed.
3636 .PD 0
3637 .RSs
3638 .IPs card=<1\-4>
3639 Specifies the device number to use if you have more than one DVB output card
3640 (V3 API only, such as 1.x.y series drivers).
3641 .IPs <filename>
3642 output filename (default: ./grab.mpg)
3643 .RE
3644 .PD 1
3645 .
3646 .TP
3647 .B zr (also see \-zr* and \-zrhelp)
3648 Video output driver for a number of MJPEG capture/\:playback cards.
3649 .
3650 .TP
3651 .B zr2 (also see the zrmjpeg video filter)
3652 Video output driver for a number of MJPEG capture/\:playback cards,
3653 second generation.
3654 .PD 0
3655 .RSs
3656 .IPs dev=<device>
3657 Specifies the video device to use.
3658 .IPs norm=<PAL|NTSC|SECAM|auto>
3659 Specifies the video norm to use (default: auto).
3660 .IPs (no)prebuf
3661 (De)Activate prebuffering, not yet supported.
3662 .RE
3663 .PD 1
3664 .
3665 .TP
3666 .B "md5sum\ "
3667 Calculate MD5 sums of each frame and write them to a file.
3668 Supports RGB24 and YV12 colorspaces.
3669 Useful for debugging.
3670 .PD 0
3671 .RSs
3672 .IPs outfile=<value>
3673 Specify the output filename (default: ./md5sums).
3674 .RE
3675 .PD 1
3676 .
3677 .TP
3678 .B yuv4mpeg
3679 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
3680 images and stores it in a file (default: ./stream.yuv).
3681 The format is the same as the one employed by mjpegtools, so this is
3682 useful if you want to process the video with the mjpegtools suite.
3683 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
3684 You can combine it with the \-fixed-vo option to concatenate files
3685 with the same dimensions and fps value.
3686 .PD 0
3687 .RSs
3688 .IPs interlaced
3689 Write the output as interlaced frames, top field first.
3690 .IPs interlaced_bf
3691 Write the output as interlaced frames, bottom field first.
3692 .IPs file=<filename>
3693 Write the output to <filename> instead of the default stream.yuv.
3694 .REss
3695 .PD 1
3696 .RS
3697 .sp 1
3698 .I NOTE:
3699 If you do not specify any option the output is progressive
3700 (i.e.\& not interlaced).
3701 .RE
3702 .
3703 .TP
3704 .B "gif89a\ "
3705 Output each frame into a single animated GIF file in the current directory.
3706 It supports only RGB format with 24 bpp and the output is converted to 256
3707 colors.
3708 .PD 0
3709 .RSs
3710 .IPs <fps>
3711 Float value to specify framerate (default: 5.0).
3712 .IPs <filename>
3713 Specify the output filename (default: ./out.gif).
3714 .REss
3715 .PD 1
3716 .RS
3717 .sp 1
3718 .I NOTE:
3719 You must specify the framerate before the filename or the framerate will
3720 be part of the filename.
3721 .sp 1
3722 .I EXAMPLE:
3723 .RE
3724 .PD 0
3725 .RSs
3726 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif
3727 .RE
3728 .PD 1
3729 .
3730 .TP
3731 .B "jpeg\ \ \ "
3732 Output each frame into a JPEG file in the current directory.
3733 Each file takes the frame number padded with leading zeros as name.
3734 .PD 0
3735 .RSs
3736 .IPs [no]progressive
3737 Specify standard or progressive JPEG (default: noprogressive).
3738 .IPs [no]baseline
3739 Specify use of baseline or not (default: baseline).
3740 .IPs optimize=<0\-100>
3741 optimization factor (default: 100)
3742 .IPs smooth=<0\-100>
3743 smooth factor (default: 0)
3744 .IPs quality=<0\-100>
3745 quality factor (default: 75)
3746 .IPs outdir=<dirname>
3747 Specify the directory to save the JPEG files to (default: ./).
3748 .IPs subdirs=<prefix>
3749 Create numbered subdirectories with the specified prefix to
3750 save the files in instead of the current directory.
3751 .IPs maxfiles=<value> (subdirs only)
3752 Maximum number of files to be saved per subdirectory.
3753 Must be equal to or larger than 1 (default: 1000).
3754 .RE
3755 .PD 1
3756 .
3757 .TP
3758 .B "pnm\ \ \ \ "
3759 Output each frame into a PNM file in the current directory.
3760 Each file takes the frame number padded with leading zeros as name.
3761 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
3762 Also see pnm(5), ppm(5) and pgm(5).
3763 .PD 0
3764 .RSs
3765 .IPs "ppm\ \ "
3766 Write PPM files (default).
3767 .IPs "pgm\ \ "
3768 Write PGM files.
3769 .IPs pgmyuv
3770 Write PGMYUV files.
3771 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
3772 bottom of the picture.
3773 .IPs "raw\ \ "
3774 Write PNM files in raw mode (default).
3775 .IPs ascii
3776 Write PNM files in ASCII mode.
3777 .IPs outdir=<dirname>
3778 Specify the directory to save the PNM files to (default: ./).
3779 .IPs subdirs=<prefix>
3780 Create numbered subdirectories with the specified prefix to
3781 save the files in instead of the current directory.
3782 .IPs maxfiles=<value> (subdirs only)
3783 Maximum number of files to be saved per subdirectory.
3784 Must be equal to or larger than 1 (default: 1000).
3785 .RE
3786 .PD 1
3787 .
3788 .TP
3789 .B "png\ \ \ \ "
3790 Output each frame into a PNG file in the current directory.
3791 Each file takes the frame number padded with leading zeros as name.
3792 24bpp RGB and BGR formats are supported.
3793 .PD 0
3794 .RSs
3795 .IPs z=<0-9>
3796 Specifies the compression level.
3797 0 is no compression, 9 is maximum compression.
3798 .RE
3799 .PD 1
3800 .
3801 .TP
3802 .B "tga\ \ \ \ "
3803 Output each frame into a Targa file in the current directory.
3804 Each file takes the frame number padded with leading zeros as name.
3805 The purpose of this video output driver is to have a simple lossless
3806 image writer to use without any external library.
3807 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
3808 You can force a particular format with the format video filter.
3809 .sp 1
3810 .I EXAMPLE:
3811 .RE
3812 .PD 0
3813 .RSs
3814 mplayer video.nut \-vf format=bgr15 \-vo tga
3815 .RE
3816 .PD 1
3817 .
3818 .
3819 .
3820 .SH "DECODING/FILTERING OPTIONS"
3821 .
3822 .TP
3823 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]>
3824 Specify a priority list of audio codecs to be used, according to their codec
3825 name in codecs.conf.
3826 Use a '-' before the codec name to omit it.
3827 Use a '+' before the codec name to force it, this will likely crash!
3828 If the list has a trailing ',' MPlayer will fall back on codecs not
3829 contained in the list.
3830 .br
3831 .I NOTE:
3832 See \-ac help for a full list of available codecs.
3833 .sp 1
3834 .I EXAMPLE:
3835 .PD 0
3836 .RSs
3837 .IPs "\-ac mp3acm"
3838 Force the l3codeca.acm MP3 codec.
3839 .IPs "\-ac mad,"
3840 Try libmad first, then fall back on others.
3841 .IPs "\-ac hwac3,a52,"
3842 Try hardware AC3 passthrough, software AC3, then others.
3843 .IPs "\-ac hwdts,"
3844 Try hardware DTS passthrough, then fall back on others.
3845 .IPs "\-ac -ffmp3,"
3846 Skip FFmpeg's MP3 decoder.
3847 .RE
3848 .PD 1
3849 .
3850 .TP
3851 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af)
3852 Specify advanced audio filter options:
3853 .RSs
3854 .IPs force=<0\-7>
3855 Forces the insertion of audio filters to one of the following:
3856 .RSss
3857 0: Use completely automatic filter insertion.
3858 .br
3859 1: Optimize for accuracy (default).
3860 .br
3861 2: Optimize for speed.
3862 .I Warning:
3863 Some features in the audio filters may silently fail,
3864 and the sound quality may drop.
3865 .br
3866 3: Use no automatic insertion of filters and no optimization.
3867 .I Warning:
3868 It may be possible to crash MPlayer using this setting.
3869 .br
3870 4: Use automatic insertion of filters according to 0 above,
3871 but use floating point processing when possible.
3872 .br
3873 5: Use automatic insertion of filters according to 1 above,
3874 but use floating point processing when possible.
3875 .br
3876 6: Use automatic insertion of filters according to 2 above,
3877 but use floating point processing when possible.
3878 .br
3879 7: Use no automatic insertion of filters according to 3 above,
3880 and use floating point processing when possible.
3881 .REss
3882 .IPs list=<filters>
3883 Same as \-af.
3884 .RE
3885 .
3886 .TP
3887 .B \-afm <driver1,driver2,...>
3888 Specify a priority list of audio codec families to be used, according
3889 to their codec name in codecs.conf.
3890 Falls back on the default codecs if none of the given codec families work.
3891 .br
3892 .I NOTE:
3893 See \-afm help for a full list of available codec families.
3894 .sp 1
3895 .I EXAMPLE:
3896 .PD 0
3897 .RSs
3898 .IPs "\-afm ffmpeg"
3899 Try FFmpeg's libavcodec codecs first.
3900 .IPs "\-afm acm,dshow"
3901 Try Win32 codecs first.
3902 .RE
3903 .PD 1
3904 .
3905 .TP
3906 .B \-aspect <ratio> (also see \-zoom)
3907 Override movie aspect ratio, in case aspect information is
3908 incorrect or missing in the file being played.
3909 .sp 1
3910 .I EXAMPLE:
3911 .PD 0
3912 .RSs
3913 \-aspect 4:3  or \-aspect 1.3333
3914 .br
3915 \-aspect 16:9 or \-aspect 1.7777
3916 .RE
3917 .PD 1
3918 .
3919 .TP
3920 .B \-noaspect
3921 Disable automatic movie aspect ratio compensation.
3922 .
3923 .TP
3924 .B "\-flip \ "
3925 Flip image upside-down.
3926 .
3927 .TP
3928 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
3929 Specify libavcodec decoding parameters.
3930 Separate multiple options with a colon.
3931 .sp 1
3932 .I EXAMPLE:
3933 .PD 0
3934 .RSs
3935 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
3936 .RE
3937 .PD 1
3938 .sp 1
3939 .RS
3940 Available options are:
3941 .RE
3942 .RSs
3943 .IPs bitexact
3944 Only use bit-exact algorithms in all decoding steps (for codec testing).
3945 .IPs bug=<value>
3946 Manually work around encoder bugs.
3947 .RSss
3948 0: nothing
3949 .br
3950 1: autodetect bugs (default)
3951 .br
3952 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
3953 .br
3954 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
3955 .br
3956 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
3957 .br
3958 16 (mpeg4): padding bug (autodetected)
3959 .br
3960 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
3961 .br
3962 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
3963 .br
3964 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
3965 .br
3966 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
3967 .br
3968 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
3969 .br
3970 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
3971 .REss
3972 .IPs debug=<value>
3973 Display debugging information.
3974 .RSss
3975 .br
3976 0: disabled
3977 .br
3978 1: picture info
3979 .br
3980 2: rate control
3981 .br
3982 4: bitstream
3983 .br
3984 8: macroblock (MB) type
3985 .br
3986 16: per-block quantization parameter (QP)
3987 .br
3988 32: motion vector
3989 .br
3990 0x0040: motion vector visualization (use \-noslices)
3991 .br
3992 0x0080: macroblock (MB) skip
3993 .br
3994 0x0100: startcode
3995 .br
3996 0x0200: PTS
3997 .br
3998 0x0400: error resilience
3999 .br
4000 0x0800: memory management control operations (H.264)
4001 .br
4002 0x1000: bugs
4003 .br
4004 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
4005 .br
4006 0x4000: Visualize block types.
4007 .REss
4008 .IPs ec=<value>
4009 Set error concealment strategy.
4010 .RSss
4011 1: Use strong deblock filter for damaged MBs.
4012 .br
4013 2: iterative motion vector (MV) search (slow)
4014 .br
4015 3: all (default)
4016 .REss
4017 .IPs er=<value>
4018 Set error resilience strategy.
4019 .RSss
4020 .br
4021 0: disabled
4022 .br
4023 1: careful (Should work with broken encoders.)
4024 .br
4025 2: normal (default) (Works with compliant encoders.)
4026 .br
4027 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4028 .br
4029 4: very aggressive
4030 .REss
4031 .IPs "fast (MPEG-2 only)"
4032 Enable optimizations which do not comply to the specification and might
4033 potentially cause problems, like simpler dequantization, assuming use
4034 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
4035 checks to detect damaged bitstreams.
4036 .IPs "gray\ "
4037 grayscale only decoding (a bit faster than with color)
4038 .IPs "idct=<0\-99> (see \-lavcopts)"
4039 For best decoding quality use the same IDCT algorithm for decoding and encoding.
4040 This may come at a price in accuracy, though.
4041 .IPs lowres=<number>[,<w>]
4042 Decode at lower resolutions.
4043 Low resolution decoding is not supported by all codecs, and it will
4044 often result in ugly artifacts.
4045 This is not a bug, but a side effect of not decoding at full resolution.
4046 .RSss
4047 .br
4048 0: disabled
4049 .br
4050 1: 1/2 resolution
4051 .br
4052 2: 1/4 resolution
4053 .br
4054 3: 1/8 resolution
4055 .REss
4056 .RS
4057 If <w> is specified lowres decoding will be used only if the width of the
4058 video is major than or equal to <w>.
4059 .RE
4060 .IPs "sb=<number> (MPEG-2 only)"
4061 Skip the given number of macroblock rows at the bottom.
4062 .IPs "st=<number> (MPEG-2 only)"
4063 Skip the given number of macroblock rows at the top.
4064 .IPs skiploopfilter=<skipvalue> (H.264 only)
4065 Skips the loop filter (AKA deblocking) during H.264 decoding.
4066 Since the filtered frame is supposed to be used as reference
4067 for decoding dependent frames this has a worse effect on quality
4068 than not doing deblocking on e.g.\& MPEG-2 video.
4069 But at least for high bitrate HDTV this provides a big speedup with
4070 no visible quality loss.
4071 .sp 1
4072 <skipvalue> can be either one of the following:
4073 .RSss
4074 .br
4075 none: Never skip.
4076 .br
4077 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
4078 .br
4079 nonref: Skip frames that are not referenced (i.e.\& not used for
4080 decoding other frames, the error cannot "build up").
4081 .br
4082 bidir: Skip B-Frames.
4083 .br
4084 nonkey: Skip all frames except keyframes.
4085 .br
4086 all: Skip all frames.
4087 .REss
4088 .IPs skipidct=<skipvalue> (MPEG1/2 only)
4089 Skips the IDCT step.
4090 This degrades quality a lot of in almost all cases
4091 (see skiploopfilter for available skip values).
4092 .IPs skipframe=<skipvalue>
4093 Skips decoding of frames completely.
4094 Big speedup, but jerky motion and sometimes bad artifacts
4095 (see skiploopfilter for available skip values).
4096 .IPs threads=<1\-8>
4097 number of threads to use for decoding (default: 1)
4098 .IPs vismv=<value>
4099 Visualize motion vectors.
4100 .RSss
4101 .br
4102 0: disabled
4103 .br
4104 1: Visualize forward predicted MVs of P-frames.
4105 .br
4106 2: Visualize forward predicted MVs of B-frames.
4107 .br
4108 4: Visualize backward predicted MVs of B-frames.
4109 .REss
4110 .IPs vstats
4111 Prints some statistics and stores them in ./vstats_*.log.
4112 .RE
4113 .
4114 .TP
4115 .B \-noslices
4116 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4117 whole frame in a single run.
4118 May be faster or slower, depending on video card and available cache.
4119 It has effect only with libmpeg2 and libavcodec codecs.
4120 .
4121 .TP
4122 .B \-nosound
4123 Do not play/\:encode sound.
4124 Useful for benchmarking.
4125 .
4126 .TP
4127 .B \-novideo
4128 Do not play/\:encode video.
4129 In many cases this will not work, use \-vc null \-vo null instead.
4130 .
4131 .TP
4132 .B \-pp <quality> (also see \-vf pp)
4133 Set the DLL postprocess level.
4134 This option is no longer usable with \-vf pp.
4135 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4136 The valid range of \-pp values varies by codec, it is mostly
4137 0\-6, where 0=disable, 6=slowest/\:best.
4138 .
4139 .TP
4140 .B \-pphelp (also see \-vf pp)
4141 Show a summary about the available postprocess filters and their usage.
4142 .
4143 .TP
4144 .B \-ssf <mode>
4145 Specifies software scaler parameters.
4146 .sp 1
4147 .I EXAMPLE:
4148 .PD 0
4149 .RSs
4150 \-vf scale \-ssf lgb=3.0
4151 .RE
4152 .PD 1
4153 .PD 0
4154 .RSs
4155 .IPs lgb=<0\-100>
4156 gaussian blur filter (luma)
4157 .IPs cgb=<0\-100>
4158 gaussian blur filter (chroma)
4159 .IPs ls=<-100\-100>
4160 sharpen filter (luma)
4161 .IPs cs=<-100\-100>
4162 sharpen filter (chroma)
4163 .IPs chs=<h>
4164 chroma horizontal shifting
4165 .IPs cvs=<v>
4166 chroma vertical shifting
4167 .RE
4168 .PD 1
4169 .
4170 .TP
4171 .B \-stereo <mode>
4172 Select type of MP2/\:MP3 stereo output.
4173 .PD 0
4174 .RSs
4175 .IPs 0
4176 stereo
4177 .IPs 1
4178 left channel
4179 .IPs 2
4180 right channel
4181 .RE
4182 .PD 1
4183 .
4184 .TP
4185 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
4186 Specify the software scaler algorithm to be used with the \-zoom option.
4187 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4188 .sp 1
4189 Available types are:
4190 .sp 1
4191 .PD 0
4192 .RSs
4193 .IPs 0
4194 fast bilinear
4195 .IPs 1
4196 bilinear
4197 .IPs 2
4198 bicubic (good quality) (default)
4199 .IPs 3
4200 experimental
4201 .IPs 4
4202 nearest neighbor (bad quality)
4203 .IPs 5
4204 area
4205 .IPs 6
4206 luma bicubic / chroma bilinear
4207 .IPs 7
4208 gauss
4209 .IPs 8
4210 sincR
4211 .IPs 9
4212 lanczos
4213 .IPs 10
4214 natural bicubic spline
4215 .RE
4216 .PD 1
4217 .sp 1
4218 .RS
4219 .I NOTE:
4220 Some \-sws options are tunable.
4221 The description of the scale video filter has further information.
4222 .RE
4223 .
4224 .TP
4225 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]>
4226 Specify a priority list of video codecs to be used, according to their codec
4227 name in codecs.conf.
4228 Use a '-' before the codec name to omit it.
4229 Use a '+' before the codec name to force it, this will likely crash!
4230 If the list has a trailing ',' MPlayer will fall back on codecs not
4231 contained in the list.
4232 .br
4233 .I NOTE:
4234 See \-vc help for a full list of available codecs.
4235 .sp 1
4236 .I EXAMPLE:
4237 .PD 0
4238 .RSs
4239 .IPs "\-vc divx"
4240 Force Win32/\:VfW DivX codec, no fallback.
4241 .IPs "\-vc -divxds,-divx,"
4242 Skip Win32 DivX codecs.
4243 .IPs "\-vc ffmpeg12,mpeg12,"
4244 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
4245 .RE
4246 .PD 1
4247 .
4248 .TP
4249 .B \-vfm <driver1,driver2,...>
4250 Specify a priority list of video codec families to be used, according
4251 to their names in codecs.conf.
4252 Falls back on the default codecs if none of the given codec families work.
4253 .br
4254 .I NOTE:
4255 See \-vfm help for a full list of available codec families.
4256 .sp 1
4257 .I EXAMPLE:
4258 .PD 0
4259 .RSs
4260 .IPs "\-vfm ffmpeg,dshow,vfw"
4261 Try the libavcodec, then Directshow, then VfW codecs and fall back
4262 on others, if they do not work.
4263 .IPs "\-vfm xanim"
4264 Try XAnim codecs first.
4265 .RE
4266 .PD 1
4267 .
4268 .TP
4269 .B \-x <x> (also see \-zoom) (MPlayer only)
4270 Scale image to width <x> (if software/\:hardware scaling is available).
4271 Disables aspect calculations.
4272 .
4273 .TP
4274 .B \-xvidopts <option1:option2:...>
4275 Specify additional parameters when decoding with Xvid.
4276 .br
4277 .I NOTE:
4278 Since libavcodec is faster than Xvid you might want to use the libavcodec
4279 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
4280 .sp 1
4281 Xvid's internal postprocessing filters:
4282 .PD 0
4283 .RSs
4284 .IPs deblock-chroma (also see \-vf pp)
4285 chroma deblock filter
4286 .IPs deblock-luma (also see \-vf pp)
4287 luma deblock filter
4288 .IPs dering-luma (also see \-vf pp)
4289 luma deringing filter
4290 .IPs dering-chroma (also see \-vf pp)
4291 chroma deringing filter
4292 .IPs filmeffect (also see \-vf noise)
4293 Adds artificial film grain to the video.
4294 May increase perceived quality, while lowering true quality.
4295 .RE
4296 .sp 1
4297 .RS
4298 rendering methods:
4299 .RE
4300 .PD 0
4301 .RSs
4302 .IPs "dr2\ \ "
4303 Activate direct rendering method 2.
4304 .IPs nodr2
4305 Deactivate direct rendering method 2.
4306 .RE
4307 .PD 1
4308 .
4309 .TP
4310 .B \-xy <value> (also see \-zoom)
4311 .PD 0
4312 .RSs
4313 .IPs value<=8
4314 Scale image by factor <value>.
4315 .IPs value>8
4316 Set width to value and calculate height to keep correct aspect ratio.
4317 .RE
4318 .PD 1
4319 .
4320 .TP
4321 .B \-y <y> (also see \-zoom) (MPlayer only)
4322 Scale image to height <y> (if software/\:hardware scaling is available).
4323 Disables aspect calculations.
4324 .
4325 .TP
4326 .B "\-zoom\ \ "
4327 Allow software scaling, where available.
4328 This will allow scaling with output drivers (like x11, fbdev) that
4329 do not support hardware scaling where MPlayer disables scaling by
4330 default for performance reasons.
4331 .
4332 .
4333 .
4334 .SH "AUDIO FILTERS"
4335 Audio filters allow you to modify the audio stream and its properties.
4336 The syntax is:
4337 .
4338 .TP
4339 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
4340 Setup a chain of audio filters.
4341 .PP
4342 .I NOTE:
4343 To get a full list of available audio filters, see \-af help.
4344 .PP
4345 Available filters are:
4346 .
4347 .TP
4348 .B resample[=srate[:sloppy[:type]]]
4349 Changes the sample rate of the audio stream.
4350 Can be used if you have a fixed frequency sound card or if you are
4351 stuck with an old sound card that is only capable of max 44.1kHz.
4352 This filter is automatically enabled if necessary.
4353 It only supports 16-bit integer and float in native-endian format as input.
4354 .br
4355 .I NOTE:
4356 With MEncoder, you need to also use \-srate <srate>.
4357 .PD 0
4358 .RSs
4359 .IPs <srate>
4360 output sample frequency in Hz.
4361 The valid range for this parameter is 8000 to 192000.
4362 If the input and output sample frequency are the same or if this
4363 parameter is omitted the filter is automatically unloaded.
4364 A high sample frequency normally improves the audio quality,
4365 especially when used in combination with other filters.
4366 .IPs <sloppy>
4367 Allow (1) or disallow (0) the output frequency to differ slightly
4368 from the frequency given by <srate> (default: 1).
4369 Can be used if the startup of the playback is extremely slow.
4370 .IPs <type>
4371 Selects which resampling method to use.
4372 .RSss
4373 0: linear interpolation (fast, poor quality especially when upsampling)
4374 .br
4375 1: polyphase filterbank and integer processing
4376 .br
4377 2: polyphase filterbank and floating point processing (slow, best quality)
4378 .REss
4379 .PD 1
4380 .RE
4381 .sp 1
4382 .RS
4383 .I EXAMPLE:
4384 .RE
4385 .PD 0
4386 .RSs
4387 .IPs "mplayer \-af resample=44100:0:0"
4388 would set the output frequency of the resample filter to 44100Hz using
4389 exact output frequency scaling and linear interpolation.
4390 .RE
4391 .PD 1
4392 .
4393 .TP
4394 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
4395 Changes the sample rate of the audio stream to an integer <srate> in Hz.
4396 It only supports the 16-bit native-endian format.
4397 .br
4398 .I NOTE:
4399 With MEncoder, you need to also use \-srate <srate>.
4400 .PD 0
4401 .RSs
4402 .IPs <srate>
4403 the output sample rate
4404 .IPs <length>
4405 length of the filter with respect to the lower sampling rate (default: 16)
4406 .IPs <linear>
4407 if 1 then filters will be linearly interpolated between polyphase entries
4408 .IPs <count>
4409 log2 of the number of polyphase entries
4410 (..., 10->1024, 11->2048, 12->4096, ...)
4411 (default: 10->1024)
4412 .IPs <cutoff>
4413 cutoff frequency (0.0-1.0), default set depending upon filter length
4414 .RE
4415 .PD 1
4416 .
4417 .TP
4418 .B sweep[=speed]
4419 Produces a sine sweep.
4420 .PD 0
4421 .RSs
4422 .IPs <0.0\-1.0>
4423 Sine function delta, use very low values to hear the sweep.
4424 .RE
4425 .PD 1
4426 .
4427 .TP
4428 .B sinesuppress[=freq:decay]
4429 Remove a sine at the specified frequency.
4430 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
4431 It probably only works on mono input.
4432 .PD 0
4433 .RSs
4434 .IPs <freq>
4435 The frequency of the sine which should be removed (in Hz) (default: 50)
4436 .IPs <decay>
4437 Controls the adaptivity (a larger value will make the filter adapt to
4438 amplitude and phase changes quicker, a smaller value will make the
4439 adaptation slower) (default: 0.0001).
4440 Reasonable values are around 0.001.
4441 .RE
4442 .PD 1
4443 .
4444 .TP
4445 .B hrtf[=flag]
4446 Head-related transfer function: Converts multichannel audio to
4447 2 channel output for headphones, preserving the spatiality of the sound.
4448 .sp 1
4449 .PD 0
4450 .RS
4451 .IPs "Flag  Meaning"
4452 .IPs "m     matrix decoding of the rear channel"
4453 .IPs "s     2-channel matrix decoding"
4454 .IPs "0     no matrix decoding (default)"
4455 .RE
4456 .PD 1
4457 .
4458 .TP
4459 .B equalizer=[g1:g2:g3:...:g10]
4460 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
4461 This means that it works regardless of what type of audio is being played back.
4462 The center frequencies for the 10 bands are:
4463 .sp 1
4464 .PD 0
4465 .RS
4466 .IPs "No. frequency"
4467 .IPs "0    31.25 Hz"
4468 .IPs "1    62.50 Hz"
4469 .IPs "2   125.00 Hz"
4470 .IPs "3   250.00 Hz"
4471 .IPs "4   500.00 Hz"
4472 .IPs "5    1.00 kHz"
4473 .IPs "6    2.00 kHz"
4474 .IPs "7    4.00 kHz"
4475 .IPs "8    8.00 kHz"
4476 .IPs "9   16.00 kHz"
4477 .RE
4478 .PD 1
4479 .sp 1
4480 .RS
4481 If the sample rate of the sound being played is lower than the center
4482 frequency for a frequency band, then that band will be disabled.
4483 A known bug with this filter is that the characteristics for the
4484 uppermost band are not completely symmetric if the sample
4485 rate is close to the center frequency of that band.
4486 This problem can be worked around by upsampling the sound
4487 using the resample filter before it reaches this filter.
4488 .RE
4489 .PD 0
4490 .RSs
4491 .IPs <g1>:<g2>:<g3>:...:<g10>
4492 floating point numbers representing the gain in dB
4493 for each frequency band (-12\-12)
4494 .RE
4495 .sp 1
4496 .RS
4497 .I EXAMPLE:
4498 .RE
4499 .RSs
4500 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi"
4501 Would amplify the sound in the upper and lower frequency region
4502 while canceling it almost completely around 1kHz.
4503 .RE
4504 .PD 1
4505 .
4506 .TP
4507 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
4508 Can be used for adding, removing, routing and copying audio channels.
4509 If only <nch> is given the default routing is used, it works as
4510 follows: If the number of output channels is bigger than the number of
4511 input channels empty channels are inserted (except mixing from mono to
4512 stereo, then the mono channel is repeated in both of the output
4513 channels).
4514 If the number of output channels is smaller than the number
4515 of input channels the exceeding channels are truncated.
4516 .PD 0
4517 .RSs
4518 .IPs <nch>
4519 number of output channels (1\-6)
4520 .IPs "<nr>\ "
4521 number of routes (1\-6)
4522 .IPs <from1:to1:from2:to2:from3:to3:...>
4523 Pairs of numbers between 0 and 5 that define where to route each channel.
4524 .RE
4525 .sp 1
4526 .RS
4527 .I EXAMPLE:
4528 .RE
4529 .RSs
4530 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
4531 Would change the number of channels to 4 and set up 4 routes that
4532 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
4533 Observe that if media containing two channels was played back, channels
4534 2 and 3 would contain silence but 0 and 1 would still be swapped.
4535 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
4536 Would change the number of channels to 6 and set up 4 routes
4537 that copy channel 0 to channels 0 to 3.
4538 Channel 4 and 5 will contain silence.
4539 .RE
4540 .PD 1
4541 .
4542 .TP
4543 .B format[=format] (also see \-format)
4544 Convert between different sample formats.
4545 Automatically enabled when needed by the sound card or another filter.
4546 .PD 0
4547 .RSs
4548 .IPs <format>
4549 Sets the desired format.
4550 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
4551 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
4552 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
4553 and 'ne' the endianness of the computer MPlayer is running on).
4554 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
4555 Exceptions to this rule that are also valid format specifiers: u8, s8,
4556 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
4557 .RE
4558 .PD 1
4559 .
4560 .TP
4561 .B volume[=v[:sc]]
4562 Implements software volume control.
4563 Use this filter with caution since it can reduce the signal
4564 to noise ratio of the sound.
4565 In most cases it is best to set the level for the PCM sound to max,
4566 leave this filter out and control the output level to your
4567 speakers with the master volume control of the mixer.
4568 In case your sound card has a digital PCM mixer instead of an analog
4569 one, and you hear distortion, use the MASTER mixer instead.
4570 If there is an external amplifier connected to the computer (this
4571 is almost always the case), the noise level can be minimized by
4572 adjusting the master level and the volume knob on the amplifier
4573 until the hissing noise in the background is gone.
4574 .br
4575 This filter has a second feature: It measures the overall maximum
4576 sound level and prints out that level when MPlayer exits.
4577 This volume estimate can be used for setting the sound level in
4578 MEncoder such that the maximum dynamic range is utilized.
4579 .br
4580 .I NOTE:
4581 This filter is not reentrant and can therefore only be enabled
4582 once for every audio stream.
4583 .PD 0
4584 .RSs
4585 .IPs "<v>\ \ "
4586 Sets the desired gain in dB for all channels in the stream
4587 from -200dB to +60dB, where -200dB mutes the sound
4588 completely and +60dB equals a gain of 1000 (default: 0).
4589 .IPs "<sc>\ "
4590 Turns soft clipping on (1) or off (0).
4591 Soft-clipping can make the sound more smooth if very
4592 high volume levels are used.
4593 Enable this option if the dynamic range of the
4594 loudspeakers is very low.
4595 .br
4596 .I WARNING:
4597 This feature creates distortion and should be considered a last resort.
4598 .RE
4599 .sp 1
4600 .RS
4601 .I EXAMPLE:
4602 .RE
4603 .RSs
4604 .IPs "mplayer \-af volume=10.1:0 media.avi"
4605 Would amplify the sound by 10.1dB and hard-clip if the
4606 sound level is too high.
4607 .RE
4608 .PD 1
4609 .
4610 .TP
4611 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
4612 Mixes channels arbitrarily.
4613 Basically a combination of the volume and the channels filter
4614 that can be used to down-mix many channels to only a few,
4615 e.g.\& stereo to mono or vary the "width" of the center
4616 speaker in a surround sound system.
4617 This filter is hard to use, and will require some tinkering
4618 before the desired result is obtained.
4619 The number of options for this filter depends on
4620 the number of output channels.
4621 An example how to downmix a six-channel file to two channels with
4622 this filter can be found in the examples section near the end.
4623 .PD 0
4624 .RSs
4625 .IPs "<n>\ \ "
4626 number of output channels (1\-6)
4627 .IPs <Lij>
4628 How much of input channel i is mixed into output channel j (0\-1).
4629 So in principle you first have n numbers saying what to do with the
4630 first input channel, then n numbers that act on the second input channel
4631 etc.
4632 If you do not specify any numbers for some input channels, 0 is assumed.
4633 .RE
4634 .sp 1
4635 .RS
4636 .I EXAMPLE:
4637 .RE
4638 .RSs
4639 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
4640 Would down-mix from stereo to mono.
4641 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
4642 Would give 3 channel output leaving channels 0 and 1 intact,
4643 and mix channels 0 and 1 into output channel 2 (which could
4644 be sent to a subwoofer for example).
4645 .RE
4646 .PD 1
4647 .
4648 .TP
4649 .B sub[=fc:ch]
4650 Adds a subwoofer channel to the audio stream.
4651 The audio data used for creating the subwoofer channel is
4652 an average of the sound in channel 0 and channel 1.
4653 The resulting sound is then low-pass filtered by a 4th order
4654 Butterworth filter with a default cutoff frequency of 60Hz
4655 and added to a separate channel in the audio stream.
4656 .br
4657 .I Warning:
4658 Disable this filter when you are playing DVDs with Dolby
4659 Digital 5.1 sound, otherwise this filter will disrupt
4660 the sound to the subwoofer.
4661 .PD 0
4662 .RSs
4663 .IPs "<fc>\ "
4664 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
4665 For the best result try setting the cutoff frequency as low as possible.
4666 This will improve the stereo or surround sound experience.
4667 .IPs "<ch>\ "
4668 Determines the channel number in which to insert the sub-channel audio.
4669 Channel number can be between 0 and 5 (default: 5).
4670 Observe that the number of channels will automatically
4671 be increased to <ch> if necessary.
4672 .RE
4673 .sp 1
4674 .RS
4675 .I EXAMPLE:
4676 .RE
4677 .RSs
4678 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
4679 Would add a sub-woofer channel with a cutoff frequency of
4680 100Hz to output channel 4.
4681 .RE
4682 .PD 1
4683 .
4684 .TP
4685 .B "center\ "
4686 Creates a center channel from the front channels.
4687 May currently be low quality as it does not implement a
4688 high-pass filter for proper extraction yet, but averages and
4689 halves the channels instead.
4690 .PD 0
4691 .RSs
4692 .IPs "<ch>\ "
4693 Determines the channel number in which to insert the center channel.
4694 Channel number can be between 0 and 5 (default: 5).
4695 Observe that the number of channels will automatically
4696 be increased to <ch> if necessary.
4697 .RE
4698 .PD 1
4699 .
4700 .TP
4701 .B surround[=delay]
4702 Decoder for matrix encoded surround sound like Dolby Surround.
4703 Many files with 2 channel audio actually contain matrixed surround sound.
4704 Requires a sound card supporting at least 4 channels.
4705 .PD 0
4706 .RSs
4707 .IPs <delay>
4708 delay time in ms for the rear speakers (0 to 1000) (default: 20)
4709 This delay should be set as follows: If d1 is the distance
4710 from the listening position to the front speakers and d2 is the distance
4711 from the listening position to the rear speakers, then the delay should
4712 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
4713 .RE
4714 .sp 1
4715 .RS
4716 .I EXAMPLE:
4717 .RE
4718 .RSs
4719 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
4720 Would add surround sound decoding with 15ms delay for the sound to the
4721 rear speakers.
4722 .RE
4723 .PD 1
4724 .
4725 .TP
4726 .B delay[=ch1:ch2:...]
4727 Delays the sound to the loudspeakers such that the sound from the
4728 different channels arrives at the listening position simultaneously.
4729 It is only useful if you have more than 2 loudspeakers.
4730 .PD 0
4731 .RSs
4732 .IPs ch1,ch2,...
4733 The delay in ms that should be imposed on each channel
4734 (floating point number between 0 and 1000).
4735 .RE
4736 .PD 1
4737 .sp 1
4738 .RS
4739 To calculate the required delay for the different channels do as follows:
4740 .IP 1. 3
4741 Measure the distance to the loudspeakers in meters in relation
4742 to your listening position, giving you the distances s1 to s5
4743 (for a 5.1 system).
4744 There is no point in compensating for the subwoofer (you will not hear the
4745 difference anyway).
4746 .IP 2. 3
4747 Subtract the distances s1 to s5 from the maximum distance,
4748 i.e.\& s[i] = max(s) - s[i]; i = 1...5.
4749 .IP 3.
4750 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
4751 .RE
4752 .PD 0
4753 .sp 1
4754 .RS
4755 .I EXAMPLE:
4756 .RE
4757 .RSs
4758 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
4759 Would delay front left and right by 10.5ms, the two rear channels
4760 and the sub by 0ms and the center channel by 7ms.
4761 .RE
4762 .PD 1
4763 .
4764 .TP
4765 .B export[=mmapped_file[:nsamples]]
4766 Exports the incoming signal to other processes using memory mapping (mmap()).
4767 Memory mapped areas contain a header:
4768 .sp 1
4769 .nf
4770 int nch                      /*number of channels*/
4771 int size                     /*buffer size*/
4772 unsigned long long counter   /*Used to keep sync, updated every
4773                                time new data is exported.*/
4774 .fi
4775 .sp 1
4776 The rest is payload (non-interleaved) 16 bit data.
4777 .PD 0
4778 .RSs
4779 .IPs <mmapped_file>
4780 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
4781 .IPs <nsamples>
4782 number of samples per channel (default: 512)
4783 .RE
4784 .sp 1
4785 .RS
4786 .I EXAMPLE:
4787 .RE
4788 .RSs
4789 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
4790 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
4791 .RE
4792 .PD 1
4793 .
4794 .TP
4795 .B extrastereo[=mul]
4796 (Linearly) increases the difference between left and right channels
4797 which adds some sort of "live" effect to playback.
4798 .PD 0
4799 .RSs
4800 .IPs <mul>
4801 Sets the difference coefficient (default: 2.5).
4802 0.0 means mono sound (average of both channels), with 1.0 sound will be
4803 unchanged, with -1.0 left and right channels will be swapped.
4804 .RE
4805 .PD 1
4806 .
4807 .TP
4808 .B volnorm[=method:target]
4809 Maximizes the volume without distorting the sound.
4810 .PD 0
4811 .RSs
4812 .IPs <method>
4813 Sets the used method.
4814 .RSss
4815 1: Use a single sample to smooth the variations via the standard
4816 weighted mean over past samples (default).
4817 .br
4818 2: Use several samples to smooth the variations via the standard
4819 weighted mean over past samples.
4820 .REss
4821 .IPs <target>
4822 Sets the target amplitude as a fraction of the maximum for the
4823 sample type (default: 0.25).
4824 .RE
4825 .PD 1
4826 .
4827 .TP
4828 .B ladspa=file:label[:controls...]
4829 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
4830 This filter is reentrant, so multiple LADSPA plugins can be used at once.
4831 .PD 0
4832 .RSs
4833 .IPs <file>
4834 Specifies the LADSPA plugin library file.
4835 If LADSPA_PATH is set, it searches for the specified file.
4836 If it is not set, you must supply a fully specified pathname.
4837 .IPs <label>
4838 Specifies the filter within the library.
4839 Some libraries contain only one filter, but others contain many of them.
4840 Entering 'help' here, will list all available filters within the specified
4841 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
4842 .IPs <controls>
4843 Controls are zero or more floating point values that determine the
4844 behavior of the loaded plugin (for example delay, threshold or gain).
4845 In verbose mode (add \-v to the MPlayer command line), all available controls
4846 and their valid ranges are printed.
4847 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
4848 .RE
4849 .PD 1
4850 .
4851 .TP
4852 .B "comp\ \ \ "
4853 Compressor/expander filter usable for microphone input.
4854 Prevents artifacts on very loud sound and raises the volume on
4855 very low sound.
4856 This filter is untested, maybe even unusable.
4857 .
4858 .TP
4859 .B "gate\ \ \ "
4860 Noise gate filter similar to the comp audio filter.
4861 This filter is untested, maybe even unusable.
4862 .
4863 .TP
4864 .B karaoke
4865 Simple voice removal filter exploiting the fact that voice is
4866 usually recorded with mono gear and later 'center' mixed onto
4867 the final audio stream.
4868 Beware that this filter will turn your signal into mono.
4869 Works well for 2 channel tracks; do not bother trying it
4870 on anything but 2 channel stereo.
4871 .
4872 .
4873 .
4874 .SH "VIDEO FILTERS"
4875 Video filters allow you to modify the video stream and its properties.
4876 The syntax is:
4877 .
4878 .TP
4879 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
4880 Setup a chain of video filters.
4881 .
4882 .TP
4883 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE)
4884 Setup a chain of video filters, to be applied in
4885 .B reverse
4886 order.
4887 Deprecated in favor of \-vf.
4888 .PP
4889 Many parameters are optional and set to default values if omitted.
4890 To explicitly use a default value set a parameter to '-1'.
4891 Parameters w:h means width x height in pixels, x:y means x;y position counted
4892 from the upper left corner of the bigger image.
4893 .br
4894 .I NOTE:
4895 To get a full list of available video filters, see \-vf help.
4896 .sp 1
4897 Video filters are managed in lists.
4898 There are a few commands to manage the filter list.
4899 .
4900 .TP
4901 .B \-vf-add <filter1[,filter2,...]>
4902 Appends the filters given as arguments to the filter list.
4903 .
4904 .TP
4905 .B \-vf-pre <filter1[,filter2,...]>
4906 Prepends the filters given as arguments to the filter list.
4907 .
4908 .TP
4909 .B \-vf-del <index1[,index2,...]>
4910 Deletes the filters at the given indexes.
4911 Index numbers start at 0, negative numbers address the end of the
4912 list (-1 is the last).
4913 .
4914 .TP
4915 .B \-vf-clr
4916 Completely empties the filter list.
4917 .PP
4918 With filters that support it, you can access parameters by their name.
4919 .
4920 .TP
4921 .B \-vf <filter>=help
4922 Prints the parameter names and parameter value ranges for a particular
4923 filter.
4924 .
4925 .TP
4926 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
4927 Sets a named parameter to the given value.
4928 Use on and off or yes and no to set flag parameters.
4929 .PP
4930 Available filters are:
4931 .
4932 .TP
4933 .B crop[=w:h:x:y]
4934 Crops the given part of the image and discards the rest.
4935 Useful to remove black bands from widescreen movies.
4936 .PD 0
4937 .RSs
4938 .IPs <w>,<h>
4939 Cropped width and height, defaults to original width and height.
4940 .IPs <x>,<y>
4941 Position of the cropped picture, defaults to center.
4942 .RE
4943 .PD 1
4944 .
4945 .TP
4946 .B cropdetect[=limit:round]
4947 Calculates necessary cropping parameters and prints the recommended parameters
4948 to stdout.
4949 .PD 0
4950 .RSs
4951 .IPs <limit>
4952 Threshold, which can be optionally specified from nothing (0) to
4953 everything (255) (default: 24).
4954 .br
4955 .IPs <round>
4956 Value which the width/\:height should be divisible by (default: 16).
4957 The offset is automatically adjusted to center the video.
4958 Use 2 to get only even dimensions (needed for 4:2:2 video).
4959 16 is best when encoding to most video codecs.
4960 .RE
4961 .PD 1
4962 .
4963 .TP
4964 .B rectangle[=w:h:x:y]
4965 The plugin responds to the input.conf directive 'change_rectangle'
4966 that takes two parameters.
4967 .PD 0
4968 .RSs
4969 .IPs <w>,<h>
4970 width and height (default: -1, maximum possible width where boundaries
4971 are still visible.)
4972 .IPs <x>,<y>
4973 top left corner position (default: -1, uppermost leftmost)
4974 .RE
4975 .PD 1
4976 .
4977 .TP
4978 .B expand[=w:h:x:y:o:a:r]
4979 Expands (not scales) movie resolution to the given value and places the
4980 unscaled original at coordinates x, y.
4981 Can be used for placing subtitles/\:OSD in the resulting black bands.