Update to MPlayer SVN rev 34180.
[vaapi:kinkis-mplayer.git] / DOCS / man / en / .svn / text-base / mplayer.1.svn-base
1 .\" $Revision$
2 .\" MPlayer (C) 2000-2010 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-03-25" "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 [br]://[title][/device]
65 [options]
66 .
67 .br
68 .B mplayer
69 [dvd|dvdnav]://[title|[start_title]\-end_title][/device]
70 [options]
71 .
72 .br
73 .B mplayer
74 vcd://track[/device]
75 .
76 .br
77 .B mplayer
78 tv://[channel][/input_id]
79 [options]
80 .
81 .br
82 .B mplayer
83 radio://[channel|frequency][/capture]
84 [options]
85 .
86 .br
87 .B mplayer
88 pvr://
89 [options]
90 .
91 .br
92 .B mplayer
93 dvb://[card_number@]channel
94 [options]
95 .
96 .br
97 .B mplayer
98 mf://[filemask|@listfile]
99 [\-mf options] [options]
100 .
101 .br
102 .B mplayer
103 [cdda|cddb]://track[\-endtrack][:speed][/device]
104 [options]
105 .
106 .br
107 .B mplayer
108 cue://file[:track]
109 [options]
110 .
111 .br
112 .B mplayer
113 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
114 [user:pass@]URL[:port] [options]
115 .
116 .br
117 .B mplayer
118 sdp://file
119 [options]
120 .
121 .br
122 .B mplayer
123 mpst://host[:port]/URL
124 [options]
125 .
126 .br
127 .B mplayer
128 tivo://host/[list|llist|fsid]
129 [options]
130 .
131 .br
132 .B gmplayer
133 [options]
134 [\-skin\ skin]
135 .
136 .br
137 .B mencoder
138 [options] file
139 [file|URL|\-] [\-o file | file://file | smb://[user:pass@]host/filepath]
140 .
141 .br
142 .B mencoder
143 [options] file1
144 [specific options] [file2] [specific options]
145 .ad
146 .hy
147 .
148 .\" --------------------------------------------------------------------------
149 .\" Description
150 .\" --------------------------------------------------------------------------
151 .
152 .SH DESCRIPTION
153 .B mplayer
154 is a movie player for Linux (runs on many other platforms and CPU
155 architectures, see the documentation).
156 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
157 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
158 native and binary codecs.
159 You can watch VCD, SVCD, DVD, Blu\-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies,
160 too.
161 .PP
162 MPlayer supports a wide range of video and audio output drivers.
163 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
164 Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
165 VESA (on every VESA-compatible card, even without X11), some low-level
166 card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
167 boards, such as the Siemens DVB, Hauppauge PVR (IVTV), DXR2 and DXR3/\:Hollywood+.
168 Most of them support software or hardware scaling, so you can enjoy movies in
169 fullscreen mode.
170 .PP
171 MPlayer has an onscreen display (OSD) for status information, nice big
172 antialiased shaded subtitles and visual feedback for keyboard controls.
173 European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
174 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
175 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
176 DVD subtitles (SPU streams, VOBsub and Closed Captions).
177 .PP
178 .B mencoder
179 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
180 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
181 below).
182 It encodes to MPEG-4 (DivX/Xvid), one of the libavcodec codecs and
183 PCM/\:MP3/\:VBRMP3 audio in 1, 2 or 3 passes.
184 Furthermore it has stream copying abilities, a powerful filter system (crop,
185 expand, flip, postprocess, rotate, scale, noise, RGB/\:YUV conversion) and
186 more.
187 .PP
188 .B gmplayer
189 is MPlayer with a graphical user interface.
190 Besides some own options (stored in gui.conf), it has the same options as
191 MPlayer, however some MPlayer options will be stored in gui.conf so that they
192 can be chosen independently from MPlayer. (See GUI CONFIGURATION FILE below.)
193 .PP
194 Usage examples to get you started quickly can be found at the end
195 of this man page.
196 .PP
197 .B Also see the HTML documentation!
198 .
199 .
200 .\" --------------------------------------------------------------------------
201 .\" interactive control
202 .\" --------------------------------------------------------------------------
203 .
204 .SH "INTERACTIVE CONTROL"
205 MPlayer has a fully configurable, command-driven control layer
206 which allows you to control MPlayer using keyboard, mouse, joystick
207 or remote control (with LIRC).
208 See the \-input option for ways to customize it.
209 .
210 .TP
211 .B keyboard control
212 .PD 0
213 .RS
214 .IPs "LEFT and RIGHT"
215 Seek backward/\:forward 10 seconds.
216 .IPs "UP and DOWN"
217 Seek forward/\:backward 1 minute.
218 .IPs "PGUP and PGDWN"
219 Seek forward/\:backward 10 minutes.
220 .IPs "[ and ]"
221 Decrease/increase current playback speed by 10%.
222 .IPs "{ and }"
223 Halve/double current playback speed.
224 .IPs "BACKSPACE"
225 Reset playback speed to normal.
226 .IPs "< and >"
227 Go backward/\:forward in the playlist.
228 .IPs "ENTER"
229 Go forward in the playlist, even over the end.
230 .IPs "HOME and END"
231 next/\:previous playtree entry in the parent list
232 .IPs "INS and DEL (ASX playlist only)"
233 next/\:previous alternative source.
234 .IPs "p / SPACE"
235 Pause (pressing again unpauses).
236 .IPs ".\ \ \ \ "
237 Step forward.
238 Pressing once will pause movie, every consecutive press will play one frame
239 and then go into pause mode again (any other key unpauses).
240 .IPs "q / ESC"
241 Stop playing and quit.
242 .IPs "U\ \ \ \ "
243 Stop playing (and quit if \-idle is not used).
244 .IPs "+ and \-"
245 Adjust audio delay by +/\- 0.1 seconds.
246 .IPs "/ and *"
247 Decrease/\:increase volume.
248 .IPs "9 and 0"
249 Decrease/\:increase volume.
250 .IPs "( and )"
251 Adjust audio balance in favor of left/\:right channel.
252 .IPs "m\ \ \ \ "
253 Mute sound.
254 .IPs "_ (MPEG-TS, AVI and libavformat only)"
255 Cycle through the available video tracks.
256 .IPs "# (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only)"
257 Cycle through the available audio tracks.
258 .IPs "TAB (MPEG-TS and libavformat only)"
259 Cycle through the available programs.
260 .IPs "f\ \ \ \ "
261 Toggle fullscreen (also see \-fs).
262 .IPs "T\ \ \ \ "
263 Toggle stay-on-top (also see \-ontop).
264 .IPs "w and e"
265 Decrease/\:increase pan-and-scan range.
266 .IPs "o\ \ \ \ "
267 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
268 .IPs "d\ \ \ \ "
269 Toggle frame dropping states: none / skip display / skip decoding
270 (see \-framedrop and \-hardframedrop).
271 .IPs "v\ \ \ \ "
272 Toggle subtitle visibility.
273 .IPs "j and J"
274 Cycle through the available subtitles.
275 .IPs "y and g"
276 Step forward/backward in the subtitle list.
277 .IPs "F\ \ \ \ "
278 Toggle displaying "forced subtitles".
279 .IPs "a\ \ \ \ "
280 Toggle subtitle alignment: top / middle / bottom.
281 .IPs "x and z"
282 Adjust subtitle delay by +/\- 0.1 seconds.
283 .IPs "c (\-capture only)"
284 Start/stop capturing the primary stream.
285 .IPs "r and t"
286 Move subtitles up/down.
287 .IPs "i (\-edlout mode only)"
288 Set start or end of an EDL skip and write it out to the given file.
289 .IPs "s (\-vf screenshot only)"
290 Take a screenshot.
291 .IPs "S (\-vf screenshot only)"
292 Start/stop taking screenshots.
293 .IPs "I\ \ \ \ "
294 Show filename on the OSD.
295 .IPs "P\ \ \ \ "
296 Show progression bar, elapsed time and total duration on the OSD.
297 .IPs "! and @"
298 Seek to the beginning of the previous/next chapter.
299 .IPs "D (\-vo xvmc, \-vo vdpau, \-vf yadif, \-vf kerndeint only)"
300 Activate/deactivate deinterlacer.
301 .IPs "A"
302 Cycle through the available DVD angles.
303 .RE
304 .PD 1
305 .PP
306 .RS
307 (The following keys are valid only when using a hardware accelerated video
308 output (xv, (x)vidix, (x)mga, etc), the software equalizer
309 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
310 .RE
311 .PP
312 .PD 0
313 .RS
314 .IPs "1 and 2"
315 Adjust contrast.
316 .IPs "3 and 4"
317 Adjust brightness.
318 .IPs "5 and 6"
319 Adjust hue.
320 .IPs "7 and 8"
321 Adjust saturation.
322 .RE
323 .PD 1
324 .PP
325 .RS
326 (The following keys are valid only when using the quartz or corevideo
327 video output driver.)
328 .RE
329 .PP
330 .PD 0
331 .RS
332 .IPs "command + 0"
333 Resize movie window to half its original size.
334 .IPs "command + 1"
335 Resize movie window to its original size.
336 .IPs "command + 2"
337 Resize movie window to double its original size.
338 .IPs "command + f"
339 Toggle fullscreen (also see \-fs).
340 .IPs "command + [ and command + ]"
341 Set movie window alpha.
342 .RE
343 .PD 1
344 .PP
345 .RS
346 (The following keys are valid only when using the sdl
347 video output driver.)
348 .RE
349 .PP
350 .PD 0
351 .RS
352 .IPs "c\ \ \ \ "
353 Cycle through available fullscreen modes.
354 .IPs "n\ \ \ \ "
355 Restore original mode.
356 .RE
357 .PD 1
358 .PP
359 .RS
360 (The following keys are valid if you have a keyboard
361 with multimedia keys.)
362 .RE
363 .PP
364 .PD 0
365 .RS
366 .IPs PAUSE
367 Pause.
368 .IPs "STOP\ "
369 Stop playing and quit.
370 .IPs "PREVIOUS and NEXT"
371 Seek backward/\:forward 1 minute.
372 .RE
373 .PD 1
374 .PP
375 .RS
376 (The following keys are only valid if you compiled with TV or DVB input
377 support and will take precedence over the keys defined above.)
378 .RE
379 .PP
380 .PD 0
381 .RS
382 .IPs "h and k"
383 Select previous/\:next channel.
384 .IPs "n\ \ \ \ "
385 Change norm.
386 .IPs "u\ \ \ \ "
387 Change channel list.
388 .RE
389 .PD 1
390 .PP
391 .RS
392 (The following keys are only valid if you compiled with dvdnav
393 support: They are used to navigate the menus.)
394 .RE
395 .PP
396 .PD 0
397 .RS
398 .IPs "keypad 8"
399 Select button up.
400 .IPs "keypad 2"
401 Select button down.
402 .IPs "keypad 4"
403 Select button left.
404 .IPs "keypad 6"
405 Select button right.
406 .IPs "keypad 5"
407 Return to main menu.
408 .IPs "keypad 7"
409 Return to nearest menu (the order of preference is: chapter->title->root).
410 .IPs "keypad ENTER"
411 Confirm choice.
412 .RE
413 .PD 1
414 .PP
415 .RS
416 .
417 (The following keys are used for controlling TV teletext. The data may
418 come from either an analog TV source or an MPEG transport stream.)
419 .RE
420 .PP
421 .PD 0
422 .RS
423 .IPs "X\ \ \ \ "
424 Switch teletext on/\:off.
425 .IPs "Q and W"
426 Go to next/\:prev teletext page.
427 .RE
428 .PD 1
429 .
430 .TP
431 .B mouse control
432 .PD 0
433 .RS
434 .IPs "button 3 and button 4"
435 Seek backward/\:forward 1 minute.
436 .IPs "button 5 and button 6"
437 Decrease/\:increase volume.
438 .RE
439 .PD 1
440 .
441 .TP
442 .B joystick control
443 .PD 0
444 .RS
445 .IPs "left and right"
446 Seek backward/\:forward 10 seconds.
447 .IPs "up and down"
448 Seek forward/\:backward 1 minute.
449 .IPs "button 1"
450 Pause.
451 .IPs "button 2"
452 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
453 .IPs "button 3 and button 4"
454 Decrease/\:increase volume.
455 .RE
456 .PD 1
457 .
458 .
459 .\" --------------------------------------------------------------------------
460 .\" Usage
461 .\" --------------------------------------------------------------------------
462 .
463 .SH "USAGE"
464 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
465 \-fs option is \-nofs.
466 .PP
467 If an option is marked as (XXX only), it will only work in combination with
468 the XXX option or if XXX is compiled in.
469 .PP
470 .I NOTE:
471 The suboption parser (used for example for \-ao pcm suboptions) supports
472 a special kind of string-escaping intended for use with external GUIs.
473 .br
474 It has the following format:
475 .br
476 %n%string_of_length_n
477 .br
478 .I EXAMPLES:
479 .br
480 mplayer \-ao pcm:file=%10%C:test.wav test.avi
481 .br
482 Or in a script:
483 .br
484 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
485 .PP
486 .
487 .\" --------------------------------------------------------------------------
488 .\" Configuration files
489 .\" --------------------------------------------------------------------------
490 .
491 .SH "CONFIGURATION FILES"
492 You can put all of the options in configuration files which will be read
493 every time MPlayer/MEncoder is run.
494 The system-wide configuration file 'mplayer.conf' is in your configuration
495 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
496 specific one is '~/\:.mplayer/\:config'.
497 The configuration file for MEncoder is 'mencoder.conf' in your configuration
498 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the
499 user specific one is '~/\:.mplayer/\:mencoder.conf'.
500 User specific options override system-wide options (in case of
501 .BR gmplayer ,
502 gui.conf options override user specific options) and options given on the
503 command line override all.
504 The syntax of the configuration files is 'option=<value>', everything after
505 a '#' is considered a comment.
506 Options that work without values can be enabled by setting them to 'yes'
507 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
508 Even suboptions can be specified in this way.
509 .PP
510 You can also write file-specific configuration files.
511 If you wish to have a configuration file for a file called 'movie.avi', create a file
512 named 'movie.avi.conf' with the file-specific options in it and put it in
513 ~/.mplayer/.
514 You can also put the configuration file in the same directory as the file to
515 be played, as long as you give the \-use\-filedir\-conf option (either on the
516 command line or in your global config file).
517 If a file-specific configuration file is found in the same directory, no
518 file-specific configuration is loaded from ~/.mplayer.
519 In addition, the \-use\-filedir\-conf option enables directory-specific
520 configuration files.
521 For this, MPlayer first tries to load a mplayer.conf from the same directory as
522 the file played and then tries to load any file-specific configuration.
523 .PP
524 .I EXAMPLE MPLAYER CONFIGURATION FILE:
525 .sp 1
526 .nf
527 # Use Matrox driver by default.
528 vo=xmga
529 # I love practicing handstands while watching videos.
530 flip=yes
531 # Decode/encode multiple files from PNG,
532 # start with mf://filemask
533 mf=type=png:fps=25
534 # Eerie negative images are cool.
535 vf=eq2=1.0:\-0.8
536 .fi
537 .PP
538 .I "EXAMPLE MENCODER CONFIGURATION FILE:"
539 .sp 1
540 .nf
541 # Make MEncoder output to a default filename.
542 o=encoded.avi
543 # The next 4 lines allow mencoder tv:// to start capturing immediately.
544 oac=pcm=yes
545 ovc=lavc=yes
546 lavcopts=vcodec=mjpeg
547 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
548 # more complex default encoding option set
549 lavcopts=vcodec=mpeg4:autoaspect=1
550 lameopts=aq=2:vbr=4
551 ovc=lavc=1
552 oac=lavc=1
553 passlogfile=pass1stats.log
554 noautoexpand=1
555 subfont-autoscale=3
556 subfont-osd-scale=6
557 subfont-text-scale=4
558 subalign=2
559 subpos=96
560 spuaa=20
561 .fi
562 .PP
563 .I "GUI CONFIGURATION FILE"
564 .sp 1
565 GUI's own options are (MPlayer option names in parentheses):
566 ao_alsa_device
567 .RB ( alsa:device= ") (ALSA only),"
568 ao_alsa_mixer
569 .RB ( mixer ") (ALSA only),"
570 ao_alsa_mixer_channel
571 .RB ( mixer-channel ") (ALSA only),"
572 ao_esd_device
573 .RB ( esd: ") (ESD only),"
574 ao_extra_stereo
575 .RB ( "af extrastereo" ") (default: 1.0),"
576 ao_extra_stereo_coefficient
577 .RB ( "af extrastereo=" "),"
578 ao_oss_device
579 .RB ( oss: ") (OSS only),"
580 ao_oss_mixer
581 .RB ( mixer ") (OSS only),"
582 ao_oss_mixer_channel
583 .RB ( mixer-channel ") (OSS only),"
584 ao_sdl_subdriver
585 .RB ( sdl: ") (SDL only),
586 ao_surround (unused),
587 ao_volnorm
588 .RB ( "af volnorm" "),"
589 autosync (enable/disable),
590 autosync_size
591 .RB ( autosync "),"
592 cache (enable/disable),
593 cache_size
594 .RB ( cache "),"
595 enable_audio_equ
596 .RB ( "af equalizer" "),"
597 equ_band_00 ... equ_band_59,
598 .RB ( "af equalizer=" "),"
599 equ_channel_1 ... equ_channel_6
600 .RB ( "af channels=" "),"
601 gui_main_pos_x,
602 gui_main_pos_y,
603 gui_save_pos (yes/no),
604 gui_video_out_pos_x,
605 gui_video_out_pos_y,
606 load_fullscreen  (yes/no),
607 playbar (enable/disable),
608 show_videowin (yes/no),
609 vf_lavc
610 .RB ( "vf lavc" ") (DXR3 only),"
611 vf_pp
612 .RB ( "vf pp" "),"
613 vo_dxr3_device (unused) (DXR3 only).
614 .sp 1
615 MPlayer options stored in gui.conf (GUI option names, MPlayer option names in
616 parentheses) are:
617 a_afm
618 .RB ( afm ),
619 ao_driver
620 .RB ( ao ),
621 ass_bottom_margin
622 .RB ( ass-bottom-margin ") (ASS only),"
623 ass_enabled
624 .RB ( ass ") (ASS only),"
625 ass_top_margin
626 .RB ( ass-top-margin ") (ASS only),"
627 ass_use_margins
628 .RB ( ass-use-margins ") (ASS only),"
629 cdrom_device
630 .RB ( cdrom-device ),
631 dvd_device
632 .RB ( dvd-device ),
633 font_autoscale
634 .RB ( subfont-autoscale ") (FreeType only),"
635 font_blur
636 .RB ( subfont-blur ") (FreeType only),"
637 font_encoding
638 .RB ( subfont-encoding ") (FreeType only),"
639 font_factor
640 .RB ( ffactor ),
641 font_name
642 .RB ( font ),
643 font_osd_scale
644 .RB ( subfont-osd-scale ") (FreeType only),"
645 font_outline
646 .RB ( subfont-outline ") (FreeType only),"
647 font_text_scale
648 .RB ( subfont-text-scale ") (FreeType only),"
649 gui_skin
650 .RB ( skin ),
651 osd_level
652 .RB ( osdlevel ),
653 softvol
654 .RB ( softvol ),
655 stopxscreensaver
656 .RB ( stop-xscreensaver ),
657 sub_auto_load
658 .RB ( autosub ),
659 sub_cp
660 .RB ( subcp ") (iconv only),"
661 sub_overlap
662 .RB ( overlapsub ),
663 sub_pos
664 .RB ( subpos ),
665 sub_unicode
666 .RB ( unicode ),
667 v_flip
668 .RB ( flip ),
669 v_framedrop
670 .RB ( framedrop ),
671 v_idx
672 .RB ( idx ),
673 v_ni
674 .RB ( ni ),
675 v_vfm
676 .RB ( vfm ),
677 vf_autoq
678 .RB ( autoq ),
679 vo_direct_render
680 .RB ( panscan ),
681 vo_doublebuffering
682 .RB ( dr ),
683 vo_driver
684 .RB ( vo ),
685 vo_panscan
686 .RB ( double ).
687 .
688 .\" --------------------------------------------------------------------------
689 .\" Profiles
690 .\" --------------------------------------------------------------------------
691 .
692 .SH "PROFILES"
693 To ease working with different configurations profiles can be defined in the
694 configuration files.
695 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
696 All following options will be part of the profile.
697 A description (shown by \-profile help) can be defined with the profile-desc
698 option.
699 To end the profile, start another one or use the profile name 'default'
700 to continue with normal options.
701 .fi
702 .PP
703 .I "EXAMPLE MPLAYER PROFILE:"
704 .sp 1
705 .nf
706
707 [protocol.dvd]
708 profile-desc="profile for dvd:// streams"
709 vf=pp=hb/vb/dr/al/fd
710 alang=en
711
712 [protocol.dvdnav]
713 profile-desc="profile for dvdnav:// streams"
714 profile=protocol.dvd
715 mouse-movements=yes
716 nocache=yes
717
718 [extension.flv]
719 profile-desc="profile for .flv files"
720 flip=yes
721
722 [vo.pnm]
723 outdir=/tmp
724
725 [ao.alsa]
726 device=spdif
727 .fi
728 .PP
729 .I "EXAMPLE MENCODER PROFILE:"
730 .sp 1
731 .nf
732
733 [mpeg4]
734 profile-desc="MPEG4 encoding"
735 ovc=lacv=yes
736 lavcopts=vcodec=mpeg4:vbitrate=1200
737
738 [mpeg4\-hq]
739 profile-desc="HQ MPEG4 encoding"
740 profile=mpeg4
741 lavcopts=mbd=2:trell=yes:v4mv=yes
742 .fi
743 .
744 .\" --------------------------------------------------------------------------
745 .\" Options
746 .\" --------------------------------------------------------------------------
747 .
748 .SH "GENERAL OPTIONS"
749 .
750 .TP
751 .B \-codecpath <dir>
752 Specify a directory for binary codecs.
753 .
754 .TP
755 .B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
756 Override the standard search path and use the specified file
757 instead of the builtin codecs.conf.
758 .
759 .TP
760 .B \-include <configuration file> (also see \-gui-include)
761 Specify configuration file to be parsed after the default ones.
762 .
763 .TP
764 .B \-list\-options
765 Prints all available options.
766 .
767 .TP
768 .B \-msgcharset <charset>
769 Convert console messages to the specified character set (default: autodetect).
770 Text will be in the encoding specified with the \-\-charset configure option.
771 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
772 .br
773 .I NOTE:
774 The option takes effect after command line parsing has finished.
775 The MPLAYER_CHARSET environment variable can help you get rid of
776 the first lines of garbled output.
777 .
778 .TP
779 .B \-msgcolor
780 Enable colorful console output on terminals that support ANSI color.
781 .
782 .TP
783 .B \-msglevel <all=<level>:<module>=<level>:...>
784 Control verbosity directly for each module.
785 The 'all' module changes the verbosity of all the modules not
786 explicitly specified on the command line.
787 See '\-msglevel help' for a list of all modules.
788 .br
789 .I NOTE:
790 Some messages are printed before the command line is parsed and are
791 therefore not affected by \-msglevel.
792 To control these messages you have to use the MPLAYER_VERBOSE environment
793 variable, see its description below for details.
794 .br
795 Available levels:
796 .PD 0
797 .RSs
798 .IPs "\-1"
799 complete silence
800 .IPs " 0"
801 fatal messages only
802 .IPs " 1"
803 error messages
804 .IPs " 2"
805 warning messages
806 .IPs " 3"
807 short hints
808 .IPs " 4"
809 informational messages
810 .IPs " 5"
811 status messages (default)
812 .IPs " 6"
813 verbose messages
814 .IPs " 7"
815 debug level 2
816 .IPs " 8"
817 debug level 3
818 .IPs " 9"
819 debug level 4
820 .RE
821 .PD 1
822 .
823 .TP
824 .B \-msgmodule
825 Prepend module name in front of each console message.
826 .
827 .TP
828 .B \-noconfig <options>
829 Do not parse selected configuration files.
830 .br
831 .I NOTE:
832 If \-include or \-use\-filedir\-conf options are
833 specified at the command line, they will be honoured.
834 .sp 1
835 Available options are:
836 .PD 0
837 .RSs
838 .IPs "all\ \ "
839 all configuration files
840 .IPs "gui (GUI only)"
841 GUI configuration file
842 .IPs system
843 system configuration file
844 .IPs "user\ "
845 user configuration file
846 .RE
847 .PD 1
848 .
849 .TP
850 .B "\-quiet\ "
851 Make console output less verbose; in particular, prevents the status line
852 (i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
853 Particularly useful on slow terminals or broken ones which do not properly
854 handle carriage return (i.e.\& \\r).
855 .
856 .TP
857 .B \-priority <prio> (Windows and OS/2 only)
858 Set process priority for MPlayer according to the predefined
859 priorities available under Windows and OS/2.
860 Possible values of <prio>:
861 .RSs
862 idle|belownormal|normal|abovenormal|high|realtime
863 .RE
864 .sp 1
865 .RS
866 .I WARNING:
867 Using realtime priority can cause system lockup.
868 .RE
869 .
870 .TP
871 .B \-profile <profile1,profile2,...>
872 Use the given profile(s), \-profile help displays a list of the defined profiles.
873 .
874 .TP
875 .B \-really\-quiet (also see \-quiet)
876 Display even less output and status messages than with \-quiet.
877 Also suppresses the GUI error message boxes.
878 .
879 .TP
880 .B \-show\-profile <profile>
881 Show the description and content of a profile.
882 .
883 .TP
884 .B \-use\-filedir\-conf
885 Look for a file-specific configuration file in the same directory as
886 the file that is being played.
887 .br
888 .I WARNING:
889 May be dangerous if playing from untrusted media.
890 .
891 .TP
892 .B "\-v\ \ \ \ \ "
893 Increment verbosity level, one level for each \-v
894 found on the command line.
895 .
896 .
897 .
898 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
899 .
900 .TP
901 .B \-autoq <quality> (use with \-vf [s]pp)
902 Dynamically changes the level of postprocessing depending on the available spare
903 CPU time.
904 The number you specify will be the maximum level used.
905 Usually you can use some big number.
906 You have to use \-vf [s]pp without parameters in order for this to work.
907 .
908 .TP
909 .B \-autosync <factor>
910 Gradually adjusts the A/V sync based on audio delay measurements.
911 Specifying \-autosync 0, the default, will cause frame timing to be based
912 entirely on audio delay measurements.
913 Specifying \-autosync 1 will do the same, but will subtly change the A/V
914 correction algorithm.
915 An uneven video framerate in a movie which plays fine with \-nosound can
916 often be helped by setting this to an integer value greater than 1.
917 The higher the value, the closer the timing will be to \-nosound.
918 Try \-autosync 30 to smooth out problems with sound drivers which do
919 not implement a perfect audio delay measurement.
920 With this value, if large A/V sync offsets occur, they will only take about
921 1 or 2 seconds to settle out.
922 This delay in reaction time to sudden A/V offsets should be the only
923 side-effect of turning this option on, for all sound drivers.
924 .
925 .TP
926 .B \-benchmark
927 Prints some statistics on CPU usage and dropped frames at the end of playback.
928 Use in combination with \-nosound and \-vo null for benchmarking only the
929 video codec.
930 .br
931 .I NOTE:
932 With this option MPlayer will also ignore frame duration when playing
933 only video (you can think of that as infinite fps).
934 .
935 .TP
936 .B \-colorkey <number>
937 Changes the colorkey to an RGB value of your choice.
938 0x000000 is black and 0xffffff is white.
939 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
940 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
941 drivers.
942 .
943 .TP
944 .B \-nocolorkey
945 Disables colorkeying.
946 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
947 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
948 drivers.
949 .
950 .TP
951 .B \-correct\-pts (EXPERIMENTAL)
952 Switches MPlayer to an experimental mode where timestamps for video frames
953 are calculated differently and video filters which add new frames or
954 modify timestamps of existing ones are supported.
955 The more accurate timestamps can be visible for example when playing
956 subtitles timed to scene changes with the \-ass option.
957 Without \-correct\-pts the subtitle timing will typically be off by some frames.
958 This option does not work correctly with some demuxers and codecs.
959 .
960 .TP
961 .B \-crash\-debug (DEBUG CODE)
962 Automatically attaches gdb upon crash or SIGTRAP.
963 Support must be compiled in by configuring with \-\-enable\-crash\-debug.
964 .
965 .TP
966 .B \-doubleclick\-time
967 Time in milliseconds to recognize two consecutive button presses as
968 a double-click (default: 300).
969 Set to 0 to let your windowing system decide what a double-click is
970 (\-vo directx only).
971 .br
972 .I NOTE:
973 You will get slightly different behaviour depending on whether you bind
974 MOUSE_BTN0_DBL or MOUSE_BTN0\-MOUSE_BTN0_DBL.
975 .
976 .TP
977 .B \-edlout <filename>
978 Creates a new file and writes edit decision list (EDL) records to it.
979 During playback, the user hits 'i' to mark the start or end of a skip block.
980 This provides a starting point from which the user can fine-tune EDL entries
981 later.
982 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
983 .
984 .TP
985 .B \-edl-backward-delay <number>
986 When using EDL during playback and jumping backwards it is possible to
987 end up in the middle of an EDL record.
988 In that case MPlayer will seek further backwards to the start position
989 of the EDL record and then immediately skip the scene specified in the
990 EDL record.
991 To avoid this kind of behavior, MPlayer jumps to a fixed time interval
992 before the start of the EDL record.
993 This parameter allows you to specify that time interval in seconds
994 (default: 2 seconds).
995 .
996 .TP
997 .B \-edl-start-pts
998 Adjust positions in EDL records according to playing file's start time.
999 Some formats, especially MPEG TS usually start with non-zero PTS
1000 values and when producing EDL file with \-edlout option, EDL records
1001 contain absolute values that are correct only for this particular file.
1002 If re-encoded into a different format, this EDL file no longer applies.
1003 Specifying \-edl-start-pts will automatically adjust EDL positions according
1004 to start time: when producing EDL file, it will substract start time from every
1005 EDL record, when playing with EDL file, it will add file's start time to every
1006 EDL position.
1007 .
1008 .TP
1009 .B \-noedl-start-pts
1010 Disable adjusting EDL positions.
1011 .
1012 .TP
1013 .B \-enqueue (GUI only)
1014 Enqueue files given on the command line in the playlist instead of playing them
1015 immediately.
1016 .
1017 .TP
1018 .B \-fixed\-vo
1019 Enforces a fixed video system for multiple files (one (un)initialization for
1020 all files).
1021 Therefore only one window will be opened for all files.
1022 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
1023 xmga, xv, xvidix and dfbmga.
1024 .
1025 .TP
1026 .B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
1027 Skip displaying some frames to maintain A/V sync on slow systems.
1028 Video filters are not applied to such frames.
1029 For B-frames even decoding is skipped completely.
1030 .
1031 .TP
1032 .B \-(no)gui
1033 Enable or disable the GUI interface (default depends on binary name).
1034 Only works as the first argument on the command line.
1035 Does not work as a config-file option.
1036 .
1037 .TP
1038 .B \-gui-include <GUI configuration file> (also see \-include) (GUI only)
1039 Specify a GUI configuration file to be parsed after the default gui.conf.
1040 .
1041 .TP
1042 .B \-h, \-help, \-\-help
1043 Show short summary of options.
1044 .
1045 .TP
1046 .B \-hardframedrop (experimental without \-nocorrect\-pts)
1047 More intense frame dropping (breaks decoding).
1048 Leads to image distortion!
1049 Note that especially the libmpeg2 decoder may crash with this,
1050 so consider using "\-vc ffmpeg12,".
1051 .
1052 .TP
1053 .B \-heartbeat\-cmd
1054 Command that is executed every 30 seconds during playback via system() -
1055 i.e.\& using the shell.
1056 .sp 1
1057 .I NOTE:
1058 MPlayer uses this command without any checking, it is your responsibility
1059 to ensure it does not cause security problems (e.g.\& make sure to use full
1060 paths if "." is in your path like on Windows).
1061 It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
1062 .sp 1
1063 This can be "misused" to disable screensavers that do not support the proper
1064 X API (also see \-stop\-xscreensaver).
1065 If you think this is too complicated, ask the author of the screensaver
1066 program to support the proper X APIs.
1067 .sp 1
1068 .I EXAMPLE for xscreensaver:
1069 mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
1070 .sp 1
1071 .I EXAMPLE for GNOME screensaver:
1072 mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
1073 .RE
1074 .PD 1
1075 .
1076 .TP
1077 .B \-identify
1078 Shorthand for \-msglevel identify=4.
1079 Show file parameters in an easily parseable format.
1080 Also prints more detailed information about subtitle and audio
1081 track languages and IDs.
1082 In some cases you can get more information by using \-msglevel identify=6.
1083 For example, for a DVD or Blu\-ray it will list the chapters and time length
1084 of each title, as well as a disk ID.
1085 Combine this with \-frames 0 to suppress all video output.
1086 The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
1087 (hopefully) shellescapes the filenames.
1088 .
1089 .TP
1090 .B \-idle (also see \-slave)
1091 Makes MPlayer wait idly instead of quitting when there is no file to play.
1092 Mostly useful in slave mode where MPlayer can be controlled
1093 through input commands.
1094 .br
1095 For
1096 .B gmplayer
1097 \-idle is the default, \-noidle will quit the GUI after all files have been
1098 played.
1099 .
1100 .TP
1101 .B \-input <commands>
1102 This option can be used to configure certain parts of the input system.
1103 Paths are relative to ~/.mplayer/.
1104 .br
1105 .I NOTE:
1106 Autorepeat is currently only supported by joysticks.
1107 .sp 1
1108 Available commands are:
1109 .sp 1
1110 .PD 0
1111 .RSs
1112 .IPs conf=<filename>
1113 Specify input configuration file other than the default
1114 ~/\:.mplayer/\:input.conf.
1115 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
1116 .IPs ar-dev=<device>
1117 Device to be used for Apple IR Remote (default is autodetected, Linux only).
1118 .IPs ar-delay
1119 Delay in milliseconds before we start to autorepeat a key (0 to disable).
1120 .IPs ar-rate
1121 Number of key presses to generate per second on autorepeat.
1122 .IPs (no)default-bindings
1123 Use the key bindings that MPlayer ships with by default.
1124 .IPs keylist
1125 Prints all keys that can be bound to commands.
1126 .IPs cmdlist
1127 Prints all commands that can be bound to keys.
1128 .IPs js-dev
1129 Specifies the joystick device to use (default: /dev/\:input/\:js0).
1130 .IPs file=<filename>
1131 Read commands from the given file.
1132 Mostly useful with a FIFO.
1133 .br
1134 .I NOTE:
1135 When the given file is a FIFO MPlayer opens both ends so you can do
1136 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
1137 .RE
1138 .PD 1
1139 .
1140 .TP
1141 .B \-key\-fifo\-size <2\-65000>
1142 Specify the size of the FIFO that buffers key events (default: 7).
1143 A FIFO of size n can buffer (n\-1) events.
1144 If it is too small some events may be lost.
1145 If it is too big, MPlayer may seem to hang while it
1146 processes the buffered events.
1147 To get the same behavior as before this option was introduced,
1148 set it to 2 for Linux or 1024 for Windows.
1149 For small value you should disable double-clicks by setting
1150 \-doubleclick\-time to 0 so they do not compete with regular
1151 events for buffer space.
1152 .
1153 .TP
1154 .B \-lircconf <filename> (LIRC only)
1155 Specifies a configuration file for LIRC (default: ~/.lircrc).
1156 .
1157 .TP
1158 .B \-list\-properties
1159 Print a list of the available properties.
1160 .
1161 .TP
1162 .B \-loop <number>
1163 Loops movie playback <number> times.
1164 0 means forever.
1165 .
1166 .TP
1167 .B \-menu (OSD menu only)
1168 Turn on OSD menu support.
1169 .
1170 .TP
1171 .B \-menu\-cfg <filename> (OSD menu only)
1172 Use an alternative menu.conf.
1173 .
1174 .TP
1175 .B \-menu\-chroot <path> (OSD menu only)
1176 Chroot the file selection menu to a specific location.
1177 .sp 1
1178 .I EXAMPLE:
1179 .PD 0
1180 .RSs
1181 .IPs "\-menu\-chroot /home"
1182 Will restrict the file selection menu to /\:home and downward (i.e.\& no
1183 access to / will be possible, but /home/user_name will).
1184 .RE
1185 .PD 1
1186 .
1187 .TP
1188 .B \-menu\-keepdir (OSD menu only)
1189 File browser starts from the last known location instead of current directory.
1190 .
1191 .TP
1192 .B \-menu\-root <value> (OSD menu only)
1193 Specify the main menu.
1194 .
1195 .TP
1196 .B \-menu\-startup (OSD menu only)
1197 Display the main menu at MPlayer startup.
1198 .
1199 .TP
1200 .B \-mouse\-movements
1201 Permit MPlayer to receive pointer events reported by the video
1202 output driver.
1203 Necessary to select the buttons in DVD menus.
1204 Supported for X11-based VOs (x11, xv, xvmc, etc) and the gl, gl2, direct3d and
1205 corevideo VOs.
1206 .
1207 .TP
1208 .B \-noar
1209 Turns off AppleIR remote support.
1210 .
1211 .TP
1212 .B \-noconsolecontrols
1213 Prevent MPlayer from reading key events from standard input.
1214 Useful when reading data from standard input.
1215 This is automatically enabled when \- is found on the command line.
1216 There are situations where you have to set it manually, e.g.\&
1217 if you open /dev/\:stdin (or the equivalent on your system), use stdin
1218 in a playlist or intend to read from stdin later on via the loadfile or
1219 loadlist slave commands.
1220 .
1221 .TP
1222 .B \-nojoystick
1223 Turns off joystick support.
1224 .
1225 .TP
1226 .B \-nolirc
1227 Turns off LIRC support.
1228 .
1229 .TP
1230 .B \-nomouseinput
1231 Disable mouse button press/\:release input (mozplayerxp's context menu relies
1232 on this option).
1233 .
1234 .TP
1235 .B \-rtc (RTC only)
1236 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
1237 mechanism.
1238 This wakes up the process every 1/1024 seconds to check the current time.
1239 Useless with modern Linux kernels configured for desktop use as they already
1240 wake up the process with similar accuracy when using normal timed sleep.
1241 .
1242 .TP
1243 .B \-playing\-msg <string>
1244 Print out a string before starting playback.
1245 The following expansions are supported:
1246 .RSs
1247 .IPs ${NAME}
1248 Expand to the value of the property NAME.
1249 .IPs ?(NAME:TEXT)
1250 Expand TEXT only if the property NAME is available.
1251 .IPs ?(!NAME:TEXT)
1252 Expand TEXT only if the property NAME is not available.
1253 .RE
1254 .
1255 .TP
1256 .B \-playlist <filename>
1257 Play files according to a playlist file (ASX, Winamp, SMIL, or
1258 one-file-per-line format).
1259 .br
1260 .I NOTE:
1261 This option is considered an entry so options found after it will apply
1262 only to the elements of this playlist.
1263 .br
1264 FIXME: This needs to be clarified and documented thoroughly.
1265 .
1266 .TP
1267 .B \-rtc\-device <device>
1268 Use the specified device for RTC timing.
1269 .
1270 .TP
1271 .B \-shuffle
1272 Play files in random order.
1273 .
1274 .TP
1275 .B \-skin <name> (GUI only)
1276 Loads a skin from the directory given as parameter below the default skin
1277 directories, ~/.mplayer/\:skins/ and /usr/\:local/\:share/\:mplayer/\:skins/\:.
1278 .sp 1
1279 .I EXAMPLE:
1280 .PD 0
1281 .RSs
1282 .IPs "\-skin fittyfene"
1283 Tries ~/.mplayer/\:skins/\:fittyfene
1284 and afterwards /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene.
1285 .RE
1286 .PD 1
1287 .
1288 .TP
1289 .B \-slave (also see \-input)
1290 Switches on slave mode, in which MPlayer works as a backend for other programs.
1291 Instead of intercepting keyboard events, MPlayer will read commands separated
1292 by a newline (\\n) from stdin.
1293 .br
1294 .I NOTE:
1295 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
1296 for their description.
1297 Also, this is not intended to disable other inputs, e.g.\& via the video window,
1298 use some other method like \-input nodefault\-bindings:conf=/dev/null for that.
1299 .
1300 .TP
1301 .B \-softsleep
1302 Time frames by repeatedly checking the current time instead of asking the
1303 kernel to wake up MPlayer at the correct time.
1304 Useful if your kernel timing is imprecise and you cannot use the RTC either.
1305 Comes at the price of higher CPU consumption.
1306 .
1307 .TP
1308 .B \-sstep <sec>
1309 Skip <sec> seconds after every frame.
1310 The normal framerate of the movie is kept, so playback is accelerated.
1311 Since MPlayer can only seek to the next keyframe this may be inexact.
1312 .
1313 .TP
1314 .B \-udp\-ip <ip>
1315 Sets the destination address for datagrams sent by the \-udp\-master.
1316 Setting it to a broadcast address allows multiple slaves having the same
1317 broadcast address to sync to the master (default: 127.0.0.1).
1318 .
1319 .TP
1320 .B \-udp\-master
1321 Send a datagram to \-udp\-ip on \-udp\-port just before playing each frame.
1322 The datagram indicates the master's position in the file.
1323 .
1324 .TP
1325 .B \-udp\-port <port>
1326 Sets the destination port for datagrams sent by the \-udp\-master, and the
1327 port a \-udp\-slave listens on (default: 23867).
1328 .
1329 .TP
1330 .B \-udp\-seek\-threshold <sec>
1331 When the master seeks, the slave has to decide whether to seek as
1332 well, or to catch up by decoding frames without pausing between frames.
1333 If the master is more than <sec> seconds away from the
1334 slave, the slave seeks.
1335 Otherwise, it "runs" to catch up or waits for the master.
1336 This should almost always be left at its default setting of 1 second.
1337 .
1338 .TP
1339 .B \-udp\-slave
1340 Listen on \-udp\-port and match the master's position.
1341 .
1342 .
1343 .SH "DEMUXER/STREAM OPTIONS"
1344 .
1345 .TP
1346 .B \-a52drc <level>
1347 Select the Dynamic Range Compression level for AC-3 audio streams.
1348 <level> is a float value ranging from 0 to 1, where 0 means no compression
1349 and 1 (which is the default) means full compression (make loud passages more
1350 silent and vice versa).
1351 Values up to 2 are also accepted, but are purely experimental.
1352 This option only shows an effect if the AC-3 stream contains the required range
1353 compression information.
1354 .
1355 .TP
1356 .B \-aid <ID> (also see \-alang)
1357 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1358 VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1359 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1360 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1361 (if present) with the chosen audio stream.
1362 .
1363 .TP
1364 .B \-ausid <ID> (also see \-alang)
1365 Select audio substream channel.
1366 Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled
1367 by the native demuxer (not by libavformat).
1368 The format type may not be correctly identified because of how this information
1369 (or lack thereof) is embedded in the stream, but it will demux correctly the
1370 audio streams when multiple substreams are present.
1371 MPlayer prints the available substream IDs when run with \-identify.
1372 .
1373 .TP
1374 .B \-alang <language code[,language code,...]> (also see \-aid)
1375 Specify a priority list of audio languages to use.
1376 Different container formats employ different language codes.
1377 DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
1378 use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
1379 MPlayer prints the available languages when run in verbose (\-v) mode.
1380 .sp 1
1381 .I EXAMPLE:
1382 .PD 0
1383 .RSs
1384 .IPs "mplayer dvd://1 \-alang hu,en"
1385 Chooses the Hungarian language track on a DVD and falls back on English if
1386 Hungarian is not available.
1387 .IPs "mplayer \-alang jpn example.mkv"
1388 Plays a Matroska file in Japanese.
1389 .RE
1390 .PD 1
1391 .
1392 .TP
1393 .B \-audio\-demuxer <[+]name> (\-audiofile only)
1394 Force audio demuxer type for \-audiofile.
1395 Use a '+' before the name to force it, this will skip some checks!
1396 Give the demuxer name as printed by \-audio\-demuxer help.
1397 For backward compatibility it also accepts the demuxer ID as defined in
1398 libmpdemux/\:demuxer.h.
1399 \-audio\-demuxer audio or \-audio\-demuxer 17 forces MP3.
1400 .
1401 .TP
1402 .B \-audiofile <filename>
1403 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1404 movie.
1405 .
1406 .TP
1407 .B \-audiofile\-cache <kBytes>
1408 Enables caching for the stream used by \-audiofile, using the specified
1409 amount of memory.
1410 .
1411 .TP
1412 .B \-reuse\-socket (udp:// only)
1413 Allows a socket to be reused by other processes as soon as it is closed.
1414 .
1415 .TP
1416 .B \-bandwidth <Bytes> (network only)
1417 Specify the maximum bandwidth for network streaming (for servers that are
1418 able to send content in different bitrates).
1419 Useful if you want to watch live streamed media behind a slow connection.
1420 With Real RTSP streaming, it is also used to set the maximum delivery
1421 bandwidth allowing faster cache filling and stream dumping.
1422 .
1423 .TP
1424 .B \-bluray\-angle <angle ID> (Blu\-ray only)
1425 Some Blu\-ray discs contain scenes that can be viewed from multiple angles.
1426 Here you can tell MPlayer which angles to use (default: 1).
1427 .
1428 .TP
1429 .B \-bluray\-chapter <chapter ID> (Blu\-ray only)
1430 Tells MPlayer which Blu\-ray chapter to start the current title from (default: 1).
1431 .
1432 .TP
1433 .B \-bluray\-device <path to disc> (Blu\-ray only)
1434 Specify the Blu\-ray disc location. Must be a directory with Blu\-ray structure.
1435 .
1436 .TP
1437 .B \-cache <kBytes>
1438 This option specifies how much memory (in kBytes) to use when precaching a
1439 file or URL.
1440 Especially useful on slow media.
1441 .
1442 .TP
1443 .B \-nocache
1444 Turns off caching.
1445 .
1446 .TP
1447 .B \-cache\-min <percentage>
1448 Playback will start when the cache has been filled up to <percentage>
1449 of the total.
1450 .
1451 .TP
1452 .B \-cache\-seek\-min <percentage>
1453 If a seek is to be made to a position within <percentage> of the cache size
1454 from the current position, MPlayer will wait for the cache to be filled to
1455 this position rather than performing a stream seek (default: 50).
1456 .
1457 .TP
1458 .B \-capture (MPlayer only)
1459 Allows capturing the primary stream (not additional audio tracks or other
1460 kind of streams) into the file specified by \-dumpfile or \"stream.dump\"
1461 by default.
1462 If this option is given, capturing can be started and stopped by pressing
1463 the key bound to this function (see section INTERACTIVE CONTROL).
1464 Same as for \-dumpstream, this will likely not produce usable results for
1465 anything else than MPEG streams.
1466 Note that, due to cache latencies, captured data may begin and end
1467 somewhat delayed compared to what you see displayed.
1468 .
1469 .TP
1470 .B \-cdda <option1:option2> (CDDA only)
1471 This option can be used to tune the CD Audio reading feature of MPlayer.
1472 .sp 1
1473 Available options are:
1474 .RSs
1475 .IPs speed=<value>
1476 Set CD spin speed.
1477 .IPs paranoia=<0\-2>
1478 Set paranoia level.
1479 Values other than 0 seem to break playback of anything but the first track.
1480 .RSss
1481 0: disable checking (default)
1482 .br
1483 1: overlap checking only
1484 .br
1485 2: full data correction and verification
1486 .REss
1487 .IPs generic-dev=<value>
1488 Use specified generic SCSI device.
1489 .IPs sector-size=<value>
1490 Set atomic read size.
1491 .IPs overlap=<value>
1492 Force minimum overlap search during verification to <value> sectors.
1493 .IPs toc-bias
1494 Assume that the beginning offset of track 1 as reported in the TOC will be
1495 addressed as LBA 0.
1496 Some Toshiba drives need this for getting track boundaries correct.
1497 .IPs toc-offset=<value>
1498 Add <value> sectors to the values reported when addressing tracks.
1499 May be negative.
1500 .IPs (no)skip
1501 (Never) accept imperfect data reconstruction.
1502 .RE
1503 .
1504 .TP
1505 .B \-cdrom\-device <path to device>
1506 Specify the CD-ROM device (default: /dev/\:cdrom).
1507 .
1508 .TP
1509 .B \-channels <number> (also see \-af channels)
1510 Request the number of playback channels (default: 2).
1511 MPlayer asks the decoder to decode the audio into as many channels as
1512 specified.
1513 Then it is up to the decoder to fulfill the requirement.
1514 This is usually only important when playing videos with AC-3 audio (like DVDs).
1515 In that case liba52 does the decoding by default and correctly downmixes the
1516 audio into the requested number of channels.
1517 To directly control the number of output channels independently of how many
1518 channels are decoded, use the channels filter.
1519 .br
1520 .I NOTE:
1521 This option is honored by codecs (AC-3 only), filters (surround) and audio
1522 output drivers (OSS at least).
1523 .sp 1
1524 Available options are:
1525 .sp 1
1526 .PD 0
1527 .RSs
1528 .IPs 2
1529 stereo
1530 .IPs 4
1531 surround
1532 .IPs 6
1533 full 5.1
1534 .IPs 8
1535 full 7.1
1536 .RE
1537 .PD 1
1538 .
1539 .TP
1540 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1541 Specify which chapter to start playing at.
1542 Optionally specify which chapter to end playing at (default: 1).
1543 .
1544 .TP
1545 .B \-cookies (network only)
1546 Send cookies when making HTTP requests.
1547 .
1548 .TP
1549 .B \-cookies\-file <filename> (network only)
1550 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1551 and skip reading from default locations.
1552 The file is assumed to be in Netscape format.
1553 .
1554 .TP
1555 .B \-delay <sec>
1556 audio delay in seconds (positive or negative float value)
1557 .br
1558 Negative values delay the audio, and positive values delay the video.
1559 Note that this is the exact opposite of the \-audio\-delay MEncoder option.
1560 .br
1561 .I NOTE:
1562 When used with MEncoder, this is not guaranteed to work correctly
1563 with \-ovc copy; use \-audio\-delay instead.
1564 .
1565 .TP
1566 .B \-ignore\-start
1567 Ignore the specified starting time for streams in AVI files.
1568 In MPlayer, this nullifies stream delays in files encoded with
1569 the \-audio\-delay option.
1570 During encoding, this option prevents MEncoder from transferring
1571 original stream start times to the new file; the \-audio\-delay option is
1572 not affected.
1573 Note that MEncoder sometimes adjusts stream starting times
1574 automatically to compensate for anticipated decoding delays, so do not
1575 use this option for encoding without testing it first.
1576 .
1577 .TP
1578 .B \-demuxer <[+]name>
1579 Force demuxer type.
1580 Use a '+' before the name to force it, this will skip some checks!
1581 Give the demuxer name as printed by \-demuxer help.
1582 For backward compatibility it also accepts the demuxer ID as defined in
1583 libmpdemux/\:demuxer.h.
1584 .
1585 .TP
1586 .B \-dumpaudio (MPlayer only)
1587 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
1588 in most other cases the resulting file will not be playable).
1589 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1590 on the command line only the last one will work.
1591 .
1592 .TP
1593 .B \-dumpfile <filename> (MPlayer only)
1594 Specify which file MPlayer should dump to.
1595 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream /
1596 \-capture.
1597 .
1598 .TP
1599 .B \-dumpstream (MPlayer only)
1600 Dumps the raw stream to ./stream.dump.
1601 Useful when ripping from DVD or network.
1602 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1603 on the command line only the last one will work.
1604 .
1605 .TP
1606 .B \-dumpvideo (MPlayer only)
1607 Dump raw compressed video stream to ./stream.dump (not very usable).
1608 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1609 on the command line only the last one will work.
1610 .
1611 .TP
1612 .B \-dvbin <options> (DVB only)
1613 Pass the following parameters to the DVB input module, in order to override
1614 the default ones:
1615 .sp 1
1616 .PD 0
1617 .RSs
1618 .IPs card=<1\-4>
1619 Specifies using card number 1\-4 (default: 1).
1620 .IPs file=<filename>
1621 Instructs MPlayer to read the channels list from <filename>.
1622 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1623 or ~/.mplayer/\:channels.conf as a last resort.
1624 .IPs timeout=<1\-240>
1625 Maximum number of seconds to wait when trying to tune a
1626 frequency before giving up (default: 30).
1627 .RE
1628 .PD 1
1629 .
1630 .TP
1631 .B \-dvd\-device <path to device> (DVD only)
1632 Specify the DVD device or .iso filename (default: /dev/\:dvd).
1633 You can also specify a directory that contains files previously copied directly
1634 from a DVD (with e.g.\& vobcopy).
1635 .
1636 .TP
1637 .B \-dvd\-speed <factor or speed in KB/s> (DVD only)
1638 Try to limit DVD speed (default: 0, no change).
1639 DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
1640 10800KB/s.
1641 Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
1642 quiet and fast enough.
1643 MPlayer resets the speed to the drive default value on close.
1644 Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
1645 10800KB/s.
1646 .br
1647 .I NOTE:
1648 You need write access to the DVD device to change the speed.
1649 .
1650 .TP
1651 .B \-dvdangle <angle ID> (DVD only)
1652 Some DVD discs contain scenes that can be viewed from multiple angles.
1653 Here you can tell MPlayer which angles to use (default: 1).
1654 .
1655 .TP
1656 .B \-edl <filename>
1657 Enables edit decision list (EDL) actions during playback.
1658 Video will be skipped over and audio will be muted and unmuted according to
1659 the entries in the given file.
1660 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1661 on how to use this.
1662 .
1663 .TP
1664 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1665 Stop at given time or byte position.
1666 .br
1667 .I NOTE:
1668 Byte position may not be accurate, as it can only stop at a frame boundary.
1669 When used in conjunction with \-ss option, \-endpos time will shift forward by
1670 seconds specified with \-ss if not a byte position.
1671 .sp 1
1672 .I EXAMPLE:
1673 .PD 0
1674 .RSs
1675 .IPs "\-endpos 56"
1676 Stop at 56 seconds.
1677 .IPs "\-endpos 01:10:00"
1678 Stop at 1 hour 10 minutes.
1679 .IPs "\-ss 10 \-endpos 56"
1680 Stop at 1 minute 6 seconds.
1681 .IPs "mplayer \-endpos 100mb"
1682 Stop playback after reading 100MB of the input file.
1683 .IPs "mencoder \-endpos 100mb"
1684 Encode only 100 MB.
1685 .RE
1686 .PD 1
1687 .
1688 .TP
1689 .B \-forceidx
1690 Force index rebuilding.
1691 Useful for files with broken index (A/V desync, etc).
1692 This will enable seeking in files where seeking was not possible.
1693 You can fix the index permanently with MEncoder (see the documentation).
1694 .br
1695 .I NOTE:
1696 This option only works if the underlying media supports seeking
1697 (i.e.\& not with stdin, pipe, etc).
1698 .
1699 .TP
1700 .B \-fps <float value>
1701 Override video framerate.
1702 Useful if the original value is wrong or missing.
1703 .
1704 .TP
1705 .B \-frames <number>
1706 Play/\:convert only first <number> frames, then quit.
1707 .
1708 .TP
1709 .B \-hr\-mp3\-seek (MP3 only)
1710 Hi-res MP3 seeking.
1711 Enabled when playing from an external MP3 file, as we need to seek
1712 to the very exact position to keep A/V sync.
1713 Can be slow especially when seeking backwards since it has to rewind
1714 to the beginning to find an exact frame position.
1715 .
1716 .TP
1717 .B \-http-header-fields <field1,field2>
1718 Set custom HTTP fields when accessing HTTP stream.
1719 .sp 1
1720 .I EXAMPLE:
1721 .PD 0
1722 .RSs
1723 .IPs
1724 mplayer \-http\-header\-fields 'Field1: value1','Field2: value2' http://localhost:1234
1725 .br
1726 Will generate HTTP request:
1727 .RSss
1728 .br
1729 GET / HTTP/1.0
1730 .br
1731 Host: localhost:1234
1732 .br
1733 User-Agent: MPlayer
1734 .br
1735 Icy-MetaData: 1
1736 .br
1737 Field1: value1
1738 .br
1739 Field2: value2
1740 .br
1741 Connection: close
1742 .REss
1743 .RE
1744 .
1745 .TP
1746 .B \-idx (also see \-forceidx)
1747 Rebuilds index of files if no index was found, allowing seeking.
1748 Useful with broken/\:incomplete downloads, or badly created files.
1749 .br
1750 .I NOTE:
1751 This option only works if the underlying media supports seeking
1752 (i.e.\& not with stdin, pipe, etc).
1753 .
1754 .TP
1755 .B \-noidx
1756 Skip rebuilding index file.
1757 MEncoder skips writing the index with this option.
1758 .
1759 .TP
1760 .B \-ipv4\-only\-proxy (network only)
1761 Skip the proxy for IPv6 addresses.
1762 It will still be used for IPv4 connections.
1763 .
1764 .TP
1765 .B \-loadidx <index file>
1766 The file from which to read the video index data saved by \-saveidx.
1767 This index will be used for seeking, overriding any index data
1768 contained in the AVI itself.
1769 MPlayer will not prevent you from loading an index file generated
1770 from a different AVI, but this is sure to cause unfavorable results.
1771 .br
1772 .I NOTE:
1773 This option is obsolete now that MPlayer has OpenDML support.
1774 .
1775 .TP
1776 .B \-mc <seconds/frame>
1777 maximum A-V sync correction per frame (in seconds)
1778 .br
1779 \-mc 0 should always be combined with \-noskip for mencoder, otherwise
1780 it will almost certainly cause A-V desync.
1781 .
1782 .TP
1783 .B \-mf <option1:option2:...>
1784 Used when decoding from multiple PNG or JPEG files.
1785 .sp 1
1786 Available options are:
1787 .sp 1
1788 .PD 0
1789 .RSs
1790 .IPs w=<value>
1791 input file width (default: autodetect)
1792 .IPs h=<value>
1793 input file height (default: autodetect)
1794 .IPs fps=<value>
1795 output fps (default: 25)
1796 .IPs type=<value>
1797 input file type (available: jpeg, png, tga, sgi)
1798 .RE
1799 .PD 1
1800 .
1801 .TP
1802 .B \-ni (AVI only)
1803 Force usage of non-interleaved AVI parser (fixes playback
1804 of some bad AVI files).
1805 .
1806 .TP
1807 .B \-nobps (AVI only)
1808 Do not use average byte/\:second value for A-V sync.
1809 Helps with some AVI files with broken header.
1810 .
1811 .TP
1812 .B \-noextbased
1813 Disables extension-based demuxer selection.
1814 By default, when the file type (demuxer) cannot be detected reliably
1815 (the file has no header or it is not reliable enough), the filename
1816 extension is used to select the demuxer.
1817 Always falls back on content-based demuxer selection.
1818 .
1819 .TP
1820 .B \-passwd <password> (also see \-user) (network only)
1821 Specify password for HTTP authentication.
1822 .
1823 .TP
1824 .B \-prefer\-ipv4 (network only)
1825 Use IPv4 on network connections.
1826 Falls back on IPv6 automatically.
1827 .
1828 .TP
1829 .B \-prefer\-ipv6 (IPv6 network only)
1830 Use IPv6 on network connections.
1831 Falls back on IPv4 automatically.
1832 .
1833 .TP
1834 .B \-psprobe <byte position>
1835 When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
1836 how many bytes in the stream you want MPlayer to scan in order to identify
1837 the video codec used.
1838 This option is needed to play EVO or VDR files containing H.264 streams.
1839 .
1840 .TP
1841 .B \-pvr <option1:option2:...> (PVR only)
1842 This option tunes various encoding properties of the PVR capture module.
1843 It has to be used with any hardware MPEG encoder based card supported by the
1844 V4L2 driver.
1845 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1846 cards are known as PVR capture cards.
1847 Be aware that only Linux 2.6.18 kernel
1848 and above is able to handle MPEG stream through V4L2 layer.
1849 For hardware capture of an MPEG stream and watching it with
1850 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1851 .sp 1
1852 Available options are:
1853 .RSs
1854 .IPs aspect=<0\-3>
1855 Specify input aspect ratio:
1856 .RSss
1857 0: 1:1
1858 .br
1859 1: 4:3 (default)
1860 .br
1861 2: 16:9
1862 .br
1863 3: 2.21:1
1864 .REss
1865 .IPs arate=<32000\-48000>
1866 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1867 and 48000 Hz).
1868 .IPs alayer=<1\-3>
1869 Specify MPEG audio layer encoding (default: 2).
1870 .IPs abitrate=<32\-448>
1871 Specify audio encoding bitrate in kbps (default: 384).
1872 .IPs amode=<value>
1873 Specify audio encoding mode.
1874 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1875 .IPs vbitrate=<value>
1876 Specify average video bitrate encoding in Mbps (default: 6).
1877 .IPs vmode=<value>
1878 Specify video encoding mode:
1879 .RSss
1880 vbr: Variable BitRate (default)
1881 .br
1882 cbr: Constant BitRate
1883 .REss
1884 .IPs vpeak=<value>
1885 Specify peak video bitrate encoding in Mbps
1886 (only useful for VBR encoding, default: 9.6).
1887 .IPs fmt=<value>
1888 Choose an MPEG format for encoding:
1889 .RSss
1890 ps:    MPEG-2 Program Stream (default)
1891 .br
1892 ts:    MPEG-2 Transport Stream
1893 .br
1894 mpeg1: MPEG-1 System Stream
1895 .br
1896 vcd:   Video CD compatible stream
1897 .br
1898 svcd:  Super Video CD compatible stream
1899 .br
1900 dvd:   DVD compatible stream
1901 .REss
1902 .RE
1903 .PD 1
1904 .
1905 .TP
1906 .B \-radio <option1:option2:...> (radio only)
1907 These options set various parameters of the radio capture module.
1908 For listening to radio with MPlayer use 'radio://<frequency>'
1909 (if channels option is not given) or 'radio://<channel_number>'
1910 (if channels option is given) as a movie URL.
1911 You can see allowed frequency range by running MPlayer with '\-v'.
1912 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1913 If the capture keyword is not given you can listen to radio
1914 using the line-in cable only.
1915 Using capture to listen is not recommended due to synchronization
1916 problems, which makes this process uncomfortable.
1917 .sp 1
1918 Available options are:
1919 .RSs
1920 .IPs device=<value>
1921 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1922 .IPs driver=<value>
1923 Radio driver to use (default: v4l2 if available, otherwise v4l).
1924 Currently, v4l and v4l2 drivers are supported.
1925 .IPs volume=<0..100>
1926 sound volume for radio device (default 100)
1927 .IPs "freq_min=<value> (*BSD BT848 only)"
1928 minimum allowed frequency (default: 87.50)
1929 .IPs "freq_max=<value> (*BSD BT848 only)"
1930 maximum allowed frequency (default: 108.00)
1931 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1932 Set channel list.
1933 Use _ for spaces in names (or play with quoting ;-).
1934 The channel names will then be written using OSD and the slave commands
1935 radio_step_channel and radio_set_channel will be usable for
1936 a remote control (see LIRC).
1937 If given, number in movie URL will be treated as channel position in
1938 channel list.
1939 .br
1940 .I EXAMPLE:
1941 radio://1, radio://104.4, radio_set_channel 1
1942 .IPs "adevice=<value> (radio capture only)"
1943 Name of device to capture sound from.
1944 Without such a name capture will be disabled,
1945 even if the capture keyword appears in the URL.
1946 For ALSA devices use it in the form hw=<card>.<device>.
1947 If the device name contains a '=', the module will use
1948 ALSA to capture, otherwise OSS.
1949 .IPs "arate=<value> (radio capture only)"
1950 Rate in samples per second (default: 44100).
1951 .br
1952 .I NOTE:
1953 When using audio capture set also \-rawaudio rate=<value> option
1954 with the same value as arate.
1955 If you have problems with sound speed (runs too quickly), try to play
1956 with different rate values (e.g.\& 48000,44100,32000,...).
1957 .IPs "achannels=<value> (radio capture only)"
1958 Number of audio channels to capture.
1959 .RE
1960 .
1961 .TP
1962 .B \-rawaudio <option1:option2:...>
1963 This option lets you play raw audio files.
1964 You have to use \-demuxer rawaudio as well.
1965 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1966 For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1967 .sp 1
1968 Available options are:
1969 .sp 1
1970 .PD 0
1971 .RSs
1972 .IPs channels=<value>
1973 number of channels
1974 .IPs rate=<value>
1975 rate in samples per second
1976 .IPs samplesize=<value>
1977 sample size in bytes
1978 .IPs bitrate=<value>
1979 bitrate for rawaudio files
1980 .IPs format=<value>
1981 fourcc in hex
1982 .RE
1983 .PD 1
1984 .
1985 .TP
1986 .B \-rawvideo <option1:option2:...>
1987 This option lets you play raw video files.
1988 You have to use \-demuxer rawvideo as well.
1989 .sp 1
1990 Available options are:
1991 .sp 1
1992 .PD 0
1993 .RSs
1994 .IPs fps=<value>
1995 rate in frames per second (default: 25.0)
1996 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1997 set standard image size
1998 .IPs w=<value>
1999 image width in pixels
2000 .IPs h=<value>
2001 image height in pixels
2002 .IPs i420|yv12|yuy2|y8
2003 set colorspace
2004 .IPs format=<value>
2005 colorspace (fourcc) in hex or string constant.
2006 Use \-rawvideo format=help for a list of possible strings.
2007 .IPs size=<value>
2008 frame size in Bytes
2009 .REss
2010 .sp 1
2011 .RS
2012 .I EXAMPLE:
2013 .RE
2014 .PD 0
2015 .RSs
2016 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
2017 Play the famous "foreman" sample video.
2018 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
2019 Play a raw YUV sample.
2020 .RE
2021 .PD 1
2022 .
2023 .TP
2024 .B \-referrer <string> (network only)
2025 Specify a referrer path or URL for HTTP requests.
2026 .
2027 .TP
2028 .B \-rtsp\-port
2029 Used with 'rtsp://' URLs to force the client's port number.
2030 This option may be useful if you are behind a router and want to forward
2031 the RTSP stream from the server to a specific client.
2032 .
2033 .TP
2034 .B \-rtsp\-destination
2035 Used with 'rtsp://' URLs to force the destination IP address to be bound.
2036 This option may be useful with some RTSP server which do not
2037 send RTP packets to the right interface.
2038 If the connection to the RTSP server fails, use \-v to see
2039 which IP address MPlayer tries to bind to and try to force
2040 it to one assigned to your computer instead.
2041 .
2042 .TP
2043 .B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
2044 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
2045 packets be streamed over TCP (using the same TCP connection as RTSP).
2046 This option may be useful if you have a broken internet connection that does
2047 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
2048 .
2049 .TP
2050 .B \-rtsp\-stream\-over\-http (LIVE555 only)
2051 Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP
2052 packets be streamed over HTTP.
2053 .
2054 .TP
2055 .B \-saveidx <filename>
2056 Force index rebuilding and dump the index to <filename>.
2057 Currently this only works with AVI files.
2058 .br
2059 .I NOTE:
2060 This option is obsolete now that MPlayer has OpenDML support.
2061 .
2062 .TP
2063 .B \-sb <byte position> (also see \-ss)
2064 Seek to byte position.
2065 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
2066 .
2067 .TP
2068 .B \-speed <0.01\-100>
2069 Slow down or speed up playback by the factor given as parameter.
2070 Not guaranteed to work correctly with \-oac copy.
2071 .
2072 .TP
2073 .B \-srate <Hz>
2074 Select the output sample rate to be used
2075 (of course sound cards have limits on this).
2076 If the sample frequency selected is different from that
2077 of the current media, the resample or lavcresample audio filter will be inserted
2078 into the audio filter layer to compensate for the difference.
2079 The type of resampling can be controlled by the \-af\-adv option.
2080 The default is fast resampling that may cause distortion.
2081 .
2082 .TP
2083 .B \-ss <time> (also see \-sb)
2084 Seek to given time position.
2085 .sp 1
2086 .I EXAMPLE:
2087 .PD 0
2088 .RSs
2089 .IPs "\-ss 56"
2090 Seeks to 56 seconds.
2091 .IPs "\-ss 01:10:00"
2092 Seeks to 1 hour 10 min.
2093 .RE
2094 .PD 1
2095 .
2096 .TP
2097 .B \-tskeepbroken
2098 Tells MPlayer not to discard TS packets reported as broken in the stream.
2099 Sometimes needed to play corrupted MPEG-TS files.
2100 .
2101 .TP
2102 .B \-tsprobe <byte position>
2103 When playing an MPEG-TS stream, this option lets you specify how many
2104 bytes in the stream you want MPlayer to search for the desired
2105 audio and video IDs.
2106 .
2107 .TP
2108 .B \-tsprog <1\-65534>
2109 When playing an MPEG-TS stream, you can specify with this option which
2110 program (if present) you want to play.
2111 Can be used with \-vid and \-aid.
2112 .
2113 .TP
2114 .B \-tv <option1:option2:...> (TV/\:PVR only)
2115 This option tunes various properties of the TV capture module.
2116 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
2117 or even 'tv://<channel_name> (see option channels for channel_name below)
2118 as a movie URL.
2119 You can also use 'tv:///<input_id>' to start watching a
2120 movie from a composite or S-Video input (see option input for details).
2121 .sp 1
2122 Available options are:
2123 .RSs
2124 .IPs noaudio
2125 no sound
2126 .IPs "automute=<0\-255> (v4l and v4l2 only)"
2127 If signal strength reported by device is less than this value,
2128 audio and video will be muted.
2129 In most cases automute=100 will be enough.
2130 Default is 0 (automute disabled).
2131 .IPs driver=<value>
2132 See \-tv driver=help for a list of compiled-in TV input drivers.
2133 available: dummy, v4l, v4l2, bsdbt848 (default: autodetect)
2134 .IPs device=<value>
2135 Specify TV device (default: /dev/\:video0).
2136 .I NOTE:
2137 For the bsdbt848 driver you can provide both bktr and tuner device
2138 names separating them with a comma, tuner after
2139 bktr (e.g.\& -tv device=/dev/bktr1,/dev/tuner1).
2140 .IPs input=<value>
2141 Specify input (default: 0 (TV), see console output for available inputs).
2142 .IPs freq=<value>
2143 Specify the frequency to set the tuner to (e.g.\& 511.250).
2144 Not compatible with the channels parameter.
2145 .IPs outfmt=<value>
2146 Specify the output format of the tuner with a preset value supported by the
2147 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
2148 arbitrary format given as hex value.
2149 Try outfmt=help for a list of all available formats.
2150 .IPs width=<value>
2151 output window width
2152 .IPs height=<value>
2153 output window height
2154 .IPs fps=<value>
2155 framerate at which to capture video (frames per second)
2156 .IPs buffersize=<value>
2157 maximum size of the capture buffer in megabytes (default: dynamical)
2158 .IPs norm=<value>
2159 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
2160 For v4l2, see the console output for a list of all available norms,
2161 also see the normid option below.
2162 .IPs "normid=<value> (v4l2 only)"
2163 Sets the TV norm to the given numeric ID.
2164 The TV norm depends on the capture card.
2165 See the console output for a list of available TV norms.
2166 .IPs channel=<value>
2167 Set tuner to <value> channel.
2168 .IPs chanlist=<value>
2169 available: argentina, australia, china-bcast, europe-east, europe-west, france,
2170 ireland, italy, japan-bcast, japan-cable, newzealand, russia, southafrica,
2171 us-bcast, us-cable, us-cable-hrc
2172 .IPs channels=<chan>\-<name>[=<norm>],<chan>\-<name>[=<norm>],...
2173 Set names for channels.
2174 .I NOTE:
2175 If <chan> is an integer greater than 1000, it will be treated as frequency (in kHz)
2176 rather than channel name from frequency table.
2177 .br
2178 Use _ for spaces in names (or play with quoting ;-).
2179 The channel names will then be written using OSD, and the slave commands
2180 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
2181 a remote control (see LIRC).
2182 Not compatible with the frequency parameter.
2183 .br
2184 .I NOTE:
2185 The channel number will then be the position in the 'channels' list,
2186 beginning with 1.
2187 .br
2188 .I EXAMPLE:
2189 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
2190 .IPs [brightness|contrast|hue|saturation]=<\-100\-100>
2191 Set the image equalizer on the card.
2192 .IPs audiorate=<value>
2193 Set input audio sample rate.
2194 .IPs forceaudio
2195 Capture audio even if there are no audio sources reported by v4l.
2196 .IPs "alsa\ "
2197 Capture from ALSA.
2198 .IPs amode=<0\-3>
2199 Choose an audio mode:
2200 .RSss
2201 0: mono
2202 .br
2203 1: stereo
2204 .br
2205 2: language 1
2206 .br
2207 3: language 2
2208 .REss
2209 .IPs forcechan=<1\-2>
2210 By default, the count of recorded audio channels is determined automatically
2211 by querying the audio mode from the TV card.
2212 This option allows forcing stereo/\:mono recording regardless of the amode
2213 option and the values returned by v4l.
2214 This can be used for troubleshooting when the TV card is unable to report the
2215 current audio mode.
2216 .IPs adevice=<value>
2217 Set an audio device.
2218 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
2219 You must replace any ':' by a '.' in the hardware ID for ALSA.
2220 .IPs audioid=<value>
2221 Choose an audio output of the capture card, if it has more than one.
2222 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
2223 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
2224 These options set parameters of the mixer on the video capture card.
2225 They will have no effect, if your card does not have one.
2226 For v4l2 50 maps to the default value of the
2227 control, as reported by the driver.
2228 .IPs "gain=<0\-100> (v4l2)"
2229 Set gain control for video devices (usually webcams) to the desired
2230 value and switch off automatic control.
2231 A value of 0 enables automatic control.
2232 If this option is omitted, gain control will not be modified.
2233 .IPs immediatemode=<bool>
2234 A value of 0 means capture and buffer audio and video together
2235 (default for MEncoder).
2236 A value of 1 (default for MPlayer) means to do video capture only and let the
2237 audio go through a loopback cable from the TV card to the sound card.
2238 .IPs mjpeg
2239 Use hardware MJPEG compression (if the card supports it).
2240 When using this option, you do not need to specify the width and height
2241 of the output window, because MPlayer will determine it automatically
2242 from the decimation value (see below).
2243 .IPs decimation=<1|2|4>
2244 choose the size of the picture that will be compressed by hardware
2245 MJPEG compression:
2246 .RSss
2247 1: full size
2248     704x576    PAL
2249     704x480    NTSC
2250 .br
2251 2: medium size
2252     352x288    PAL
2253     352x240    NTSC
2254 .br
2255 4: small size
2256     176x144    PAL
2257     176x120    NTSC
2258 .REss
2259 .IPs quality=<0\-100>
2260 Choose the quality of the JPEG compression
2261 (< 60 recommended for full size).
2262 .IPs tdevice=<value>
2263 Specify TV teletext device (example: /dev/\:vbi0) (default: none).
2264 .IPs tformat=<format>
2265 Specify TV teletext display format (default: 0):
2266 .RSss
2267 0: opaque
2268 .br
2269 1: transparent
2270 .br
2271 2: opaque with inverted colors
2272 .br
2273 3: transparent with inverted colors
2274 .REss
2275 .IPs tpage=<100\-899>
2276 Specify initial TV teletext page number (default: 100).
2277 .IPs tlang=<\-1\-127>
2278 Specify default teletext language code (default: 0), which will be used
2279 as primary language until a type 28 packet is received.
2280 Useful when the teletext system uses a non-latin character set, but language
2281 codes are not transmitted via teletext type 28 packets for some reason.
2282 To see a list of supported language codes set this option to \-1.
2283 .IPs "hidden_video_renderer (dshow only)"
2284 Terminate stream with video renderer instead of Null renderer (default: off).
2285 Will help if video freezes but audio does not.
2286 .I NOTE:
2287 May not work with \-vo directx and \-vf crop combination.
2288 .IPs "hidden_vp_renderer (dshow only)"
2289 Terminate VideoPort pin stream with video renderer
2290 instead of removing it from the graph (default: off).
2291 Useful if your card has a VideoPort pin and video is choppy.
2292 .I NOTE:
2293 May not work with \-vo directx and \-vf crop combination.
2294 .IPs "system_clock (dshow only)"
2295 Use the system clock as sync source instead of the default graph clock
2296 (usually the clock from one of the live sources in graph).
2297 .IPs "normalize_audio_chunks (dshow only)"
2298 Create audio chunks with a time length equal to
2299 video frame time length (default: off).
2300 Some audio cards create audio chunks about 0.5s in size, resulting in
2301 choppy video when using immediatemode=0.
2302 .RE
2303 .
2304 .TP
2305 .B \-tvscan <option1:option2:...> (TV and MPlayer only)
2306 Tune the TV channel scanner.
2307 MPlayer will also print value for "-tv channels=" option,
2308 including existing and just found channels.
2309 .sp 1
2310 Available suboptions are:
2311 .RSs
2312 .IPs autostart
2313 Begin channel scanning immediately after startup (default: disabled).
2314 .IPs period=<0.1\-2.0>
2315 Specify delay in seconds before switching to next channel (default: 0.5).
2316 Lower values will cause faster scanning, but can detect
2317 inactive TV channels as active.
2318 .IPs threshold=<1\-100>
2319 Threshold value for the signal strength (in percent), as reported
2320 by the device (default: 50).
2321 A signal strength higher than this value will indicate that the
2322 currently scanning channel is active.
2323 .RE
2324 .
2325 .TP
2326 .B \-user <username> (also see \-passwd) (network only)
2327 Specify username for HTTP authentication.
2328 .
2329 .TP
2330 .B \-user\-agent <string>
2331 Use <string> as user agent for HTTP streaming.
2332 .
2333 .TP
2334 .B \-vid <ID>
2335 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
2336 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
2337 (if present) with the chosen video stream.
2338 .
2339 .TP
2340 .B \-vivo <suboption> (DEBUG CODE)
2341 Force audio parameters for the VIVO demuxer (for debugging purposes).
2342 FIXME: Document this.
2343 .
2344 .
2345 .
2346 .SH "OSD/SUBTITLE OPTIONS"
2347 .I NOTE:
2348 Also see \-vf expand.
2349 .
2350 .TP
2351 .B \-ass (FreeType only)
2352 Turn on SSA/ASS subtitle rendering.
2353 With this option, libass will be used for SSA/ASS
2354 external subtitles and Matroska tracks.
2355 You may also want to use \-embeddedfonts.
2356 .br
2357 .I NOTE:
2358 Unlike normal OSD, libass uses fontconfig by default. To disable it, use
2359 \-nofontconfig.
2360 .
2361 .TP
2362 .B \-ass\-border\-color <value>
2363 Sets the border (outline) color for text subtitles.
2364 The color format is RRGGBBAA.
2365 .
2366 .TP
2367 .B \-ass\-bottom\-margin <value>
2368 Adds a black band at the bottom of the frame.
2369 The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
2370 .
2371 .TP
2372 .B \-ass\-color <value>
2373 Sets the color for text subtitles.
2374 The color format is RRGGBBAA.
2375 .
2376 .TP
2377 .B \-ass\-font\-scale <value>
2378 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
2379 .
2380 .TP
2381 .B \-ass\-force\-style <[Style.]Param=Value[,...]>
2382 Override some style or script info parameters.
2383 .sp
2384 .I EXAMPLE:
2385 .PD 0
2386 .RSs
2387 \-ass\-force\-style FontName=Arial,Default.Bold=1
2388 .br
2389 \-ass\-force\-style PlayResY=768
2390 .RE
2391 .PD 1
2392 .
2393 .TP
2394 .B \-ass\-hinting <type>
2395 Set hinting type.
2396 <type> can be:
2397 .PD 0
2398 .RSs
2399 .IPs 0
2400 no hinting
2401 .IPs 1
2402 FreeType autohinter, light mode
2403 .IPs 2
2404 FreeType autohinter, normal mode
2405 .IPs 3
2406 font native hinter
2407 .IPs "0-3 + 4"
2408 The same, but hinting will only be performed if the OSD is rendered at
2409 screen resolution and will therefore not be scaled.
2410 .RE
2411 .RSs
2412 The default value is 7 (use native hinter for unscaled OSD and no hinting otherwise).
2413 .RE
2414 .PD 1
2415 .
2416 .TP
2417 .B \-ass\-line\-spacing <value>
2418 Set line spacing value for SSA/ASS renderer.
2419 .
2420 .TP
2421 .B \-ass\-styles <filename>
2422 Load all SSA/ASS styles found in the specified file and use them for
2423 rendering text subtitles.
2424 The syntax of the file is exactly like the
2425 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
2426 .
2427 .TP
2428 .B \-ass\-top\-margin <value>
2429 Adds a black band at the top of the frame.
2430 The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
2431 .
2432 .TP
2433 .B \-ass\-use\-margins
2434 Enables placing toptitles and subtitles in black borders when they
2435 are available.
2436 .
2437 .TP
2438 .B \-dumpjacosub (MPlayer only)
2439 Convert the given subtitle (specified with the \-sub option) to the time-based
2440 JACOsub subtitle format.
2441 Creates a dumpsub.js file in the current directory.
2442 .
2443 .TP
2444 .B \-dumpmicrodvdsub (MPlayer only)
2445 Convert the given subtitle (specified with the \-sub option) to the
2446 MicroDVD subtitle format.
2447 Creates a dumpsub.sub file in the current directory.
2448 .
2449 .TP
2450 .B \-dumpmpsub (MPlayer only)
2451 Convert the given subtitle (specified with the \-sub option) to MPlayer's
2452 subtitle format, MPsub.
2453 Creates a dump.mpsub file in the current directory.
2454 .
2455 .TP
2456 .B \-dumpsami (MPlayer only)
2457 Convert the given subtitle (specified with the \-sub option) to the time-based
2458 SAMI subtitle format.
2459 Creates a dumpsub.smi file in the current directory.
2460 .
2461 .TP
2462 .B \-dumpsrtsub (MPlayer only)
2463 Convert the given subtitle (specified with the \-sub option) to the time-based
2464 SubViewer (SRT) subtitle format.
2465 Creates a dumpsub.srt file in the current directory.
2466 .br
2467 .I NOTE:
2468 Some broken hardware players choke on SRT subtitle files with Unix
2469 line endings.
2470 If you are unlucky enough to have such a box, pass your subtitle
2471 files through unix2dos or a similar program to replace Unix line
2472 endings with DOS/Windows line endings.
2473 .
2474 .TP
2475 .B \-dumpsub (MPlayer only) (BETA CODE)
2476 Dumps the subtitle substream from VOB streams.
2477 Also see the \-dump*sub and \-vobsubout* options.
2478 .
2479 .TP
2480 .B \-embeddedfonts (FreeType only)
2481 Enables extraction of Matroska embedded fonts (default: disabled).
2482 These fonts can be used for SSA/ASS subtitle
2483 rendering (\-ass option).
2484 Font files are created in the ~/.mplayer/\:fonts directory.
2485 .br
2486 .I NOTE:
2487 With FontConfig 2.4.2 or newer, embedded fonts are opened directly from memory,
2488 and this option is enabled by default.
2489 .
2490 .TP
2491 .B \-ffactor <number>
2492 Resample the font alphamap.
2493 Can be:
2494 .PD 0
2495 .RSs
2496 .IPs 0
2497 plain white fonts
2498 .IPs 0.75
2499 very narrow black outline (default)
2500 .IPs 1
2501 narrow black outline
2502 .IPs 10
2503 bold black outline
2504 .RE
2505 .PD 1
2506 .
2507 .TP
2508 .B \-flip\-hebrew (FriBiDi only)
2509 Turns on flipping subtitles using FriBiDi.
2510 .
2511 .TP
2512 .B \-noflip\-hebrew\-commas
2513 Change FriBiDi's assumptions about the placements of commas in subtitles.
2514 Use this if commas in subtitles are shown at the start of a sentence
2515 instead of at the end.
2516 .
2517 .TP
2518 .B \-font <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
2519 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
2520 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
2521 ~/.mplayer/\:subfont.ttf).
2522 .br
2523 .I NOTE:
2524 With FreeType, this option determines the path to the text font file.
2525 With Fontconfig, this option determines the Fontconfig font pattern.
2526 .sp 1
2527 .I EXAMPLE:
2528 .PD 0
2529 .RSs
2530 \-font ~/\:.mplayer/\:arial-14/\:font.desc
2531 .br
2532 \-font ~/\:.mplayer/\:arialuni.ttf
2533 .br
2534 \-font 'Bitstream Vera Sans'
2535 .br
2536 \-font 'Bitstream Vera Sans:style=Bold'
2537 .RE
2538 .PD 1
2539 .
2540 .TP
2541 .B \-fontconfig (fontconfig only)
2542 Enables the usage of fontconfig managed fonts.
2543 .br
2544 .I NOTE:
2545 By default fontconfig is used for libass-rendered subtitles and not used for
2546 OSD. With \-fontconfig it is used for both libass and OSD, with \-nofontconfig
2547 it is not used at all.
2548 .
2549 .TP
2550 .B \-forcedsubsonly
2551 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
2552 \-slang.
2553 .
2554 .TP
2555 .B \-fribidi\-charset <charset name> (FriBiDi only)
2556 Specifies the character set that will be passed to FriBiDi when
2557 decoding non-UTF-8 subtitles (default: ISO8859-8).
2558 .
2559 .TP
2560 .B \-ifo <VOBsub IFO file>
2561 Indicate the file that will be used to load palette and frame size for VOBsub
2562 subtitles.
2563 .
2564 .TP
2565 .B \-noautosub
2566 Turns off automatic subtitle file loading.
2567 .
2568 .TP
2569 .B \-osd\-duration <time>
2570 Set the duration of the OSD messages in ms (default: 1000).
2571 .
2572 .TP
2573 .B \-osd\-fractions <0\-2>
2574 Set how fractions of seconds of the current timestamp are printed on the OSD:
2575 .PD 0
2576 .RSs
2577 .IPs 0
2578 Do not display fractions (default).
2579 .IPs 1
2580 Show the first two decimals.
2581 .IPs 2
2582 Show approximated frame count within current second.
2583 This frame count is not accurate but only an approximation.
2584 For variable fps, the approximation is known to be far off the correct frame
2585 count.
2586 .RE
2587 .PD 1
2588 .
2589 .TP
2590 .B \-osdlevel <0\-3> (MPlayer only)
2591 Specifies which mode the OSD should start in.
2592 .PD 0
2593 .RSs
2594 .IPs 0
2595 subtitles only
2596 .IPs 1
2597 volume + seek (default)
2598 .IPs 2
2599 volume + seek + timer + percentage
2600 .IPs 3
2601 volume + seek + timer + percentage + total time
2602 .RE
2603 .PD 1
2604 .
2605 .TP
2606 .B \-overlapsub
2607 Allows the next subtitle to be displayed while the current one is
2608 still visible (default is to enable the support only for specific
2609 formats).
2610 .
2611 .TP
2612 .B \-sid <ID> (also see \-slang, \-vobsubid)
2613 Display the subtitle stream specified by <ID> (0\-31).
2614 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2615 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2616 .
2617 .TP
2618 .B \-nosub
2619 Disables any otherwise auto-selected internal subtitles (as e.g.\& the Matroska/mkv
2620 demuxer supports).
2621 Use \-noautosub to disable the loading of external subtitle files.
2622 .
2623 .TP
2624 .B \-slang <language code[,language code,...]> (also see \-sid)
2625 Specify a priority list of subtitle languages to use.
2626 Different container formats employ different language codes.
2627 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2628 three letter language codes while OGM uses a free-form identifier.
2629 MPlayer prints the available languages when run in verbose (\-v) mode.
2630 .sp 1
2631 .I EXAMPLE:
2632 .PD 0
2633 .RSs
2634 .IPs "mplayer dvd://1 \-slang hu,en"
2635 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2636 Hungarian is not available.
2637 .IPs "mplayer \-slang jpn example.mkv"
2638 Plays a Matroska file with Japanese subtitles.
2639 .RE
2640 .PD 1
2641 .
2642 .TP
2643 .B \-spuaa <mode>
2644 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2645 A value of 16 may be added to <mode> in order to force scaling even
2646 when original and scaled frame size already match.
2647 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2648 Available modes are:
2649 .PD 0
2650 .RSs
2651 .IPs 0
2652 none (fastest, very ugly)
2653 .IPs 1
2654 approximate (broken?)
2655 .IPs 2
2656 full (slow)
2657 .IPs 3
2658 bilinear (default, fast and not too bad)
2659 .IPs 4
2660 uses swscaler gaussian blur (looks very good)
2661 .RE
2662 .PD 1
2663 .
2664 .TP
2665 .B \-spualign <\-1\-2>
2666 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2667 .PD 0
2668 .RSs
2669 .IPs "\-1"
2670 original position
2671 .IPs " 0"
2672 Align at top (original behavior, default).
2673 .IPs " 1"
2674 Align at center.
2675 .IPs " 2"
2676 Align at bottom.
2677 .RE
2678 .PD 1
2679 .
2680 .TP
2681 .B \-spugauss <0.0\-3.0>
2682 Variance parameter of gaussian used by \-spuaa 4.
2683 Higher means more blur (default: 1.0).
2684 .
2685 .TP
2686 .B \-sub <subtitlefile1,subtitlefile2,...>
2687 Use/\:display these subtitle files.
2688 Only one file can be displayed at the same time.
2689 .
2690 .TP
2691 .B \-sub\-bg\-alpha <0\-255>
2692 Specify the alpha channel value for subtitles and OSD backgrounds.
2693 Big values mean more transparency.
2694 0 means completely transparent.
2695 .
2696 .TP
2697 .B \-sub\-bg\-color <0\-255>
2698 Specify the color value for subtitles and OSD backgrounds.
2699 Currently subtitles are grayscale so this value is equivalent to the
2700 intensity of the color.
2701 255 means white and 0 black.
2702 .
2703 .TP
2704 .B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
2705 Force subtitle demuxer type for \-subfile.
2706 Use a '+' before the name to force it, this will skip some checks!
2707 Give the demuxer name as printed by \-sub\-demuxer help.
2708 For backward compatibility it also accepts the demuxer ID as defined in
2709 subreader.h.
2710 .
2711 .TP
2712 .B \-sub\-fuzziness <mode>
2713 Adjust matching fuzziness when searching for subtitles:
2714 .PD 0
2715 .RSs
2716 .IPs 0
2717 exact match (default)
2718 .IPs 1
2719 Load all subs containing movie name.
2720 .IPs 2
2721 Load all subs in the current and \-sub\-paths directories.
2722 .RE
2723 .PD 1
2724 .
2725 .TP
2726 .B \-sub\-no\-text\-pp
2727 Disables any kind of text post processing done after loading the subtitles.
2728 Used for debug purposes.
2729 .
2730 .TP
2731 .B \-subalign <0\-2>
2732 Specify which edge of the subtitles should be aligned at the height
2733 given by \-subpos.
2734 .PD 0
2735 .RSs
2736 .IPs 0
2737 Align subtitle top edge (original behavior).
2738 .IPs 1
2739 Align subtitle center.
2740 .IPs 2
2741 Align subtitle bottom edge (default).
2742 .RE
2743 .PD 1
2744 .
2745 .TP
2746 .B "\-subcc <1\-4>\ "
2747 Display DVD Closed Caption (CC) subtitles from the specified channel.
2748 These are
2749 .B not
2750 the VOB subtitles, these are special ASCII subtitles for the
2751 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2752 CC subtitles have not been spotted on DVDs from other regions so far.
2753 .
2754 .TP
2755 .B \-subcp <codepage> (iconv only)
2756 If your system supports iconv(3), you can use this option to
2757 specify the subtitle codepage.
2758 .sp 1
2759 .I EXAMPLE:
2760 .PD 0
2761 .RSs
2762 \-subcp latin2
2763 .br
2764 \-subcp cp1250
2765 .RE
2766 .PD 1
2767 .
2768 .TP
2769 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2770 You can specify your language using a two letter language code to
2771 make ENCA detect the codepage automatically.
2772 If unsure, enter anything and watch mplayer \-v output for available
2773 languages.
2774 Fallback codepage specifies the codepage to use, when autodetection fails.
2775 .sp 1
2776 .I EXAMPLE:
2777 .PD 0
2778 .RSs
2779 .IPs "\-subcp enca:cs:latin2"
2780 Guess the encoding, assuming the subtitles are Czech, fall back on
2781 latin 2, if the detection fails.
2782 .IPs "\-subcp enca:pl:cp1250"
2783 Guess the encoding for Polish, fall back on cp1250.
2784 .RE
2785 .PD 1
2786 .
2787 .TP
2788 .B \-sub\-paths <path1,path2,...>
2789 Specify extra subtitle paths to track in the media directory.
2790 .sp 1
2791 .I EXAMPLE:
2792 Assuming that /path/\:to/\:movie/\:movie.avi is played and \-sub\-paths
2793 sub,subtitles,/tmp/subs is specified, MPlayer searches for subtitle files in
2794 these directories:
2795 .RSs
2796 /path/\:to/\:movie/
2797 .br
2798 /path/\:to/\:movie/\:sub/
2799 .br
2800 /path/\:to/\:movie/\:subtitles/
2801 .br
2802 /tmp/\:subs/
2803 .br
2804 ~/.mplayer/\:sub/
2805 .RE
2806 .PD 1
2807 .
2808 .TP
2809 .B \-subdelay <sec>
2810 Delays subtitles by <sec> seconds.
2811 Can be negative.
2812 .
2813 .TP
2814 .B \-subfile <filename> (BETA CODE)
2815 Currently useless.
2816 Same as \-audiofile, but for subtitle streams (OggDS?).
2817 .
2818 .TP
2819 .B \-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
2820 Sets the subtitle font (see \-font).
2821 If no \-subfont is given, \-font is used.
2822 .
2823 .TP
2824 .B \-subfont\-autoscale <0\-3> (FreeType only)
2825 Sets the autoscale mode.
2826 .br
2827 .I NOTE:
2828 0 means that text scale and OSD scale are font heights in points.
2829 .sp 1
2830 The mode can be:
2831 .sp 1
2832 .PD 0
2833 .RSs
2834 .IPs 0
2835 no autoscale
2836 .IPs 1
2837 proportional to movie height
2838 .IPs 2
2839 proportional to movie width
2840 .IPs 3
2841 proportional to movie diagonal (default)
2842 .RE
2843 .PD 1
2844 .
2845 .TP
2846 .B \-subfont\-blur <0\-8> (FreeType only)
2847 Sets the font blur radius (default: 2).
2848 .
2849 .TP
2850 .B \-subfont\-encoding <value> (FreeType only)
2851 Sets the font encoding.
2852 When set to 'unicode', all the glyphs from the font file will be rendered and
2853 unicode will be used (default: unicode).
2854 .
2855 .TP
2856 .B \-subfont\-osd\-scale <0\-100> (FreeType only)
2857 Sets the autoscale coefficient of the OSD elements (default: 6).
2858 .
2859 .TP
2860 .B \-subfont\-outline <0\-8> (FreeType only)
2861 Sets the font outline thickness (default: 2).
2862 .
2863 .TP
2864 .B \-subfont\-text\-scale <0\-100> (FreeType only)
2865 Sets the subtitle text autoscale coefficient as percentage of the
2866 screen size (default: 5).
2867 .
2868 .TP
2869 .B \-subfps <rate>
2870 Specify the framerate of the subtitle file (default: movie fps).
2871 .br
2872 .I NOTE:
2873 <rate> > movie fps speeds the subtitles up for frame-based subtitle files and
2874 slows them down for time-based ones.
2875 .
2876 .TP
2877 .B \-subpos <0\-100> (useful with \-vf expand)
2878 Specify the position of subtitles on the screen.
2879 The value is the vertical position of the subtitle in % of the screen height.
2880 .
2881 .TP
2882 .B \-subwidth <10\-100>
2883 Specify the maximum width of subtitles on the screen.
2884 Useful for TV-out.
2885 The value is the width of the subtitle in % of the screen width.
2886 .
2887 .TP
2888 .B \-noterm\-osd
2889 Disable the display of OSD messages on the console when no video output is
2890 available.
2891 .
2892 .TP
2893 .B \-term\-osd\-esc <escape sequence>
2894 Specify the escape sequence to use before writing an OSD message on the
2895 console.
2896 The escape sequence should move the pointer to the beginning of the line
2897 used for the OSD and clear it (default: ^[[A\\r^[[K).
2898 .
2899 .TP