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