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