Initial import of MPlayer SVN rev 28382 and FFmpeg SVN rev 16846.
[vaapi:miks-mplayer.git] / DOCS / man / en / .svn / text-base / mplayer.1.svn-base
1 .\" $Revision$
2 .\" MPlayer (C) 2000-2009 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 "2009-01-05" "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|icyx|noicyx|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 nocache=yes
599
600 [extension.flv]
601 profile-desc="profile for .flv files"
602 flip=yes
603
604 [vo.pnm]
605 outdir=/tmp
606
607 [ao.alsa]
608 device=spdif
609 .fi
610 .PP
611 .I "EXAMPLE MENCODER PROFILE:"
612 .sp 1
613 .nf
614
615 [mpeg4]
616 profile-desc="MPEG4 encoding"
617 ovc=lacv=yes
618 lavcopts=vcodec=mpeg4:vbitrate=1200
619
620 [mpeg4\-hq]
621 profile-desc="HQ MPEG4 encoding"
622 profile=mpeg4
623 lavcopts=mbd=2:trell=yes:v4mv=yes
624 .fi
625 .
626 .\" --------------------------------------------------------------------------
627 .\" Options
628 .\" --------------------------------------------------------------------------
629 .
630 .SH "GENERAL OPTIONS"
631 .
632 .TP
633 .B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
634 Override the standard search path and use the specified file
635 instead of the builtin codecs.conf.
636 .
637 .TP
638 .B \-include <configuration file>
639 Specify configuration file to be parsed after the default ones.
640 .
641 .TP
642 .B \-list\-options
643 Prints all available options.
644 .
645 .TP
646 .B \-msgcharset <charset>
647 Convert console messages to the specified character set (default: autodetect).
648 Text will be in the encoding specified with the \-\-charset configure option.
649 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
650 .br
651 .I NOTE:
652 The option takes effect after command line parsing has finished.
653 The MPLAYER_CHARSET environment variable can help you get rid of
654 the first lines of garbled output.
655 .
656 .TP
657 .B \-msgcolor
658 Enable colorful console output on terminals that support ANSI color.
659 .
660 .TP
661 .B \-msglevel <all=<level>:<module>=<level>:...>
662 Control verbosity directly for each module.
663 The 'all' module changes the verbosity of all the modules not
664 explicitly specified on the command line.
665 See '\-msglevel help' for a list of all modules.
666 .br
667 .I NOTE:
668 Some messages are printed before the command line is parsed and are
669 therefore not affected by \-msglevel.
670 To control these messages you have to use the MPLAYER_VERBOSE environment
671 variable, see its description below for details.
672 .br
673 Available levels:
674 .PD 0
675 .RSs
676 .IPs "\-1"
677 complete silence
678 .IPs " 0"
679 fatal messages only
680 .IPs " 1"
681 error messages
682 .IPs " 2"
683 warning messages
684 .IPs " 3"
685 short hints
686 .IPs " 4"
687 informational messages
688 .IPs " 5"
689 status messages (default)
690 .IPs " 6"
691 verbose messages
692 .IPs " 7"
693 debug level 2
694 .IPs " 8"
695 debug level 3
696 .IPs " 9"
697 debug level 4
698 .RE
699 .PD 1
700 .
701 .TP
702 .B \-msgmodule
703 Prepend module name in front of each console message.
704 .
705 .TP
706 .B \-noconfig <options>
707 Do not parse selected configuration files.
708 .br
709 .I NOTE:
710 If \-include or \-use\-filedir\-conf options are
711 specified at the command line, they will be honoured.
712 .sp 1
713 Available options are:
714 .PD 0
715 .RSs
716 .IPs "all\ \ "
717 all configuration files
718 .IPs "gui (GUI only)"
719 GUI configuration file
720 .IPs system
721 system configuration file
722 .IPs "user\ "
723 user configuration file
724 .RE
725 .PD 1
726 .
727 .TP
728 .B "\-quiet\ "
729 Make console output less verbose; in particular, prevents the status line
730 (i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
731 Particularly useful on slow terminals or broken ones which do not properly
732 handle carriage return (i.e.\& \\r).
733 .
734 .TP
735 .B \-priority <prio> (Windows only)
736 Set process priority for MPlayer according to the predefined
737 priorities available under Windows.
738 Possible values of <prio>:
739 .RSs
740 idle|belownormal|normal|abovenormal|high|realtime
741 .RE
742 .sp 1
743 .RS
744 .I WARNING:
745 Using realtime priority can cause system lockup.
746 .RE
747 .
748 .TP
749 .B \-profile <profile1,profile2,...>
750 Use the given profile(s), \-profile help displays a list of the defined profiles.
751 .
752 .TP
753 .B \-really\-quiet (also see \-quiet)
754 Display even less output and status messages than with \-quiet.
755 Also suppresses the GUI error message boxes.
756 .
757 .TP
758 .B \-show\-profile <profile>
759 Show the description and content of a profile.
760 .
761 .TP
762 .B \-use\-filedir\-conf
763 Look for a file-specific configuration file in the same directory as
764 the file that is being played.
765 .br
766 .I WARNING:
767 May be dangerous if playing from untrusted media.
768 .
769 .TP
770 .B "\-v\ \ \ \ \ "
771 Increment verbosity level, one level for each \-v
772 found on the command line.
773 .
774 .
775 .
776 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
777 .
778 .TP
779 .B \-autoq <quality> (use with \-vf [s]pp)
780 Dynamically changes the level of postprocessing depending on the available spare
781 CPU time.
782 The number you specify will be the maximum level used.
783 Usually you can use some big number.
784 You have to use \-vf [s]pp without parameters in order for this to work.
785 .
786 .TP
787 .B \-autosync <factor>
788 Gradually adjusts the A/V sync based on audio delay measurements.
789 Specifying \-autosync 0, the default, will cause frame timing to be based
790 entirely on audio delay measurements.
791 Specifying \-autosync 1 will do the same, but will subtly change the A/V
792 correction algorithm.
793 An uneven video framerate in a movie which plays fine with \-nosound can
794 often be helped by setting this to an integer value greater than 1.
795 The higher the value, the closer the timing will be to \-nosound.
796 Try \-autosync 30 to smooth out problems with sound drivers which do
797 not implement a perfect audio delay measurement.
798 With this value, if large A/V sync offsets occur, they will only take about
799 1 or 2 seconds to settle out.
800 This delay in reaction time to sudden A/V offsets should be the only
801 side-effect of turning this option on, for all sound drivers.
802 .
803 .TP
804 .B \-benchmark
805 Prints some statistics on CPU usage and dropped frames at the end of playback.
806 Use in combination with \-nosound and \-vo null for benchmarking only the
807 video codec.
808 .br
809 .I NOTE:
810 With this option MPlayer will also ignore frame duration when playing
811 only video (you can think of that as infinite fps).
812 .
813 .TP
814 .B \-colorkey <number>
815 Changes the colorkey to an RGB value of your choice.
816 0x000000 is black and 0xffffff is white.
817 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
818 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
819 drivers.
820 .
821 .TP
822 .B \-nocolorkey
823 Disables colorkeying.
824 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
825 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
826 drivers.
827 .
828 .TP
829 .B \-correct\-pts (EXPERIMENTAL)
830 Switches MPlayer to an experimental mode where timestamps for video frames
831 are calculated differently and video filters which add new frames or
832 modify timestamps of existing ones are supported.
833 The more accurate timestamps can be visible for example when playing
834 subtitles timed to scene changes with the \-ass option.
835 Without \-correct\-pts the subtitle timing will typically be off by some frames.
836 This option does not work correctly with some demuxers and codecs.
837 .
838 .TP
839 .B \-crash\-debug (DEBUG CODE)
840 Automatically attaches gdb upon crash or SIGTRAP.
841 Support must be compiled in by configuring with \-\-enable\-crash\-debug.
842 .
843 .TP
844 .B \-doubleclick\-time
845 Time in milliseconds to recognize two consecutive button presses as
846 a double-click (default: 300).
847 Set to 0 to let your windowing system decide what a double-click is
848 (\-vo directx only).
849 .br
850 .I NOTE:
851 You will get slightly different behaviour depending on whether you bind
852 MOUSE_BTN0_DBL or MOUSE_BTN0\-MOUSE_BTN0_DBL.
853 .
854 .TP
855 .B \-edlout <filename>
856 Creates a new file and writes edit decision list (EDL) records to it.
857 During playback, the user hits 'i' to mark the start or end of a skip block.
858 This provides a starting point from which the user can fine-tune EDL entries
859 later.
860 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
861 .
862 .TP
863 .B \-enqueue (GUI only)
864 Enqueue files given on the command line in the playlist instead of playing them
865 immediately.
866 .
867 .TP
868 .B \-fixed\-vo
869 Enforces a fixed video system for multiple files (one (un)initialization for
870 all files).
871 Therefore only one window will be opened for all files.
872 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
873 xmga, xv, xvidix and dfbmga.
874 .
875 .TP
876 .B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
877 Skip displaying some frames to maintain A/V sync on slow systems.
878 Video filters are not applied to such frames.
879 For B-frames even decoding is skipped completely.
880 .
881 .TP
882 .B \-(no)gui
883 Enable or disable the GUI interface (default depends on binary name).
884 Only works as the first argument on the command line.
885 Does not work as a config-file option.
886 .
887 .TP
888 .B \-h, \-help, \-\-help
889 Show short summary of options.
890 .
891 .TP
892 .B \-hardframedrop (experimental without \-nocorrect\-pts)
893 More intense frame dropping (breaks decoding).
894 Leads to image distortion!
895 Note that especially the libmpeg2 decoder may crash with this,
896 so consider using "\-vc ffmpeg12,".
897 .
898 .TP
899 .B \-heartbeat\-cmd
900 Command that is executed every 30 seconds during playback via system() -
901 i.e.\& using the shell.
902 .sp 1
903 .I NOTE:
904 MPlayer uses this command without any checking, it is your responsibility
905 to ensure it does not cause security problems (e.g.\& make sure to use full
906 paths if "." is in your path like on Windows).
907 .sp 1
908 This can be "misused" to disable screensavers that do not support the proper
909 X API (also see \-stop\-xscreensaver).
910 If you think this is too complicated, ask the author of the screensaver
911 program to support the proper X APIs.
912 .sp 1
913 .I EXAMPLE for xscreensaver:
914 mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
915 .sp 1
916 .I EXAMPLE for GNOME screensaver:
917 mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
918 .RE
919 .PD 1
920 .
921 .TP
922 .B \-identify
923 Shorthand for \-msglevel identify=4.
924 Show file parameters in an easily parseable format.
925 Also prints more detailed information about subtitle and audio
926 track languages and IDs.
927 In some cases you can get more information by using \-msglevel identify=6.
928 For example, for a DVD it will list the chapters and time length of each title,
929 as well as a disk ID.
930 Combine this with \-frames 0 to suppress all output.
931 The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
932 (hopefully) shellescapes the filenames.
933 .
934 .TP
935 .B \-idle (also see \-slave)
936 Makes MPlayer wait idly instead of quitting when there is no file to play.
937 Mostly useful in slave mode where MPlayer can be controlled
938 through input commands.
939 .
940 .TP
941 .B \-input <commands>
942 This option can be used to configure certain parts of the input system.
943 Paths are relative to ~/.mplayer/.
944 .br
945 .I NOTE:
946 Autorepeat is currently only supported by joysticks.
947 .sp 1
948 Available commands are:
949 .sp 1
950 .PD 0
951 .RSs
952 .IPs conf=<filename>
953 Specify input configuration file other than the default
954 ~/\:.mplayer/\:input.conf.
955 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
956 .IPs ar-dev=<device>
957 Device to be used for Apple IR Remote (default is autodetected, Linux only).
958 .IPs ar-delay
959 Delay in milliseconds before we start to autorepeat a key (0 to disable).
960 .IPs ar-rate
961 Number of key presses to generate per second on autorepeat.
962 .IPs keylist
963 Prints all keys that can be bound to commands.
964 .IPs cmdlist
965 Prints all commands that can be bound to keys.
966 .IPs js-dev
967 Specifies the joystick device to use (default: /dev/\:input/\:js0).
968 .IPs file=<filename>
969 Read commands from the given file.
970 Mostly useful with a FIFO.
971 .br
972 .I NOTE:
973 When the given file is a FIFO MPlayer opens both ends so you can do
974 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
975 .RE
976 .PD 1
977 .
978 .TP
979 .B \-key\-fifo\-size <2\-65000>
980 Specify the size of the FIFO that buffers key events (default: 7).
981 A FIFO of size n can buffer (n\-1) events.
982 If it is too small some events may be lost
983 (leading to "stuck mouse buttons" and similar effects).
984 If it is too big, MPlayer may seem to hang while it
985 processes the buffered events.
986 To get the same behavior as before this option was introduced,
987 set it to 2 for Linux or 1024 for Windows.
988 .
989 .TP
990 .B \-lircconf <filename> (LIRC only)
991 Specifies a configuration file for LIRC (default: ~/.lircrc).
992 .
993 .TP
994 .B \-list\-properties
995 Print a list of the available properties.
996 .
997 .TP
998 .B \-loop <number>
999 Loops movie playback <number> times.
1000 0 means forever.
1001 .
1002 .TP
1003 .B \-menu (OSD menu only)
1004 Turn on OSD menu support.
1005 .
1006 .TP
1007 .B \-menu\-cfg <filename> (OSD menu only)
1008 Use an alternative menu.conf.
1009 .
1010 .TP
1011 .B \-menu\-chroot <path> (OSD menu only)
1012 Chroot the file selection menu to a specific location.
1013 .sp 1
1014 .I EXAMPLE:
1015 .PD 0
1016 .RSs
1017 .IPs "\-menu\-chroot /home"
1018 Will restrict the file selection menu to /\:home and downward (i.e.\& no
1019 access to / will be possible, but /home/user_name will).
1020 .RE
1021 .PD 1
1022 .
1023 .TP
1024 .B \-menu\-keepdir (OSD menu only)
1025 File browser starts from the last known location instead of current directory.
1026 .
1027 .TP
1028 .B \-menu\-root <value> (OSD menu only)
1029 Specify the main menu.
1030 .
1031 .TP
1032 .B \-menu\-startup (OSD menu only)
1033 Display the main menu at MPlayer startup.
1034 .
1035 .TP
1036 .B \-mouse\-movements
1037 Permit MPlayer to receive pointer events reported by the video
1038 output driver.
1039 Necessary to select the buttons in DVD menus.
1040 Supported for X11 based VOs (x11, xv, xvmc, etc.) and the gl, gl2, direct3d and
1041 macosx VOs.
1042 .
1043 .TP
1044 .B \-noar
1045 Turns off AppleIR remote support.
1046 .
1047 .TP
1048 .B \-noconsolecontrols
1049 Prevent MPlayer from reading key events from standard input.
1050 Useful when reading data from standard input.
1051 This is automatically enabled when \- is found on the command line.
1052 There are situations where you have to set it manually, e.g.\&
1053 if you open /dev/\:stdin (or the equivalent on your system), use stdin
1054 in a playlist or intend to read from stdin later on via the loadfile or
1055 loadlist slave commands.
1056 .
1057 .TP
1058 .B \-nojoystick
1059 Turns off joystick support.
1060 .
1061 .TP
1062 .B \-nolirc
1063 Turns off LIRC support.
1064 .
1065 .TP
1066 .B \-nomouseinput
1067 Disable mouse button press/\:release input (mozplayerxp's context menu relies
1068 on this option).
1069 .
1070 .TP
1071 .B \-rtc (RTC only)
1072 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
1073 mechanism.
1074 This wakes up the process every 1/1024 seconds to check the current time.
1075 Useless with modern Linux kernels configured for desktop use as they already
1076 wake up the process with similar accuracy when using normal timed sleep.
1077 .
1078 .TP
1079 .B \-playing\-msg <string>
1080 Print out a string before starting playback.
1081 The following expansions are supported:
1082 .RSs
1083 .IPs ${NAME}
1084 Expand to the value of the property NAME.
1085 .IPs ?(NAME:TEXT)
1086 Expand TEXT only if the property NAME is available.
1087 .IPs ?(!NAME:TEXT)
1088 Expand TEXT only if the property NAME is not available.
1089 .RE
1090 .
1091 .TP
1092 .B \-playlist <filename>
1093 Play files according to a playlist file (ASX, Winamp, SMIL, or
1094 one-file-per-line format).
1095 .br
1096 .I NOTE:
1097 This option is considered an entry so options found after it will apply
1098 only to the elements of this playlist.
1099 .br
1100 FIXME: This needs to be clarified and documented thoroughly.
1101 .
1102 .TP
1103 .B \-rtc\-device <device>
1104 Use the specified device for RTC timing.
1105 .
1106 .TP
1107 .B \-shuffle
1108 Play files in random order.
1109 .
1110 .TP
1111 .B \-skin <name> (GUI only)
1112 Loads a skin from the directory given as parameter below the default skin
1113 directories, /usr/\:local/\:share/\:mplayer/\:skins/\: and ~/.mplayer/\:skins/.
1114 .sp 1
1115 .I EXAMPLE:
1116 .PD 0
1117 .RSs
1118 .IPs "\-skin fittyfene"
1119 Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
1120 and afterwards ~/.mplayer/\:skins/\:fittyfene.
1121 .RE
1122 .PD 1
1123 .
1124 .TP
1125 .B \-slave (also see \-input)
1126 Switches on slave mode, in which MPlayer works as a backend for other programs.
1127 Instead of intercepting keyboard events, MPlayer will read commands separated
1128 by a newline (\\n) from stdin.
1129 .br
1130 .I NOTE:
1131 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
1132 for their description.
1133 .
1134 .TP
1135 .B \-softsleep
1136 Time frames by repeatedly checking the current time instead of asking the
1137 kernel to wake up MPlayer at the correct time.
1138 Useful if your kernel timing is imprecise and you cannot use the RTC either.
1139 Comes at the price of higher CPU consumption.
1140 .
1141 .TP
1142 .B \-sstep <sec>
1143 Skip <sec> seconds after every frame.
1144 The normal framerate of the movie is kept, so playback is accelerated.
1145 Since MPlayer can only seek to the next keyframe this may be inexact.
1146 .
1147 .
1148 .
1149 .SH "DEMUXER/STREAM OPTIONS"
1150 .
1151 .TP
1152 .B \-a52drc <level>
1153 Select the Dynamic Range Compression level for AC-3 audio streams.
1154 <level> is a float value ranging from 0 to 1, where 0 means no compression
1155 and 1 (which is the default) means full compression (make loud passages more
1156 silent and vice versa).
1157 This option only shows an effect if the AC-3 stream contains the required range
1158 compression information.
1159 .
1160 .TP
1161 .B \-aid <ID> (also see \-alang)
1162 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1163 VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1164 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1165 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1166 (if present) with the chosen audio stream.
1167 .
1168 .TP
1169 .B \-ausid <ID> (also see \-alang)
1170 Select audio substream channel.
1171 Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled
1172 by the native demuxer (not by libavformat).
1173 The format type may not be correctly identified because of how this information
1174 (or lack thereof) is embedded in the stream, but it will demux correctly the
1175 audio streams when multiple substreams are present.
1176 MPlayer prints the available substream IDs when run with \-identify.
1177 .
1178 .TP
1179 .B \-alang <language code[,language code,...]> (also see \-aid)
1180 Specify a priority list of audio languages to use.
1181 Different container formats employ different language codes.
1182 DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
1183 use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
1184 MPlayer prints the available languages when run in verbose (\-v) mode.
1185 .sp 1
1186 .I EXAMPLE:
1187 .PD 0
1188 .RSs
1189 .IPs "mplayer dvd://1 \-alang hu,en"
1190 Chooses the Hungarian language track on a DVD and falls back on English if
1191 Hungarian is not available.
1192 .IPs "mplayer \-alang jpn example.mkv"
1193 Plays a Matroska file in Japanese.
1194 .RE
1195 .PD 1
1196 .
1197 .TP
1198 .B \-audio\-demuxer <[+]name> (\-audiofile only)
1199 Force audio demuxer type for \-audiofile.
1200 Use a '+' before the name to force it, this will skip some checks!
1201 Give the demuxer name as printed by \-audio\-demuxer help.
1202 For backward compatibility it also accepts the demuxer ID as defined in
1203 libmpdemux/\:demuxer.h.
1204 \-audio\-demuxer audio or \-audio\-demuxer 17 forces MP3.
1205 .
1206 .TP
1207 .B \-audiofile <filename>
1208 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1209 movie.
1210 .
1211 .TP
1212 .B \-audiofile\-cache <kBytes>
1213 Enables caching for the stream used by \-audiofile, using the specified
1214 amount of memory.
1215 .
1216 .TP
1217 .B \-reuse\-socket (udp:// only)
1218 Allows a socket to be reused by other processes as soon as it is closed.
1219 .
1220 .TP
1221 .B \-bandwidth <value> (network only)
1222 Specify the maximum bandwidth for network streaming (for servers that are
1223 able to send content in different bitrates).
1224 Useful if you want to watch live streamed media behind a slow connection.
1225 With Real RTSP streaming, it is also used to set the maximum delivery
1226 bandwidth allowing faster cache filling and stream dumping.
1227 .
1228 .TP
1229 .B \-cache <kBytes>
1230 This option specifies how much memory (in kBytes) to use when precaching a
1231 file or URL.
1232 Especially useful on slow media.
1233 .
1234 .TP
1235 .B \-nocache
1236 Turns off caching.
1237 .
1238 .TP
1239 .B \-cache\-min <percentage>
1240 Playback will start when the cache has been filled up to <percentage>
1241 of the total.
1242 .
1243 .TP
1244 .B \-cache\-seek\-min <percentage>
1245 If a seek is to be made to a position within <percentage> of the cache size
1246 from the current position, MPlayer will wait for the cache to be filled to
1247 this position rather than performing a stream seek (default: 50).
1248 .
1249 .TP
1250 .B \-cdda <option1:option2> (CDDA only)
1251 This option can be used to tune the CD Audio reading feature of MPlayer.
1252 .sp 1
1253 Available options are:
1254 .RSs
1255 .IPs speed=<value>
1256 Set CD spin speed.
1257 .IPs paranoia=<0\-2>
1258 Set paranoia level.
1259 Values other than 0 seem to break playback of anything but the first track.
1260 .RSss
1261 0: disable checking (default)
1262 .br
1263 1: overlap checking only
1264 .br
1265 2: full data correction and verification
1266 .REss
1267 .IPs generic-dev=<value>
1268 Use specified generic SCSI device.
1269 .IPs sector-size=<value>
1270 Set atomic read size.
1271 .IPs overlap=<value>
1272 Force minimum overlap search during verification to <value> sectors.
1273 .IPs toc-bias
1274 Assume that the beginning offset of track 1 as reported in the TOC will be
1275 addressed as LBA 0.
1276 Some Toshiba drives need this for getting track boundaries correct.
1277 .IPs toc-offset=<value>
1278 Add <value> sectors to the values reported when addressing tracks.
1279 May be negative.
1280 .IPs (no)skip
1281 (Never) accept imperfect data reconstruction.
1282 .RE
1283 .
1284 .TP
1285 .B \-cdrom\-device <path to device>
1286 Specify the CD-ROM device (default: /dev/\:cdrom).
1287 .
1288 .TP
1289 .B \-channels <number> (also see \-af channels)
1290 Request the number of playback channels (default: 2).
1291 MPlayer asks the decoder to decode the audio into as many channels as
1292 specified.
1293 Then it is up to the decoder to fulfill the requirement.
1294 This is usually only important when playing videos with AC-3 audio (like DVDs).
1295 In that case liba52 does the decoding by default and correctly downmixes the
1296 audio into the requested number of channels.
1297 To directly control the number of output channels independently of how many
1298 channels are decoded, use the channels filter.
1299 .br
1300 .I NOTE:
1301 This option is honored by codecs (AC-3 only), filters (surround) and audio
1302 output drivers (OSS at least).
1303 .sp 1
1304 Available options are:
1305 .sp 1
1306 .PD 0
1307 .RSs
1308 .IPs 2
1309 stereo
1310 .IPs 4
1311 surround
1312 .IPs 6
1313 full 5.1
1314 .RE
1315 .PD 1
1316 .
1317 .TP
1318 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1319 Specify which chapter to start playing at.
1320 Optionally specify which chapter to end playing at (default: 1).
1321 .
1322 .TP
1323 .B \-cookies (network only)
1324 Send cookies when making HTTP requests.
1325 .
1326 .TP
1327 .B \-cookies\-file <filename> (network only)
1328 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1329 and skip reading from default locations.
1330 The file is assumed to be in Netscape format.
1331 .
1332 .TP
1333 .B \-delay <sec>
1334 audio delay in seconds (positive or negative float value)
1335 .br
1336 Negative values delay the audio, and positive values delay the video.
1337 Note that this is the exact opposite of the \-audio\-delay MEncoder option.
1338 .br
1339 .I NOTE:
1340 When used with MEncoder, this is not guaranteed to work correctly
1341 with \-ovc copy; use \-audio\-delay instead.
1342 .
1343 .TP
1344 .B \-ignore\-start
1345 Ignore the specified starting time for streams in AVI files.
1346 In MPlayer, this nullifies stream delays in files encoded with
1347 the \-audio\-delay option.
1348 During encoding, this option prevents MEncoder from transferring
1349 original stream start times to the new file; the \-audio\-delay option is
1350 not affected.
1351 Note that MEncoder sometimes adjusts stream starting times
1352 automatically to compensate for anticipated decoding delays, so do not
1353 use this option for encoding without testing it first.
1354 .
1355 .TP
1356 .B \-demuxer <[+]name>
1357 Force demuxer type.
1358 Use a '+' before the name to force it, this will skip some checks!
1359 Give the demuxer name as printed by \-demuxer help.
1360 For backward compatibility it also accepts the demuxer ID as defined in
1361 libmpdemux/\:demuxer.h.
1362 .
1363 .TP
1364 .B \-dumpaudio (MPlayer only)
1365 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
1366 in most other cases the resulting file will not be playable).
1367 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1368 on the command line only the last one will work.
1369 .
1370 .TP
1371 .B \-dumpfile <filename> (MPlayer only)
1372 Specify which file MPlayer should dump to.
1373 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
1374 .
1375 .TP
1376 .B \-dumpstream (MPlayer only)
1377 Dumps the raw stream to ./stream.dump.
1378 Useful when ripping from DVD or network.
1379 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1380 on the command line only the last one will work.
1381 .
1382 .TP
1383 .B \-dumpvideo (MPlayer only)
1384 Dump raw compressed video stream to ./stream.dump (not very usable).
1385 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1386 on the command line only the last one will work.
1387 .
1388 .TP
1389 .B \-dvbin <options> (DVB only)
1390 Pass the following parameters to the DVB input module, in order to override
1391 the default ones:
1392 .sp 1
1393 .PD 0
1394 .RSs
1395 .IPs card=<1\-4>
1396 Specifies using card number 1\-4 (default: 1).
1397 .IPs file=<filename>
1398 Instructs MPlayer to read the channels list from <filename>.
1399 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1400 or ~/.mplayer/\:channels.conf as a last resort.
1401 .IPs timeout=<1\-30>
1402 Maximum number of seconds to wait when trying to tune a
1403 frequency before giving up (default: 30).
1404 .RE
1405 .PD 1
1406 .
1407 .TP
1408 .B \-dvd\-device <path to device> (DVD only)
1409 Specify the DVD device or .iso filename (default: /dev/\:dvd).
1410 You can also specify a directory that contains files previously copied directly
1411 from a DVD (with e.g.\& vobcopy).
1412 .
1413 .TP
1414 .B \-dvd\-speed <factor or speed in KB/s> (DVD only)
1415 Try to limit DVD speed (default: 0, no change).
1416 DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
1417 10800KB/s.
1418 Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
1419 quiet and fast enough.
1420 MPlayer resets the speed to the drive default value on close.
1421 Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
1422 10800KB/s.
1423 .br
1424 .I NOTE:
1425 You need write access to the DVD device to change the speed.
1426 .
1427 .TP
1428 .B \-dvdangle <angle ID> (DVD only)
1429 Some DVD discs contain scenes that can be viewed from multiple angles.
1430 Here you can tell MPlayer which angles to use (default: 1).
1431 .
1432 .TP
1433 .B \-edl <filename>
1434 Enables edit decision list (EDL) actions during playback.
1435 Video will be skipped over and audio will be muted and unmuted according to
1436 the entries in the given file.
1437 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1438 on how to use this.
1439 .
1440 .TP
1441 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1442 Stop at given time or byte position.
1443 .br
1444 .I NOTE:
1445 Byte position is enabled only for MEncoder and will not be accurate, as it can
1446 only stop at a frame boundary.
1447 When used in conjunction with \-ss option, \-endpos time will shift forward by
1448 seconds specified with \-ss.
1449 .sp 1
1450 .I EXAMPLE:
1451 .PD 0
1452 .RSs
1453 .IPs "\-endpos 56"
1454 Stop at 56 seconds.
1455 .IPs "\-endpos 01:10:00"
1456 Stop at 1 hour 10 minutes.
1457 .IPs "\-ss 10 \-endpos 56"
1458 Stop at 1 minute 6 seconds.
1459 .IPs "\-endpos 100mb"
1460 Encode only 100 MB.
1461 .RE
1462 .PD 1
1463 .
1464 .TP
1465 .B \-forceidx
1466 Force index rebuilding.
1467 Useful for files with broken index (A/V desync, etc).
1468 This will enable seeking in files where seeking was not possible.
1469 You can fix the index permanently with MEncoder (see the documentation).
1470 .br
1471 .I NOTE:
1472 This option only works if the underlying media supports seeking
1473 (i.e.\& not with stdin, pipe, etc).
1474 .
1475 .TP
1476 .B \-fps <float value>
1477 Override video framerate.
1478 Useful if the original value is wrong or missing.
1479 .
1480 .TP
1481 .B \-frames <number>
1482 Play/\:convert only first <number> frames, then quit.
1483 .
1484 .TP
1485 .B \-hr\-mp3\-seek (MP3 only)
1486 Hi-res MP3 seeking.
1487 Enabled when playing from an external MP3 file, as we need to seek
1488 to the very exact position to keep A/V sync.
1489 Can be slow especially when seeking backwards since it has to rewind
1490 to the beginning to find an exact frame position.
1491 .
1492 .TP
1493 .B \-idx (also see \-forceidx)
1494 Rebuilds index of files if no index was found, allowing seeking.
1495 Useful with broken/\:incomplete downloads, or badly created files.
1496 .br
1497 .I NOTE:
1498 This option only works if the underlying media supports seeking
1499 (i.e.\& not with stdin, pipe, etc).
1500 .
1501 .TP
1502 .B \-noidx
1503 Skip rebuilding index file.
1504 MEncoder skips writing the index with this option.
1505 .
1506 .TP
1507 .B \-ipv4\-only\-proxy (network only)
1508 Skip the proxy for IPv6 addresses.
1509 It will still be used for IPv4 connections.
1510 .
1511 .TP
1512 .B \-loadidx <index file>
1513 The file from which to read the video index data saved by \-saveidx.
1514 This index will be used for seeking, overriding any index data
1515 contained in the AVI itself.
1516 MPlayer will not prevent you from loading an index file generated
1517 from a different AVI, but this is sure to cause unfavorable results.
1518 .br
1519 .I NOTE:
1520 This option is obsolete now that MPlayer has OpenDML support.
1521 .
1522 .TP
1523 .B \-mc <seconds/frame>
1524 maximum A-V sync correction per frame (in seconds)
1525 .
1526 .TP
1527 .B \-mf <option1:option2:...>
1528 Used when decoding from multiple PNG or JPEG files.
1529 .sp 1
1530 Available options are:
1531 .sp 1
1532 .PD 0
1533 .RSs
1534 .IPs w=<value>
1535 input file width (default: autodetect)
1536 .IPs h=<value>
1537 input file height (default: autodetect)
1538 .IPs fps=<value>
1539 output fps (default: 25)
1540 .IPs type=<value>
1541 input file type (available: jpeg, png, tga, sgi)
1542 .RE
1543 .PD 1
1544 .
1545 .TP
1546 .B \-ni (AVI only)
1547 Force usage of non-interleaved AVI parser (fixes playback
1548 of some bad AVI files).
1549 .
1550 .TP
1551 .B \-nobps (AVI only)
1552 Do not use average byte/\:second value for A-V sync.
1553 Helps with some AVI files with broken header.
1554 .
1555 .TP
1556 .B \-noextbased
1557 Disables extension-based demuxer selection.
1558 By default, when the file type (demuxer) cannot be detected reliably
1559 (the file has no header or it is not reliable enough), the filename
1560 extension is used to select the demuxer.
1561 Always falls back on content-based demuxer selection.
1562 .
1563 .TP
1564 .B \-passwd <password> (also see \-user) (network only)
1565 Specify password for HTTP authentication.
1566 .
1567 .TP
1568 .B \-prefer\-ipv4 (network only)
1569 Use IPv4 on network connections.
1570 Falls back on IPv6 automatically.
1571 .
1572 .TP
1573 .B \-prefer\-ipv6 (IPv6 network only)
1574 Use IPv6 on network connections.
1575 Falls back on IPv4 automatically.
1576 .
1577 .TP
1578 .B \-psprobe <byte position>
1579 When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
1580 how many bytes in the stream you want MPlayer to scan in order to identify
1581 the video codec used.
1582 This option is needed to play EVO or VDR files containing H.264 streams.
1583 .
1584 .TP
1585 .B \-pvr <option1:option2:...> (PVR only)
1586 This option tunes various encoding properties of the PVR capture module.
1587 It has to be used with any hardware MPEG encoder based card supported by the
1588 V4L2 driver.
1589 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1590 cards are known as PVR capture cards.
1591 Be aware that only Linux 2.6.18 kernel
1592 and above is able to handle MPEG stream through V4L2 layer.
1593 For hardware capture of an MPEG stream and watching it with
1594 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1595 .sp 1
1596 Available options are:
1597 .RSs
1598 .IPs aspect=<0\-3>
1599 Specify input aspect ratio:
1600 .RSss
1601 0: 1:1
1602 .br
1603 1: 4:3 (default)
1604 .br
1605 2: 16:9
1606 .br
1607 3: 2.21:1
1608 .REss
1609 .IPs arate=<32000\-48000>
1610 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1611 and 48000 Hz).
1612 .IPs alayer=<1\-3>
1613 Specify MPEG audio layer encoding (default: 2).
1614 .IPs abitrate=<32\-448>
1615 Specify audio encoding bitrate in kbps (default: 384).
1616 .IPs amode=<value>
1617 Specify audio encoding mode.
1618 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1619 .IPs vbitrate=<value>
1620 Specify average video bitrate encoding in Mbps (default: 6).
1621 .IPs vmode=<value>
1622 Specify video encoding mode:
1623 .RSss
1624 vbr: Variable BitRate (default)
1625 .br
1626 cbr: Constant BitRate
1627 .REss
1628 .IPs vpeak=<value>
1629 Specify peak video bitrate encoding in Mbps
1630 (only useful for VBR encoding, default: 9.6).
1631 .IPs fmt=<value>
1632 Choose an MPEG format for encoding:
1633 .RSss
1634 ps:    MPEG-2 Program Stream (default)
1635 .br
1636 ts:    MPEG-2 Transport Stream
1637 .br
1638 mpeg1: MPEG-1 System Stream
1639 .br
1640 vcd:   Video CD compatible stream
1641 .br
1642 svcd:  Super Video CD compatible stream
1643 .br
1644 dvd:   DVD compatible stream
1645 .REss
1646 .RE
1647 .PD 1
1648 .
1649 .TP
1650 .B \-radio <option1:option2:...> (radio only)
1651 These options set various parameters of the radio capture module.
1652 For listening to radio with MPlayer use 'radio://<frequency>'
1653 (if channels option is not given) or 'radio://<channel_number>'
1654 (if channels option is given) as a movie URL.
1655 You can see allowed frequency range by running MPlayer with '\-v'.
1656 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1657 If the capture keyword is not given you can listen to radio
1658 using the line-in cable only.
1659 Using capture to listen is not recommended due to synchronization
1660 problems, which makes this process uncomfortable.
1661 .sp 1
1662 Available options are:
1663 .RSs
1664 .IPs device=<value>
1665 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1666 .IPs driver=<value>
1667 Radio driver to use (default: v4l2 if available, otherwise v4l).
1668 Currently, v4l and v4l2 drivers are supported.
1669 .IPs volume=<0..100>
1670 sound volume for radio device (default 100)
1671 .IPs "freq_min=<value> (*BSD BT848 only)"
1672 minimum allowed frequency (default: 87.50)
1673 .IPs "freq_max=<value> (*BSD BT848 only)"
1674 maximum allowed frequency (default: 108.00)
1675 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1676 Set channel list.
1677 Use _ for spaces in names (or play with quoting ;-).
1678 The channel names will then be written using OSD and the slave commands
1679 radio_step_channel and radio_set_channel will be usable for
1680 a remote control (see LIRC).
1681 If given, number in movie URL will be treated as channel position in
1682 channel list.
1683 .br
1684 .I EXAMPLE:
1685 radio://1, radio://104.4, radio_set_channel 1
1686 .IPs "adevice=<value> (radio capture only)"
1687 Name of device to capture sound from.
1688 Without such a name capture will be disabled,
1689 even if the capture keyword appears in the URL.
1690 For ALSA devices use it in the form hw=<card>.<device>.
1691 If the device name contains a '=', the module will use
1692 ALSA to capture, otherwise OSS.
1693 .IPs "arate=<value> (radio capture only)"
1694 Rate in samples per second (default: 44100).
1695 .br
1696 .I NOTE:
1697 When using audio capture set also \-rawaudio rate=<value> option
1698 with the same value as arate.
1699 If you have problems with sound speed (runs too quickly), try to play
1700 with different rate values (e.g.\& 48000,44100,32000,...).
1701 .IPs "achannels=<value> (radio capture only)"
1702 Number of audio channels to capture.
1703 .RE
1704 .
1705 .TP
1706 .B \-rawaudio <option1:option2:...>
1707 This option lets you play raw audio files.
1708 You have to use \-demuxer rawaudio as well.
1709 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1710 For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1711 .sp 1
1712 Available options are:
1713 .sp 1
1714 .PD 0
1715 .RSs
1716 .IPs channels=<value>
1717 number of channels
1718 .IPs rate=<value>
1719 rate in samples per second
1720 .IPs samplesize=<value>
1721 sample size in bytes
1722 .IPs bitrate=<value>
1723 bitrate for rawaudio files
1724 .IPs format=<value>
1725 fourcc in hex
1726 .RE
1727 .PD 1
1728 .
1729 .TP
1730 .B \-rawvideo <option1:option2:...>
1731 This option lets you play raw video files.
1732 You have to use \-demuxer rawvideo as well.
1733 .sp 1
1734 Available options are:
1735 .sp 1
1736 .PD 0
1737 .RSs
1738 .IPs fps=<value>
1739 rate in frames per second (default: 25.0)
1740 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1741 set standard image size
1742 .IPs w=<value>
1743 image width in pixels
1744 .IPs h=<value>
1745 image height in pixels
1746 .IPs i420|yv12|yuy2|y8
1747 set colorspace
1748 .IPs format=<value>
1749 colorspace (fourcc) in hex or string constant.
1750 Use \-rawvideo format=help for a list of possible strings.
1751 .IPs size=<value>
1752 frame size in Bytes
1753 .REss
1754 .sp 1
1755 .RS
1756 .I EXAMPLE:
1757 .RE
1758 .PD 0
1759 .RSs
1760 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1761 Play the famous "foreman" sample video.
1762 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1763 Play a raw YUV sample.
1764 .RE
1765 .PD 1
1766 .
1767 .TP
1768 .B \-rtsp\-port
1769 Used with 'rtsp://' URLs to force the client's port number.
1770 This option may be useful if you are behind a router and want to forward
1771 the RTSP stream from the server to a specific client.
1772 .
1773 .TP
1774 .B \-rtsp\-destination
1775 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1776 This option may be useful with some RTSP server which do not
1777 send RTP packets to the right interface.
1778 If the connection to the RTSP server fails, use \-v to see
1779 which IP address MPlayer tries to bind to and try to force
1780 it to one assigned to your computer instead.
1781 .
1782 .TP
1783 .B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
1784 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1785 packets be streamed over TCP (using the same TCP connection as RTSP).
1786 This option may be useful if you have a broken internet connection that does
1787 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1788 .
1789 .TP
1790 .B \-saveidx <filename>
1791 Force index rebuilding and dump the index to <filename>.
1792 Currently this only works with AVI files.
1793 .br
1794 .I NOTE:
1795 This option is obsolete now that MPlayer has OpenDML support.
1796 .
1797 .TP
1798 .B \-sb <byte position> (also see \-ss)
1799 Seek to byte position.
1800 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1801 .
1802 .TP
1803 .B \-speed <0.01\-100>
1804 Slow down or speed up playback by the factor given as parameter.
1805 Not guaranteed to work correctly with \-oac copy.
1806 .
1807 .TP
1808 .B \-srate <Hz>
1809 Selects the output sample rate to be used
1810 (of course sound cards have limits on this).
1811 If the sample frequency selected is different from that
1812 of the current media, the resample or lavcresample audio filter will be inserted
1813 into the audio filter layer to compensate for the difference.
1814 The type of resampling can be controlled by the \-af\-adv option.
1815 The default is fast resampling that may cause distortion.
1816 .
1817 .TP
1818 .B \-ss <time> (also see \-sb)
1819 Seek to given time position.
1820 .sp 1
1821 .I EXAMPLE:
1822 .PD 0
1823 .RSs
1824 .IPs "\-ss 56"
1825 Seeks to 56 seconds.
1826 .IPs "\-ss 01:10:00"
1827 Seeks to 1 hour 10 min.
1828 .RE
1829 .PD 1
1830 .
1831 .TP
1832 .B \-tskeepbroken
1833 Tells MPlayer not to discard TS packets reported as broken in the stream.
1834 Sometimes needed to play corrupted MPEG-TS files.
1835 .
1836 .TP
1837 .B \-tsprobe <byte position>
1838 When playing an MPEG-TS stream, this option lets you specify how many
1839 bytes in the stream you want MPlayer to search for the desired
1840 audio and video IDs.
1841 .
1842 .TP
1843 .B \-tsprog <1\-65534>
1844 When playing an MPEG-TS stream, you can specify with this option which
1845 program (if present) you want to play.
1846 Can be used with \-vid and \-aid.
1847 .
1848 .TP
1849 .B \-tv <option1:option2:...> (TV/\:PVR only)
1850 This option tunes various properties of the TV capture module.
1851 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
1852 or even 'tv://<channel_name> (see option channels for channel_name below)
1853 as a movie URL.
1854 You can also use 'tv:///<input_id>' to start watching a
1855 movie from a composite or S-Video input (see option input for details).
1856 .sp 1
1857 Available options are:
1858 .RSs
1859 .IPs noaudio
1860 no sound
1861 .IPs "automute=<0\-255> (v4l and v4l2 only)"
1862 If signal strength reported by device is less than this value,
1863 audio and video will be muted.
1864 In most cases automute=100 will be enough.
1865 Default is 0 (automute disabled).
1866 .IPs driver=<value>
1867 See \-tv driver=help for a list of compiled-in TV input drivers.
1868 available: dummy, v4l, v4l2, bsdbt848 (default: autodetect)
1869 .IPs device=<value>
1870 Specify TV device (default: /dev/\:video0).
1871 .I NOTE:
1872 For the bsdbt848 driver you can provide both bktr and tuner device
1873 names separating them with a comma, tuner after
1874 bktr (e.g.\& -tv device=/dev/bktr1,/dev/tuner1).
1875 .IPs input=<value>
1876 Specify input (default: 0 (TV), see console output for available inputs).
1877 .IPs freq=<value>
1878 Specify the frequency to set the tuner to (e.g.\& 511.250).
1879 Not compatible with the channels parameter.
1880 .IPs outfmt=<value>
1881 Specify the output format of the tuner with a preset value supported by the
1882 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1883 arbitrary format given as hex value.
1884 Try outfmt=help for a list of all available formats.
1885 .IPs width=<value>
1886 output window width
1887 .IPs height=<value>
1888 output window height
1889 .IPs fps=<value>
1890 framerate at which to capture video (frames per second)
1891 .IPs buffersize=<value>
1892 maximum size of the capture buffer in megabytes (default: dynamical)
1893 .IPs norm=<value>
1894 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
1895 For v4l2, see the console output for a list of all available norms,
1896 also see the normid option below.
1897 .IPs "normid=<value> (v4l2 only)"
1898 Sets the TV norm to the given numeric ID.
1899 The TV norm depends on the capture card.
1900 See the console output for a list of available TV norms.
1901 .IPs channel=<value>
1902 Set tuner to <value> channel.
1903 .IPs chanlist=<value>
1904 available: europe-east, europe-west, us-bcast, us-cable, etc
1905 .IPs channels=<channel>\-<name>[=<norm>],<channel>\-<name>[=<norm>],...
1906 Set names for channels.
1907 .I NOTE:
1908 If <channel> is an integer greater than 1000, it will be treated as frequency (in kHz)
1909 rather than channel name from frequency table.
1910 .br
1911 Use _ for spaces in names (or play with quoting ;-).
1912 The channel names will then be written using OSD, and the slave commands
1913 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
1914 a remote control (see LIRC).
1915 Not compatible with the frequency parameter.
1916 .br
1917 .I NOTE:
1918 The channel number will then be the position in the 'channels' list,
1919 beginning with 1.
1920 .br
1921 .I EXAMPLE:
1922 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
1923 .IPs [brightness|contrast|hue|saturation]=<\-100\-100>
1924 Set the image equalizer on the card.
1925 .IPs audiorate=<value>
1926 Set audio capture bitrate.
1927 .IPs forceaudio
1928 Capture audio even if there are no audio sources reported by v4l.
1929 .IPs "alsa\ "
1930 Capture from ALSA.
1931 .IPs amode=<0\-3>
1932 Choose an audio mode:
1933 .RSss
1934 0: mono
1935 .br
1936 1: stereo
1937 .br
1938 2: language 1
1939 .br
1940 3: language 2
1941 .REss
1942 .IPs forcechan=<1\-2>
1943 By default, the count of recorded audio channels is determined automatically
1944 by querying the audio mode from the TV card.
1945 This option allows forcing stereo/\:mono recording regardless of the amode
1946 option and the values returned by v4l.
1947 This can be used for troubleshooting when the TV card is unable to report the
1948 current audio mode.
1949 .IPs adevice=<value>
1950 Set an audio device.
1951 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
1952 You must replace any ':' by a '.' in the hardware ID for ALSA.
1953 .IPs audioid=<value>
1954 Choose an audio output of the capture card, if it has more than one.
1955 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
1956 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
1957 These options set parameters of the mixer on the video capture card.
1958 They will have no effect, if your card does not have one.
1959 For v4l2 50 maps to the default value of the
1960 control, as reported by the driver.
1961 .IPs "gain=<0\-100> (v4l2)"
1962 Set gain control for video devices (usually webcams) to the desired
1963 value and switch off automatic control.
1964 A value of 0 enables automatic control.
1965 If this option is omitted, gain control will not be modified.
1966 .IPs immediatemode=<bool>
1967 A value of 0 means capture and buffer audio and video together
1968 (default for MEncoder).
1969 A value of 1 (default for MPlayer) means to do video capture only and let the
1970 audio go through a loopback cable from the TV card to the sound card.
1971 .IPs mjpeg
1972 Use hardware MJPEG compression (if the card supports it).
1973 When using this option, you do not need to specify the width and height
1974 of the output window, because MPlayer will determine it automatically
1975 from the decimation value (see below).
1976 .IPs decimation=<1|2|4>
1977 choose the size of the picture that will be compressed by hardware
1978 MJPEG compression:
1979 .RSss
1980 1: full size
1981     704x576    PAL
1982     704x480    NTSC
1983 .br
1984 2: medium size
1985     352x288    PAL
1986     352x240    NTSC
1987 .br
1988 4: small size
1989     176x144    PAL
1990     176x120    NTSC
1991 .REss
1992 .IPs quality=<0\-100>
1993 Choose the quality of the JPEG compression
1994 (< 60 recommended for full size).
1995 .IPs tdevice=<value>
1996 Specify TV teletext device (example: /dev/\:vbi0) (default: none).
1997 .IPs tformat=<format>
1998 Specify TV teletext display format (default: 0):
1999 .RSss
2000 0: opaque
2001 .br
2002 1: transparent
2003 .br
2004 2: opaque with inverted colors
2005 .br
2006 3: transparent with inverted colors
2007 .REss
2008 .IPs tpage=<100\-899>
2009 Specify initial TV teletext page number (default: 100).
2010 .IPs tlang=<\-1\-127>
2011 Specify default teletext language code (default: 0), which will be used
2012 as primary language until a type 28 packet is received.
2013 Useful when the teletext system uses a non-latin character set, but language
2014 codes are not transmitted via teletext type 28 packets for some reason.
2015 To see a list of supported language codes set this option to \-1.
2016 .IPs "hidden_video_renderer (dshow only)"
2017 Terminate stream with video renderer instead of Null renderer (default: off).
2018 Will help if video freezes but audio does not.
2019 .I NOTE:
2020 May not work with \-vo directx and \-vf crop combination.
2021 .IPs "hidden_vp_renderer (dshow only)"
2022 Terminate VideoPort pin stream with video renderer
2023 instead of removing it from the graph (default: off).
2024 Useful if your card has a VideoPort pin and video is choppy.
2025 .I NOTE:
2026 May not work with \-vo directx and \-vf crop combination.
2027 .IPs "system_clock (dshow only)"
2028 Use the system clock as sync source instead of the default graph clock
2029 (usually the clock from one of the live sources in graph).
2030 .IPs "normalize_audio_chunks (dshow only)"
2031 Create audio chunks with a time length equal to
2032 video frame time length (default: off).
2033 Some audio cards create audio chunks about 0.5s in size, resulting in
2034 choppy video when using immediatemode=0.
2035 .RE
2036 .
2037 .TP
2038 .B \-tvscan <option1:option2:...> (TV and MPlayer only)
2039 Tune the TV channel scanner.
2040 MPlayer will also print value for "-tv channels=" option,
2041 including existing and just found channels.
2042 .sp 1
2043 Available suboptions are:
2044 .RSs
2045 .IPs autostart
2046 Begin channel scanning immediately after startup (default: disabled).
2047 .IPs period=<0.1\-2.0>
2048 Specify delay in seconds before switching to next channel (default: 0.5).
2049 Lower values will cause faster scanning, but can detect
2050 inactive TV channels as active.
2051 .IPs threshold=<1\-100>
2052 Threshold value for the signal strength (in percent), as reported
2053 by the device (default: 50).
2054 A signal strength higher than this value will indicate that the
2055 currently scanning channel is active.
2056 .RE
2057 .
2058 .TP
2059 .B \-user <username> (also see \-passwd) (network only)
2060 Specify username for HTTP authentication.
2061 .
2062 .TP
2063 .B \-user\-agent <string>
2064 Use <string> as user agent for HTTP streaming.
2065 .
2066 .TP
2067 .B \-vid <ID>
2068 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
2069 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
2070 (if present) with the chosen video stream.
2071 .
2072 .TP
2073 .B \-vivo <suboption> (DEBUG CODE)
2074 Force audio parameters for the VIVO demuxer (for debugging purposes).
2075 FIXME: Document this.
2076 .
2077 .
2078 .
2079 .SH "OSD/SUBTITLE OPTIONS"
2080 .I NOTE:
2081 Also see \-vf expand.
2082 .
2083 .TP
2084 .B \-ass (FreeType only)
2085 Turn on SSA/ASS subtitle rendering.
2086 With this option, libass will be used for SSA/ASS
2087 external subtitles and Matroska tracks.
2088 You may also want to use \-embeddedfonts.
2089 .br
2090 .I NOTE:
2091 Unlike normal OSD, libass uses fontconfig by default. To disable it, use
2092 \-nofontconfig.
2093 .
2094 .TP
2095 .B \-ass\-border\-color <value>
2096 Sets the border (outline) color for text subtitles.
2097 The color format is RRGGBBAA.
2098 .
2099 .TP
2100 .B \-ass\-bottom\-margin <value>
2101 Adds a black band at the bottom of the frame.
2102 The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
2103 .
2104 .TP
2105 .B \-ass\-color <value>
2106 Sets the color for text subtitles.
2107 The color format is RRGGBBAA.
2108 .
2109 .TP
2110 .B \-ass\-font\-scale <value>
2111 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
2112 .
2113 .TP
2114 .B \-ass\-force\-style <[Style.]Param=Value[,...]>
2115 Override some style or script info parameters.
2116 .sp
2117 .I EXAMPLE:
2118 .PD 0
2119 .RSs
2120 \-ass\-force\-style FontName=Arial,Default.Bold=1
2121 .br
2122 \-ass\-force\-style PlayResY=768
2123 .RE
2124 .PD 1
2125 .
2126 .TP
2127 .B \-ass\-hinting <type>
2128 Set hinting type.
2129 <type> can be:
2130 .PD 0
2131 .RSs
2132 .IPs 0
2133 no hinting
2134 .IPs 1
2135 FreeType autohinter, light mode
2136 .IPs 2
2137 FreeType autohinter, normal mode
2138 .IPs 3
2139 font native hinter
2140 .IPs "0-3 + 4"
2141 The same, but hinting will only be performed if the OSD is rendered at
2142 screen resolution and will therefore not be scaled.
2143 .RE
2144 .RSs
2145 The default value is 7 (use native hinter for unscaled OSD and no hinting otherwise).
2146 .RE
2147 .PD 1
2148 .
2149 .TP
2150 .B \-ass\-line\-spacing <value>
2151 Set line spacing value for SSA/ASS renderer.
2152 .
2153 .TP
2154 .B \-ass\-styles <filename>
2155 Load all SSA/ASS styles found in the specified file and use them for
2156 rendering text subtitles.
2157 The syntax of the file is exactly like the
2158 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
2159 .
2160 .TP
2161 .B \-ass\-top\-margin <value>
2162 Adds a black band at the top of the frame.
2163 The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
2164 .
2165 .TP
2166 .B \-ass\-use\-margins
2167 Enables placing toptitles and subtitles in black borders when they
2168 are available.
2169 .
2170 .TP
2171 .B \-dumpjacosub (MPlayer only)
2172 Convert the given subtitle (specified with the \-sub option) to the time-based
2173 JACOsub subtitle format.
2174 Creates a dumpsub.js file in the current directory.
2175 .
2176 .TP
2177 .B \-dumpmicrodvdsub (MPlayer only)
2178 Convert the given subtitle (specified with the \-sub option) to the
2179 MicroDVD subtitle format.
2180 Creates a dumpsub.sub file in the current directory.
2181 .
2182 .TP
2183 .B \-dumpmpsub (MPlayer only)
2184 Convert the given subtitle (specified with the \-sub option) to MPlayer's
2185 subtitle format, MPsub.
2186 Creates a dump.mpsub file in the current directory.
2187 .
2188 .TP
2189 .B \-dumpsami (MPlayer only)
2190 Convert the given subtitle (specified with the \-sub option) to the time-based
2191 SAMI subtitle format.
2192 Creates a dumpsub.smi file in the current directory.
2193 .
2194 .TP
2195 .B \-dumpsrtsub (MPlayer only)
2196 Convert the given subtitle (specified with the \-sub option) to the time-based
2197 SubViewer (SRT) subtitle format.
2198 Creates a dumpsub.srt file in the current directory.
2199 .br
2200 .I NOTE:
2201 Some broken hardware players choke on SRT subtitle files with Unix
2202 line endings.
2203 If you are unlucky enough to have such a box, pass your subtitle
2204 files through unix2dos or a similar program to replace Unix line
2205 endings with DOS/Windows line endings.
2206 .
2207 .TP
2208 .B \-dumpsub (MPlayer only) (BETA CODE)
2209 Dumps the subtitle substream from VOB streams.
2210 Also see the \-dump*sub and \-vobsubout* options.
2211 .
2212 .TP
2213 .B \-embeddedfonts (FreeType only)
2214 Enables extraction of Matroska embedded fonts (default: disabled).
2215 These fonts can be used for SSA/ASS subtitle
2216 rendering (\-ass option).
2217 Font files are created in the ~/.mplayer/\:fonts directory.
2218 .br
2219 .I NOTE:
2220 With FontConfig 2.4.2 or newer, embedded fonts are opened directly from memory,
2221 and this option is enabled by default.
2222 .
2223 .TP
2224 .B \-ffactor <number>
2225 Resample the font alphamap.
2226 Can be:
2227 .PD 0
2228 .RSs
2229 .IPs 0
2230 plain white fonts
2231 .IPs 0.75
2232 very narrow black outline (default)
2233 .IPs 1
2234 narrow black outline
2235 .IPs 10
2236 bold black outline
2237 .RE
2238 .PD 1
2239 .
2240 .TP
2241 .B \-flip\-hebrew (FriBiDi only)
2242 Turns on flipping subtitles using FriBiDi.
2243 .
2244 .TP
2245 .B \-noflip\-hebrew\-commas
2246 Change FriBiDi's assumptions about the placements of commas in subtitles.
2247 Use this if commas in subtitles are shown at the start of a sentence
2248 instead of at the end.
2249 .
2250 .TP
2251 .B \-font <path to font.desc file>
2252 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
2253 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
2254 ~/.mplayer/\:subfont.ttf).
2255 .br
2256 .I NOTE:
2257 With FreeType, this option determines the path to the text font file.
2258 With fontconfig, this option determines the fontconfig font name.
2259 .sp 1
2260 .I EXAMPLE:
2261 .PD 0
2262 .RSs
2263 \-font ~/\:.mplayer/\:arial-14/\:font.desc
2264 .br
2265 \-font ~/\:.mplayer/\:arialuni.ttf
2266 .br
2267 \-font 'Bitstream Vera Sans'
2268 .RE
2269 .PD 1
2270 .
2271 .TP
2272 .B \-fontconfig (fontconfig only)
2273 Enables the usage of fontconfig managed fonts.
2274 .br
2275 .I NOTE:
2276 By default fontconfig is used for libass-rendered subtitles and not used for
2277 OSD. With \-fontconfig it is used for both libass and OSD, with \-nofontconfig
2278 it is not used at all.
2279 .
2280 .TP
2281 .B \-forcedsubsonly
2282 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
2283 \-slang.
2284 .
2285 .TP
2286 .B \-fribidi\-charset <charset name> (FriBiDi only)
2287 Specifies the character set that will be passed to FriBiDi when
2288 decoding non-UTF-8 subtitles (default: ISO8859-8).
2289 .
2290 .TP
2291 .B \-ifo <VOBsub IFO file>
2292 Indicate the file that will be used to load palette and frame size for VOBsub
2293 subtitles.
2294 .
2295 .TP
2296 .B \-noautosub
2297 Turns off automatic subtitle file loading.
2298 .
2299 .TP
2300 .B \-osd\-duration <time>
2301 Set the duration of the OSD messages in ms (default: 1000).
2302 .
2303 .TP
2304 .B \-osdlevel <0\-3> (MPlayer only)
2305 Specifies which mode the OSD should start in.
2306 .PD 0
2307 .RSs
2308 .IPs 0
2309 subtitles only
2310 .IPs 1
2311 volume + seek (default)
2312 .IPs 2
2313 volume + seek + timer + percentage
2314 .IPs 3
2315 volume + seek + timer + percentage + total time
2316 .RE
2317 .PD 1
2318 .
2319 .TP
2320 .B \-overlapsub
2321 Allows the next subtitle to be displayed while the current one is
2322 still visible (default is to enable the support only for specific
2323 formats).
2324 .
2325 .TP
2326 .B \-sid <ID> (also see \-slang, \-vobsubid)
2327 Display the subtitle stream specified by <ID> (0\-31).
2328 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2329 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2330 .
2331 .TP
2332 .B \-slang <language code[,language code,...]> (also see \-sid)
2333 Specify a priority list of subtitle languages to use.
2334 Different container formats employ different language codes.
2335 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2336 three letter language codes while OGM uses a free-form identifier.
2337 MPlayer prints the available languages when run in verbose (\-v) mode.
2338 .sp 1
2339 .I EXAMPLE:
2340 .PD 0
2341 .RSs
2342 .IPs "mplayer dvd://1 \-slang hu,en"
2343 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2344 Hungarian is not available.
2345 .IPs "mplayer \-slang jpn example.mkv"
2346 Plays a Matroska file with Japanese subtitles.
2347 .RE
2348 .PD 1
2349 .
2350 .TP
2351 .B \-spuaa <mode>
2352 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2353 A value of 16 may be added to <mode> in order to force scaling even
2354 when original and scaled frame size already match.
2355 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2356 Available modes are:
2357 .PD 0
2358 .RSs
2359 .IPs 0
2360 none (fastest, very ugly)
2361 .IPs 1
2362 approximate (broken?)
2363 .IPs 2
2364 full (slow)
2365 .IPs 3
2366 bilinear (default, fast and not too bad)
2367 .IPs 4
2368 uses swscaler gaussian blur (looks very good)
2369 .RE
2370 .PD 1
2371 .
2372 .TP
2373 .B \-spualign <\-1\-2>
2374 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2375 .PD 0
2376 .RSs
2377 .IPs "\-1"
2378 original position
2379 .IPs " 0"
2380 Align at top (original behavior, default).
2381 .IPs " 1"
2382 Align at center.
2383 .IPs " 2"
2384 Align at bottom.
2385 .RE
2386 .PD 1
2387 .
2388 .TP
2389 .B \-spugauss <0.0\-3.0>
2390 Variance parameter of gaussian used by \-spuaa 4.
2391 Higher means more blur (default: 1.0).
2392 .
2393 .TP
2394 .B \-sub <subtitlefile1,subtitlefile2,...>
2395 Use/\:display these subtitle files.
2396 Only one file can be displayed at the same time.
2397 .
2398 .TP
2399 .B \-sub\-bg\-alpha <0\-255>
2400 Specify the alpha channel value for subtitles and OSD backgrounds.
2401 Big values mean more transparency.
2402 0 means completely transparent.
2403 .
2404 .TP
2405 .B \-sub\-bg\-color <0\-255>
2406 Specify the color value for subtitles and OSD backgrounds.
2407 Currently subtitles are grayscale so this value is equivalent to the
2408 intensity of the color.
2409 255 means white and 0 black.
2410 .
2411 .TP
2412 .B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
2413 Force subtitle demuxer type for \-subfile.
2414 Use a '+' before the name to force it, this will skip some checks!
2415 Give the demuxer name as printed by \-sub\-demuxer help.
2416 For backward compatibility it also accepts the demuxer ID as defined in
2417 subreader.h.
2418 .
2419 .TP
2420 .B \-sub\-fuzziness <mode>
2421 Adjust matching fuzziness when searching for subtitles:
2422 .PD 0
2423 .RSs
2424 .IPs 0
2425 exact match
2426 .IPs 1
2427 Load all subs containing movie name.
2428 .IPs 2
2429 Load all subs in the current directory.
2430 .RE
2431 .PD 1
2432 .
2433 .TP
2434 .B \-sub\-no\-text\-pp
2435 Disables any kind of text post processing done after loading the subtitles.
2436 Used for debug purposes.
2437 .
2438 .TP
2439 .B \-subalign <0\-2>
2440 Specify which edge of the subtitles should be aligned at the height
2441 given by \-subpos.
2442 .PD 0
2443 .RSs
2444 .IPs 0
2445 Align subtitle top edge (original behavior).
2446 .IPs 1
2447 Align subtitle center.
2448 .IPs 2
2449 Align subtitle bottom edge (default).
2450 .RE
2451 .PD 1
2452 .
2453 .TP
2454 .B "\-subcc \ "
2455 Display DVD Closed Caption (CC) subtitles.
2456 These are
2457 .B not
2458 the VOB subtitles, these are special ASCII subtitles for the
2459 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2460 CC subtitles have not been spotted on DVDs from other regions so far.
2461 .
2462 .TP
2463 .B \-subcp <codepage> (iconv only)
2464 If your system supports iconv(3), you can use this option to
2465 specify the subtitle codepage.
2466 .sp 1
2467 .I EXAMPLE:
2468 .PD 0
2469 .RSs
2470 \-subcp latin2
2471 .br
2472 \-subcp cp1250
2473 .RE
2474 .PD 1
2475 .
2476 .TP
2477 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2478 You can specify your language using a two letter language code to
2479 make ENCA detect the codepage automatically.
2480 If unsure, enter anything and watch mplayer \-v output for available
2481 languages.
2482 Fallback codepage specifies the codepage to use, when autodetection fails.
2483 .sp 1
2484 .I EXAMPLE:
2485 .PD 0
2486 .RSs
2487 .IPs "\-subcp enca:cs:latin2"
2488 Guess the encoding, assuming the subtitles are Czech, fall back on
2489 latin 2, if the detection fails.
2490 .IPs "\-subcp enca:pl:cp1250"
2491 Guess the encoding for Polish, fall back on cp1250.
2492 .RE
2493 .PD 1
2494 .
2495 .TP
2496 .B \-subdelay <sec>
2497 Delays subtitles by <sec> seconds.
2498 Can be negative.
2499 .
2500 .TP
2501 .B \-subfile <filename> (BETA CODE)
2502 Currently useless.
2503 Same as \-audiofile, but for subtitle streams (OggDS?).
2504 .
2505 .TP
2506 .B \-subfont <filename> (FreeType only)
2507 Sets the subtitle font.
2508 If no \-subfont is given, \-font is used.
2509 .
2510 .TP
2511 .B \-subfont\-autoscale <0\-3> (FreeType only)
2512 Sets the autoscale mode.
2513 .br
2514 .I NOTE:
2515 0 means that text scale and OSD scale are font heights in points.
2516 .sp 1
2517 The mode can be:
2518 .sp 1
2519 .PD 0
2520 .RSs
2521 .IPs 0
2522 no autoscale
2523 .IPs 1
2524 proportional to movie height
2525 .IPs 2
2526 proportional to movie width
2527 .IPs 3
2528 proportional to movie diagonal (default)
2529 .RE
2530 .PD 1
2531 .
2532 .TP
2533 .B \-subfont\-blur <0\-8> (FreeType only)
2534 Sets the font blur radius (default: 2).
2535 .
2536 .TP
2537 .B \-subfont\-encoding <value> (FreeType only)
2538 Sets the font encoding.
2539 When set to 'unicode', all the glyphs from the font file will be rendered and
2540 unicode will be used (default: unicode).
2541 .
2542 .TP
2543 .B \-subfont\-osd\-scale <0\-100> (FreeType only)
2544 Sets the autoscale coefficient of the OSD elements (default: 6).
2545 .
2546 .TP
2547 .B \-subfont\-outline <0\-8> (FreeType only)
2548 Sets the font outline thickness (default: 2).
2549 .
2550 .TP
2551 .B \-subfont\-text\-scale <0\-100> (FreeType only)
2552 Sets the subtitle text autoscale coefficient as percentage of the
2553 screen size (default: 5).
2554 .
2555 .TP
2556 .B \-subfps <rate>
2557 Specify the framerate of the subtitle file (default: movie fps).
2558 .br
2559 .I NOTE:
2560 <rate> > movie fps speeds the subtitles up for frame-based subtitle files and
2561 slows them down for time-based ones.
2562 .
2563 .TP
2564 .B \-subpos <0\-100> (useful with \-vf expand)
2565 Specify the position of subtitles on the screen.
2566 The value is the vertical position of the subtitle in % of the screen height.
2567 .
2568 .TP
2569 .B \-subwidth <10\-100>
2570 Specify the maximum width of subtitles on the screen.
2571 Useful for TV-out.
2572 The value is the width of the subtitle in % of the screen width.
2573 .
2574 .TP
2575 .B \-noterm\-osd
2576 Disable the display of OSD messages on the console when no video output is
2577 available.
2578 .
2579 .TP
2580 .B \-term\-osd\-esc <escape sequence>
2581 Specify the escape sequence to use before writing an OSD message on the
2582 console.
2583 The escape sequence should move the pointer to the beginning of the line
2584 used for the OSD and clear it (default: ^[[A\\r^[[K).
2585 .
2586 .TP
2587 .B \-unicode
2588 Tells MPlayer to handle the subtitle file as unicode.
2589 .
2590 .TP
2591 .B \-unrarexec <path to unrar executable> (not supported on MingW)
2592 Specify the path to the unrar executable so MPlayer can use it to access
2593 rar-compressed VOBsub files (default: not set, so the feature is off).
2594 The path must include the executable's filename, i.e.\& /usr/local/bin/unrar.
2595 .
2596 .TP
2597 .B "\-utf8 \ \ "
2598 Tells MPlayer to handle the subtitle file as UTF-8.
2599 .
2600 .TP
2601 .B \-vobsub <VOBsub file without extension>
2602 Specify a VOBsub file to use for subtitles.
2603 Has to be the full pathname without extension, i.e.\& without
2604 the '.idx', '.ifo' or '.sub'.
2605 .
2606 .TP
2607 .B \-vobsubid <0\-31>
2608 Specify the VOBsub subtitle ID.
2609 .
2610 .
2611 .
2612 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
2613 .
2614 .TP
2615 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2616 Override audio driver/\:card buffer size detection.
2617 .
2618 .TP
2619 .B \-format <format> (also see the format audio filter)
2620 Select the sample format used for output from the audio filter
2621 layer to the sound card.
2622 The values that <format> can adopt are listed below in the
2623 description of the format audio filter.
2624 .
2625 .TP
2626 .B \-mixer <device>
2627 Use a mixer device different from the default /dev/\:mixer.
2628 For ALSA this is the mixer name.
2629 .
2630 .TP
2631 .B \-mixer\-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2632 This option will tell MPlayer to use a different channel for controlling
2633 volume than the default PCM.
2634 Options for OSS include
2635 .B vol, pcm, line.
2636 For a complete list of options look for SOUND_DEVICE_NAMES in
2637 /usr/\:include/\:linux/\:soundcard.h.
2638 For ALSA you can use the names e.g.\& alsamixer displays, like
2639 .B Master, Line, PCM.
2640 .br
2641 .I NOTE:
2642 ALSA mixer channel names followed by a number must be specified in the
2643 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2644 be converted to
2645 .BR PCM,1 .
2646 .
2647 .TP
2648 .B \-softvol
2649 Force the use of the software mixer, instead of using the sound card
2650 mixer.
2651 .
2652 .TP
2653 .B \-softvol\-max <10.0\-10000.0>
2654 Set the maximum amplification level in percent (default: 110).
2655 A value of 200 will allow you to adjust the volume up to a maximum of
2656 double the current level.
2657 With values below 100 the initial volume (which is 100%) will be above
2658 the maximum, which e.g.\& the OSD cannot display correctly.
2659 .
2660 .TP
2661 .B \-volstep <0\-100>
2662 Set the step size of mixer volume changes in percent of the whole range
2663 (default: 3).
2664 .
2665 .TP
2666 .B \-volume <-1\-100> (also see \-af volume)
2667 Set the startup volume in the mixer, either hardware or software (if
2668 used with \-softvol).
2669 A value of -1 (the default) will not change the volume.
2670 .
2671 .
2672 .
2673 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
2674 Audio output drivers are interfaces to different audio output facilities.
2675 The syntax is:
2676 .
2677 .TP
2678 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2679 Specify a priority list of audio output drivers to be used.
2680 .PP
2681 If the list has a trailing ',' MPlayer will fall back on drivers not
2682 contained in the list.
2683 Suboptions are optional and can mostly be omitted.
2684 .br
2685 .I NOTE:
2686 See \-ao help for a list of compiled-in audio output drivers.
2687 .sp 1
2688 .I EXAMPLE:
2689 .PD 0
2690 .RSs
2691 .IPs "\-ao alsa,oss,"
2692 Try the ALSA driver, then the OSS driver, then others.
2693 .IPs "\-ao alsa:noblock:device=hw=0.3"
2694 Sets noblock-mode and the device-name as first card, fourth device.
2695 .RE
2696 .PD 1
2697 .sp 1
2698 Available audio output drivers are:
2699 .
2700 .TP
2701 .B "alsa\ \ \ "
2702 ALSA 0.9/1.x audio output driver
2703 .PD 0
2704 .RSs
2705 .IPs noblock
2706 Sets noblock-mode.
2707 .IPs device=<device>
2708 Sets the device name.
2709 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2710 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2711 you really know how to set it correctly.
2712 .RE
2713 .PD 1
2714 .
2715 .TP
2716 .B "alsa5\ \ "
2717 ALSA 0.5 audio output driver
2718 .
2719 .TP
2720 .B "oss\ \ \ \ "
2721 OSS audio output driver
2722 .PD 0
2723 .RSs
2724 .IPs <dsp-device>
2725 Sets the audio output device (default: /dev/\:dsp).
2726 .IPs <mixer-device>
2727 Sets the audio mixer device (default: /dev/\:mixer).
2728 .IPs <mixer-channel>
2729 Sets the audio mixer channel (default: pcm).
2730 .RE
2731 .PD 1
2732 .
2733 .TP
2734 .B sdl (SDL only)
2735 highly platform independent SDL (Simple Directmedia Layer) library
2736 audio output driver
2737 .PD 0
2738 .RSs
2739 .IPs <driver>
2740 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2741 .RE
2742 .PD 1
2743 .
2744 .TP
2745 .B "arts\ \ \ "
2746 audio output through the aRts daemon
2747 .
2748 .TP
2749 .B "esd\ \ \ \ "
2750 audio output through the ESD daemon
2751 .PD 0
2752 .RSs
2753 .IPs <server>
2754 Explicitly choose the ESD server to use (default: localhost).
2755 .RE
2756 .PD 1
2757 .
2758 .TP
2759 .B "jack\ \ \ \ "
2760 audio output through JACK (Jack Audio Connection Kit)
2761 .PD 0
2762 .RSs
2763 .IPs port=<name>
2764 Connects to the ports with the given name (default: physical ports).
2765 .IPs name=<client name>
2766 Client name that is passed to JACK (default: MPlayer [<PID>]).
2767 Useful if you want to have certain connections established automatically.
2768 .IPs (no)estimate
2769 Estimate the audio delay, supposed to make the video playback smoother
2770 (default: enabled).
2771 .IPs (no)autostart (default: disabled)
2772 Automatically start jackd if necessary.
2773 Note that this seems unreliable and will spam stdout with server messages.
2774 .RE
2775 .PD 1
2776 .
2777 .TP
2778 .B "nas\ \ \ \ "
2779 audio output through NAS
2780 .
2781 .TP
2782 .B macosx (Mac OS X only)
2783 native Mac OS X audio output driver
2784 .
2785 .TP
2786 .B "openal\ "
2787 Experimental OpenAL audio output driver
2788 .
2789 .TP
2790 .B "pulse\ \ "
2791 PulseAudio audio output driver
2792 .PD 0
2793 .RSs
2794 .IPs "[<host>][:<output sink>]"
2795 Specify the host and optionally output sink to use.
2796 An empty <host> string uses a local connection, "localhost"
2797 uses network transfer (most likely not what you want).
2798 .RE
2799 .PD 1
2800 .
2801 .TP
2802 .B sgi (SGI only)
2803 native SGI audio output driver
2804 .PD 0
2805 .RSs
2806 .IPs "<output device name>"
2807 Explicitly choose the output device/\:interface to use
2808 (default: system-wide default).
2809 For example, 'Analog Out' or 'Digital Out'.
2810 .RE
2811 .PD 1
2812 .
2813 .TP
2814 .B sun (Sun only)
2815 native Sun audio output driver
2816 .PD 0
2817 .RSs
2818 .IPs <device>
2819 Explicitly choose the audio device to use (default: /dev/\:audio).
2820 .RE
2821 .PD 1
2822 .
2823 .TP
2824 .B win32 (Windows only)
2825 native Windows waveout audio output driver
2826 .
2827 .TP
2828 .B dsound (Windows only)
2829 DirectX DirectSound audio output driver
2830 .PD 0
2831 .RSs
2832 .IPs device=<devicenum>
2833 Sets the device number to use.
2834 Playing a file with \-v will show a list of available devices.
2835 .RE
2836 .PD 1
2837 .
2838 .TP
2839 .B dxr2 (also see \-dxr2) (DXR2 only)
2840 Creative DXR2 specific output driver