1MPlayer(1) MPlayer(1) 2 3 4 5NAME 6 mplayer - Movie Player for Linux 7 mencoder - Movie Encoder for Linux 8 9 10SYNOPSIS 11 mplayer [options] [ file | URL | playlist | - ] 12 mplayer [global options] file1 [specific options] [file2] 13 [specific options] 14 mplayer [global options] {group of files and options} 15 [group specific options] 16 mplayer [dvd|vcd|cdda|cddb|tv]://title [options] 17 mplayer [mms[t]|http|http_proxy|rt[s]p]:// 18 [user:passwd@]URL[:port] [options] 19 mencoder [options] [ file | URL | - ] [-o file] 20 gmplayer [options] [-skin skin] 21 22 23DESCRIPTION 24 mplayer is a movie player for LINUX (runs on many other 25 Unices and non-x86 CPUs, see the documentation). It plays 26 most MPEG/VOB, AVI, ASF/WMA/WMV, RM, QT/MOV/MP4, OGG/OGM, 27 VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, sup- 28 ported by many native, XAnim, and Win32 DLL codecs. You 29 can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even 30 WMV movies, too (without using the avifile library). 31 32 Another great feature of MPlayer is the wide range of sup- 33 ported output drivers. It works with X11, XV, DGA, 34 OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can also 35 use GGI, SDL (and this way all their drivers), VESA (on 36 every VESA compatible card, even without X11), some low 37 level card-specific drivers (for Matrox, 3Dfx and ATI) and 38 some hardware MPEG decoder boards, such as the Siemens 39 DVB, DXR2 and DXR3/Hollywood+. Most of them support soft- 40 ware or hardware scaling, so you can enjoy movies in 41 fullscreen. 42 43 MPlayer has an onscreen display (OSD) for status informa- 44 tion, nice big antialiased shaded subtitles and visual 45 feedback for keyboard controls. European/ISO 8859-1,2 46 (Hungarian, English, Czech, etc), Cyrillic and Korean 47 fonts are supported along with 10 subtitle formats (Mi- 48 croDVD, SubRip, SubViewer, Sami, VPlayer, RT, SSA, AQTi- 49 tle, JACOsub and our own: MPsub) and DVD subtitles (SPU 50 streams, VobSub and Closed Captions). 51 52 mencoder (MPlayer's Movie Encoder) is a simple movie en- 53 coder, designed to encode MPlayer-playable movies (see 54 above) to other MPlayer-playable formats (see below). It 55 encodes to DivX4, XviD, one of the libavcodec codecs and 56 PCM/MP3/VBRMP3 audio in 1, 2 or 3 passes. Furthermore it 57 has stream copying abilities, a powerful plugin system 58 (crop, expand, flip, postprocess, rotate, scale, noise, 59 rgb/yuv conversion) and more. 60 61 gmplayer is MPlayer with a graphical user interface. It 62 has the same options as MPlayer. 63 64 65 66GENERAL NOTES 67 Also see the HTML documentation! 68 69 Every 'flag' option has a 'noflag' counterpart, e.g. the 70 opposite of the -fs option is -nofs. 71 72 You can put all of the options in a configuration file 73 which will be read every time mplayer is run. The system- 74 wide configuration file 'mplayer.conf' is in your configu- 75 ration directory (e.g. /etc/mplayer or /usr/local/etc/ 76 mplayer), the user specific one is '~/.mplayer/config'. 77 User specific options override system-wide options and op- 78 tions given on the command line override either. The syn- 79 tax of the configuration files is 'option=<value>', every- 80 thing after a '#' is considered a comment. Options that 81 work without values can be enabled by setting them to 82 'yes' or '1' and disabled by setting them to 'no' or '0'. 83 Even suboptions can be specified in this way. 84 85 EXAMPLE: 86 # Use Matrox driver by default. 87 vo=xmga 88 # I love practicing handstands while watching videos. 89 flip=yes 90 # Decode/encode multiple files from png, start it with -mf 91 on 92 mf= type=png:fps=25 93 94 95 96PLAYER OPTIONS (MPLAYER ONLY) 97 -autoq <quality> (use with -vop pp) 98 Dynamically changes the level of postprocessing de- 99 pending on available spare CPU time. The number 100 you specify will be the maximum level used. Usual- 101 ly you can use some big number. You have to use 102 -vop pp without parameters in order to use this. 103 104 -autosync <factor> 105 Gradually adjusts the A/V sync based on audio delay 106 measurements. Specifying -autosync 0, the default, 107 will cause frame timing to be based entirely on au- 108 dio delay measurements. Specifying -autosync 1 109 will do the same, but will subtly change the A/V 110 correction algorithm used. An uneven video frame 111 rate in a movie which plays fine with -nosound can 112 often be helped by setting this to an integer value 113 greater than 1. The higher the value, the closer 114 the timing will be to -nosound. Try -autosync 30 115 to smooth out problems with sound drivers which do 116 not implement a perfect audio delay measurement. 117 With this value, if large A/V sync offsets occur, 118 they will only take about 1 or 2 seconds to settle 119 out. This delay in reaction time to sudden A/V 120 offsets should be the only side-effect of turning 121 this option on, for all sound drivers. 122 123 -benchmark 124 Prints some statistics on CPU usage and dropped 125 frames at the end. Use in combination with 126 -nosound and -vo null for benchmarking only the 127 video codec. 128 129 -framedrop (also see -hardframedrop) 130 Skips displaying some frames to maintain A/V sync 131 on slow systems. Decoding of B frames is also 132 skipped and video filters are not used. 133 134 -h, -help, --help 135 Show short summary of options. 136 137 -hardframedrop 138 More intense frame dropping (breaks decoding). 139 Leads to image distortion! 140 141 -identify 142 Show file parameters in easy parsable format. The 143 wrapper script TOOLS/midentify suppresses the other 144 mplayer output and (hopefully) shellescapes the 145 filenames. 146 147 -input <commands> 148 This option can be used to configure certain parts 149 of the input system. Paths are relative to ~/ 150 .mplayer/. 151 152 NOTE: 153 Autorepeat is currently only supported by joy- 154 sticks. 155 Available commands are: 156 157 conf=<file> Read alternative input.conf. 158 If given without pathname, 159 ~/.mplayer is assumed. 160 ar-delay Delay in msec before we 161 start to autorepeat a key (0 162 to disable). 163 ar-rate How many key presses per 164 second when we autorepeat. 165 keylist Prints all keys that can be 166 bound. 167 cmdlist Prints all commands that can 168 be bound. 169 js-dev Specifies the joystick de- 170 vice to use (default is 171 /dev/input/js0). 172 file Read commands from the given 173 file. Mostly useful with a 174 fifo. 175 176 -lircconf <configuration file> 177 Specifies a configuration file for LIRC (Linux In- 178 frared Remote Control, see http://www.lirc.org) if 179 you don't like the default ~/.lircrc. 180 181 -loop <number> 182 Loops movie playback <number> times. 0 means for- 183 ever. 184 185 -nojoystick 186 Turns off joystick support. Default is on, if com- 187 piled in. 188 189 -nolirc 190 Turns off LIRC support. 191 192 -nortc 193 Turns off usage of the Linux RTC (real-time clock - 194 /dev/rtc) as timing mechanism. 195 196 -playlist <file> 197 Play files according to a playlist (1 file per row 198 or Winamp or ASX format). 199 200 -quiet 201 Display less output and status messages. 202 203 -really-quiet 204 Display even less output and status messages. 205 206 -rnd 207 Play files in random order. 208 209 -sdp Specifies that the input file is a SDP ('Session 210 Description Protocol') file that describes an RTP 211 session (see http://www.live.com/mplayer/). 212 213 -skin <skin directory> (BETA CODE) 214 Load skin from the given directory (WITHOUT path 215 name). 216 217 EXAMPLE: 218 -skin fittyfene tries Skin/fittyfene. It 219 first checks /usr/lo- 220 cal/share/mplayer/ and af- 221 terwards ~/.mplayer/. 222 223 -slave 224 This option switches on slave mode. This is in- 225 tended for use of MPlayer as a backend to other 226 programs. Instead of intercepting keyboard events, 227 MPlayer will read simplistic command lines from its 228 stdin. The section SLAVE MODE PROTOCOL explains 229 the syntax. 230 231 -softsleep 232 Uses high quality software timers. As precise as 233 the RTC without requiring special privileges. 234 Comes at the price of higher CPU consumption. 235 236 -speed <0.01-100> 237 Set playback speed rate. 238 239 -sstep <sec> 240 Specifies seconds between displayed frames. Useful 241 for slideshows. 242 243 -use-stdin 244 245 246 247DEMUXER/STREAM OPTIONS 248 -aid <id> (also see -alang option) 249 Select audio channel [MPEG: 0-31 AVI/OGM: 1-99 ASF/ 250 RM: 0-127 VOB(AC3): 128-159 VOB(LPCM): 160-191] 251 MPlayer prints the available IDs when running in 252 verbose (-v) mode. 253 254 -alang <two letter country code> (also see -aid option) 255 Works only for DVD playback. It selects the DVD 256 audio language and always tries to play audio 257 streams whose language matches the given code. For 258 the list of available languages, use with the -v 259 switch and look at the output. 260 261 EXAMPLE: 262 -alang hu,en Plays Hungarian and falls 263 back to English if Hungarian 264 is not available. 265 266 -audio-demuxer <number> (-audiofile only) 267 Force audio demuxer type for -audiofile. Give the 268 demuxer ID as defined in demuxers.h. Use -au- 269 dio-demuxer 17 to force .mp3 detection. 270 271 -audiofile <filename> 272 Play audio from an external file (WAV, MP3 or Ogg 273 Vorbis). 274 275 -cdrom-device <path to device> 276 Override default CDROM drive name /dev/cdrom. 277 278 -cache <kbytes> 279 This option specifies how much memory (in kbytes) 280 to use when precaching a file/URL. Especially use- 281 ful on slow media (default is -nocache). 282 283 -cdda <option1:option2> 284 This option can be used to tune the CD Audio read- 285 ing feature of MPlayer. 286 Available options are: 287 288 speed=<value> set CD spin speed 289 290 paranoia=<0-2> set paranoia level 291 0: disable checking 292 1: overlap checking only 293 (default) 294 2: full data correction 295 and verification 296 297 generic-dev=<value> use specified generic SCSI 298 device 299 300 sector-size=<value> atomic read size 301 302 overlap=<value> force minimum overlap search 303 during verification to <val- 304 ue> sectors. 305 306 toc-bias Assume that the beginning 307 offset of track 1 as report- 308 ed in the TOC will be ad- 309 dressed as LBA 0. Some 310 Toshiba drives need this for 311 getting track boundaries 312 correct. 313 314 toc-offset=<value> Add <value> sectors to the 315 values reported when ad- 316 dressing tracks. May be 317 negative. 318 319 (no)skip (never) accept imperfect da- 320 ta reconstruction. 321 322 -channels <number> 323 Change the number of playback channels, defaults to 324 '2' if not specified. If the number of output 325 channels is bigger than the number of input chan- 326 nels empty channels are inserted (unless mixing 327 from mono to stereo, then the mono channel is re- 328 peated in both output channels). If the number of 329 output channels is smaller than the number of input 330 channels, results depend on the audio decoder 331 (-afm). Mplayer asks the decoder to decode the au- 332 dio into as many channels as specified. Now it's up 333 to the decoder to fulfill the requirement. If the 334 decoder outputs more channels than requested, the 335 exceeding channels are truncated. This is usually 336 only important when playing videos with AC3 audio 337 (like DVDs). In that case liba52 does the decoding 338 by default and correctly downmixes the audio into 339 the requested number of channels. 340 341 NOTE: 342 This option is honored by codecs (AC3 only) filters 343 (surround) and ao drivers (OSS at least). 344 Available options are: 345 346 2 Stereo 347 4 Surround 348 6 Full 5.1 349 350 -chapter <chapter id>[-<end chapter id>] 351 Specify which chapter to start playing at. Option- 352 ally specify which chapter to end playing at (de- 353 fault: 1). Examples can be found below. 354 355 -csslib <filename> 356 (old-style DVD option) This option is used to over- 357 ride the default location of libcss.so. 358 359 -demuxer <number> 360 Force demuxer type. Give the demuxer ID as defined 361 in demuxers.h. Use -demuxer 17 to force .mp3 de- 362 tection. 363 364 -dumpaudio (MPLAYER only) 365 Dumps raw compressed audio stream to ./stream.dump 366 (useful with mpeg/ac3). 367 368 -dumpfile <filename> (MPLAYER only) 369 Specify which file MPlayer should dump to. Should 370 be used together with -dumpaudio / -dumpvideo / 371 -dumpstream. 372 373 -dumpstream (MPLAYER only) 374 Dumps the raw stream to ./stream.dump. Useful when 375 ripping from DVD or network. 376 377 -dumpvideo (MPLAYER only) 378 Dump raw compressed video stream to ./stream.dump 379 (not very usable). 380 381 -dvd <title id> 382 Tell MPlayer which movies (specified by title id) 383 to play. For example sometimes '1' is a trailer, 384 and '2' is the real movie. 385 386 NOTE: 387 Sometimes deinterlacing is required for DVD play- 388 back, see the -vop pp=0x20000 option. 389 390 -dvd-device <path to device> 391 Override default DVD device name /dev/dvd. 392 393 -dvdangle <angle id> 394 Some DVD discs contain scenes that can be viewed 395 from multiple angles. Here you can tell MPlayer 396 which angles to use (default: 1). Examples can be 397 found below. 398 399 -dvdauth <DVD device> 400 (old-style DVD option) Turns on DVD authentication 401 using the given device. 402 403 -dvdkey <CSS key> 404 (old-style DVD option) When decoding a VOB file 405 copied undecrypted from DVD, this option gives the 406 CSS key needed to decrypt the VOB (the key is 407 printed when authenticating with the DVD drive us- 408 ing -dvdauth). 409 410 -dvdnav (BETA CODE) 411 Force usage of libdvdnav. 412 413 -forceidx 414 Force rebuilding of INDEX. Useful for files with 415 broken index (desyncs, etc). Seeking will be pos- 416 sible. You can fix the index permanently with MEn- 417 coder (see the documentation). 418 419 -fps <value> 420 Override video framerate (if value is wrong/missing 421 in the header) (float number). 422 423 -frames <number> 424 Play/convert only first <number> frames, then quit. 425 426 -hr-mp3-seek (.MP3 only) 427 Hi-res mp3 seeking. Default is: enabled when play- 428 ing from external MP3 file, as we need to seek to 429 the very exact position to keep A/V sync.It can be 430 slow especially when seeking backwards - it has to 431 rewind to the beginning to find the exact frame. 432 433 -idx (also see -forceidx) 434 Rebuilds INDEX of the AVI if no INDEX was found, 435 thus allowing seeking. Useful with broken/incom- 436 plete downloads, or badly created AVIs. 437 438 -mc <seconds/frame> 439 Maximum A-V sync correction per frame (in seconds). 440 441 -mf <option1:option2:...> 442 Used when decoding from multiple PNG or JPEG files. 443 Available options are: 444 445 on turns on multifile support 446 w=<value> width of the output (autode- 447 tect) 448 h=<value> height of the output (au- 449 todetect) 450 fps=<value> fps of the output (default: 451 25) 452 type=<value> type of input files (avail- 453 able types: jpeg, png, tga) 454 455 -ni (.AVI only) 456 Force usage of non-interleaved AVI parser (fixes 457 playing of some bad AVI files). 458 459 -nobps (.AVI only) 460 Do not use average byte/sec value for A-V sync 461 (AVI). Helps with some AVI files with broken head- 462 er. 463 464 -passwd <password> (see -user option too) 465 Specify password for http authentication. 466 467 -rawaudio <option1:option2:...> 468 This option lets you play raw audio files. It may 469 also be used to play audio CDs which are not 44KHz 470 16Bit stereo. 471 Available options are: 472 473 on use raw audio demuxer 474 channels=<value> number of channels 475 rate=<value> rate in samples per second 476 samplesize=<value> sample size in byte 477 format=<value> fourcc in hex 478 479 -rtsp-stream-over-tcp 480 Used with 'rtsp://' URLs to specify that the re- 481 sulting incoming RTP and RTCP packets be streamed 482 over TCP (using the same TCP connection as RTSP). 483 This option may be useful if you have a broken In- 484 ternet connection that does not pass incoming UDP 485 packets (see http://www.live.com/mplayer/). 486 487 -skipopening 488 Skip DVD opening (dvdnav only). 489 490 -sb <byte position> (see -ss option too) 491 Seek to byte position. Useful for playback from 492 CDROM images / .VOB files with junk at the begin- 493 ning. 494 495 -srate <Hz> 496 Forces the given audio playback rate, changing 497 video speed to keep a-v sync. MEncoder passes this 498 value to lame for resampling. 499 500 -ss <time> (see -sb option too) 501 Seek to given time position. 502 503 EXAMPLE: 504 -ss 56 seeks to 56 seconds 505 -ss 01:10:00 seeks to 1 hour 10 min 506 507 -tv <option1:option2:...> 508 This option enables the TV grabbing feature of 509 MPlayer. 510 511 NOTE: 512 MPlayer doesn't accept colons so type dots instead 513 in the device ID (e.g. hw.0,0 instead of hw:0,0). 514 Be advised that although you can select any sam- 515 plerate when using ALSA, the LAME audio codec is 516 able to encode only the 'standard' samplerates. 517 You'll get an .avi file with no sound when you 518 choose an odd samplerate and use this codec. 519 Available options are: 520 521 on use TV input 522 523 noaudio no sound 524 525 driver=<value> available: dummy, v4l, bs- 526 dbt848 527 528 device=<value> Specify other device than 529 the default /dev/video0. 530 531 input=<value> Specify other input than the 532 default 0 (Television) (see 533 output for a list) 534 535 freq=<value> Specify the frequency to set 536 the tuner to (e.g. 511.250). 537 538 outfmt=<value> output format of the tuner 539 (yv12, rgb32, rgb24, rgb16, 540 rgb15, uyvy, yuy2, i420) 541 542 width=<value> width of the output window 543 544 height=<value> height of the output window 545 546 buffersize=<value> capture buffer size in 547 megabytes (default is half 548 of the physical memory) 549 550 norm=<value> available: PAL, SECAM, NTSC 551 552 channel=<value> Set tuner to <value> chan- 553 nel. 554 555 chanlist=<value> available: europe-east, eu- 556 rope-west, us-bcast, us-ca- 557 ble, etc 558 559 audiorate=<value> set audio capture bitrate 560 561 forceaudio capture audio even if there 562 are no audio sources report- 563 ed by v4l 564 565 alsa capture from ALSA 566 567 amode=<0-3> choose an audio mode: 568 0: mono 569 1: stereo 570 2: language 1 571 3: language 2 572 573 forcechan=<1-2> By default, the count of 574 recorded audio channels is 575 determined automatically by 576 querying the audio mode from 577 the tv card. This option 578 allows to force stereo/mono 579 recording regardless of the 580 amode option and the values 581 returned by v4l. This can 582 be used for troubleshooting 583 when the tv card is unable 584 to report the current audio 585 mode. 586 587 adevice=<value> set an audio device 588 /dev/... for OSS 589 hardware ID for ALSA 590 591 audioid=<value> choose an audio output of 592 the capture card, if it has 593 more of them 594 595 [volume|bass|treble|balance]=<0-65535> 596 These options set parameters 597 of the mixer on the video 598 capture card. They will 599 have no effect, if your card 600 doesn't have one. 601 602 -user <user name> (see -passwd option too) 603 Specify user name for http authentication. 604 605 -vcd <track> 606 Play video CD track from device instead of plain 607 file. 608 609 -vid <id> 610 Select video channel [MPG: 0-15 ASF: 0-255]. 611 612 -vivo <sub-options> (DEBUG CODE) 613 Force audio parameters for the .vivo demuxer (for 614 debugging purposes). 615 616 617 618OSD/SUB OPTIONS 619 NOTE: 620 See -vop expand too. 621 622 -dumpmicrodvdsub (MPLAYER only) 623 Convert the given subtitle (specified with the -sub 624 switch) to the MicroDVD subtitle format. Creates a 625 dumpsub.sub file in the current directory. 626 627 -dumpmpsub (MPLAYER only) 628 Convert the given subtitle (specified with the -sub 629 switch) to MPlayer's subtitle format, MPsub. Cre- 630 ates a dump.mpsub file in the current directory. 631 632 -dumpsrtsub (MPLAYER only) 633 Convert the given subtitle (specified with the -sub 634 switch) to the time-based SubViewer (SRT) subtitle 635 format. Creates a dumpsub.srt file in the current 636 directory. 637 638 -dumpjacosub (MPLAYER only) 639 Convert the given subtitle (specified with the -sub 640 switch) to the time-based JACOsub subtitle format. 641 Creates a dumpsub.js file in the current directory. 642 643 -dumpsami (MPLAYER only) 644 Convert the given subtitle (specified with the -sub 645 switch) to the time-based SAMI subtitle format. 646 Creates a dumpsub.smi file in the current directo- 647 ry. 648 649 -dumpsub (MPLAYER only) (BETA CODE) 650 Dumps the subtitle substream from VOB streams. See 651 -dump*sub and -vobsubout* options too. 652 653 -ifo <vobsub ifo file> 654 Indicate the file that will be used to load palette 655 and frame size for VOBSUB subtitles. 656 657 -ffactor <number> 658 Resample alphamap of the font. Can be: 659 660 0 plain white fonts 661 0.75 very narrow black outline 662 [default] 663 1 narrow black outline 664 10 bold black outline 665 666 -font <path to font.desc file> 667 Search for the OSD/SUB fonts in an alternative di- 668 rectory (default for normal fonts: ~/.mplayer/font/ 669 font.desc, default for FreeType fonts: ~/.mplayer/ 670 subfont.ttf). 671 672 NOTE: 673 With FreeType, this option determines path to the 674 text font file. 675 The -subfont-* options are available only with 676 FreeType support compiled in. If FreeType support 677 is enabled, the old font support can't be used. 678 679 EXAMPLE: 680 -font ~/.mplayer/arial-14/font.desc 681 -font ~/.mplayer/arialuni.ttf 682 683 -noautosub 684 Turns off automatic loading of subtitle files. 685 686 -nooverlapsub 687 Turns off support for overlapping subtitles. 688 689 -osdlevel <0-2> (MPLAYER only) 690 Specifies which mode the OSD should start in (0: 691 none, 1: seek, 2: seek+timer, default is 1). 692 693 -sid <id> (also see -slang option) 694 Turns on DVD subtitle displaying. Also, you MUST 695 specify a number which corresponds to a DVD subti- 696 tle language (0-31). For the list of available 697 subtitles, use with the -v switch and look at the 698 output. 699 700 -slang <two letter country code> (also see -sid option) 701 Works only for DVD playback. Turns on/selects DVD 702 subtitle language. For the list of available sub- 703 titles, use with the -v switch and look at the out- 704 put. 705 706 EXAMPLE: 707 -slang hu,en Selects Hungarian and falls 708 back to English if Hungarian 709 is not available. 710 711 -sub <subtitle file> 712 Use/display this subtitle file. 713 714 -subcc 715 Display DVD Closed Caption (CC) subtitles. These 716 are NOT the VOB subtitles, these are special ASCII 717 subtitles for the hearing impaired encoded in the 718 VOB userdata stream on most region 1 DVDs. CC sub- 719 titles have not been spotted on DVDs from other re- 720 gions so far. 721 722 -subcp <codepage> 723 If your system supports iconv(3), you can use this 724 option to specify codepage of the subtitle. 725 726 EXAMPLE: 727 -subcp latin2 728 -subcp cp1250 729 730 -sub-demuxer <number> (BETA CODE) 731 Force subtitle demuxer type for -subfile. 732 733 -subdelay <sec> 734 Delays subtitles by <sec> seconds. Can be nega- 735 tive. 736 737 -subfont-autoscale <0-3> 738 Sets the autoscale mode. 739 740 NOTE: 741 Zero means that text-scale and osd-scale are font 742 heights in points. 743 The mode can be: 744 745 0 no autoscale 746 1 proportional to movie height 747 2 proportional to movie width 748 3 proportional to movie diago- 749 nal (default) 750 751 -subfont-blur <0-8> 752 Sets the font blur radius (default: 2). 753 754 -subfont-encoding <value> 755 Sets the font encoding. When set to 'unicode', all 756 the glyphs from the font file will be rendered and 757 unicode will be used (default: unicode). 758 759 -subfont-osd-scale <0-100> 760 Sets the osd elements autoscale coefficient (de- 761 fault: 6). 762 763 -subfont-outline <0-8> 764 Sets the font outline thickness (default: 2). 765 766 -subfont-text-scale <0-100> 767 Sets the subtitle text autoscale coefficient (per- 768 centage of the screen size) (default: 5). 769 770 -subfps <rate> 771 Specify frame/sec rate of subtitle file (float num- 772 ber), default: the same fps as the movie. 773 774 NOTE: 775 ONLY for frame-based SUB files, i.e. NOT MicroDVD 776 format. 777 778 -subfile <filename> (BETA CODE) 779 Currently useless. Same as -audiofile, but for 780 subtitle streams (OggDS?). 781 782 -subpos <0-100> (useful with -vop expand) 783 Specify the position of subtitles on the screen. 784 The value is the vertical position of the subtitle 785 in % of the screen height. 786 787 -unicode 788 Tells MPlayer to handle the subtitle file as UNI- 789 CODE. 790 791 -utf8 792 Tells MPlayer to handle the subtitle file as UTF8. 793 794 -vobsub <vobsub file without extension> 795 Specify the VobSub files that are to be used for 796 subtitle. This is the full pathname without exten- 797 sions, i.e. without the '.idx', '.ifo' or '.sub'. 798 799 -vobsubid <0-31> 800 Specify the VobSub subtitle id. 801 802 803 804AUDIO OUTPUT OPTIONS (MPLAYER ONLY) 805 -abs <value> (OBSOLETE) 806 Override audio driver/card buffer size detection, 807 -ao oss only 808 809 -af <plugin1,plugin2,plugin3[=options],...> 810 Activate a comma separated list of audio filters 811 and their options. 812 Available filters are: 813 814 resample[=srate[:sloppy][:fast]] 815 Changes the sample rate of 816 the audio stream to an inte- 817 ger srate (Hz). It only 818 supports the 16 bit little 819 endian format. 820 821 channels[=nch] Change the number of chan- 822 nels to nch output channels. 823 If the number of output 824 channels is bigger than the 825 number of input channels 826 empty channels are inserted 827 (except mixing from mono to 828 stereo, then the mono chan- 829 nel is repeated in both of 830 the output channels). If 831 the number of output chan- 832 nels is smaller than the 833 number of input channels the 834 exceeding channels are trun- 835 cated. 836 837 format[=bps,f] Select the format f and bits 838 per sample bps used for out- 839 put from the filter layer. 840 The option bps is an integer 841 and denotes bytes per sam- 842 ple. The format f is a 843 string containing a concate- 844 nated mix of: 845 alaw, mulaw or imaadpcm 846 float or int 847 unsigned or signed 848 le or be (little or big en- 849 dian) 850 851 volume[=v:sc:pr:en] Select the output volume 852 level. This filter is not 853 reentrant and can therefore 854 only be enabled once for ev- 855 ery audio stream. 856 v: desired gain in dB for 857 all channels in the 858 stream. The gain can be 859 set from -200dB to +40dB 860 (where -200dB mutes the 861 sound completely and 862 +40dB equals a gain of 863 1000). The default gain 864 is -20dB. 865 sc: enable soft clipping. 866 pr: enable probing of the 867 volume level for each au- 868 dio stream. Both the max- 869 imum and instantaneous 870 volume is probed. The in- 871 stantaneous volume can 872 only be accessed through 873 the runtime interface, 874 but the maximum volume is 875 printed at the end of the 876 movie. This value can be 877 used when transcoding 878 movies to maximize the 879 utilization of the dynam- 880 ic range. 881 en: enable and disable 882 the volume control. 883 884 delay[=d] Delay sound output by d sec- 885 onds (floating point num- 886 ber). 887 888 -af-adv <force=(0-3):list=(filters)> (see -af option too) 889 Specify advanced audio filter options: 890 891 force=<0-3> Forces the insertion of au- 892 dio filters to one of the 893 following: 894 0: Completely automatic 895 insertion of filters (de- 896 fault) 897 1: Optimize for speed 898 2: Optimize for accuracy 899 3: Turn off auto 900 901 list=<filters> Same as -af (see -af op- 902 tion). 903 904 -ao <driver1[:device],driver2,...[,]> 905 Specify a priority list of audio output drivers 906 (optionally with device) to be used. 'device' is 907 valid with SDL, too, it means subdriver then. 908 909 NOTE: 910 To get a full list of available drivers, see -ao 911 help. 912 If the list has a trailing ',' it will fallback to 913 drivers not listed. 914 915 EXAMPLE 916 -ao oss:/dev/dsp2,oss:/dev/dsp1, 917 try to use OSS with the 918 specified sound devices and 919 fallback to others if it 920 fails 921 -ao sdl:esd specify the SDL subdriver 922 923 -aofile <filename> 924 Filename for -ao pcm. 925 926 -aop <list=plugin1,plugin2...:option1=value1:opt2=val2...> 927 Specify audio plugin(s) and their options (see doc- 928 umentation too). 929 Available options are: 930 931 list=[plugins] comma separated list of plu- 932 gins (resample, surround, 933 format, volume, extrastereo, 934 volnorm) 935 936 delay=<sec> example plugin, do not use. 937 938 format=<format> output format (format plugin 939 only) 940 941 fout=<Hz> output frequency (resample 942 plugin only) 943 944 volume=<0-255> volume (volume plugin only) 945 946 mul=<value> stereo coefficient (default: 947 2.5) (extrastereo plugin on- 948 ly) 949 950 softclip compressor / 'soft-clipping' 951 capabilities (volume plugin 952 only) 953 954 -delay <sec> 955 Audio delay in seconds (may be +/- float value). 956 957 -mixer <device> 958 This option will tell MPlayer to use a different 959 device for mixing than /dev/mixer. 960 961 -nowaveheader (-ao pcm only) 962 Don't include wave header. Used for RAW PCM. 963 964 965 966VIDEO OUTPUT OPTIONS (MPLAYER ONLY) 967 -aa* (-vo aa only) 968 You can get a list and an explanation of available 969 options executing mplayer -aahelp 970 971 -bpp <depth> 972 Use different color depth than autodetect. Not all 973 -vo drivers support it (fbdev, dga2, svga, vesa). 974 975 -brightness <-100 - 100> 976 Adjust brightness of video output (default 0). It 977 changes intensity of RGB components of video signal 978 from black to white screen. 979 980 -contrast <-100 - 100> 981 Adjust contrast of video output (default 0). Works 982 in similar manner as brightness. 983 984 -display <name> 985 Specify the hostname and display number of the X 986 server you want to display on. 987 988 EXAMPLE: 989 -display xtest.localdomain:0 990 991 -double 992 Enables doublebuffering. Fixes flicker by storing 993 two frames in memory, and displaying one while de- 994 coding another. Can affect OSD. Needs twice the 995 memory of a single buffer, so it won't work on 996 cards with very little video memory. 997 998 -dr 999 Turns on direct rendering (not supported by all 1000 codecs and video outputs) (default is off). Warn- 1001 ing: may cause OSD/SUB corruption! 1002 1003 -dxr2 <option1:option2:...> 1004 This option is used to control the dxr2 driver. 1005 Note: The lavc filter is now auto inserted if you 1006 try to play a non MPEG1/2 format so all formats 1007 supported by MPlayer should play out of the box (if 1008 you have the CPU power needed to encode on the 1009 fly). The overlay chipset used on the dxr2 is of 1010 pretty bad quality but the default settings should 1011 work for everybody. The OSD may be usable with the 1012 overlay (not on TV) by drawing it in the colorkey. 1013 With the default colorkey settings you may get 1014 variable results, usually you will see the colorkey 1015 around the characters or some other funny effect. 1016 Buf if you properly adjust the colorkey settings 1017 you should be able to get acceptable results. 1018 1019 ar-mode=<value> aspect ratio mode (0 = nor- 1020 mal, 1 = pan scan, 2 = let- 1021 terbox (default)) 1022 1023 iec958-encoded/decoded 1024 iec958 output mode 1025 1026 mute mute sound output 1027 1028 ucode=<value> path to the microcode 1029 1030 TV Out 1031 1032 75ire enable 7.5 IRE 1033 1034 bw b/w TV output 1035 1036 color color TV output 1037 1038 interlaced interlaced TV output 1039 1040 macrovision=<value> macrovision mode (0 = off 1041 (default), 1 = agc, 2 = agc 1042 2 colorstripe, 3 = agc 4 1043 colorstripe) 1044 1045 norm=<value> TV norm (ntsc (default), 1046 pal,pal60,palm,paln,palnc) 1047 1048 square/ccir601-pixel 1049 TV pixel mode 1050 1051 Overlay 1052 1053 cr-[left|right|top|bot]=<-20-20> 1054 adjust the overlay cropping 1055 1056 ck-[rgb]min=<0-255> minimum value for the color 1057 key 1058 1059 ck-[rgb]max=<0-255> maximum value for the color 1060 key 1061 1062 ck-[rgb]=<0-255> color key values 1063 1064 ignore-cache do not use the VGA cache 1065 1066 ol-osd enable the osd hack on the 1067 overlay 1068 1069 ol[hwxy]-cor=<value> 1070 adjust the overlay size and 1071 position in case it doesn't 1072 match the window perfectly 1073 1074 overlay enable the overlay 1075 1076 overlay-ratio=<1-2500> 1077 tune the overlay (default 1078 1000) 1079 1080 update-cache recreate the VGA cache 1081 1082 -fb <device> (fbdev or DirectFB only) 1083 Specifies the framebuffer device to use. By de- 1084 fault it uses /dev/fb0. 1085 1086 -fbmode <modename> (fbdev only) 1087 Change video mode to the one that is labelled as 1088 <modename> in /etc/fb.modes. 1089 1090 NOTE: 1091 VESA framebuffer doesn't support mode changing. 1092 1093 -fbmodeconfig <filename> (fbdev only) 1094 Use this configuration file instead of the default 1095 /etc/fb.modes. Only valid for the fbdev driver. 1096 1097 -forcexv (SDL only) 1098 Force using XVideo. 1099 1100 -fs 1101 Fullscreen playing (centers movie, and makes black 1102 bands around it). Toggle it with the 'f' key (not 1103 all video outputs support it). See also -zoom. 1104 1105 -fsmode-dontuse <0-31> (OBSOLETE) (use -fs option) 1106 Try this option if you still experience fullscreen 1107 problems. 1108 1109 -geometry x[%][:y[%]] 1110 Adjust where the output is on the screen initially. 1111 The x and y specifications are in pixels measured 1112 from the top-right of the screen to the top-right 1113 of the image being displayed, however if a percent- 1114 age sign is given after the argument it turns the 1115 value into a percentage of the screen size in that 1116 direction. The values given must be integers. 1117 1118 EXAMPLE: 1119 50:40 Places the window at x=50, 1120 y=40 1121 50%:50% Places the window in the 1122 middle of the screen 1123 100% Places the window at the top 1124 left corner of the screen 1125 100%:100% Places the window at the 1126 bottom left corner of the 1127 screen 1128 1129 -hue <-100 - 100> 1130 Adjust hue of video signal (default: 0). You can 1131 get colored negative of image with this option. 1132 1133 -icelayer <0-15> (icewm only) 1134 Sets the layer of the fullscreen window of mplayer 1135 for icewm. 1136 1137 0 Desktop 1138 2 Below 1139 4 Normal 1140 6 OnTop 1141 8 Dock 1142 10 AboveDock 1143 12 Menu (default) 1144 1145 -jpeg <option1:option2:...> (-vo jpeg only) 1146 Specify options for the JPEG output. 1147 Available options are: [no]progressiv, [no]base- 1148 line, optimize, smooth, quality and outdir. 1149 1150 -monitor_dotclock <dotclock (or pixelclock) range> (fbdev 1151 and vesa only) 1152 Look into etc/example.conf for further information 1153 and in DOCS/video.html. 1154 1155 -monitor_hfreq <horizontal frequency range> (fbdev and 1156 vesa only) 1157 1158 -monitor_vfreq <vertical frequency range> (fbdev and vesa 1159 only) 1160 1161 -monitoraspect <ratio> 1162 Set aspect ratio of your monitor or TV screen. See 1163 also -aspect for movie aspect. 1164 1165 EXAMPLE: 1166 -monitoraspect 4:3 or 1.3333 1167 -monitoraspect 16:9 or 1.7777 1168 1169 -nograbpointer 1170 Do not grab mouse pointer after VidMode change 1171 (-vm), useful for multihead setup. 1172 1173 -noslices 1174 Disable drawing video by 16-pixel height slices/ 1175 bands, instead draws the while frame in a single 1176 run. May be faster or slower, depending on card/ 1177 cache. It has effect only with libmpeg2 and libav- 1178 codec codecs. 1179 1180 -panscan <0.0-1.0> 1181 Enables Pan & Scan functionality, i.e. in order to 1182 display a 16:9 movie on a 4:3 display, the sides of 1183 the movie are cropped to get a 4:3 image which fits 1184 the screen. This function works only with xv, xmga 1185 and xvidix drivers. 1186 The range controls how much of the image is 1187 cropped. 1188 1189 -rootwin 1190 Play movie in the root window (desktop background) 1191 instead of opening a new one. Works only with x11, 1192 xv, xmga and xvidix drivers. 1193 1194 -saturation <-100 - 100> 1195 Adjust saturation of video output (default: 0). 1196 You can get grayscale output with this option. 1197 1198 -screenw <pixels> -screenh <pixels> 1199 If you use an output driver which can't know the 1200 resolution of the screen (fbdev/x11 and/or TVout) 1201 this is where you can specify the horizontal and 1202 vertical resolution. 1203 1204 -stop_xscreensaver 1205 Turns off xscreensaver at startup and turns it on 1206 again on exit. 1207 1208 -vm 1209 Try to change to a better video mode. dga, x11/xv 1210 (XF86VidMode) and sdl output drivers support it. 1211 1212 -vo <driver1[:device],driver2,...[,]> 1213 Specify a priority list of video output drivers 1214 (optionally with device) to be used. 'device' is 1215 valid with SDL and GGI, too, it means subdriver 1216 then. 1217 1218 NOTE: 1219 See -vo help for a full list of available drivers. 1220 If the list has a trailing ',' it will fallback to 1221 drivers not listed. 1222 1223 EXAMPLE: 1224 -vo xmga,xv, Try Matrox kernel driver, 1225 then Xv driver, then others 1226 -vo sdl:aalib specify the SDL subdriver 1227 1228 -vsync 1229 Enables VBI for vesa. 1230 1231 -wid <window id> 1232 This tells MPlayer to use a X11 window, which is 1233 useful to embed MPlayer in a browser (with the 1234 plugger extension for instance). 1235 1236 -xineramascreen <0-...> 1237 In Xinerama configurations (i.e. a single desktop 1238 that spans across multiple displays) this option 1239 tells MPlayer which screen to display movie on. 1240 1241 -z <0-9> 1242 Specifies compression level for PNG output (-vo 1243 png) 1244 1245 0 no compression 1246 9 max compression 1247 1248 -zrbw (-vo zr only) 1249 Display in black and white (for optimal perfor- 1250 mance, this option can be combined with the 'decode 1251 only in black and white' option for codecs belong- 1252 ing to the FFmpeg family). 1253 1254 -zrcrop <[width]x[height]+[x offset]+[y offset]> (-vo zr 1255 only) 1256 Select a part of the input image for display, mul- 1257 tiple occurences of this option switch on cinerama 1258 mode. In cinerama mode the movie is distributed 1259 over more than one TV (or beamer) to create a larg- 1260 er screen. Options appearing after the n-th -zr- 1261 crop apply to the n-th MJPEG card, each card should 1262 at least have a -zrdev in addition to the -zrcrop. 1263 For examples, see the output of -zrhelp and the Zr 1264 section of the documentation. 1265 1266 -zrdev <device> (-vo zr only) 1267 Specify the device special file that belongs to 1268 your MJPEG card, by default this driver takes the 1269 first v4l device it can find. 1270 1271 -zrfd (-vo zr only) 1272 Force decimation: Decimation, as specified by 1273 -zrhdec and -zrvdec, only happens if the hardware 1274 scaler can stretch the image to its original size. 1275 Use this option to force decimation. 1276 1277 -zrhelp (-vo zr only) 1278 Display a list of all -zr* options, their default 1279 values and an example of cinerama mode. 1280 1281 -zrnorm <norm> (-vo zr only) 1282 Specify norm PAL/NTSC, the default is 'no change'. 1283 1284 -zrquality <1-20> (-vo zr only) 1285 A number from 1 to 20 representing the jpeg encod- 1286 ing quality. 1 gives the best quality and 20 gives 1287 very bad quality. 1288 1289 -zrvdec <1,2,4> -zrhdec <1,2,4> (-vo zr only) 1290 Vertical/horizontal decimation: Ask the driver to 1291 send only every 2nd or 4th line/pixel of the input 1292 image to the MJPEG card and use the scaler of the 1293 MJPEG card to strech the image to its original 1294 size. 1295 1296 -zrxdoff <x display offset>, -zrydoff <y display offset> 1297 (-vo zr only) 1298 If the movie is smaller than the TV screen, these 1299 options control the position of the movie relative 1300 to the upper left corner of the screen. The movie 1301 is centered by default. 1302 1303 1304 1305DECODING/FILTERING OPTIONS 1306 -ac <[-]codec1,[-]codec2,...[,]> 1307 Specify a priority list of audio codecs to be used, 1308 according to their codec name in codecs.conf. Use 1309 a '-' before the codec name to omit it. 1310 1311 NOTE: 1312 See -ac help for a full list of available codecs. 1313 If the list has a trailing ',' it will fallback to 1314 codecs not listed. 1315 1316 EXAMPLE: 1317 -ac mp3acm force l3codeca.acm MP3 codec 1318 -ac mad, try libmad first, then fall- 1319 back to others 1320 -ac hwac3,a52, try hardware AC3 1321 passthrough, then software 1322 AC3 codec, then others 1323 -ac -ffmp3, try other codecs except FFm- 1324 peg's MP3 decoder 1325 1326 -afm <driver1,driver2,...> 1327 Specify a priority list of audio drivers to be 1328 used, according to their driver name in 1329 codecs.conf. It falls back to default if none is 1330 ok. 1331 1332 NOTE: 1333 See -afm help for a full list of available drivers. 1334 1335 EXAMPLE: 1336 -afm ffmpeg try FFmpeg's libavcodec 1337 (mp1/2/3) codecs first 1338 -afm acm,dshow try Win32 codecs first 1339 1340 -aspect <ratio> 1341 Override aspect ratio of movies. It's autodetected 1342 on MPEG files, but can't be autodetected on most 1343 AVI files. 1344 1345 EXAMPLE: 1346 -aspect 4:3 or -aspect 1.3333 1347 -aspect 16:9 or -aspect 1.7777 1348 1349 -flip 1350 Flip image upside-down. 1351 1352 -lavdopts <option1:option2:...> (DEBUG CODE) 1353 If decoding with a codec from libavcodec, you can 1354 specify its parameters here. 1355 1356 EXAMPLE: 1357 -lavdopts bug=1 1358 1359 NOTE: 1360 Just add the values of the things you want to enable. 1361 Available options are: 1362 1363 ec error concealment: 1364 1: use strong deblock 1365 filter for damaged MBs 1366 2: iterative MV search 1367 (slow) 1368 3: all (default) 1369 1370 er=<value> error resilience: 1371 0: disabled 1372 1: careful (should work 1373 with broken encoders) 1374 2: normal (default) 1375 (works with compliant en- 1376 coders) 1377 3: agressive (more checks 1378 but might cause problems 1379 even for valid bit- 1380 streams) 1381 4: very agressive 1382 1383 bug=<value> manually work around encoder 1384 bugs: 1385 0: nothing 1386 1: autodetect bugs (de- 1387 fault) 1388 2 (msmpeg4v3): some old 1389 lavc generated msmpeg4v3 1390 files (no autodetect) 1391 4 (mpeg4): xvid interlac- 1392 ing bug (autodetected if 1393 fourcc==XVIX) 1394 8 (mpeg4): UMP4 (autode- 1395 tected if fourcc==UMP4) 1396 16 (mpeg4): padding bug 1397 32 (mpeg4): illegal vlc 1398 bug (autodetected per 1399 fourcc) 1400 1401 gray grayscale only decoding (a 1402 bit faster than with color) 1403 1404 -noaspect 1405 Disable automatic movie aspect ratio compensation. 1406 1407 -nosound 1408 Do not play/encode sound. 1409 1410 -vop pp=<option1/option2/...> 1411 This option enables usage of MPlayer's internal 1412 postprocessing filter, and also gives an interface 1413 where you can pass options to the named filter. 1414 1415 Note that each sub-filter must be separated with a 1416 / sign. 1417 Each filter defaults to 'c' (chrominance). 1418 The keywords accept a '-' prefix to disable the op- 1419 tion. 1420 A ':' followed by a letter may be appended to the 1421 option to indicate its scope: 1422 a: Automatically switches the filter off if the 1423 CPU is too slow. 1424 c: Do chrominance filtering, too. 1425 y: Do not do chrominance filtering (only lumi- 1426 nance filtering). 1427 1428 EXAMPLE: 1429 -vop pp=hb/vb/dr/al/lb 1430 -vop pp=hb/vb/dr/al 1431 -vop pp=de/-al default filters without 1432 brightness/contrast correc- 1433 tion 1434 -vop pp=de/tn:1:2:3 Enable default filters & 1435 temporal denoiser. 1436 -vop pp=hb:y/vb:a -autoq 6 1437 Deblock horizontal only lu- 1438 minance and switch vertical 1439 deblocking on or off auto- 1440 matically depending on 1441 available CPU time. 1442 1443 -pp <quality> (see -vop pp option too) 1444 Set postprocess level of the DLL. This option is NO 1445 LONGER USABLE with MPlayer's postprocess filter, 1446 but only with Win32 DirectShow DLLs which have in- 1447 teral postprocessing routine. 1448 1449 The valid range of -pp value vary on codecs, mostly 1450 0-6, where 0=disable 6=slowest/best. 1451 1452 1453 -ssf <mode> 1454 Specifies SwScaler parameters. 1455 1456 EXAMPLE 1457 -vop scale -ssf lgb=3.0 1458 1459 lgb=<0-100> Gaussian blur filter (luma) 1460 cgb=<0-100> Gaussian blur filter (chro- 1461 ma) 1462 ls=<0-100> sharpen filter (luma) 1463 cs=<0-100> sharpen filter (chroma) 1464 chs=<h> chroma horizontal shifting 1465 cvs=<v> chroma vertical shifting 1466 1467 -stereo <mode> 1468 Select type of MP2/MP3 stereo output. 1469 1470 0 Stereo 1471 1 Left channel 1472 2 Right channel 1473 1474 -sws <software scaler type> (see -vop scale option too) 1475 This option sets the quality (and speed, respec- 1476 tively) of the software scaler, with the -zoom op- 1477 tion. For example with x11 or other outputs which 1478 lack hardware acceleration. Possible settings are: 1479 1480 NOTE: 1481 For -sws 2 and 7, the sharpness can be set with the 1482 scaling parameter (p) of -vop scale (0 (soft) - 100 1483 (sharp)), for -sws 9, it specifies the filter 1484 length (1 - 10). 1485 1486 0 fast bilinear (default) 1487 1 bilinear 1488 2 bicubic (good quality) 1489 3 experimental 1490 4 nearest neighbour (bad qual- 1491 ity) 1492 5 area 1493 6 luma bicubic / chroma bilin- 1494 ear 1495 7 gauss 1496 8 sincR 1497 9 lanczos 1498 10 bicubic spline 1499 1500 -vc <[-]codec1,[-]codec2,...[,]> 1501 Specify a priority list of video codecs to be used, 1502 according to their codec name in codecs.conf. Use 1503 a '-' before the codec name to omit it. 1504 1505 NOTE: 1506 See -vc help for a full list of available codecs. 1507 If the list has a trailing ',' it will fallback to 1508 codecs not listed. 1509 1510 EXAMPLE: 1511 -vc divx force Win32/VFW DivX codec, 1512 no fallback 1513 -vc divx4, try divx4linux codec first, 1514 then fallback to others 1515 -vc -divxds,-divx, try other codecs except 1516 Win32 DivX codecs 1517 -vc ffmpeg12,mpeg12, 1518 try libavcodec's MPEG1/2 1519 codec, then libmpeg2, then 1520 others 1521 1522 -vfm <driver1,driver2,...> 1523 Specify a priority list of video drivers to be 1524 used, according to their driver name in 1525 codecs.conf. It falls back to default if none is 1526 ok. 1527 1528 NOTE: 1529 If libdivxdecore support was compiled in, then odi- 1530 vx and divx4 now contains just the same DivX4 1531 codec, but different APIs to reach it. For differ- 1532 ence between them and when to use which, check the 1533 DivX4 section in the documentation. 1534 See -vfm help for a full list of available drivers. 1535 1536 EXAMPLE: 1537 -vfm ffmpeg,dshow,vfw 1538 try the libavcodec, then Di- 1539 rectshow, then VFW codecs 1540 and fallback to the others, 1541 if still none is ok 1542 -vfm xanim try XAnim codecs first 1543 1544 -vop <...,filter3[=options],filter2,filter1> 1545 Activate a comma separated list of video filters 1546 and their options in reverse order. 1547 1548 NOTE: 1549 The parameters are optional and if omitted, some of 1550 them are set to default values. Use -1 to keep the 1551 default value. Parameters w:h means width x height 1552 in pixels, x:y means x;y position counted from the 1553 upper left corner of the bigger image. 1554 To get a full list of available plugins, see -vop 1555 help. 1556 Available filters are: 1557 1558 crop[=w:h:x:y] Crops the given part of the 1559 image and discards the rest. 1560 Useful to remove black bands 1561 from widescreen movies. 1562 1563 rectangle[=w:h:x:y] Draws a rectangle of the re- 1564 quested width and height at 1565 the specified coordinates 1566 over the image (used to test 1567 crop). (default: maximum w/ 1568 h, upper left x/y position) 1569 1570 expand[=w:h:x:y:o] Expands (not scales) movie 1571 resolution to the given val- 1572 ue and places the unscaled 1573 original at coordinates x y. 1574 Can be used for placing sub- 1575 titles/OSD in the resulting 1576 black bands (default: origi- 1577 nal w/h, centered x/y). The 1578 last parameter (de)activates 1579 OSD rendering (default: 0). 1580 1581 flip Flips the image upside down. 1582 See also option -flip. 1583 1584 mirror Flips the image on Y axis. 1585 1586 rotate[=<0-7>] Rotates and flips (optional) 1587 the image +/- 90 degrees. 1588 For parameters between 4-7 1589 rotation is only done if the 1590 movie's geometry is portrait 1591 and not landscape. 1592 1593 scale[=w:h[:c[:p]]] Scales the image with the 1594 software scaler (slow) and 1595 performs a YUV<->RGB col- 1596 orspace conversion (see -sws 1597 option too). The value 0 is 1598 used for scaled (aspect) 1599 destination w/h. (default: 1600 original w/h, destination w/ 1601 h with -zoom) Optionaly 1602 chroma skipping (c from 0-3) 1603 and scaling parameters can 1604 be specified. (see the -sws 1605 option for details) 1606 1607 yuy2 Forces software YV12/I420 or 1608 422P to YUY2 conversion. 1609 1610 rgb2bgr[=swap] RGB 24/32 <-> BGR 24/32 col- 1611 orspace conversion with op- 1612 tional R <-> B swapping. 1613 1614 palette RGB/BGR 8 -> 15/16/24/32bpp 1615 colorspace conversion using 1616 palette. 1617 1618 format[=fourcc] Restricts the colorspace for 1619 next filter. It does not do 1620 any conversion. Use togeth- 1621 er with the scale filter for 1622 a real conversion. 1623 1624 pp[=flags] Activates the external post- 1625 processing filter. (see 1626 -vop pp option for details) 1627 1628 lavc[=quality:fps] Realtime MPEG1 encoder for 1629 use with DVB/DXR3 (libav- 1630 codec) 1631 1632 fame Realtime MPEG1 encoder for 1633 use with DVB/DXR3 (libfame) 1634 1635 dvbscale[=aspect] Set up optimal scaling for 1636 DVB cards. (aspect = 1637 DVB_HEIGHT*ASPECTRATIO, de- 1638 fault: 768) 1639 1640 cropdetect[=0-255] Calculates necessary crop- 1641 ping parameters and prints 1642 the recommended parameters 1643 to stdout. The threshold 1644 can be optionally specified 1645 from nothing (0) to every- 1646 thing (255). (default: 24) 1647 1648 noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] 1649 Adds noise 1650 <0-100>: luma noise 1651 <0-100>: chroma noise 1652 u: uniform noise 1653 t: temporal noise 1654 a: averaged temporal 1655 noise 1656 h: high quality 1657 p: mix with pattern 1658 1659 eq[=bright:cont] Activates the software 1660 equalizer with interactive 1661 controls like the hardware 1662 eq controls. The values can 1663 be from -100 to 100. 1664 1665 halfpack Convert planar YUV 4:2:0 to 1666 half-height packed 4:2:2, 1667 downsampling luma but keep- 1668 ing all chroma samples. 1669 Useful for output to low- 1670 resolution display devices 1671 when hardware downscaling is 1672 poor quality or is not 1673 available. 1674 1675 dint[=sense:level] Detects and drops first of 1676 interlaced frames in video 1677 stream. Values can be from 1678 0.0 to 1.0 - first (default 1679 0.1) is relative difference 1680 between neighbor pixels, 1681 second (default 0.15) is 1682 what part of image have to 1683 be detected as interlaced to 1684 drop the frame. 1685 1686 unsharp=l|cWxH:amount[:l|cWxH:amount] 1687 Unsharp mask / gaussian 1688 blur. 1689 l: apply effect on luma 1690 component 1691 c: apply effect on chroma 1692 components 1693 WxH: width and height of 1694 the matrix, odd sized in 1695 both directions (min = 1696 3x3, max = 13x11 or 1697 11x13, usually something 1698 between 3x3 and 7x7) 1699 amount: relative amount 1700 of sharpness / blur to 1701 add to the image (amount 1702 < 0 = blur, amount > 0 = 1703 sharpen, usually some- 1704 thing between -1.5 and 1705 1.5) 1706 1707 swapuv Swap U & V plane. 1708 1709 il=[d|i][s][:[d|i][s]] 1710 (de)interleaves lines. 1711 d: deinterleave 1712 i: interleave 1713 s: swap fields (exchange 1714 even & odd lines) 1715 1716 boxblur=radius:power[:radius:power] 1717 radius: size of the fil- 1718 ter 1719 power: how often the fil- 1720 ter should be applied 1721 1722 1723 1724 !!! .IPs 1bpp !!! .IPs 2xsai !!! .IPs eq2 !!! 1725 .IPs yvu9 !!! more (IMHO all of -vop help should 1726 be documented), !!! especially bmovl (see .c 1727 file), add vo/test? 1728 1729 1730 1731 1732 -x <x> (MPLAYER only) 1733 Scale image to x width (if sw/hw scaling avail- 1734 able). Disables aspect calculations. 1735 1736 -xvidopts <option1:option2:...> 1737 Specify additional parameters when decoding with 1738 XviD. 1739 1740 dr2 Activate direct rendering 1741 method 2. 1742 nodr2 Deactivate direct rendering 1743 method 2. 1744 1745 -xy <x> 1746 x<=8 Scale image by factor <x>. 1747 x>8 Set width to <x> and calcu- 1748 late height to keep correct 1749 aspect ratio. 1750 1751 -y <y> (MPLAYER only) 1752 Scale image to y height (if sw/hw scaling avail- 1753 able). Disables aspect calculations. 1754 1755 -zoom 1756 Allow software scaling, where available. Could be 1757 used to force scaling with -vop scale. 1758 1759 NOTE: 1760 -vop scale will IGNORE options -x / -y / -xy / -fs 1761 / -aspect without -zoom. 1762 1763 1764 1765ENCODING OPTIONS (MENCODER ONLY) 1766 -audio-density <1-50> 1767 Number of audio chunks per second (default is 2 for 1768 0.5s long audio chunks). 1769 1770 NOTE: 1771 CBR only, VBR ignores this as it puts each packet 1772 in a new chunk. 1773 1774 -audio-delay <0.0-...> 1775 Sets the audio delay field in the header. Default 1776 is 0.0, negative values do not work. This does not 1777 delay the audio while encoding, but the player will 1778 see the default audio delay, sparing you the use of 1779 the -delay option. 1780 1781 -audio-preload <0.0-2.0> 1782 Sets up audio buffering time interval (default: 1783 0.5s). 1784 1785 -divx4opts <option1:option2:...> 1786 If encoding to DivX4, you can specify its parame- 1787 ters here. 1788 Available options are: 1789 1790 help get help 1791 1792 br=<value> specify bitrate in 1793 kbit <4-16000> or 1794 bit <16001-24000000> 1795 1796 key=<value> maximum keyframe interval 1797 (in frames) 1798 1799 deinterlace enable deinterlacing (avoid 1800 it, DivX4 is buggy) 1801 1802 q=<1-5> quality (1-fastest, 5-best) 1803 1804 min_quant=<1-31> minimum quantizer 1805 1806 max_quant=<1-31> maximum quantizer 1807 1808 rc_period=<value> rate control period 1809 1810 rc_reaction_period=<value> 1811 rate control reaction period 1812 1813 rc_reaction_ratio=<value> 1814 rate control reaction ratio 1815 1816 crispness=<0-100> specify crispness/smoothness 1817 1818 pass=<1-2> With this you can encode 1819 2pass DivX4 files. First 1820 encode with pass=1, then 1821 with the same parameters, 1822 encode with pass=2. 1823 1824 vbrpass=<0-2> Override the pass argument 1825 and use XviD VBR Library in- 1826 stead of DivX4 VBR. Avail- 1827 able options are: 1828 0: one pass encoding (as 1829 in not putting pass on 1830 the command line) 1831 1: Analysis (first) pass 1832 of two pass encoding. 1833 The resulting AVI file 1834 can be directed to 1835 /dev/null. 1836 2: Final (second) pass of 1837 two pass encoding. 1838 1839 -endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see -ss and -sb 1840 option too) 1841 Stop encoding at given time or byte position. Can 1842 be specified in many ways: 1843 1844 NOTE: 1845 Byte position won't be accurate, as it can only 1846 stop at a frame boundary. 1847 1848 EXAMPLE: 1849 -endpos 56 encode only 56 seconds 1850 -endpos 01:10:00 encode only 1 hour 10 min- 1851 utes 1852 -endpos 100mb encode only 100 MBytes 1853 1854 -ffourcc <fourcc> 1855 Can be used to override the video fourcc of the 1856 output file. 1857 1858 EXAMPLE: 1859 -ffourcc div3 will have the output file 1860 contain 'div3' as video 1861 fourcc. 1862 1863 -include <configuration file> 1864 Specify configuration file to be parsed after the 1865 default 1866 1867 -info <option1:option2:...> (.AVI only) 1868 Specify the info header of the resulting .AVI file. 1869 Available options are: 1870 1871 help show this description 1872 1873 name=<value> title of the subject of the 1874 file 1875 1876 artist=<value> artist or author of the 1877 original subject of the file 1878 1879 genre=<value> original work category 1880 1881 subject=<value> contents of the file 1882 1883 copyright=<value> copyright information for 1884 the file 1885 1886 srcform=<value> original form of the materi- 1887 al that was digitized 1888 1889 comment=<value> general comments about the 1890 file or the subject of the 1891 file 1892 1893 -lameopts <option1:option2:...> 1894 If encoding to MP3 with libmp3lame, you can specify 1895 its parameters here. 1896 Available options are: 1897 1898 help get help 1899 1900 vbr=<0-4> variable bitrate method 1901 0: cbr 1902 1: mt 1903 2: rh(default) 1904 3: abr 1905 4: mtrh 1906 1907 abr average bitrate 1908 1909 cbr constant bitrate 1910 1911 br=<0-1024> specify bitrate in kBit (CBR 1912 and ABR only) 1913 1914 q=<0-9> quality (0-highest, 9-low- 1915 est) (only for VBR) 1916 1917 aq=<0-9> algorithmic quality (0-best/ 1918 slowest, 9-worst/fastest) 1919 1920 ratio=<1-100> compression ratio 1921 1922 vol=<0-10> set audio input gain 1923 1924 mode=<0-3> (default: auto) 1925 0: stereo 1926 1: joint-stereo 1927 2: dualchannel 1928 3: mono 1929 1930 padding=<0-2> 1931 0: no 1932 1: all 1933 2: adjust 1934 1935 -lavcopts <option1:option2:...> 1936 If encoding with a codec from libavcodec, you can 1937 specify its parameters here. 1938 1939 EXAMPLE: 1940 -lavcopts vcodec=msmpeg4:vbi- 1941 trate=1800:vhq:keyint=250 1942 1943 Available options are: 1944 1945 vcodec=<value> use the specified codec 1946 (there is no default, you 1947 must specify it): 1948 mjpeg: Motion JPEG 1949 h263: H263 1950 h263p: H263 Plus 1951 mpeg4: DivX 4/5 1952 msmpeg4: DivX 3 1953 rv10: an old RealVideo 1954 codec 1955 mpeg1video: MPEG1 video 1956 :) 1957 1958 vqmin=<2-31> minimum quantizer (pass 1/2) 1959 (default: 3) 1960 1961 vqscale=<2-31> constant quantizer (selects 1962 fixed quantizer mode) (de- 1963 fault: 0 (disabled)) 1964 1965 vqmax=<1-31> maximum quantizer (pass 1/2) 1966 (default: 15) 1967 1968 vqdiff=<1-31> maximum quantizer difference 1969 between I or P frames 1970 (pass 1/2) (default: 3) 1971 1972 vmax_b_frames=<0-4> maximum number of B frames 1973 between non B frames: 1974 0: no B frames (default) 1975 0-2: sane range 1976 1977 vme=<0-5> motion estimation method: 1978 0: none (very lq) 1979 1: full (slow) 1980 2: log (lq) 1981 3: phods (lq) 1982 4: EPZS (default) 1983 5: X1 1984 1985 vhq high quality mode, encode 1986 each macro block in all 1987 modes an choose the smallest 1988 (slow). (default: HQ dis- 1989 abled) 1990 1991 v4mv 4 motion vectors per mac- 1992 roblock (slightly better 1993 quality), cannot be used 1994 with B frames. (default: 1995 disabled) 1996 1997 keyint=<0-300> interval between keyframes 1998 in frames. Larger numbers 1999 mean slightly smaller files, 2000 but less precise seeking, 0 2001 means no key frames and val- 2002 ues >300 aren't recommended. 2003 For a strict mpeg1/2/4 com- 2004 pliance this would have to 2005 be <=132. (default: 250 or 2006 one key frame every ten sec- 2007 onds in a 25fps movie) 2008 2009 vb_strategy=<0-1> strategy to choose between 2010 I/P/B frames (pass 2): 2011 0: always use the maximum 2012 number of B frames (de- 2013 fault) 2014 1: avoid B frames in high 2015 motion scenes (bitrate 2016 mispredictions) 2017 2018 vpass=<1-2> Activates internal 2pass 2019 mode (default: disabled): 2020 1: first pass 2021 2: second pass 2022 2023 aspect=<x.x/y.y> Store movie aspect internal- 2024 ly, just like MPEG files. 2025 Much nicer solution than 2026 rescaling, because quality 2027 isn't decreased. Only MPlay- 2028 er will play these files 2029 back correctly, other play- 2030 ers will display them with 2031 wrong aspect. Example: 2032 aspect=16.0/9.0 2033 2034 vbitrate=<value> specify bitrate (pass 1/2) 2035 in 2036 kBit <4-16000> or 2037 Bit <16001-24000000> 2038 (warning: 1kBit = 1000 2039 Bits) 2040 (default: 800) 2041 2042 vratetol=<value> approximated filesize toler- 2043 ance in kbit. (warning: 2044 1kBit = 1000 Bits) (default: 2045 8000) 2046 2047 vrc_maxrate=<value> maximum bitrate in kbit/sec 2048 (pass 1/2) 2049 2050 vrc_minrate=<value> minimum bitrate in kbit/sec 2051 (pass 1/2) 2052 2053 vrc_buf_size=<value> 2054 buffer size in kbit (pass 1/ 2055 2). Note: vratetol should 2056 not be too large during the 2057 second pass or there might 2058 be problems if 2059 vrc_(min|max)rate is used. 2060 2061 vb_qfactor=<-31.0-31.0> 2062 quantizer factor between B 2063 and non B frames (pass 1/2) 2064 (default: 1.25) 2065 2066 vi_qfactor=<-31.0-31.0> 2067 (pass 1/2) (default: 0.8) 2068 2069 vb_qoffset=<-31.0-31.0> 2070 quantizer offset between B 2071 and non B frames (pass 1/2) 2072 (default: 1.25) 2073 2074 vi_qoffset=<-31.0-31.0> 2075 (pass 1/2) (default: 0.0) 2076 if v{b|i}_qfactor > 0 2077 I/B-Frame quantizer = P- 2078 Frame quantizer * 2079 v{b|i}_qfactor + 2080 v{b|i}_qoffset 2081 else 2082 do normal ratecontrol (dont 2083 lock to next P frame quan- 2084 tizer) and set q= -q * 2085 v{b|i}_qfactor + 2086 v{b|i}_qoffset 2087 2088 vqblur=<0.0-1.0> quantizer blur (pass1): 2089 0.0: qblur disabled 2090 0.5 (default) 2091 1.0: average the quantiz- 2092 er over all previous 2093 frames, larger values 2094 will 2095 average the quantizer 2096 more over time (slower 2097 change) 2098 2099 vqblur=<0.0-99.0> quantizer gaussian blur, 2100 larger values will average 2101 the quantizer more over time 2102 (slower change) (pass2) (de- 2103 fault: 0.5) 2104 2105 vqcomp=<value> quantizer compression, de- 2106 pends upon vrc_eq (pass 1/2) 2107 (default: 0.5) 2108 2109 vrc_eq=<equation> main ratecontrol equation 2110 (pass 1/2): 2111 2112 1: constant bitrate 2113 tex: constant quality 2114 1+(tex/avgTex-1)*qComp: ap- 2115 proximately the equation of 2116 the old ratecontrol code 2117 tex^qComp: with qcomp 0.5 or 2118 something like that (de- 2119 fault) 2120 2121 infix operators: +,-,*,/,^ 2122 2123 variables: 2124 tex: texture 2125 complexity 2126 iTex,pTex: intra, non 2127 intra texture complexity 2128 avgTex: average 2129 texture complexity 2130 avgIITexaverage: intra tex- 2131 ture complexity in I frames 2132 avgPITexaverage: intra tex- 2133 ture complexity in P frames 2134 avgPPTexaverage: non intra 2135 texture complexity in P 2136 frames 2137 avgBPTexaverage: non intra 2138 texture complexity in B 2139 frames 2140 mv: bits used 2141 for MVs 2142 fCode: maximum 2143 length of MV in log2 scale 2144 iCount: number of 2145 intra MBs / number of MBs 2146 var: spatial 2147 complexity 2148 mcVar: temporal 2149 complexity 2150 qComp: qcomp from 2151 the command line 2152 isI, isP, isB: is 1 if 2153 picture type is I/P/B else 0 2154 Pi,E: see your 2155 favorite math book 2156 2157 functions: 2158 max(a,b),min(a,b): maximum / 2159 minimum 2160 gt(a,b): is 1 if a>b, 0 oth- 2161 erwise 2162 lt(a,b): is 1 if a<b, 0 oth- 2163 erwise 2164 eq(a,b): is 1 if a==b,0 oth- 2165 erwise 2166 sin, cos, tan, sinh, cosh, 2167 tanh, exp, log, abs 2168 2169 vrc_override=<options> 2170 User specified quality for 2171 specific parts (pass 1/2). 2172 The options are <start- 2173 frame, end-frame, quality[/ 2174 start-frame, end-frame, 2175 quality[/...]]>: 2176 quality 2-31: quantizer 2177 quality -500-0: quality 2178 correcture in % 2179 2180 vrc_init_cplx=<0-1000> 2181 initial complexity (pass 1) 2182 2183 vqsquish=<0-1> specify how to keep the 2184 quantizer between qmin and 2185 qmax (pass 1/2): 2186 0: use cliping 2187 1: use a nice differen- 2188 tiable function (default) 2189 2190 vlelim=<-1000-1000> single coefficient elimina- 2191 tion threshold for lumi- 2192 nance. Negative values will 2193 also consider the dc coeffi- 2194 cient (should be at least -4 2195 or lower for encoding at 2196 quant=1): 2197 0: disabled (default) 2198 -4 (JVT recommendation) 2199 2200 vcelim=<-1000-1000> single coefficient elimina- 2201 tion threshold for chromi- 2202 nance. Negative values will 2203 also consider the dc coeffi- 2204 cient (should be at least -4 2205 or lower for encoding at 2206 quant=1): 2207 0 disabled (default) 2208 7 (JVT recommendation) 2209 2210 vstrict strict standard compliance. 2211 Only recommended if you want 2212 to feed the output into the 2213 mpeg4 reference decoder. 2214 2215 vdpart data partitioning. Adds 2 2216 byte per video packet, im- 2217 proves error-resistance when 2218 transfering over unreliable 2219 channels (eg. streaming over 2220 the internet) 2221 2222 vpsize=<0-10000> video packet size, improves 2223 error-resistance (see -vd- 2224 part option too): 2225 0: disabled (default) 2226 100-1000: good choice 2227 2228 gray grayscale only encoding 2229 (faster) (default: disabled) 2230 2231 vfdct=<0-99> dct algorithm: 2232 0: automatically select a 2233 good one (default) 2234 1: fast integer 2235 2: accurate integer 2236 3: mmx 2237 4: mlib 2238 2239 idct=<0-99> idct algorithm. Note: all 2240 these IDCTs do pass the 2241 IEEE1180 tests afaik: 2242 0: automatically select a 2243 good one (default) 2244 1: jpeg reference integer 2245 2: simple 2246 3: simplemmx 2247 4: libmpeg2mmx (inaccu- 2248 rate, DONT USE for encod- 2249 ing with keyint >100) 2250 5: ps2 2251 6: mlib 2252 7: arm 2253 2254 lumi_mask=<0.0-1.0> luminance masking. Warning: 2255 be careful, too large values 2256 can cause disasterous 2257 things. Warning2: large 2258 values might look good on 2259 some monitors but may look 2260 horrible on other monitors: 2261 0.0: disabled (default) 2262 0.0-0.3: sane range 2263 2264 dark_mask=<0.0-1.0> darkness masking. Warning: 2265 be careful, too large values 2266 can cause disasterous 2267 things. Warning2: large 2268 values might look good on 2269 some monitors but may look 2270 horrible on other monitors / 2271 TV / TFT: 2272 0.0: disabled (default) 2273 0.0-0.3: sane range 2274 2275 tcplx_mask=<0.0-1.0> 2276 temporal complexity masking 2277 (default: 0.0 (disabled)) 2278 2279 scplx_mask=<0.0-1.0> 2280 spatial complexity masking. 2281 Larger values help against 2282 blockiness, if no deblocking 2283 filter is used for decoding. 2284 Crop any black borders to 2285 get better quality: 2286 0.0: disabled (default) 2287 0.0-0.5: sane range 2288 2289 naq normalize adaptive quantiza- 2290 tion (experimental) 2291 2292 ildct use interlaced dct 2293 2294 mpeg_quant use MPEG quantizers instead 2295 of H.263. (default: dis- 2296 abled) (i.e. use H.263 quan- 2297 tizers) 2298 2299 -noskip 2300 Do not skip frames. 2301 2302 -o <filename> 2303 Outputs to the given filename, instead of the de- 2304 fault 'test.avi'. 2305 2306 -oac <codec name> 2307 Encode with the given codec. Use -ovc help to get 2308 a list of available codecs. (no default set) 2309 2310 EXAMPLE: 2311 -oac copy no encoding, just streamcopy 2312 -oac pcm encode to uncompressed PCM 2313 -oac mp3lame encode to MP3 (using Lame) 2314 2315 -ofps <fps> 2316 The output file will have different frame/sec than 2317 the source. You MUST set it for variable fps (asf, 2318 some mov) and progressive (29.97fps telecined mpeg) 2319 files. 2320 2321 -ovc <codec name> 2322 Encode with the given codec. Use -ovc help to get 2323 a list of available codecs. (no default set) 2324 2325 EXAMPLE: 2326 -ovc copy no encoding, just streamcopy 2327 -ovc divx4 encode to DivX4/DivX5 2328 -ovc rawrgb encode to uncompressed RGB24 2329 -ovc lavc encode with a libavcodec 2330 codecs 2331 2332 -passlogfile <filename> 2333 When encoding in 2pass mode, MEncoder dumps first 2334 pass' informations to the given file instead of the 2335 default divx2pass.log. 2336 2337 -skiplimit <value> 2338 Maximal skipable frames after non-skipped one 2339 (-noskiplimit for unlimited number). 2340 2341 -v, --verbose 2342 Enable verbose output (more -v means more verbosi- 2343 ty). 2344 2345 -vobsubout <basename> 2346 Specify the basename for the output .idx and .sub 2347 files. This turns off subtitle rendering in the 2348 encoded movie and diverts it to Vobsub subtitle 2349 files. 2350 2351 -vobsuboutindex <index> 2352 Specify the index of the subtitles in the output 2353 files. (default: 0) 2354 2355 -vobsuboutid <langid> 2356 Specify the language two letter code for the subti- 2357 tles. This overrides what is read from the DVD or 2358 the .ifo file. 2359 2360 -xvidencopts <option1:option2:...> 2361 If encoding to XviD, you can specify its parameters 2362 here. 2363 There's three modes available : constant bitrate 2364 (CBR), fixed quantizer and 2pass. 2365 Available options are: 2366 2367 pass=<1|2> specify the pass in 2pass 2368 mode 2369 2370 quality=<0-6> specify the encoding quality 2371 (default=6) 2372 2373 br=<value> sets the bitrate to be used 2374 in kbits/second if <16000 or 2375 in bits/second if >16000 2376 (CBR or 2pass mode, de- 2377 fault=687 kbits/s) 2378 2379 rc_reaction_delay_factor=<value> 2380 specify how fast the rate 2381 control reacts, lower values 2382 are faster 2383 2384 rc_averaging_period=<value> 2385 period to reach the required 2386 average 2387 2388 rc_buffer=<value> size of the rate control 2389 buffer 2390 2391 quant_range=<1-31>-<1-31>[/<1-31>-<1-31>] 2392 min & max quantizer for all 2393 frames (default=2-31, CBR 2394 mode) 2395 min & max quantizer for I/P 2396 frames (default=2-31/2-31, 2397 2pass mode) 2398 2399 min_key_interval=<value> 2400 minimum interval between key 2401 frames (default=0, 2pass on- 2402 ly) 2403 2404 max_key_interval=<value> 2405 maximum interval between key 2406 frames (default=10*fps) 2407 2408 mpeg_quant use MPEG quantizers instead 2409 of H.263 (default=off) 2410 2411 mod_quant decide whether to use MPEG 2412 or H.263 quantizers on a 2413 frame-by-frame basis. (de- 2414 fault=off, 2pass mode only) 2415 2416 lumi_mask use a lumimasking algorithm 2417 (default=off, seems buggy) 2418 2419 hintedme save Motion Estimation vec- 2420 tors to a file during the 2421 first pass and reuse this 2422 file during the second (de- 2423 fault=off, 2pass mode only, 2424 seems buggy) 2425 2426 hintfile specify the temporary file 2427 to be used by the 'hintedme' 2428 option (default= 2429 ./xvid_hint_me.dat, 2pass 2430 mode only) 2431 2432 debug save per-frame statistics in 2433 xvid.dbg (default=off) 2434 this is *not* the 2pass con- 2435 trol file 2436 2437 keyframe_boost=<0-1000> 2438 (default=0, 2pass mode only) 2439 2440 kfthreshold=<value> (default=10, 2pass mode on- 2441 ly) 2442 2443 kfreduction=<0-100> (default=30, 2pass mode on- 2444 ly) 2445 2446 fixed_quant=<1-31> switch to fixed quantizer 2447 mode and specify the quan- 2448 tizer to be used 2449 2450 2451 2452KEYBOARD CONTROL 2453 NOTE: 2454 MPlayer has a fully configurable, command driven, control 2455 layer which allow you to control MPlayer using keyboard, 2456 mouse, joystick or remote control (using lirc). 2457 The default configuration file for the input system is 2458 ~/.mplayer/input.conf but it can be overriden using the 2459 -input conf option. 2460 These keys may/may not work, depending on your video out- 2461 put driver. 2462 2463 general control 2464 <- and -> seek backward/forward 10 2465 seconds 2466 up and down seek backward/forward 1 2467 minute 2468 pgup and pgdown seek backward/forward 10 2469 minutes 2470 < and > backward/forward in playlist 2471 HOME and END go to next/previous playtree 2472 entry in the parent list 2473 INS and DEL go to next/previous alterna- 2474 tive source (asx playlist 2475 only) 2476 p / SPACE pause movie (any key unpaus- 2477 es) 2478 q / ESC stop playing and quit 2479 + and - adjust audio delay by +/- 2480 0.1 second 2481 / and * decrease/increase volume 2482 9 and 0 decrease/increase volume 2483 m mute sound 2484 f toggle fullscreen 2485 w and e decrease/increase panscan 2486 range 2487 o toggle between OSD states: 2488 none / seek / seek+timer 2489 d toggle frame dropping 2490 v toggle subtitle visibility 2491 j switch subtitle language 2492 z and x adjust subtitle delay by +/- 2493 0.1 second 2494 r and t adjust subtitle position 2495 2496 (The following keys are valid only when using 2497 -vo xv or -vo [vesa|fbdev]:vidix or -vo xvidix 2498 -vo (x)mga or -vc divxds (slow).) 2499 2500 1 and 2 adjust contrast 2501 3 and 4 adjust brightness 2502 5 and 6 adjust hue 2503 7 and 8 adjust saturation 2504 2505 GUI keyboard control 2506 ENTER start playing 2507 s stop playing 2508 a about 2509 l load file 2510 c skin browser 2511 p toggle playlist 2512 2513 TV input control 2514 h and k select previous/next channel 2515 n change norm 2516 u change channel list 2517 2518 DVDNAV input control 2519 K,J,H,L browse up/down/left/right 2520 M jump to main menu 2521 S select 2522 2523 2524 2525SLAVE MODE PROTOCOL 2526 If the -slave switch is given, playback is controlled by a 2527 line-based protocol. Each line must contain one command 2528 otherwise one of the following tokens: 2529 2530 Commands 2531 2532 seek <value> [type=<0/1/2>] 2533 Seek to some place in the 2534 movie. Type 0 is a relative 2535 seek of +/- <value> seconds. 2536 Type 1 seek to <value> % in 2537 the movie. Type 2 is a seek 2538 to an absolute position of 2539 <value> seconds. 2540 2541 audio_delay <value> Adjust the audio delay of 2542 value seconds 2543 2544 quit Quit MPlayer 2545 2546 pause Pause/unpause the playback 2547 2548 grap_frames Somebody know ? 2549 2550 pt_step <value> [force=<value>] 2551 Go to next/previous entry in 2552 the playtree. 2553 2554 pt_up_step <value> [force=<value>] 2555 Like pt_step but it jumps to 2556 next/previous in the parent 2557 list. 2558 2559 alt_src_step <value> 2560 When more than one source is 2561 available it selects the 2562 next/previous one (only sup- 2563 ported by asx playlist). 2564 2565 sub_delay <value> [abs=<value>] 2566 Adjust the subtitles delay 2567 of +/- <value> seconds or 2568 set it to <value> seconds 2569 when abs is non zero. 2570 2571 osd [level=<value>] Toggle osd mode or set it to 2572 level when level > 0. 2573 2574 volume <dir> Increase/decrease volume 2575 2576 [contrast|brightness|hue|saturation] <-100 - 2577 100> [abs=<value>] 2578 Set/Adjust video parameters. 2579 2580 frame_drop [type=<value>] 2581 Toggle/Set frame dropping 2582 mode. 2583 2584 sub_visibility Toggle subtitle visibility. 2585 2586 sub_pos <value> Adjust subtitles position. 2587 2588 vo_fullscreen Switch to fullscreen mode. 2589 2590 tv_step_channel <dir> 2591 Select next/previous tv 2592 channel. 2593 2594 tv_step_norm Change TV norm. 2595 2596 tv_step_chanlist Change channel list. 2597 2598 gui_[loadsubtitle|about|play|stop] 2599 GUI actions 2600 2601 2602 2603FILES 2604 /etc/mplayer/mplayer.conf 2605 system-wide settings 2606 2607 ~/.mplayer/config 2608 user settings 2609 2610 ~/.mplayer/input.conf 2611 input bindings (see '-input keylist' for full 2612 keylist) 2613 2614 ~/.mplayer/gui.conf 2615 GUI configuration file 2616 2617 ~/.mplayer/gui.pl 2618 GUI playlist 2619 2620 ~/.mplayer/font/ 2621 font directory (There must be a font.desc file and 2622 files with .RAW extension.) 2623 2624 ~/.mplayer/DVDkeys/ 2625 cracked CSS keys 2626 Sub files 2627 are searched for in this priority (for example 2628 /mnt/movie/movie.avi): 2629 /mnt/cdrom/movie.sub 2630 ~/.mplayer/sub/movie.sub 2631 ~/.mplayer/default.sub 2632 2633 2634 2635EXAMPLES 2636 Quickstart DVD playing 2637 mplayer -dvd 1 2638 2639 Play in japanese with english subtitles 2640 mplayer -dvd 1 -alang ja -slang en 2641 2642 Play only chapters 5, 6, 7 2643 mplayer -dvd 1 -chapter 5-7 2644 2645 Multiangle DVD playing 2646 mplayer -dvd 1 -dvdangle 2 2647 2648 Playing from a different DVD device 2649 mplayer -dvd 1 -dvd-device /dev/dvd2 2650 2651 Old style DVD (VOB) playing 2652 mplayer -dvdauth /dev/dvd /mnt/dvd/VIDEO_TS/ 2653 VTS_02_4.VOB 2654 2655 Stream from HTTP 2656 mplayer http://mplayer.hq/example.avi 2657 2658 Stream using RTSP 2659 mplayer rtsp://server.example.com/streamName 2660 2661 Convert subtitle to MPsub (to ./dump.mpsub) 2662 mplayer dummy.avi -sub source.sub -dumpmpsub 2663 2664 Input from standard V4L 2665 mplayer -tv on:driv- 2666 er=v4l:width=640:height=480:outfmt=i420 -vc rawi420 2667 -vo xv 2668 2669 Encoding DVD title #2, only selected chapters 2670 mencoder -dvd 2 -chapter 10-15 -o title2.avi -oac 2671 copy -ovc divx4 2672 2673 Encoding DVD title #2, resizing to 640x480 2674 mencoder -dvd 2 -vop scale=640:480 -o title2.avi 2675 -oac copy -ovc divx4 2676 2677 Encoding DVD title #2, resizing to 512xHHH (keep aspect 2678 ratio) 2679 mencoder -dvd 2 -vop scale -zoom -xy 512 -o ti- 2680 tle2.avi -oac copy -ovc divx4 2681 2682 The same, but with libavcodec family, MPEG4 (Divx5) com- 2683 pression 2684 mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts 2685 vcodec=mpeg4:vhq:vbitrate=1800 -oac copy 2686 2687 The same, but with libavcodec family, MJPEG compression 2688 mencoder -dvd 2 -o titel2.avi -ovc lavc -lavcopts 2689 vcodec=mjpeg:vhq:vbitrate=1800 -oac copy 2690 2691 Encoding all *.jpg files in the current dir 2692 mencoder \*.jpg -mf on:fps=25 -o output.avi -ovc 2693 divx4 2694 2695 Encoding from tuner 2696 mencoder -tv on:driver=v4l:width=640:height=480 -o 2697 tv.avi -ovc rawrgb 2698 2699 Encoding from a pipe 2700 rar p test-SVCD.rar | mencoder -ovc divx4 -di- 2701 vx4opts br=800 -ofps 24 -- - 2702 2703 Encoding multiple *.vob files 2704 cat *.vob | mencoder <options> - 2705 2706 2707 2708BUGS 2709 Probably. PLEASE, double-check the documentation (espe- 2710 cially bugreports.html), the FAQ and the mail archive be- 2711 fore! 2712 Send your complete bug reports to the MPlayer-users mail- 2713 ing list at <mplayer-users@mplayerhq.hu>. We love com- 2714 plete bug reports :) 2715 2716 2717 2718AUTHORS 2719 Check documentation. 2720 2721 MPlayer is (C) 2000-2002 2722 Arpad Gereoffy 2723 2724 This man page is written and maintained by 2725 Gabucino 2726 Diego Biurrun 2727 Jonas Jermann 2728 2729 Please send mails about it to the MPlayer-users mailing 2730 list. 2731 2732 2733 2734STANDARD DISCLAIMER 2735 Use only at your own risk! There may be errors and inac- 2736 curacies that could be damaging to your system or your 2737 eye. Proceed with caution, and although this is highly 2738 unlikely, the authors don't take any responsibility for 2739 that! 2740 2741 2742 2743 2002-10-19 MPlayer(1) 2744