2 .\" MPlayer (C) 2000-2009 MPlayer Team
3 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
5 .\" --------------------------------------------------------------------------
7 .\" --------------------------------------------------------------------------
9 .\" define indentation for suboptions
15 .\" begin of first level suboptions, end with .RE
19 .\" begin of 2nd level suboptions
24 .\" end of 2nd level suboptions
30 .\" --------------------------------------------------------------------------
32 .\" --------------------------------------------------------------------------
34 .TH MPlayer 1 "2009-03-25" "The MPlayer Project" "The Movie Player"
37 mplayer \- movie player
39 mencoder \- movie encoder
41 .\" --------------------------------------------------------------------------
43 .\" --------------------------------------------------------------------------
49 [options] [file|URL|playlist|\-]
54 [specific options] [file2] [specific options]
59 {group of files and options}
60 [group-specific options]
64 [dvd|dvdnav]://[title|[start_title]\-end_title][/device]
73 tv://[channel][/input_id]
78 radio://[channel|frequency][/capture]
88 dvb://[card_number@]channel
93 mf://[filemask|@listfile]
94 [\-mf options] [options]
98 [cdda|cddb]://track[\-endtrack][:speed][/device]
108 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
109 [user:pass@]URL[:port] [options]
118 mpst://host[:port]/URL
123 tivo://host/[list|llist|fsid]
134 [file|URL|\-] [\-o file | file://file | smb://[user:pass@]host/filepath]
139 [specific options] [file2] [specific options]
143 .\" --------------------------------------------------------------------------
145 .\" --------------------------------------------------------------------------
149 is a movie player for Linux (runs on many other platforms and CPU
150 architectures, see the documentation).
151 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
152 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
153 native and binary codecs.
154 You can watch VCD, SVCD, DVD, 3ivx, DivX 3/4/5, WMV and even H.264 movies,
157 MPlayer supports a wide range of video and audio output drivers.
158 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
159 Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
160 VESA (on every VESA-compatible card, even without X11), some low-level
161 card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
162 boards, such as the Siemens DVB, Hauppauge PVR (IVTV), DXR2 and DXR3/\:Hollywood+.
163 Most of them support software or hardware scaling, so you can enjoy movies in
166 MPlayer has an onscreen display (OSD) for status information, nice big
167 antialiased shaded subtitles and visual feedback for keyboard controls.
168 European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
169 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
170 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
171 DVD subtitles (SPU streams, VOBsub and Closed Captions).
174 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
175 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
177 It encodes to MPEG-4 (DivX/Xvid), one of the libavcodec codecs and
178 PCM/\:MP3/\:VBRMP3 audio in 1, 2 or 3 passes.
179 Furthermore it has stream copying abilities, a powerful filter system (crop,
180 expand, flip, postprocess, rotate, scale, noise, RGB/\:YUV conversion) and
184 is MPlayer with a graphical user interface.
185 It has the same options as MPlayer.
187 Usage examples to get you started quickly can be found at the end
190 .B Also see the HTML documentation!
193 .\" --------------------------------------------------------------------------
194 .\" interactive control
195 .\" --------------------------------------------------------------------------
197 .SH "INTERACTIVE CONTROL"
198 MPlayer has a fully configurable, command-driven control layer
199 which allows you to control MPlayer using keyboard, mouse, joystick
200 or remote control (with LIRC).
201 See the \-input option for ways to customize it.
208 Seek backward/\:forward 10 seconds.
210 Seek forward/\:backward 1 minute.
211 .IPs "pgup and pgdown"
212 Seek forward/\:backward 10 minutes.
214 Decrease/increase current playback speed by 10%.
216 Halve/double current playback speed.
218 Reset playback speed to normal.
220 Go backward/\:forward in the playlist.
222 Go forward in the playlist, even over the end.
224 next/\:previous playtree entry in the parent list
225 .IPs "INS and DEL (ASX playlist only)"
226 next/\:previous alternative source.
228 Pause (pressing again unpauses).
231 Pressing once will pause movie, every consecutive press will play one frame
232 and then go into pause mode again (any other key unpauses).
234 Stop playing and quit.
236 Stop playing (and quit if \-idle is not used).
238 Adjust audio delay by +/\- 0.1 seconds.
240 Decrease/\:increase volume.
242 Decrease/\:increase volume.
244 Adjust audio balance in favor of left/\:right channel.
247 .IPs "_ (MPEG-TS, AVI and libavformat only)"
248 Cycle through the available video tracks.
249 .IPs "# (DVD, MPEG, Matroska, AVI and libavformat only)"
250 Cycle through the available audio tracks.
251 .IPs "TAB (MPEG-TS and libavformat only)"
252 Cycle through the available programs.
254 Toggle fullscreen (also see \-fs).
256 Toggle stay-on-top (also see \-ontop).
258 Decrease/\:increase pan-and-scan range.
260 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
262 Toggle frame dropping states: none / skip display / skip decoding
263 (see \-framedrop and \-hardframedrop).
265 Toggle subtitle visibility.
267 Cycle through the available subtitles.
269 Step forward/backward in the subtitle list.
271 Toggle displaying "forced subtitles".
273 Toggle subtitle alignment: top / middle / bottom.
275 Adjust subtitle delay by +/\- 0.1 seconds.
277 Move subtitles up/down.
278 .IPs "i (\-edlout mode only)"
279 Set start or end of an EDL skip and write it out to the given file.
280 .IPs "s (\-vf screenshot only)"
282 .IPs "S (\-vf screenshot only)"
283 Start/stop taking screenshots.
285 Show filename on the OSD.
287 Seek to the beginning of the previous/next chapter.
288 .IPs "D (\-vo xvmc, \-vo vdpau, \-vf yadif, \-vf kerndeint only)"
289 Activate/deactivate deinterlacer.
291 Cycle through the available DVD angles.
296 (The following keys are valid only when using a hardware accelerated video
297 output (xv, (x)vidix, (x)mga, etc), the software equalizer
298 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
315 (The following keys are valid only when using the quartz or corevideo
316 video output driver.)
322 Resize movie window to half its original size.
324 Resize movie window to its original size.
326 Resize movie window to double its original size.
328 Toggle fullscreen (also see \-fs).
329 .IPs "command + [ and command + ]"
330 Set movie window alpha.
335 (The following keys are valid only when using the sdl
336 video output driver.)
342 Cycle through available fullscreen modes.
344 Restore original mode.
349 (The following keys are valid if you have a keyboard
350 with multimedia keys.)
358 Stop playing and quit.
359 .IPs "PREVIOUS and NEXT"
360 Seek backward/\:forward 1 minute.
365 (The following keys are only valid if GUI support is compiled in
366 and will take precedence over the keys defined above.)
389 (The following keys are only valid if you compiled with TV or DVB input
390 support and will take precedence over the keys defined above.)
396 Select previous/\:next channel.
405 (The following keys are only valid if you compiled with dvdnav
406 support: They are used to navigate the menus.)
422 Return to nearest menu (the order of preference is: chapter->title->root).
430 (The following keys are only valid if teletext support is enabled during
431 compilation: They are used for controlling TV teletext.)
437 Switch teletext on/\:off.
439 Go to next/\:prev teletext page.
449 .IPs "button 3 and button 4"
450 Seek backward/\:forward 1 minute.
451 .IPs "button 5 and button 6"
452 Decrease/\:increase volume.
460 .IPs "left and right"
461 Seek backward/\:forward 10 seconds.
463 Seek forward/\:backward 1 minute.
467 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
468 .IPs "button 3 and button 4"
469 Decrease/\:increase volume.
474 .\" --------------------------------------------------------------------------
476 .\" --------------------------------------------------------------------------
479 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
480 \-fs option is \-nofs.
482 If an option is marked as (XXX only), it will only work in combination with
483 the XXX option or if XXX is compiled in.
486 The suboption parser (used for example for \-ao pcm suboptions) supports
487 a special kind of string-escaping intended for use with external GUIs.
489 It has the following format:
491 %n%string_of_length_n
495 mplayer \-ao pcm:file=%10%C:test.wav test.avi
499 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
502 .\" --------------------------------------------------------------------------
503 .\" Configuration files
504 .\" --------------------------------------------------------------------------
506 .SH "CONFIGURATION FILES"
507 You can put all of the options in configuration files which will be read
508 every time MPlayer/MEncoder is run.
509 The system-wide configuration file 'mplayer.conf' is in your configuration
510 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
511 specific one is '~/\:.mplayer/\:config'.
512 The configuration file for MEncoder is 'mencoder.conf' in your configuration
513 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the
514 user specific one is '~/\:.mplayer/\:mencoder.conf'.
515 User specific options override system-wide options and options given on the
516 command line override either.
517 The syntax of the configuration files is 'option=<value>', everything after
518 a '#' is considered a comment.
519 Options that work without values can be enabled by setting them to 'yes'
520 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
521 Even suboptions can be specified in this way.
523 You can also write file-specific configuration files.
524 If you wish to have a configuration file for a file called 'movie.avi', create a file
525 named 'movie.avi.conf' with the file-specific options in it and put it in
527 You can also put the configuration file in the same directory as the file to
528 be played, as long as you give the \-use\-filedir\-conf option (either on the
529 command line or in your global config file).
531 .I EXAMPLE MPLAYER CONFIGURATION FILE:
534 # Use Matrox driver by default.
536 # I love practicing handstands while watching videos.
538 # Decode/encode multiple files from PNG,
539 # start with mf://filemask
541 # Eerie negative images are cool.
545 .I "EXAMPLE MENCODER CONFIGURATION FILE:"
548 # Make MEncoder output to a default filename.
550 # The next 4 lines allow mencoder tv:// to start capturing immediately.
553 lavcopts=vcodec=mjpeg
554 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
555 # more complex default encoding option set
556 lavcopts=vcodec=mpeg4:autoaspect=1
560 passlogfile=pass1stats.log
570 .\" --------------------------------------------------------------------------
572 .\" --------------------------------------------------------------------------
575 To ease working with different configurations profiles can be defined in the
577 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
578 All following options will be part of the profile.
579 A description (shown by \-profile help) can be defined with the profile-desc
581 To end the profile, start another one or use the profile name 'default'
582 to continue with normal options.
585 .I "EXAMPLE MPLAYER PROFILE:"
590 profile-desc="profile for dvd:// streams"
595 profile-desc="profile for dvdnav:// streams"
601 profile-desc="profile for .flv files"
611 .I "EXAMPLE MENCODER PROFILE:"
616 profile-desc="MPEG4 encoding"
618 lavcopts=vcodec=mpeg4:vbitrate=1200
621 profile-desc="HQ MPEG4 encoding"
623 lavcopts=mbd=2:trell=yes:v4mv=yes
626 .\" --------------------------------------------------------------------------
628 .\" --------------------------------------------------------------------------
630 .SH "GENERAL OPTIONS"
633 .B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
634 Override the standard search path and use the specified file
635 instead of the builtin codecs.conf.
638 .B \-include <configuration file>
639 Specify configuration file to be parsed after the default ones.
643 Prints all available options.
646 .B \-msgcharset <charset>
647 Convert console messages to the specified character set (default: autodetect).
648 Text will be in the encoding specified with the \-\-charset configure option.
649 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
652 The option takes effect after command line parsing has finished.
653 The MPLAYER_CHARSET environment variable can help you get rid of
654 the first lines of garbled output.
658 Enable colorful console output on terminals that support ANSI color.
661 .B \-msglevel <all=<level>:<module>=<level>:...>
662 Control verbosity directly for each module.
663 The 'all' module changes the verbosity of all the modules not
664 explicitly specified on the command line.
665 See '\-msglevel help' for a list of all modules.
668 Some messages are printed before the command line is parsed and are
669 therefore not affected by \-msglevel.
670 To control these messages you have to use the MPLAYER_VERBOSE environment
671 variable, see its description below for details.
687 informational messages
689 status messages (default)
703 Prepend module name in front of each console message.
706 .B \-noconfig <options>
707 Do not parse selected configuration files.
710 If \-include or \-use\-filedir\-conf options are
711 specified at the command line, they will be honoured.
713 Available options are:
717 all configuration files
718 .IPs "gui (GUI only)"
719 GUI configuration file
721 system configuration file
723 user configuration file
729 Make console output less verbose; in particular, prevents the status line
730 (i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed.
731 Particularly useful on slow terminals or broken ones which do not properly
732 handle carriage return (i.e.\& \\r).
735 .B \-priority <prio> (Windows and OS/2 only)
736 Set process priority for MPlayer according to the predefined
737 priorities available under Windows and OS/2.
738 Possible values of <prio>:
740 idle|belownormal|normal|abovenormal|high|realtime
745 Using realtime priority can cause system lockup.
749 .B \-profile <profile1,profile2,...>
750 Use the given profile(s), \-profile help displays a list of the defined profiles.
753 .B \-really\-quiet (also see \-quiet)
754 Display even less output and status messages than with \-quiet.
755 Also suppresses the GUI error message boxes.
758 .B \-show\-profile <profile>
759 Show the description and content of a profile.
762 .B \-use\-filedir\-conf
763 Look for a file-specific configuration file in the same directory as
764 the file that is being played.
767 May be dangerous if playing from untrusted media.
771 Increment verbosity level, one level for each \-v
772 found on the command line.
776 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
779 .B \-autoq <quality> (use with \-vf [s]pp)
780 Dynamically changes the level of postprocessing depending on the available spare
782 The number you specify will be the maximum level used.
783 Usually you can use some big number.
784 You have to use \-vf [s]pp without parameters in order for this to work.
787 .B \-autosync <factor>
788 Gradually adjusts the A/V sync based on audio delay measurements.
789 Specifying \-autosync 0, the default, will cause frame timing to be based
790 entirely on audio delay measurements.
791 Specifying \-autosync 1 will do the same, but will subtly change the A/V
792 correction algorithm.
793 An uneven video framerate in a movie which plays fine with \-nosound can
794 often be helped by setting this to an integer value greater than 1.
795 The higher the value, the closer the timing will be to \-nosound.
796 Try \-autosync 30 to smooth out problems with sound drivers which do
797 not implement a perfect audio delay measurement.
798 With this value, if large A/V sync offsets occur, they will only take about
799 1 or 2 seconds to settle out.
800 This delay in reaction time to sudden A/V offsets should be the only
801 side-effect of turning this option on, for all sound drivers.
805 Prints some statistics on CPU usage and dropped frames at the end of playback.
806 Use in combination with \-nosound and \-vo null for benchmarking only the
810 With this option MPlayer will also ignore frame duration when playing
811 only video (you can think of that as infinite fps).
814 .B \-colorkey <number>
815 Changes the colorkey to an RGB value of your choice.
816 0x000000 is black and 0xffffff is white.
817 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
818 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
823 Disables colorkeying.
824 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
825 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
829 .B \-correct\-pts (EXPERIMENTAL)
830 Switches MPlayer to an experimental mode where timestamps for video frames
831 are calculated differently and video filters which add new frames or
832 modify timestamps of existing ones are supported.
833 The more accurate timestamps can be visible for example when playing
834 subtitles timed to scene changes with the \-ass option.
835 Without \-correct\-pts the subtitle timing will typically be off by some frames.
836 This option does not work correctly with some demuxers and codecs.
839 .B \-crash\-debug (DEBUG CODE)
840 Automatically attaches gdb upon crash or SIGTRAP.
841 Support must be compiled in by configuring with \-\-enable\-crash\-debug.
844 .B \-doubleclick\-time
845 Time in milliseconds to recognize two consecutive button presses as
846 a double-click (default: 300).
847 Set to 0 to let your windowing system decide what a double-click is
851 You will get slightly different behaviour depending on whether you bind
852 MOUSE_BTN0_DBL or MOUSE_BTN0\-MOUSE_BTN0_DBL.
855 .B \-edlout <filename>
856 Creates a new file and writes edit decision list (EDL) records to it.
857 During playback, the user hits 'i' to mark the start or end of a skip block.
858 This provides a starting point from which the user can fine-tune EDL entries
860 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
863 .B \-enqueue (GUI only)
864 Enqueue files given on the command line in the playlist instead of playing them
869 \-fixed\-vo enforces a fixed video system for multiple files (one
870 (un)initialization for all files).
871 Therefore only one window will be opened for all files.
872 Now enabled by default, use \-nofixed\-vo to disable and create a new window
873 whenever the video stream changes.
874 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
875 xmga, xv, xvidix and dfbmga.
878 .B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
879 Skip displaying some frames to maintain A/V sync on slow systems.
880 Video filters are not applied to such frames.
881 For B-frames even decoding is skipped completely.
885 Enable or disable the GUI interface (default depends on binary name).
886 Only works as the first argument on the command line.
887 Does not work as a config-file option.
890 .B \-h, \-help, \-\-help
891 Show short summary of options.
894 .B \-hardframedrop (experimental without \-nocorrect\-pts)
895 More intense frame dropping (breaks decoding).
896 Leads to image distortion!
897 Note that especially the libmpeg2 decoder may crash with this,
898 so consider using "\-vc ffmpeg12,".
902 Command that is executed every 30 seconds during playback via system() -
903 i.e.\& using the shell.
906 MPlayer uses this command without any checking, it is your responsibility
907 to ensure it does not cause security problems (e.g.\& make sure to use full
908 paths if "." is in your path like on Windows).
909 It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
911 This can be "misused" to disable screensavers that do not support the proper
912 X API (also see \-stop\-xscreensaver).
913 If you think this is too complicated, ask the author of the screensaver
914 program to support the proper X APIs.
916 .I EXAMPLE for xscreensaver:
917 mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
919 .I EXAMPLE for GNOME screensaver:
920 mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
926 Shorthand for \-msglevel identify=4.
927 Show file parameters in an easily parseable format.
928 Also prints more detailed information about subtitle and audio
929 track languages and IDs.
930 In some cases you can get more information by using \-msglevel identify=6.
931 For example, for a DVD it will list the chapters and time length of each title,
932 as well as a disk ID.
933 Combine this with \-frames 0 to suppress all output.
934 The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
935 (hopefully) shellescapes the filenames.
938 .B \-idle (also see \-slave)
939 Makes MPlayer wait idly instead of quitting when there is no file to play.
940 Mostly useful in slave mode where MPlayer can be controlled
941 through input commands.
944 .B \-input <commands>
945 This option can be used to configure certain parts of the input system.
946 Paths are relative to ~/.mplayer/.
949 Autorepeat is currently only supported by joysticks.
951 Available commands are:
956 Specify input configuration file other than the default
957 ~/\:.mplayer/\:input.conf.
958 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
960 Device to be used for Apple IR Remote (default is autodetected, Linux only).
962 Delay in milliseconds before we start to autorepeat a key (0 to disable).
964 Number of key presses to generate per second on autorepeat.
965 .IPs (no)default-bindings
966 Use the key bindings that MPlayer ships with by default.
968 Prints all keys that can be bound to commands.
970 Prints all commands that can be bound to keys.
972 Specifies the joystick device to use (default: /dev/\:input/\:js0).
974 Read commands from the given file.
975 Mostly useful with a FIFO.
978 When the given file is a FIFO MPlayer opens both ends so you can do
979 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
984 .B \-key\-fifo\-size <2\-65000>
985 Specify the size of the FIFO that buffers key events (default: 7).
986 A FIFO of size n can buffer (n\-1) events.
987 If it is too small some events may be lost
988 (leading to "stuck mouse buttons" and similar effects).
989 If it is too big, MPlayer may seem to hang while it
990 processes the buffered events.
991 To get the same behavior as before this option was introduced,
992 set it to 2 for Linux or 1024 for Windows.
995 .B \-lircconf <filename> (LIRC only)
996 Specifies a configuration file for LIRC (default: ~/.lircrc).
999 .B \-list\-properties
1000 Print a list of the available properties.
1004 Loops movie playback <number> times.
1008 .B \-menu (OSD menu only)
1009 Turn on OSD menu support.
1012 .B \-menu\-cfg <filename> (OSD menu only)
1013 Use an alternative menu.conf.
1016 .B \-menu\-chroot <path> (OSD menu only)
1017 Chroot the file selection menu to a specific location.
1022 .IPs "\-menu\-chroot /home"
1023 Will restrict the file selection menu to /\:home and downward (i.e.\& no
1024 access to / will be possible, but /home/user_name will).
1029 .B \-menu\-keepdir (OSD menu only)
1030 File browser starts from the last known location instead of current directory.
1033 .B \-menu\-root <value> (OSD menu only)
1034 Specify the main menu.
1037 .B \-menu\-startup (OSD menu only)
1038 Display the main menu at MPlayer startup.
1041 .B \-mouse\-movements
1042 Permit MPlayer to receive pointer events reported by the video
1044 Necessary to select the buttons in DVD menus.
1045 Supported for X11 based VOs (x11, xv, xvmc, etc.) and the gl, gl2, direct3d and
1050 Turns off AppleIR remote support.
1053 .B \-noconsolecontrols
1054 Prevent MPlayer from reading key events from standard input.
1055 Useful when reading data from standard input.
1056 This is automatically enabled when \- is found on the command line.
1057 There are situations where you have to set it manually, e.g.\&
1058 if you open /dev/\:stdin (or the equivalent on your system), use stdin
1059 in a playlist or intend to read from stdin later on via the loadfile or
1060 loadlist slave commands.
1064 Turns off joystick support.
1068 Turns off LIRC support.
1072 Disable mouse button press/\:release input (mozplayerxp's context menu relies
1075 .B \-noorderedchapters
1076 Disable support for Matroska ordered chapters.
1077 MPlayer will not load or search for video segments from other files,
1078 and will also ignore any chapter order specified for the main file.
1082 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
1084 This wakes up the process every 1/1024 seconds to check the current time.
1085 Useless with modern Linux kernels configured for desktop use as they already
1086 wake up the process with similar accuracy when using normal timed sleep.
1089 .B \-playing\-msg <string>
1090 Print out a string before starting playback.
1091 The following expansions are supported:
1094 Expand to the value of the property NAME.
1096 Expand TEXT only if the property NAME is available.
1098 Expand TEXT only if the property NAME is not available.
1102 .B \-playlist <filename>
1103 Play files according to a playlist file (ASX, Winamp, SMIL, or
1104 one-file-per-line format).
1107 This option is considered an entry so options found after it will apply
1108 only to the elements of this playlist.
1110 FIXME: This needs to be clarified and documented thoroughly.
1113 .B \-rtc\-device <device>
1114 Use the specified device for RTC timing.
1118 Play files in random order.
1121 .B \-skin <name> (GUI only)
1122 Loads a skin from the directory given as parameter below the default skin
1123 directories, /usr/\:local/\:share/\:mplayer/\:skins/\: and ~/.mplayer/\:skins/.
1128 .IPs "\-skin fittyfene"
1129 Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
1130 and afterwards ~/.mplayer/\:skins/\:fittyfene.
1135 .B \-slave (also see \-input)
1136 Switches on slave mode, in which MPlayer works as a backend for other programs.
1137 Instead of intercepting keyboard events, MPlayer will read commands separated
1138 by a newline (\\n) from stdin.
1141 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
1142 for their description.
1143 Also, this is not intended to disable other inputs, e.g.\& via the video window,
1144 use some other method like \-input nodefault\-binds:conf=/dev/null for that.
1148 Time frames by repeatedly checking the current time instead of asking the
1149 kernel to wake up MPlayer at the correct time.
1150 Useful if your kernel timing is imprecise and you cannot use the RTC either.
1151 Comes at the price of higher CPU consumption.
1155 Skip <sec> seconds after every frame.
1156 The normal framerate of the movie is kept, so playback is accelerated.
1157 Since MPlayer can only seek to the next keyframe this may be inexact.
1161 .SH "DEMUXER/STREAM OPTIONS"
1165 Select the Dynamic Range Compression level for AC-3 audio streams.
1166 <level> is a float value ranging from 0 to 1, where 0 means no compression
1167 and 1 (which is the default) means full compression (make loud passages more
1168 silent and vice versa).
1169 This option only shows an effect if the AC-3 stream contains the required range
1170 compression information.
1173 .B \-aid <ID> (also see \-alang)
1174 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1175 VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1176 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1177 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1178 (if present) with the chosen audio stream.
1181 .B \-ausid <ID> (also see \-alang)
1182 Select audio substream channel.
1183 Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled
1184 by the native demuxer (not by libavformat).
1185 The format type may not be correctly identified because of how this information
1186 (or lack thereof) is embedded in the stream, but it will demux correctly the
1187 audio streams when multiple substreams are present.
1188 MPlayer prints the available substream IDs when run with \-identify.
1191 .B \-alang <language code[,language code,...]> (also see \-aid)
1192 Specify a priority list of audio languages to use.
1193 Different container formats employ different language codes.
1194 DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
1195 use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
1196 MPlayer prints the available languages when run in verbose (\-v) mode.
1201 .IPs "mplayer dvd://1 \-alang hu,en"
1202 Chooses the Hungarian language track on a DVD and falls back on English if
1203 Hungarian is not available.
1204 .IPs "mplayer \-alang jpn example.mkv"
1205 Plays a Matroska file in Japanese.
1210 .B \-audio\-demuxer <[+]name> (\-audiofile only)
1211 Force audio demuxer type for \-audiofile.
1212 Use a '+' before the name to force it, this will skip some checks!
1213 Give the demuxer name as printed by \-audio\-demuxer help.
1214 For backward compatibility it also accepts the demuxer ID as defined in
1215 libmpdemux/\:demuxer.h.
1216 \-audio\-demuxer audio or \-audio\-demuxer 17 forces MP3.
1219 .B \-audiofile <filename>
1220 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1224 .B \-audiofile\-cache <kBytes>
1225 Enables caching for the stream used by \-audiofile, using the specified
1229 .B \-reuse\-socket (udp:// only)
1230 Allows a socket to be reused by other processes as soon as it is closed.
1233 .B \-bandwidth <value> (network only)
1234 Specify the maximum bandwidth for network streaming (for servers that are
1235 able to send content in different bitrates).
1236 Useful if you want to watch live streamed media behind a slow connection.
1237 With Real RTSP streaming, it is also used to set the maximum delivery
1238 bandwidth allowing faster cache filling and stream dumping.
1242 This option specifies how much memory (in kBytes) to use when precaching a
1244 Especially useful on slow media.
1251 .B \-cache\-min <percentage>
1252 Playback will start when the cache has been filled up to <percentage>
1256 .B \-cache\-seek\-min <percentage>
1257 If a seek is to be made to a position within <percentage> of the cache size
1258 from the current position, MPlayer will wait for the cache to be filled to
1259 this position rather than performing a stream seek (default: 50).
1262 .B \-cdda <option1:option2> (CDDA only)
1263 This option can be used to tune the CD Audio reading feature of MPlayer.
1265 Available options are:
1269 .IPs paranoia=<0\-2>
1271 Values other than 0 seem to break playback of anything but the first track.
1273 0: disable checking (default)
1275 1: overlap checking only
1277 2: full data correction and verification
1279 .IPs generic-dev=<value>
1280 Use specified generic SCSI device.
1281 .IPs sector-size=<value>
1282 Set atomic read size.
1283 .IPs overlap=<value>
1284 Force minimum overlap search during verification to <value> sectors.
1286 Assume that the beginning offset of track 1 as reported in the TOC will be
1288 Some Toshiba drives need this for getting track boundaries correct.
1289 .IPs toc-offset=<value>
1290 Add <value> sectors to the values reported when addressing tracks.
1293 (Never) accept imperfect data reconstruction.
1297 .B \-cdrom\-device <path to device>
1298 Specify the CD-ROM device (default: /dev/\:cdrom).
1301 .B \-channels <number> (also see \-af channels)
1302 Request the number of playback channels (default: 2).
1303 MPlayer asks the decoder to decode the audio into as many channels as
1305 Then it is up to the decoder to fulfill the requirement.
1306 This is usually only important when playing videos with AC-3 audio (like DVDs).
1307 In that case liba52 does the decoding by default and correctly downmixes the
1308 audio into the requested number of channels.
1309 To directly control the number of output channels independently of how many
1310 channels are decoded, use the channels filter.
1313 This option is honored by codecs (AC-3 only), filters (surround) and audio
1314 output drivers (OSS at least).
1316 Available options are:
1330 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1331 Specify which chapter to start playing at.
1332 Optionally specify which chapter to end playing at (default: 1).
1335 .B \-cookies (network only)
1336 Send cookies when making HTTP requests.
1339 .B \-cookies\-file <filename> (network only)
1340 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1341 and skip reading from default locations.
1342 The file is assumed to be in Netscape format.
1346 audio delay in seconds (positive or negative float value)
1348 Negative values delay the audio, and positive values delay the video.
1349 Note that this is the exact opposite of the \-audio\-delay MEncoder option.
1352 When used with MEncoder, this is not guaranteed to work correctly
1353 with \-ovc copy; use \-audio\-delay instead.
1357 Ignore the specified starting time for streams in AVI files.
1358 In MPlayer, this nullifies stream delays in files encoded with
1359 the \-audio\-delay option.
1360 During encoding, this option prevents MEncoder from transferring
1361 original stream start times to the new file; the \-audio\-delay option is
1363 Note that MEncoder sometimes adjusts stream starting times
1364 automatically to compensate for anticipated decoding delays, so do not
1365 use this option for encoding without testing it first.
1368 .B \-demuxer <[+]name>
1370 Use a '+' before the name to force it, this will skip some checks!
1371 Give the demuxer name as printed by \-demuxer help.
1372 For backward compatibility it also accepts the demuxer ID as defined in
1373 libmpdemux/\:demuxer.h.
1376 .B \-dumpaudio (MPlayer only)
1377 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
1378 in most other cases the resulting file will not be playable).
1379 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1380 on the command line only the last one will work.
1383 .B \-dumpfile <filename> (MPlayer only)
1384 Specify which file MPlayer should dump to.
1385 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
1388 .B \-dumpstream (MPlayer only)
1389 Dumps the raw stream to ./stream.dump.
1390 Useful when ripping from DVD or network.
1391 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1392 on the command line only the last one will work.
1395 .B \-dumpvideo (MPlayer only)
1396 Dump raw compressed video stream to ./stream.dump (not very usable).
1397 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1398 on the command line only the last one will work.
1401 .B \-dvbin <options> (DVB only)
1402 Pass the following parameters to the DVB input module, in order to override
1408 Specifies using card number 1\-4 (default: 1).
1409 .IPs file=<filename>
1410 Instructs MPlayer to read the channels list from <filename>.
1411 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1412 or ~/.mplayer/\:channels.conf as a last resort.
1413 .IPs timeout=<1\-30>
1414 Maximum number of seconds to wait when trying to tune a
1415 frequency before giving up (default: 30).
1420 .B \-dvd\-device <path to device> (DVD only)
1421 Specify the DVD device or .iso filename (default: /dev/\:dvd).
1422 You can also specify a directory that contains files previously copied directly
1423 from a DVD (with e.g.\& vobcopy).
1426 .B \-dvd\-speed <factor or speed in KB/s> (DVD only)
1427 Try to limit DVD speed (default: 0, no change).
1428 DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
1430 Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
1431 quiet and fast enough.
1432 MPlayer resets the speed to the drive default value on close.
1433 Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
1437 You need write access to the DVD device to change the speed.
1440 .B \-dvdangle <angle ID> (DVD only)
1441 Some DVD discs contain scenes that can be viewed from multiple angles.
1442 Here you can tell MPlayer which angles to use (default: 1).
1446 Enables edit decision list (EDL) actions during playback.
1447 Video will be skipped over and audio will be muted and unmuted according to
1448 the entries in the given file.
1449 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1453 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1454 Stop at given time or byte position.
1457 Byte position is enabled only for MEncoder and will not be accurate, as it can
1458 only stop at a frame boundary.
1459 When used in conjunction with \-ss option, \-endpos time will shift forward by
1460 seconds specified with \-ss.
1467 .IPs "\-endpos 01:10:00"
1468 Stop at 1 hour 10 minutes.
1469 .IPs "\-ss 10 \-endpos 56"
1470 Stop at 1 minute 6 seconds.
1471 .IPs "\-endpos 100mb"
1478 Force index rebuilding.
1479 Useful for files with broken index (A/V desync, etc).
1480 This will enable seeking in files where seeking was not possible.
1481 You can fix the index permanently with MEncoder (see the documentation).
1484 This option only works if the underlying media supports seeking
1485 (i.e.\& not with stdin, pipe, etc).
1488 .B \-fps <float value>
1489 Override video framerate.
1490 Useful if the original value is wrong or missing.
1493 .B \-frames <number>
1494 Play/\:convert only first <number> frames, then quit.
1497 .B \-hr\-mp3\-seek (MP3 only)
1499 Enabled when playing from an external MP3 file, as we need to seek
1500 to the very exact position to keep A/V sync.
1501 Can be slow especially when seeking backwards since it has to rewind
1502 to the beginning to find an exact frame position.
1505 .B \-idx (also see \-forceidx)
1506 Rebuilds index of files if no index was found, allowing seeking.
1507 Useful with broken/\:incomplete downloads, or badly created files.
1510 This option only works if the underlying media supports seeking
1511 (i.e.\& not with stdin, pipe, etc).
1515 Skip rebuilding index file.
1516 MEncoder skips writing the index with this option.
1519 .B \-ipv4\-only\-proxy (network only)
1520 Skip the proxy for IPv6 addresses.
1521 It will still be used for IPv4 connections.
1524 .B \-loadidx <index file>
1525 The file from which to read the video index data saved by \-saveidx.
1526 This index will be used for seeking, overriding any index data
1527 contained in the AVI itself.
1528 MPlayer will not prevent you from loading an index file generated
1529 from a different AVI, but this is sure to cause unfavorable results.
1532 This option is obsolete now that MPlayer has OpenDML support.
1535 .B \-mc <seconds/frame>
1536 maximum A-V sync correction per frame (in seconds)
1539 .B \-mf <option1:option2:...>
1540 Used when decoding from multiple PNG or JPEG files.
1542 Available options are:
1547 input file width (default: autodetect)
1549 input file height (default: autodetect)
1551 output fps (default: 25)
1553 input file type (available: jpeg, png, tga, sgi)
1559 Force usage of non-interleaved AVI parser (fixes playback
1560 of some bad AVI files).
1563 .B \-nobps (AVI only)
1564 Do not use average byte/\:second value for A-V sync.
1565 Helps with some AVI files with broken header.
1569 Disables extension-based demuxer selection.
1570 By default, when the file type (demuxer) cannot be detected reliably
1571 (the file has no header or it is not reliable enough), the filename
1572 extension is used to select the demuxer.
1573 Always falls back on content-based demuxer selection.
1576 .B \-passwd <password> (also see \-user) (network only)
1577 Specify password for HTTP authentication.
1580 .B \-prefer\-ipv4 (network only)
1581 Use IPv4 on network connections.
1582 Falls back on IPv6 automatically.
1585 .B \-prefer\-ipv6 (IPv6 network only)
1586 Use IPv6 on network connections.
1587 Falls back on IPv4 automatically.
1590 .B \-psprobe <byte position>
1591 When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
1592 how many bytes in the stream you want MPlayer to scan in order to identify
1593 the video codec used.
1594 This option is needed to play EVO or VDR files containing H.264 streams.
1597 .B \-pvr <option1:option2:...> (PVR only)
1598 This option tunes various encoding properties of the PVR capture module.
1599 It has to be used with any hardware MPEG encoder based card supported by the
1601 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1602 cards are known as PVR capture cards.
1603 Be aware that only Linux 2.6.18 kernel
1604 and above is able to handle MPEG stream through V4L2 layer.
1605 For hardware capture of an MPEG stream and watching it with
1606 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1608 Available options are:
1611 Specify input aspect ratio:
1621 .IPs arate=<32000\-48000>
1622 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1625 Specify MPEG audio layer encoding (default: 2).
1626 .IPs abitrate=<32\-448>
1627 Specify audio encoding bitrate in kbps (default: 384).
1629 Specify audio encoding mode.
1630 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1631 .IPs vbitrate=<value>
1632 Specify average video bitrate encoding in Mbps (default: 6).
1634 Specify video encoding mode:
1636 vbr: Variable BitRate (default)
1638 cbr: Constant BitRate
1641 Specify peak video bitrate encoding in Mbps
1642 (only useful for VBR encoding, default: 9.6).
1644 Choose an MPEG format for encoding:
1646 ps: MPEG-2 Program Stream (default)
1648 ts: MPEG-2 Transport Stream
1650 mpeg1: MPEG-1 System Stream
1652 vcd: Video CD compatible stream
1654 svcd: Super Video CD compatible stream
1656 dvd: DVD compatible stream
1662 .B \-radio <option1:option2:...> (radio only)
1663 These options set various parameters of the radio capture module.
1664 For listening to radio with MPlayer use 'radio://<frequency>'
1665 (if channels option is not given) or 'radio://<channel_number>'
1666 (if channels option is given) as a movie URL.
1667 You can see allowed frequency range by running MPlayer with '\-v'.
1668 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1669 If the capture keyword is not given you can listen to radio
1670 using the line-in cable only.
1671 Using capture to listen is not recommended due to synchronization
1672 problems, which makes this process uncomfortable.
1674 Available options are:
1677 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1679 Radio driver to use (default: v4l2 if available, otherwise v4l).
1680 Currently, v4l and v4l2 drivers are supported.
1681 .IPs volume=<0..100>
1682 sound volume for radio device (default 100)
1683 .IPs "freq_min=<value> (*BSD BT848 only)"
1684 minimum allowed frequency (default: 87.50)
1685 .IPs "freq_max=<value> (*BSD BT848 only)"
1686 maximum allowed frequency (default: 108.00)
1687 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1689 Use _ for spaces in names (or play with quoting ;-).
1690 The channel names will then be written using OSD and the slave commands
1691 radio_step_channel and radio_set_channel will be usable for
1692 a remote control (see LIRC).
1693 If given, number in movie URL will be treated as channel position in
1697 radio://1, radio://104.4, radio_set_channel 1
1698 .IPs "adevice=<value> (radio capture only)"
1699 Name of device to capture sound from.
1700 Without such a name capture will be disabled,
1701 even if the capture keyword appears in the URL.
1702 For ALSA devices use it in the form hw=<card>.<device>.
1703 If the device name contains a '=', the module will use
1704 ALSA to capture, otherwise OSS.
1705 .IPs "arate=<value> (radio capture only)"
1706 Rate in samples per second (default: 44100).
1709 When using audio capture set also \-rawaudio rate=<value> option
1710 with the same value as arate.
1711 If you have problems with sound speed (runs too quickly), try to play
1712 with different rate values (e.g.\& 48000,44100,32000,...).
1713 .IPs "achannels=<value> (radio capture only)"
1714 Number of audio channels to capture.
1718 .B \-rawaudio <option1:option2:...>
1719 This option lets you play raw audio files.
1720 You have to use \-demuxer rawaudio as well.
1721 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1722 For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1724 Available options are:
1728 .IPs channels=<value>
1731 rate in samples per second
1732 .IPs samplesize=<value>
1733 sample size in bytes
1734 .IPs bitrate=<value>
1735 bitrate for rawaudio files
1742 .B \-rawvideo <option1:option2:...>
1743 This option lets you play raw video files.
1744 You have to use \-demuxer rawvideo as well.
1746 Available options are:
1751 rate in frames per second (default: 25.0)
1752 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1753 set standard image size
1755 image width in pixels
1757 image height in pixels
1758 .IPs i420|yv12|yuy2|y8
1761 colorspace (fourcc) in hex or string constant.
1762 Use \-rawvideo format=help for a list of possible strings.
1772 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1773 Play the famous "foreman" sample video.
1774 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1775 Play a raw YUV sample.
1781 Used with 'rtsp://' URLs to force the client's port number.
1782 This option may be useful if you are behind a router and want to forward
1783 the RTSP stream from the server to a specific client.
1786 .B \-rtsp\-destination
1787 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1788 This option may be useful with some RTSP server which do not
1789 send RTP packets to the right interface.
1790 If the connection to the RTSP server fails, use \-v to see
1791 which IP address MPlayer tries to bind to and try to force
1792 it to one assigned to your computer instead.
1795 .B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
1796 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1797 packets be streamed over TCP (using the same TCP connection as RTSP).
1798 This option may be useful if you have a broken internet connection that does
1799 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1802 .B \-saveidx <filename>
1803 Force index rebuilding and dump the index to <filename>.
1804 Currently this only works with AVI files.
1807 This option is obsolete now that MPlayer has OpenDML support.
1810 .B \-sb <byte position> (also see \-ss)
1811 Seek to byte position.
1812 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1815 .B \-speed <0.01\-100>
1816 Slow down or speed up playback by the factor given as parameter.
1817 Not guaranteed to work correctly with \-oac copy.
1821 Selects the output sample rate to be used
1822 (of course sound cards have limits on this).
1823 If the sample frequency selected is different from that
1824 of the current media, the resample or lavcresample audio filter will be inserted
1825 into the audio filter layer to compensate for the difference.
1826 The type of resampling can be controlled by the \-af\-adv option.
1827 The default is fast resampling that may cause distortion.
1830 .B \-ss <time> (also see \-sb)
1831 Seek to given time position.
1837 Seeks to 56 seconds.
1838 .IPs "\-ss 01:10:00"
1839 Seeks to 1 hour 10 min.
1845 Tells MPlayer not to discard TS packets reported as broken in the stream.
1846 Sometimes needed to play corrupted MPEG-TS files.
1849 .B \-tsprobe <byte position>
1850 When playing an MPEG-TS stream, this option lets you specify how many
1851 bytes in the stream you want MPlayer to search for the desired
1852 audio and video IDs.
1855 .B \-tsprog <1\-65534>
1856 When playing an MPEG-TS stream, you can specify with this option which
1857 program (if present) you want to play.
1858 Can be used with \-vid and \-aid.
1861 .B \-tv <option1:option2:...> (TV/\:PVR only)
1862 This option tunes various properties of the TV capture module.
1863 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
1864 or even 'tv://<channel_name> (see option channels for channel_name below)
1866 You can also use 'tv:///<input_id>' to start watching a
1867 movie from a composite or S-Video input (see option input for details).
1869 Available options are:
1873 .IPs "automute=<0\-255> (v4l and v4l2 only)"
1874 If signal strength reported by device is less than this value,
1875 audio and video will be muted.
1876 In most cases automute=100 will be enough.
1877 Default is 0 (automute disabled).
1879 See \-tv driver=help for a list of compiled-in TV input drivers.
1880 available: dummy, v4l, v4l2, bsdbt848 (default: autodetect)
1882 Specify TV device (default: /dev/\:video0).
1884 For the bsdbt848 driver you can provide both bktr and tuner device
1885 names separating them with a comma, tuner after
1886 bktr (e.g.\& -tv device=/dev/bktr1,/dev/tuner1).
1888 Specify input (default: 0 (TV), see console output for available inputs).
1890 Specify the frequency to set the tuner to (e.g.\& 511.250).
1891 Not compatible with the channels parameter.
1893 Specify the output format of the tuner with a preset value supported by the
1894 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1895 arbitrary format given as hex value.
1896 Try outfmt=help for a list of all available formats.
1900 output window height
1902 framerate at which to capture video (frames per second)
1903 .IPs buffersize=<value>
1904 maximum size of the capture buffer in megabytes (default: dynamical)
1906 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
1907 For v4l2, see the console output for a list of all available norms,
1908 also see the normid option below.
1909 .IPs "normid=<value> (v4l2 only)"
1910 Sets the TV norm to the given numeric ID.
1911 The TV norm depends on the capture card.
1912 See the console output for a list of available TV norms.
1913 .IPs channel=<value>
1914 Set tuner to <value> channel.
1915 .IPs chanlist=<value>
1916 available: europe-east, europe-west, us-bcast, us-cable, etc
1917 .IPs channels=<chan>\-<name>[=<norm>],<chan>\-<name>[=<norm>],...
1918 Set names for channels.
1920 If <chan> is an integer greater than 1000, it will be treated as frequency (in kHz)
1921 rather than channel name from frequency table.
1923 Use _ for spaces in names (or play with quoting ;-).
1924 The channel names will then be written using OSD, and the slave commands
1925 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
1926 a remote control (see LIRC).
1927 Not compatible with the frequency parameter.
1930 The channel number will then be the position in the 'channels' list,
1934 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
1935 .IPs [brightness|contrast|hue|saturation]=<\-100\-100>
1936 Set the image equalizer on the card.
1937 .IPs audiorate=<value>
1938 Set audio capture bitrate.
1940 Capture audio even if there are no audio sources reported by v4l.
1944 Choose an audio mode:
1954 .IPs forcechan=<1\-2>
1955 By default, the count of recorded audio channels is determined automatically
1956 by querying the audio mode from the TV card.
1957 This option allows forcing stereo/\:mono recording regardless of the amode
1958 option and the values returned by v4l.
1959 This can be used for troubleshooting when the TV card is unable to report the
1961 .IPs adevice=<value>
1962 Set an audio device.
1963 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
1964 You must replace any ':' by a '.' in the hardware ID for ALSA.
1965 .IPs audioid=<value>
1966 Choose an audio output of the capture card, if it has more than one.
1967 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
1968 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
1969 These options set parameters of the mixer on the video capture card.
1970 They will have no effect, if your card does not have one.
1971 For v4l2 50 maps to the default value of the
1972 control, as reported by the driver.
1973 .IPs "gain=<0\-100> (v4l2)"
1974 Set gain control for video devices (usually webcams) to the desired
1975 value and switch off automatic control.
1976 A value of 0 enables automatic control.
1977 If this option is omitted, gain control will not be modified.
1978 .IPs immediatemode=<bool>
1979 A value of 0 means capture and buffer audio and video together
1980 (default for MEncoder).
1981 A value of 1 (default for MPlayer) means to do video capture only and let the
1982 audio go through a loopback cable from the TV card to the sound card.
1984 Use hardware MJPEG compression (if the card supports it).
1985 When using this option, you do not need to specify the width and height
1986 of the output window, because MPlayer will determine it automatically
1987 from the decimation value (see below).
1988 .IPs decimation=<1|2|4>
1989 choose the size of the picture that will be compressed by hardware
2004 .IPs quality=<0\-100>
2005 Choose the quality of the JPEG compression
2006 (< 60 recommended for full size).
2007 .IPs tdevice=<value>
2008 Specify TV teletext device (example: /dev/\:vbi0) (default: none).
2009 .IPs tformat=<format>
2010 Specify TV teletext display format (default: 0):
2016 2: opaque with inverted colors
2018 3: transparent with inverted colors
2020 .IPs tpage=<100\-899>
2021 Specify initial TV teletext page number (default: 100).
2022 .IPs tlang=<\-1\-127>
2023 Specify default teletext language code (default: 0), which will be used
2024 as primary language until a type 28 packet is received.
2025 Useful when the teletext system uses a non-latin character set, but language
2026 codes are not transmitted via teletext type 28 packets for some reason.
2027 To see a list of supported language codes set this option to \-1.
2028 .IPs "hidden_video_renderer (dshow only)"
2029 Terminate stream with video renderer instead of Null renderer (default: off).
2030 Will help if video freezes but audio does not.
2032 May not work with \-vo directx and \-vf crop combination.
2033 .IPs "hidden_vp_renderer (dshow only)"
2034 Terminate VideoPort pin stream with video renderer
2035 instead of removing it from the graph (default: off).
2036 Useful if your card has a VideoPort pin and video is choppy.
2038 May not work with \-vo directx and \-vf crop combination.
2039 .IPs "system_clock (dshow only)"
2040 Use the system clock as sync source instead of the default graph clock
2041 (usually the clock from one of the live sources in graph).
2042 .IPs "normalize_audio_chunks (dshow only)"
2043 Create audio chunks with a time length equal to
2044 video frame time length (default: off).
2045 Some audio cards create audio chunks about 0.5s in size, resulting in
2046 choppy video when using immediatemode=0.
2050 .B \-tvscan <option1:option2:...> (TV and MPlayer only)
2051 Tune the TV channel scanner.
2052 MPlayer will also print value for "-tv channels=" option,
2053 including existing and just found channels.
2055 Available suboptions are:
2058 Begin channel scanning immediately after startup (default: disabled).
2059 .IPs period=<0.1\-2.0>
2060 Specify delay in seconds before switching to next channel (default: 0.5).
2061 Lower values will cause faster scanning, but can detect
2062 inactive TV channels as active.
2063 .IPs threshold=<1\-100>
2064 Threshold value for the signal strength (in percent), as reported
2065 by the device (default: 50).
2066 A signal strength higher than this value will indicate that the
2067 currently scanning channel is active.
2071 .B \-user <username> (also see \-passwd) (network only)
2072 Specify username for HTTP authentication.
2075 .B \-user\-agent <string>
2076 Use <string> as user agent for HTTP streaming.
2080 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
2081 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
2082 (if present) with the chosen video stream.
2085 .B \-vivo <suboption> (DEBUG CODE)
2086 Force audio parameters for the VIVO demuxer (for debugging purposes).
2087 FIXME: Document this.
2091 .SH "OSD/SUBTITLE OPTIONS"
2093 Also see \-vf expand.
2096 .B \-ass (FreeType only)
2097 Turn on SSA/ASS subtitle rendering.
2098 With this option, libass will be used for SSA/ASS
2099 external subtitles and Matroska tracks.
2100 You may also want to use \-embeddedfonts.
2103 Unlike normal OSD, libass uses fontconfig by default. To disable it, use
2107 .B \-ass\-border\-color <value>
2108 Sets the border (outline) color for text subtitles.
2109 The color format is RRGGBBAA.
2112 .B \-ass\-bottom\-margin <value>
2113 Adds a black band at the bottom of the frame.
2114 The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
2117 .B \-ass\-color <value>
2118 Sets the color for text subtitles.
2119 The color format is RRGGBBAA.
2122 .B \-ass\-font\-scale <value>
2123 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
2126 .B \-ass\-force\-style <[Style.]Param=Value[,...]>
2127 Override some style or script info parameters.
2132 \-ass\-force\-style FontName=Arial,Default.Bold=1
2134 \-ass\-force\-style PlayResY=768
2139 .B \-ass\-hinting <type>
2147 FreeType autohinter, light mode
2149 FreeType autohinter, normal mode
2153 The same, but hinting will only be performed if the OSD is rendered at
2154 screen resolution and will therefore not be scaled.
2157 The default value is 7 (use native hinter for unscaled OSD and no hinting otherwise).
2162 .B \-ass\-line\-spacing <value>
2163 Set line spacing value for SSA/ASS renderer.
2166 .B \-ass\-styles <filename>
2167 Load all SSA/ASS styles found in the specified file and use them for
2168 rendering text subtitles.
2169 The syntax of the file is exactly like the
2170 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
2173 .B \-ass\-top\-margin <value>
2174 Adds a black band at the top of the frame.
2175 The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
2178 .B \-ass\-use\-margins
2179 Enables placing toptitles and subtitles in black borders when they
2183 .B \-dumpjacosub (MPlayer only)
2184 Convert the given subtitle (specified with the \-sub option) to the time-based
2185 JACOsub subtitle format.
2186 Creates a dumpsub.js file in the current directory.
2189 .B \-dumpmicrodvdsub (MPlayer only)
2190 Convert the given subtitle (specified with the \-sub option) to the
2191 MicroDVD subtitle format.
2192 Creates a dumpsub.sub file in the current directory.
2195 .B \-dumpmpsub (MPlayer only)
2196 Convert the given subtitle (specified with the \-sub option) to MPlayer's
2197 subtitle format, MPsub.
2198 Creates a dump.mpsub file in the current directory.
2201 .B \-dumpsami (MPlayer only)
2202 Convert the given subtitle (specified with the \-sub option) to the time-based
2203 SAMI subtitle format.
2204 Creates a dumpsub.smi file in the current directory.
2207 .B \-dumpsrtsub (MPlayer only)
2208 Convert the given subtitle (specified with the \-sub option) to the time-based
2209 SubViewer (SRT) subtitle format.
2210 Creates a dumpsub.srt file in the current directory.
2213 Some broken hardware players choke on SRT subtitle files with Unix
2215 If you are unlucky enough to have such a box, pass your subtitle
2216 files through unix2dos or a similar program to replace Unix line
2217 endings with DOS/Windows line endings.
2220 .B \-dumpsub (MPlayer only) (BETA CODE)
2221 Dumps the subtitle substream from VOB streams.
2222 Also see the \-dump*sub and \-vobsubout* options.
2225 .B \-embeddedfonts (FreeType only)
2226 Enables extraction of Matroska embedded fonts (default: disabled).
2227 These fonts can be used for SSA/ASS subtitle
2228 rendering (\-ass option).
2229 Font files are created in the ~/.mplayer/\:fonts directory.
2232 With FontConfig 2.4.2 or newer, embedded fonts are opened directly from memory,
2233 and this option is enabled by default.
2236 .B \-ffactor <number>
2237 Resample the font alphamap.
2244 very narrow black outline (default)
2246 narrow black outline
2253 .B \-flip\-hebrew (FriBiDi only)
2254 Turns on flipping subtitles using FriBiDi.
2257 .B \-noflip\-hebrew\-commas
2258 Change FriBiDi's assumptions about the placements of commas in subtitles.
2259 Use this if commas in subtitles are shown at the start of a sentence
2260 instead of at the end.
2263 .B \-font <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
2264 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
2265 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
2266 ~/.mplayer/\:subfont.ttf).
2269 With FreeType, this option determines the path to the text font file.
2270 With Fontconfig, this option determines the Fontconfig font pattern.
2275 \-font ~/\:.mplayer/\:arial-14/\:font.desc
2277 \-font ~/\:.mplayer/\:arialuni.ttf
2279 \-font 'Bitstream Vera Sans'
2281 \-font 'Bitstream Vera Sans:style=Bold'
2286 .B \-fontconfig (fontconfig only)
2287 Enables the usage of fontconfig managed fonts.
2290 By default fontconfig is used for libass-rendered subtitles and not used for
2291 OSD. With \-fontconfig it is used for both libass and OSD, with \-nofontconfig
2292 it is not used at all.
2296 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
2300 .B \-fribidi\-charset <charset name> (FriBiDi only)
2301 Specifies the character set that will be passed to FriBiDi when
2302 decoding non-UTF-8 subtitles (default: ISO8859-8).
2305 .B \-ifo <VOBsub IFO file>
2306 Indicate the file that will be used to load palette and frame size for VOBsub
2311 Turns off automatic subtitle file loading.
2314 .B \-osd\-duration <time>
2315 Set the duration of the OSD messages in ms (default: 1000).
2318 .B \-osdlevel <0\-3> (MPlayer only)
2319 Specifies which mode the OSD should start in.
2325 volume + seek (default)
2327 volume + seek + timer + percentage
2329 volume + seek + timer + percentage + total time
2335 Allows the next subtitle to be displayed while the current one is
2336 still visible (default is to enable the support only for specific
2340 .B \-sid <ID> (also see \-slang, \-vobsubid)
2341 Display the subtitle stream specified by <ID> (0\-31).
2342 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2343 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2346 .B \-slang <language code[,language code,...]> (also see \-sid)
2347 Specify a priority list of subtitle languages to use.
2348 Different container formats employ different language codes.
2349 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2350 three letter language codes while OGM uses a free-form identifier.
2351 MPlayer prints the available languages when run in verbose (\-v) mode.
2356 .IPs "mplayer dvd://1 \-slang hu,en"
2357 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2358 Hungarian is not available.
2359 .IPs "mplayer \-slang jpn example.mkv"
2360 Plays a Matroska file with Japanese subtitles.
2366 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2367 A value of 16 may be added to <mode> in order to force scaling even
2368 when original and scaled frame size already match.
2369 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2370 Available modes are:
2374 none (fastest, very ugly)
2376 approximate (broken?)
2380 bilinear (default, fast and not too bad)
2382 uses swscaler gaussian blur (looks very good)
2387 .B \-spualign <\-1\-2>
2388 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2394 Align at top (original behavior, default).
2403 .B \-spugauss <0.0\-3.0>
2404 Variance parameter of gaussian used by \-spuaa 4.
2405 Higher means more blur (default: 1.0).
2408 .B \-sub <subtitlefile1,subtitlefile2,...>
2409 Use/\:display these subtitle files.
2410 Only one file can be displayed at the same time.
2413 .B \-sub\-bg\-alpha <0\-255>
2414 Specify the alpha channel value for subtitles and OSD backgrounds.
2415 Big values mean more transparency.
2416 0 means completely transparent.
2419 .B \-sub\-bg\-color <0\-255>
2420 Specify the color value for subtitles and OSD backgrounds.
2421 Currently subtitles are grayscale so this value is equivalent to the
2422 intensity of the color.
2423 255 means white and 0 black.
2426 .B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
2427 Force subtitle demuxer type for \-subfile.
2428 Use a '+' before the name to force it, this will skip some checks!
2429 Give the demuxer name as printed by \-sub\-demuxer help.
2430 For backward compatibility it also accepts the demuxer ID as defined in
2434 .B \-sub\-fuzziness <mode>
2435 Adjust matching fuzziness when searching for subtitles:
2441 Load all subs containing movie name.
2443 Load all subs in the current directory.
2448 .B \-sub\-no\-text\-pp
2449 Disables any kind of text post processing done after loading the subtitles.
2450 Used for debug purposes.
2453 .B \-subalign <0\-2>
2454 Specify which edge of the subtitles should be aligned at the height
2459 Align subtitle top edge (original behavior).
2461 Align subtitle center.
2463 Align subtitle bottom edge (default).
2469 Display DVD Closed Caption (CC) subtitles.
2472 the VOB subtitles, these are special ASCII subtitles for the
2473 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2474 CC subtitles have not been spotted on DVDs from other regions so far.
2477 .B \-subcp <codepage> (iconv only)
2478 If your system supports iconv(3), you can use this option to
2479 specify the subtitle codepage.
2491 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2492 You can specify your language using a two letter language code to
2493 make ENCA detect the codepage automatically.
2494 If unsure, enter anything and watch mplayer \-v output for available
2496 Fallback codepage specifies the codepage to use, when autodetection fails.
2501 .IPs "\-subcp enca:cs:latin2"
2502 Guess the encoding, assuming the subtitles are Czech, fall back on
2503 latin 2, if the detection fails.
2504 .IPs "\-subcp enca:pl:cp1250"
2505 Guess the encoding for Polish, fall back on cp1250.
2511 Delays subtitles by <sec> seconds.
2515 .B \-subfile <filename> (BETA CODE)
2517 Same as \-audiofile, but for subtitle streams (OggDS?).
2520 .B \-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
2521 Sets the subtitle font (see \-font).
2522 If no \-subfont is given, \-font is used.
2525 .B \-subfont\-autoscale <0\-3> (FreeType only)
2526 Sets the autoscale mode.
2529 0 means that text scale and OSD scale are font heights in points.
2538 proportional to movie height
2540 proportional to movie width
2542 proportional to movie diagonal (default)
2547 .B \-subfont\-blur <0\-8> (FreeType only)
2548 Sets the font blur radius (default: 2).
2551 .B \-subfont\-encoding <value> (FreeType only)
2552 Sets the font encoding.
2553 When set to 'unicode', all the glyphs from the font file will be rendered and
2554 unicode will be used (default: unicode).
2557 .B \-subfont\-osd\-scale <0\-100> (FreeType only)
2558 Sets the autoscale coefficient of the OSD elements (default: 6).
2561 .B \-subfont\-outline <0\-8> (FreeType only)
2562 Sets the font outline thickness (default: 2).
2565 .B \-subfont\-text\-scale <0\-100> (FreeType only)
2566 Sets the subtitle text autoscale coefficient as percentage of the
2567 screen size (default: 5).
2571 Specify the framerate of the subtitle file (default: movie fps).
2574 <rate> > movie fps speeds the subtitles up for frame-based subtitle files and
2575 slows them down for time-based ones.
2578 .B \-subpos <0\-100> (useful with \-vf expand)
2579 Specify the position of subtitles on the screen.
2580 The value is the vertical position of the subtitle in % of the screen height.
2583 .B \-subwidth <10\-100>
2584 Specify the maximum width of subtitles on the screen.
2586 The value is the width of the subtitle in % of the screen width.
2590 Disable the display of OSD messages on the console when no video output is
2594 .B \-term\-osd\-esc <escape sequence>
2595 Specify the escape sequence to use before writing an OSD message on the
2597 The escape sequence should move the pointer to the beginning of the line
2598 used for the OSD and clear it (default: ^[[A\\r^[[K).
2602 Tells MPlayer to handle the subtitle file as unicode.
2605 .B \-unrarexec <path to unrar executable> (not supported on MingW)
2606 Specify the path to the unrar executable so MPlayer can use it to access
2607 rar-compressed VOBsub files (default: not set, so the feature is off).
2608 The path must include the executable's filename, i.e.\& /usr/local/bin/unrar.
2612 Tells MPlayer to handle the subtitle file as UTF-8.
2615 .B \-vobsub <VOBsub file without extension>
2616 Specify a VOBsub file to use for subtitles.
2617 Has to be the full pathname without extension, i.e.\& without
2618 the '.idx', '.ifo' or '.sub'.
2621 .B \-vobsubid <0\-31>
2622 Specify the VOBsub subtitle ID.
2626 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
2629 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2630 Override audio driver/\:card buffer size detection.
2633 .B \-format <format> (also see the format audio filter)
2634 Select the sample format used for output from the audio filter
2635 layer to the sound card.
2636 The values that <format> can adopt are listed below in the
2637 description of the format audio filter.
2641 Use a mixer device different from the default /dev/\:mixer.
2642 For ALSA this is the mixer name.
2645 .B \-mixer\-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2646 This option will tell MPlayer to use a different channel for controlling
2647 volume than the default PCM.
2648 Options for OSS include
2650 For a complete list of options look for SOUND_DEVICE_NAMES in
2651 /usr/\:include/\:linux/\:soundcard.h.
2652 For ALSA you can use the names e.g.\& alsamixer displays, like
2653 .B Master, Line, PCM.
2656 ALSA mixer channel names followed by a number must be specified in the
2657 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2663 Force the use of the software mixer, instead of using the sound card
2667 .B \-softvol\-max <10.0\-10000.0>
2668 Set the maximum amplification level in percent (default: 110).
2669 A value of 200 will allow you to adjust the volume up to a maximum of
2670 double the current level.
2671 With values below 100 the initial volume (which is 100%) will be above
2672 the maximum, which e.g.\& the OSD cannot display correctly.
2675 .B \-volstep <0\-100>
2676 Set the step size of mixer volume changes in percent of the whole range
2680 .B \-volume <-1\-100> (also see \-af volume)
2681 Set the startup volume in the mixer, either hardware or software (if
2682 used with \-softvol).
2683 A value of -1 (the default) will not change the volume.
2687 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
2688 Audio output drivers are interfaces to different audio output facilities.
2692 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2693 Specify a priority list of audio output drivers to be used.
2695 If the list has a trailing ',' MPlayer will fall back on drivers not
2696 contained in the list.
2697 Suboptions are optional and can mostly be omitted.
2700 See \-ao help for a list of compiled-in audio output drivers.
2705 .IPs "\-ao alsa,oss,"
2706 Try the ALSA driver, then the OSS driver, then others.
2707 .IPs "\-ao alsa:noblock:device=hw=0.3"
2708 Sets noblock-mode and the device-name as first card, fourth device.
2712 Available audio output drivers are:
2716 ALSA 0.9/1.x audio output driver
2721 .IPs device=<device>
2722 Sets the device name.
2723 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2724 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2725 you really know how to set it correctly.
2731 ALSA 0.5 audio output driver
2735 OSS audio output driver
2739 Sets the audio output device (default: /dev/\:dsp).
2741 Sets the audio mixer device (default: /dev/\:mixer).
2742 .IPs <mixer-channel>
2743 Sets the audio mixer channel (default: pcm).
2749 highly platform independent SDL (Simple Directmedia Layer) library
2754 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2760 audio output through the aRts daemon
2764 audio output through the ESD daemon
2768 Explicitly choose the ESD server to use (default: localhost).
2774 audio output through JACK (Jack Audio Connection Kit)
2778 Connects to the ports with the given name (default: physical ports).
2779 .IPs name=<client name>
2780 Client name that is passed to JACK (default: MPlayer [<PID>]).
2781 Useful if you want to have certain connections established automatically.
2783 Estimate the audio delay, supposed to make the video playback smoother
2785 .IPs (no)autostart (default: disabled)
2786 Automatically start jackd if necessary.
2787 Note that this seems unreliable and will spam stdout with server messages.
2793 audio output through NAS
2796 .B coreaudio (Mac OS X only)
2797 native Mac OS X audio output driver
2801 Experimental OpenAL audio output driver
2805 PulseAudio audio output driver
2808 .IPs "[<host>][:<output sink>]"
2809 Specify the host and optionally output sink to use.
2810 An empty <host> string uses a local connection, "localhost"
2811 uses network transfer (most likely not what you want).
2817 native SGI audio output driver
2820 .IPs "<output device name>"
2821 Explicitly choose the output device/\:interface to use
2822 (default: system-wide default).
2823 For example, 'Analog Out' or 'Digital Out'.
2829 native Sun audio output driver
2833 Explicitly choose the audio device to use (default: /dev/\:audio).
2838 .B win32 (Windows only)
2839 native Windows waveout audio output driver
2842 .B dsound (Windows only)
2843 DirectX DirectSound audio output driver
2846 .IPs device=<devicenum>
2847 Sets the device number to use.
2848 Playing a file with \-v will show a list of available devices.
2854 OS/2 DART audio output driver
2858 Open DART in shareable or exclusive mode.
2860 Set buffer size to <size> in samples (default: 2048).
2865 .B dxr2 (also see \-dxr2) (DXR2 only)
2866 Creative DXR2 specific output driver
2870 IVTV specific MPEG audio output driver.
2871 Works with \-ac hwmpa only.
2874 .B v4l2 (requires Linux 2.6.22+ kernel)
2875 Audio output driver for V4L2 cards with hardware MPEG decoder.
2878 .B mpegpes (DVB only)
2879 Audio output driver for DVB cards that writes the output to an MPEG-PES
2880 file if no DVB card is installed.
2884 DVB card to use if more than one card is present.
2885 If not specified MPlayer will search the first usable card.
2886 .IPs file=<filename>
2893 Produces no audio output but maintains video playback speed.
2894 Use \-nosound for benchmarking.
2898 raw PCM/wave file writer audio output
2902 Include or do not include the wave header (default: included).
2903 When not included, raw PCM will be generated.
2904 .IPs file=<filename>
2905 Write the sound to <filename> instead of the default
2907 If nowaveheader is specified, the default is audiodump.pcm.
2909 Try to dump faster than realtime.
2910 Make sure the output does not get truncated (usually with
2911 "Too many video packets in buffer" message).
2912 It is normal that you get a "Your system is too SLOW to play this!" message.
2918 plugin audio output driver
2922 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
2925 .B \-adapter <value>
2926 Set the graphics card that will receive the image.
2927 You can get a list of available cards when you run this option with \-v.
2928 Currently only works with the directx video output driver.
2932 Override the autodetected color depth.
2933 Only supported by the fbdev, dga, svga, vesa video output drivers.
2937 Play movie with window border and decorations.
2938 Since this is on by default, use \-noborder to disable the standard window
2942 .B \-brightness <\-100\-100>
2943 Adjust the brightness of the video signal (default: 0).
2944 Not supported by all video output drivers.
2947 .B \-contrast <\-100\-100>
2948 Adjust the contrast of the video signal (default: 0).
2949 Not supported by all video output drivers.
2952 .B \-display <name> (X11 only)
2953 Specify the hostname and display number of the X server you want to display
2959 \-display xtest.localdomain:0
2965 Turns on direct rendering (not supported by all codecs and video outputs)
2968 May cause OSD/SUB corruption!
2971 .B \-dxr2 <option1:option2:...>
2972 This option is used to control the dxr2 video output driver.
2974 .IPs ar-mode=<value>
2975 aspect ratio mode (0 = normal, 1 = pan-and-scan, 2 = letterbox (default))
2977 Set iec958 output mode to encoded.
2979 Set iec958 output mode to decoded (default).
2980 .IPs macrovision=<value>
2981 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
2982 3 = agc 4 colorstripe)
2988 path to the microcode
2996 enable 7.5 IRE output mode
2998 disable 7.5 IRE output mode (default)
3002 color TV output (default)
3004 interlaced TV output (default)
3006 disable interlaced TV output
3008 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
3010 set pixel mode to square
3012 set pixel mode to ccir601
3019 .IPs cr-left=<0\-500>
3020 Set the left cropping value (default: 50).
3021 .IPs cr-right=<0\-500>
3022 Set the right cropping value (default: 300).
3023 .IPs cr-top=<0\-500>
3024 Set the top cropping value (default: 0).
3025 .IPs cr-bottom=<0\-500>
3026 Set the bottom cropping value (default: 0).
3027 .IPs ck-[r|g|b]=<0\-255>
3028 Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.
3029 .IPs ck-[r|g|b]min=<0\-255>
3030 minimum value for the respective color key
3031 .IPs ck-[r|g|b]max=<0\-255>
3032 maximum value for the respective color key
3034 Ignore cached overlay settings.
3036 Update cached overlay settings.
3038 Enable overlay onscreen display.
3040 Disable overlay onscreen display (default).
3041 .IPs ol[h|w|x|y]-cor=<\-20\-20>
3042 Adjust the overlay size (h,w) and position (x,y) in case it does not
3043 match the window perfectly (default: 0).
3045 Activate overlay (default).
3048 .IPs overlay-ratio=<1\-2500>
3049 Tune the overlay (default: 1000).
3053 .B \-fbmode <modename> (\-vo fbdev only)
3054 Change video mode to the one that is labeled as <modename> in
3058 VESA framebuffer does not support mode changing.
3061 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3062 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
3065 .B \-force\-window\-position
3066 Forcefully move MPlayer's video output window to default location whenever
3067 there is a change in video parameters, video stream or file.
3068 This used to be the default behavior.
3069 Currently only affects X11 VOs.
3072 .B \-fs (also see \-zoom)
3073 Fullscreen playback (centers movie, and paints black bands around it).
3074 Not supported by all video output drivers.
3077 .B \-fsmode\-dontuse <0\-31> (OBSOLETE, use the \-fs option)
3078 Try this option if you still experience fullscreen problems.
3081 .B \-fstype <type1,type2,...> (X11 only)
3082 Specify a priority list of fullscreen modes to be used.
3083 You can negate the modes by prefixing them with '\-'.
3084 If you experience problems like the fullscreen window being covered
3085 by other windows try using a different order.
3088 See \-fstype help for a full list of available modes.
3090 The available types are:
3095 Use the _NETWM_STATE_ABOVE hint if available.
3097 Use the _NETWM_STATE_BELOW hint if available.
3099 Use the _NETWM_STATE_FULLSCREEN hint if available.
3101 Use the _WIN_LAYER hint with the default layer.
3103 Use the _WIN_LAYER hint with the given layer number.
3107 Do not set fullscreen window layer.
3109 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
3117 .IPs layer,stays_on_top,above,fullscreen
3118 Default order, will be used as a fallback if incorrect or
3119 unsupported modes are specified.
3121 Fixes fullscreen switching on OpenBox 1.x.
3126 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
3127 Adjust where the output is on the screen initially.
3128 The x and y specifications are in pixels measured from the top-left of the
3129 screen to the top-left of the image being displayed, however if a percentage
3130 sign is given after the argument it turns the value into a percentage of the
3131 screen size in that direction.
3132 It also supports the standard X11 \-geometry option format.
3133 If an external window is specified using the \-wid option, then the x and
3134 y coordinates are relative to the top-left corner of the window rather
3136 The coordinates are relative to the screen given with \-xineramascreen for
3137 the video output drivers that fully support \-xineramascreen (direct3d, gl, gl2,
3138 vdpau, x11, xv, xvmc).
3141 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
3142 gl, gl2, directx, fbdev and tdfxfb video output drivers.
3148 Places the window at x=50, y=40.
3150 Places the window in the middle of the screen.
3152 Places the window at the middle of the right edge of the screen.
3154 Places the window at the bottom right corner of the screen.
3159 .B \-guiwid <window ID> (also see \-wid) (GUI only)
3160 This tells the GUI to also use an X11 window and stick itself to the bottom
3161 of the video, which is useful to embed a mini-GUI in a browser (with the
3162 MPlayer plugin for instance).
3165 .B \-hue <\-100\-100>
3166 Adjust the hue of the video signal (default: 0).
3167 You can get a colored negative of the image with this option.
3168 Not supported by all video output drivers.
3171 .B \-monitor\-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
3172 Specify the dotclock or pixelclock range of the monitor.
3175 .B \-monitor\-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
3176 Specify the horizontal frequency range of the monitor.
3179 .B \-monitor\-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
3180 Specify the vertical frequency range of the monitor.
3183 .B \-monitoraspect <ratio> (also see \-aspect)
3184 Set the aspect ratio of your monitor or TV screen.
3185 A value of 0 disables a previous setting (e.g.\& in the config file).
3186 Overrides the \-monitorpixelaspect setting if enabled.
3191 \-monitoraspect 4:3 or 1.3333
3193 \-monitoraspect 16:9 or 1.7777
3198 .B \-monitorpixelaspect <ratio> (also see \-aspect)
3199 Set the aspect of a single pixel of your monitor or TV screen (default: 1).
3200 A value of 1 means square pixels
3201 (correct for (almost?) all LCDs).
3205 Disables double buffering, mostly for debugging purposes.
3206 Double buffering fixes flicker by storing two frames in memory, and
3207 displaying one while decoding another.
3208 It can affect OSD negatively, but often removes OSD flickering.
3212 Do not grab the mouse pointer after a video mode change (\-vm).
3213 Useful for multihead setups.
3217 Do not keep window aspect ratio when resizing windows.
3218 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
3219 Furthermore under X11 your window manager has to honor window aspect hints.
3223 Makes the player window stay on top of other windows.
3224 Supported by video output drivers which use X11, except SDL,
3225 as well as directx, corevideo, quartz, ggi and gl2.
3228 .B \-panscan <0.0\-1.0>
3229 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
3230 movie to make it fit a 4:3 display without black bands).
3231 The range controls how much of the image is cropped.
3232 Only works with the xv, xmga, mga, gl, gl2, quartz, corevideo and xvidix
3233 video output drivers.
3236 Values between \-1 and 0 are allowed as well, but highly experimental
3237 and may crash or worse.
3238 Use at your own risk!
3241 .B \-panscanrange <\-19.0\-99.0> (experimental)
3242 Change the range of the pan-and-scan functionality (default: 1).
3243 Positive values mean multiples of the default range.
3244 Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
3245 E.g.\& \-panscanrange \-3 allows a zoom factor of up to 4.
3246 This feature is experimental.
3247 Do not report bugs unless you are using \-vo gl.
3250 .B \-refreshrate <Hz>
3251 Set the monitor refreshrate in Hz.
3252 Currently only supported by \-vo directx combined with the \-vm option.
3256 Play movie in the root window (desktop background).
3257 Desktop background images may cover the movie window, though.
3258 Only works with the x11, xv, xmga, xvidix, quartz, corevideo and directx video output drivers.
3261 .B \-saturation <\-100\-100>
3262 Adjust the saturation of the video signal (default: 0).
3263 You can get grayscale output with this option.
3264 Not supported by all video output drivers.
3267 .B \-screenh <pixels>
3268 Specify the screen height for video output drivers which
3269 do not know the screen resolution like fbdev, x11 and TV-out.
3272 .B \-screenw <pixels>
3273 Specify the screen width for video output drivers which
3274 do not know the screen resolution like fbdev, x11 and TV-out.
3277 .B \-stop\-xscreensaver (X11 only)
3278 Turns off xscreensaver at startup and turns it on again on exit.
3279 If your screensaver supports neither the XSS nor XResetScreenSaver
3280 API please use \-heartbeat\-cmd instead.
3284 Try to change to a different video mode.
3285 Supported by the dga, x11, xv, sdl and directx video output drivers.
3286 If used with the directx video output driver the \-screenw,
3287 \-screenh, \-bpp and \-refreshrate options can be used to set
3288 the new display mode.
3292 Enables VBI for the vesa, dfbmga and svga video output drivers.
3295 .B \-wid <window ID> (also see \-guiwid) (X11, OpenGL and DirectX only)
3296 This tells MPlayer to attach to an existing window.
3297 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
3300 .B \-xineramascreen <\-2\-...>
3301 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
3302 displays) this option tells MPlayer which screen to display the movie on.
3303 A value of \-2 means fullscreen across the whole virtual display (in this case
3304 Xinerama information is completely ignored), \-1 means
3305 fullscreen on the display the window currently is on.
3306 The initial position set via the \-geometry option is relative to the
3308 Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
3309 This option is not suitable to only set the startup screen (because
3310 it will always display on the given screen in fullscreen mode),
3311 \-geometry is the best that is available for that purpose
3313 Supported by at least the direct3d, gl, gl2, x11 and xv video output drivers.
3316 .B \-zrbw (\-vo zr only)
3317 Display in black and white.
3318 For optimal performance, this can be combined with '\-lavdopts gray'.
3321 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
3322 Select a part of the input image to display, multiple occurrences
3323 of this option switch on cinerama mode.
3324 In cinerama mode the movie is distributed over more than one TV
3325 (or beamer) to create a larger image.
3326 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
3327 card should at least have a \-zrdev in addition to the \-zrcrop.
3328 For examples, see the output of \-zrhelp and the Zr section of the
3332 .B \-zrdev <device> (\-vo zr only)
3333 Specify the device special file that belongs to your MJPEG card, by default
3334 the zr video output driver takes the first v4l device it can find.
3337 .B \-zrfd (\-vo zr only)
3338 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
3339 happens if the hardware scaler can stretch the image to its original size.
3340 Use this option to force decimation.
3343 .B \-zrhdec <1|2|4> (\-vo zr only)
3344 Horizontal decimation: Ask the driver to send only every 2nd or 4th
3345 line/\:pixel of the input image to the MJPEG card and use the scaler
3346 of the MJPEG card to stretch the image to its original size.
3349 .B \-zrhelp (\-vo zr only)
3350 Display a list of all \-zr* options, their default values and a
3351 cinerama mode example.
3354 .B \-zrnorm <norm> (\-vo zr only)
3355 Specify the TV norm as PAL or NTSC (default: no change).
3358 .B \-zrquality <1\-20> (\-vo zr only)
3359 A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
3362 .B \-zrvdec <1|2|4> (\-vo zr only)
3363 Vertical decimation: Ask the driver to send only every 2nd or 4th
3364 line/\:pixel of the input image to the MJPEG card and use the scaler
3365 of the MJPEG card to stretch the image to its original size.
3368 .B \-zrxdoff <x display offset> (\-vo zr only)
3369 If the movie is smaller than the TV screen, this option specifies the x
3370 offset from the upper-left corner of the TV screen (default: centered).
3373 .B \-zrydoff <y display offset> (\-vo zr only)
3374 If the movie is smaller than the TV screen, this option specifies the y
3375 offset from the upper-left corner of the TV screen (default: centered).
3379 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
3380 Video output drivers are interfaces to different video output facilities.
3384 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
3385 Specify a priority list of video output drivers to be used.
3387 If the list has a trailing ',' MPlayer will fall back on drivers not
3388 contained in the list.
3389 Suboptions are optional and can mostly be omitted.
3392 See \-vo help for a list of compiled-in video output drivers.
3397 .IPs "\-vo xmga,xv,"
3398 Try the Matrox X11 driver, then the Xv driver, then others.
3399 .IPs "\-vo directx:noaccel"
3400 Uses the DirectX driver with acceleration features turned off.
3404 Available video output drivers are:
3408 Uses the XVideo extension of XFree86 4.x to enable hardware
3409 accelerated playback.
3410 If you cannot use a hardware specific driver, this is probably
3412 For information about what colorkey is used and how it is drawn run MPlayer
3413 with \-v option and look out for the lines tagged with [xv common] at the
3417 .IPs adaptor=<number>
3418 Select a specific XVideo adaptor (check xvinfo results).
3420 Select a specific XVideo port.
3421 .IPs ck=<cur|use|set>
3422 Select the source from which the colorkey is taken (default: cur).
3425 The default takes the colorkey currently set in Xv.
3427 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
3430 Same as use but also sets the supplied colorkey.
3432 .IPs ck-method=<man|bg|auto>
3433 Sets the colorkey drawing method (default: man).
3436 Draw the colorkey manually (reduces flicker in some cases).
3438 Set the colorkey as window background.
3440 Let Xv draw the colorkey.
3447 Shared memory video output driver without hardware acceleration that
3448 works whenever X11 is present.
3452 Adds X11 support to all overlay based video output drivers.
3453 Currently only supported by tdfx_vid.
3457 Select the driver to use as source to overlay on top of X11.
3462 .B vdpau (with \-vc ffmpeg12vdpau, ffwmv3vdpau, ffvc1vdpau or ffh264vdpau)
3463 Video output that uses VDPAU to decode video via hardware.
3464 Also supports displaying of software-decoded video.
3467 .IPs sharpen=<\-1\-1>
3468 For positive values, apply a sharpening algorithm to the video,
3469 for negative values a blurring algorithm (default: 0).
3471 Apply a noise reduction algorithm to the video (default: 0, no noise reduction).
3473 Chooses the deinterlacer (default: 0).
3474 All modes > 0 respect \-field\-dominance.
3479 Show only first field, similar to \-vf field.
3481 Bob deinterlacing, similar to \-vf tfields=1.
3483 Motion adaptive temporal deinterlacing.
3484 May lead to A/V desync with slow video hardware and/or high resolution.
3485 This is the default if "D" is used to enable deinterlacing.
3487 Motion adaptive temporal deinterlacing with edge-guided spatial interpolation.
3488 Needs fast video hardware.
3491 Makes temporal deinterlacers operate both on luma and chroma (default).
3492 Use nochroma\-deint to solely use luma and speed up advanced deinterlacing.
3493 Useful with slow video memory.
3495 Try to apply inverse telecine, needs motion adaptive temporal deinterlacing.
3500 .B xvmc (X11 with \-vc ffmpeg12mc only)
3501 Video output driver that uses the XvMC (X Video Motion Compensation)
3502 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
3505 .IPs adaptor=<number>
3506 Select a specific XVideo adaptor (check xvinfo results).
3508 Select a specific XVideo port.
3510 Disables image display.
3511 Necessary for proper benchmarking of drivers that change
3512 image buffers on monitor retrace only (nVidia).
3513 Default is not to disable image display (nobenchmark).
3515 Very simple deinterlacer.
3516 Might not look better than \-vf tfields=1,
3517 but it is the only deinterlacer for xvmc (default: nobobdeint).
3519 Queue frames for display to allow more parallel work of the video hardware.
3520 May add a small (not noticeable) constant A/V desync (default: noqueue).
3522 Use sleep function while waiting for rendering to finish
3523 (not recommended on Linux) (default: nosleep).
3525 Same as \-vo xv:ck (see \-vo xv).
3526 .IPs ck-method=man|bg|auto
3527 Same as \-vo xv:ck-method (see \-vo xv).
3533 Play video through the XFree86 Direct Graphics Access extension.
3534 Considered obsolete.
3537 .B sdl (SDL only, buggy/outdated)
3538 Highly platform independent SDL (Simple Directmedia Layer) library
3539 video output driver.
3540 Since SDL uses its own X11 layer, MPlayer X11 options do not have
3542 Note that it has several minor bugs (\-vm/\-novm is mostly ignored,
3543 \-fs behaves like \-novm should, window is in top-left corner when
3544 returning from fullscreen, panscan is not supported, ...)
3547 .IPs driver=<driver>
3548 Explicitly choose the SDL driver to use.
3550 Use XVideo through the sdl video output driver (default: forcexv).
3552 Use hardware accelerated scaler (default: hwaccel).
3558 VIDIX (VIDeo Interface for *niX) is an interface to the
3559 video acceleration features of different graphics cards.
3560 Very fast video output driver on cards that support it.
3564 Explicitly choose the VIDIX subdevice driver to use.
3565 Available subdevice drivers are cyberblade, ivtv, mach64,
3566 mga_crtc2, mga, nvidia, pm2, pm3, radeon, rage128, s3, sh_veu,
3567 sis_vid and unichrome.
3572 .B xvidix (X11 only)
3573 X11 frontend for VIDIX
3583 Generic and platform independent VIDIX frontend, can even run in a
3584 text console with nVidia cards.
3593 .B winvidix (Windows only)
3594 Windows frontend for VIDIX
3603 .B direct3d (Windows only) (BETA CODE!)
3604 Video output driver that uses the Direct3D interface (useful for Vista).
3607 .B directx (Windows only)
3608 Video output driver that uses the DirectX interface.
3612 Turns off hardware acceleration.
3613 Try this option if you have display problems.
3619 Video output driver that uses the libkva interface.
3625 Force WarpOverlay! mode.
3629 Enable/disable workaround for T23 laptop (default: \-not23).
3630 Try to enable this option if your video card supports upscaling only.
3635 .B quartz (Mac OS X only)
3636 Mac OS X Quartz video output driver.
3637 Under some circumstances, it might be more efficient to force a
3638 packed YUV output format, with e.g.\& \-vf format=yuy2.
3641 .IPs device_id=<number>
3642 Choose the display device to use in fullscreen.
3643 .IPs fs_res=<width>:<height>
3644 Specify the fullscreen resolution (useful on slow systems).
3649 .B corevideo (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
3650 Mac OS X CoreVideo video output driver
3653 .IPs device_id=<number>
3654 Choose the display device to use for fullscreen or set it to \-1 to
3655 always use the same screen the video window is on (default: \-1 \- auto).
3657 Write output to a shared memory buffer instead of displaying it and
3658 try to open an existing NSConnection for communication with a GUI.
3659 .IPs buffer_name=<name>
3660 Name of the shared buffer created with shm_open as well as the name of
3661 the NSConnection MPlayer will try to open (default: "mplayerosx").
3662 Setting buffer_name implicitly enables shared_buffer.
3667 .B fbdev (Linux only)
3668 Uses the kernel framebuffer to play video.
3672 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
3673 name of the VIDIX subdevice if the device name starts with 'vidix'
3674 (e.g.\& 'vidixsis_vid' for the sis driver).
3679 .B fbdev2 (Linux only)
3680 Uses the kernel framebuffer to play video,
3681 alternative implementation.
3685 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3691 Very general video output driver that should work on any VESA VBE 2.0
3696 Turns DGA mode on or off (default: on).
3698 Activate the NeoMagic TV out and set it to PAL norm.
3700 Activate the NeoMagic TV out and set it to NTSC norm.
3702 Use the VIDIX driver.
3704 Activate the Linux Video Overlay on top of VESA mode.
3710 Play video using the SVGA library.
3714 Specify video mode to use.
3715 The mode can be given in a <width>x<height>x<colors> format,
3716 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
3718 Draw OSD into black bands below the movie (slower).
3720 Use only native drawing functions.
3721 This avoids direct rendering, OSD and hardware acceleration.
3723 Force frame switch on vertical retrace.
3724 Usable only with \-double.
3725 It has the same effect as the \-vsync option.
3727 Try to select a video mode with square pixels.
3729 Use svga with VIDIX.
3735 OpenGL video output driver, simple version.
3736 Video size must be smaller than
3737 the maximum texture size of your OpenGL implementation.
3738 Intended to work even with the most basic OpenGL implementations,
3739 but also makes use of newer extensions, which allow support for more
3740 colorspaces and direct rendering.
3741 For optimal speed try something similar to
3743 \-vo gl:yuv=2:rectangle=2:force\-pbo:ati\-hack \-dr \-noslices
3745 The code performs very few checks, so if a feature does not work, this
3746 might be because it is not supported by your card/OpenGL implementation
3747 even if you do not get any error message.
3748 Use glxinfo or a similar tool to display the supported OpenGL extensions.
3752 ATI drivers may give a corrupted image when PBOs are used (when using \-dr
3754 This option fixes this, at the expense of using a bit more memory.
3756 Always uses PBOs to transfer textures even if this involves an extra copy.
3757 Currently this gives a little extra speed with NVidia drivers and a lot more
3758 speed with ATI drivers.
3759 May need \-noslices and the ati\-hack suboption to work correctly.
3761 Changes the way the OSD behaves when the size of the
3762 window changes (default: disabled).
3763 When enabled behaves more like the other video output drivers,
3764 which is better for fixed-size fonts.
3765 Disabled looks much better with FreeType fonts and uses the
3766 borders in fullscreen mode.
3767 Does not work correctly with ass subtitles (see \-ass), you can instead
3768 render them without OpenGL support via \-vf ass.
3769 .IPs osdcolor=<0xAARRGGBB>
3770 Color for OSD (default: 0x00ffffff, corresponds to non-transparent white).
3771 .IPs rectangle=<0,1,2>
3772 Select usage of rectangular textures which saves video RAM, but often is
3773 slower (default: 0).
3775 0: Use power-of-two textures (default).
3777 1: Use the GL_ARB_texture_rectangle extension.
3779 2: Use the GL_ARB_texture_non_power_of_two extension.
3780 In some cases only supported in software and thus very slow.
3782 .IPs swapinterval=<n>
3783 Minimum interval between two buffer swaps, counted in
3784 displayed frames (default: 1).
3785 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
3786 Values below 0 will leave it at the system default.
3787 This limits the framerate to (horizontal refresh rate / n).
3788 Requires GLX_SGI_swap_control support to work.
3789 With some (most/all?) implementations this only works in fullscreen mode.
3791 Select the type of YUV to RGB conversion.
3793 0: Use software conversion (default).
3794 Compatible with all OpenGL versions.
3795 Provides brightness, contrast and saturation control.
3797 1: Use register combiners.
3798 This uses an nVidia-specific extension (GL_NV_register_combiners).
3799 At least three texture units are needed.
3800 Provides saturation and hue control.
3801 This method is fast but inexact.
3803 2: Use a fragment program.
3804 Needs the GL_ARB_fragment_program extension and at least three texture units.
3805 Provides brightness, contrast, saturation and hue control.
3807 3: Use a fragment program using the POW instruction.
3808 Needs the GL_ARB_fragment_program extension and at least three texture units.
3809 Provides brightness, contrast, saturation, hue and gamma control.
3810 Gamma can also be set independently for red, green and blue.
3811 Method 4 is usually faster.
3813 4: Use a fragment program with additional lookup.
3814 Needs the GL_ARB_fragment_program extension and at least four texture units.
3815 Provides brightness, contrast, saturation, hue and gamma control.
3816 Gamma can also be set independently for red, green and blue.
3818 5: Use ATI-specific method (for older cards).
3819 This uses an ATI-specific extension (GL_ATI_fragment_shader \- not
3820 GL_ARB_fragment_shader!).
3821 At least three texture units are needed.
3822 Provides saturation and hue control.
3823 This method is fast but inexact.
3825 6: Use a 3D texture to do conversion via lookup.
3826 Needs the GL_ARB_fragment_program extension and at least four texture units.
3827 Extremely slow (software emulation) on some (all?) ATI cards since it uses
3828 a texture with border pixels.
3829 Provides brightness, contrast, saturation, hue and gamma control.
3830 Gamma can also be set independently for red, green and blue.
3831 Speed depends more on GPU memory bandwidth than other methods.
3834 Use the GL_MESA_ycbcr_texture extension to convert YUV to RGB.
3835 In most cases this is probably slower than doing software conversion to RGB.
3837 Select the scaling function to use for luminance scaling.
3838 Only valid for yuv modes 2, 3, 4 and 6.
3840 0: Use simple linear filtering (default).
3842 1: Use bicubic B-spline filtering (better quality).
3843 Needs one additional texture unit.
3844 Older cards will not be able to handle this for chroma at least in fullscreen mode.
3846 2: Use cubic filtering in horizontal, linear filtering in vertical direction.
3847 Works on a few more cards than method 1.
3849 3: Same as 1 but does not use a lookup texture.
3850 Might be faster on some cards.
3852 4: Use experimental unsharp masking with 3x3 support and a default strength of 0.5 (see filter-strength).
3854 5: Use experimental unsharp masking with 5x5 support and a default strength of 0.5 (see filter-strength).
3857 Select the scaling function to use for chrominance scaling.
3858 For details see lscale.
3859 .IPs filter-strength=<value>
3860 Set the effect strength for the lscale/cscale filters that support it.
3861 .IPs customprog=<filename>
3862 Load a custom fragment program from <filename>.
3863 See TOOLS/edgedect.fp for an example.
3864 .IPs customtex=<filename>
3865 Load a custom "gamma ramp" texture from <filename>.
3866 This can be used in combination with yuv=4 or with the customprog option.
3868 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
3869 for customtex texture.
3870 .IPs (no)customtrect
3871 If enabled, use texture_rectangle for customtex texture.
3872 Default is disabled.
3876 Normally there is no reason to use the following options, they mostly
3877 exist for testing purposes.
3882 Call glFinish() before swapping buffers.
3883 Slower but in some cases more correct output (default: disabled).
3885 Enables support for more (RGB and BGR) color formats (default: enabled).
3886 Needs OpenGL version >= 1.2.
3887 .IPs slice-height=<0\-...>
3888 Number of lines copied to texture in one piece (default: 0).
3892 If YUV colorspace is used (see yuv suboption), special rules apply:
3894 If the decoder uses slice rendering (see \-noslices), this setting
3895 has no effect, the size of the slices as provided by the decoder is used.
3897 If the decoder does not use slice rendering, the default is 16.
3900 Enable or disable support for OSD rendering via OpenGL (default: enabled).
3901 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
3903 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
3904 Disabling might increase speed.
3911 Variant of the OpenGL video output driver.
3912 Supports videos larger than the maximum texture size but lacks many of the
3913 advanced features and optimizations of the gl driver and is unlikely to be
3918 same as gl (default: enabled)
3920 Select the type of YUV to RGB conversion.
3921 If set to anything except 0 OSD will be disabled and brightness, contrast and
3922 gamma setting is only available via the global X server settings.
3923 Apart from this the values have the same meaning as for \-vo gl.
3928 Produces no video output.
3929 Useful for benchmarking.
3933 ASCII art video output driver that works on a text console.
3934 You can get a list and an explanation of available suboptions
3935 by executing 'mplayer \-vo aa:help'.
3938 The driver does not handle \-aspect correctly.
3941 You probably have to specify \-monitorpixelaspect.
3942 Try 'mplayer \-vo aa \-monitorpixelaspect 0.5'.
3946 Color ASCII art video output driver that works on a text console.
3950 Video playback using the Blinkenlights UDP protocol.
3951 This driver is highly hardware specific.
3955 Explicitly choose the Blinkenlights subdevice driver to use.
3956 It is something like arcade:host=localhost:2323 or
3957 hdl:file=name1,file=name2.
3958 You must specify a subdevice.
3964 GGI graphics system video output driver
3968 Explicitly choose the GGI driver to use.
3969 Replace any ',' that would appear in the driver string by a '.'.
3975 Play video using the DirectFB library.
3979 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
3980 .IPs buffermode=single|double|triple
3981 Double and triple buffering give best results if you want to avoid tearing issues.
3982 Triple buffering is more efficient than double buffering as it does
3983 not block MPlayer while waiting for the vertical retrace.
3984 Single buffering should be avoided (default: single).
3985 .IPs fieldparity=top|bottom
3986 Control the output order for interlaced frames (default: disabled).
3987 Valid values are top = top fields first, bottom = bottom fields first.
3988 This option does not have any effect on progressive film material
3989 like most MPEG movies are.
3990 You need to enable this option if you have tearing issues or unsmooth
3991 motions watching interlaced film material.
3993 Will force layer with ID N for playback (default: \-1 \- auto).
3995 Specify a parameter list for DirectFB.
4001 Matrox G400/\:G450/\:G550 specific video output driver that uses the
4002 DirectFB library to make use of special hardware features.
4003 Enables CRTC2 (second head), displaying video independently of the first head.
4007 same as directfb (default: disabled)
4008 .IPs buffermode=single|double|triple
4009 same as directfb (default: triple)
4010 .IPs fieldparity=top|bottom
4013 Enable the use of the Matrox BES (backend scaler) (default: disabled).
4014 Gives very good results concerning speed and output quality as interpolated
4015 picture processing is done in hardware.
4016 Works only on the primary head.
4018 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
4020 Turn on TV-out on the second head (default: enabled).
4021 The output quality is amazing as it is a full interlaced picture
4022 with proper sync to every odd/\:even field.
4023 .IPs tvnorm=pal|ntsc|auto
4024 Will set the TV norm of the Matrox card without the need
4025 for modifying /etc/\:directfbrc (default: disabled).
4026 Valid norms are pal = PAL, ntsc = NTSC.
4027 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
4028 which norm to use by looking at the framerate of the movie.
4034 Matrox specific video output driver that makes use of the YUV back
4035 end scaler on Gxxx cards through a kernel module.
4036 If you have a Matrox card, this is the fastest option.
4040 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4045 .B xmga (Linux, X11 only)
4046 The mga video output driver, running in an X11 window.
4050 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4055 .B s3fb (Linux only) (also see \-vf yuv2 and \-dr)
4056 S3 Virge specific video output driver.
4057 This driver supports the card's YUV conversion and scaling, double
4058 buffering and direct rendering features.
4059 Use \-vf yuy2 to get hardware-accelerated YUY2 rendering, which is
4060 much faster than YV12 on this card.
4064 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4070 Nintendo Wii/GameCube specific video output driver.
4073 .B 3dfx (Linux only)
4074 3dfx-specific video output driver that directly uses
4075 the hardware on top of X11.
4076 Only 16 bpp are supported.
4079 .B tdfxfb (Linux only)
4080 This driver employs the tdfxfb framebuffer driver to play movies with
4081 YUV acceleration on 3dfx cards.
4085 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4090 .B tdfx_vid (Linux only)
4091 3dfx-specific video output driver that works in combination with
4092 the tdfx_vid kernel module.
4096 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
4101 .B dxr2 (also see \-dxr2) (DXR2 only)
4102 Creative DXR2 specific video output driver.
4106 Output video subdriver to use as overlay (x11, xv).
4112 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
4113 Hollywood Plus) specific video output driver.
4114 Also see the lavc video filter.
4118 Activates the overlay instead of TV-out.
4120 Turns on prebuffering.
4122 Will turn on the new sync-engine.
4124 Specifies the TV norm.
4126 0: Does not change current norm (default).
4128 1: Auto-adjust using PAL/\:NTSC.
4130 2: Auto-adjust using PAL/\:PAL-60.
4139 Specifies the device number to use if you have more than one em8300 card.
4145 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
4146 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
4147 specific video output driver for TV-out.
4148 Also see the lavc video filter.
4152 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4154 Explicitly choose the TV-out output to be used for the video signal.
4159 .B v4l2 (requires Linux 2.6.22+ kernel)
4160 Video output driver for V4L2 compliant cards with built-in hardware MPEG decoder.
4161 Also see the lavc video filter.
4165 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4167 Explicitly choose the TV-out output to be used for the video signal.
4172 .B mpegpes (DVB only)
4173 Video output driver for DVB cards that writes the output to an MPEG-PES file
4174 if no DVB card is installed.
4178 Specifies the device number to use if you have more than one DVB output card
4179 (V3 API only, such as 1.x.y series drivers).
4180 If not specified MPlayer will search the first usable card.
4182 output filename (default: ./grab.mpg)
4187 .B zr (also see \-zr* and \-zrhelp)
4188 Video output driver for a number of MJPEG capture/\:playback cards.
4191 .B zr2 (also see the zrmjpeg video filter)
4192 Video output driver for a number of MJPEG capture/\:playback cards,
4197 Specifies the video device to use.
4198 .IPs norm=<PAL|NTSC|SECAM|auto>
4199 Specifies the video norm to use (default: auto).
4201 (De)Activate prebuffering, not yet supported.
4207 Calculate MD5 sums of each frame and write them to a file.
4208 Supports RGB24 and YV12 colorspaces.
4209 Useful for debugging.
4212 .IPs outfile=<value>
4213 Specify the output filename (default: ./md5sums).
4219 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
4220 images and stores it in a file (default: ./stream.yuv).
4221 The format is the same as the one employed by mjpegtools, so this is
4222 useful if you want to process the video with the mjpegtools suite.
4223 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
4224 You can combine it with the \-fixed\-vo option to concatenate files
4225 with the same dimensions and fps value.
4229 Write the output as interlaced frames, top field first.
4231 Write the output as interlaced frames, bottom field first.
4232 .IPs file=<filename>
4233 Write the output to <filename> instead of the default stream.yuv.
4239 If you do not specify any option the output is progressive
4240 (i.e.\& not interlaced).
4245 Output each frame into a single animated GIF file in the current directory.
4246 It supports only RGB format with 24 bpp and the output is converted to 256
4251 Float value to specify framerate (default: 5.0).
4253 Specify the output filename (default: ./out.gif).
4259 You must specify the framerate before the filename or the framerate will
4260 be part of the filename.
4266 mplayer video.nut \-vo gif89a:fps=15:output=test.gif
4272 Output each frame into a JPEG file in the current directory.
4273 Each file takes the frame number padded with leading zeros as name.
4276 .IPs [no]progressive
4277 Specify standard or progressive JPEG (default: noprogressive).
4279 Specify use of baseline or not (default: baseline).
4280 .IPs optimize=<0\-100>
4281 optimization factor (default: 100)
4282 .IPs smooth=<0\-100>
4283 smooth factor (default: 0)
4284 .IPs quality=<0\-100>
4285 quality factor (default: 75)
4286 .IPs outdir=<dirname>
4287 Specify the directory to save the JPEG files to (default: ./).
4288 .IPs subdirs=<prefix>
4289 Create numbered subdirectories with the specified prefix to
4290 save the files in instead of the current directory.
4291 .IPs "maxfiles=<value> (subdirs only)"
4292 Maximum number of files to be saved per subdirectory.
4293 Must be equal to or larger than 1 (default: 1000).
4299 Output each frame into a PNM file in the current directory.
4300 Each file takes the frame number padded with leading zeros as name.
4301 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
4302 Also see pnm(5), ppm(5) and pgm(5).
4306 Write PPM files (default).
4311 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
4312 bottom of the picture.
4314 Write PNM files in raw mode (default).
4316 Write PNM files in ASCII mode.
4317 .IPs outdir=<dirname>
4318 Specify the directory to save the PNM files to (default: ./).
4319 .IPs subdirs=<prefix>
4320 Create numbered subdirectories with the specified prefix to
4321 save the files in instead of the current directory.
4322 .IPs "maxfiles=<value> (subdirs only)"
4323 Maximum number of files to be saved per subdirectory.
4324 Must be equal to or larger than 1 (default: 1000).
4330 Output each frame into a PNG file in the current directory.
4331 Each file takes the frame number padded with leading zeros as name.
4332 24bpp RGB and BGR formats are supported.
4336 Specifies the compression level.
4337 0 is no compression, 9 is maximum compression.
4338 .IPs alpha (default: noalpha)
4339 Create PNG files with an alpha channel.
4340 Note that MPlayer in general does not support alpha, so this will only
4341 be useful in some rare cases.
4347 Output each frame into a Targa file in the current directory.
4348 Each file takes the frame number padded with leading zeros as name.
4349 The purpose of this video output driver is to have a simple lossless
4350 image writer to use without any external library.
4351 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
4352 You can force a particular format with the format video filter.
4358 mplayer video.nut \-vf format=bgr15 \-vo tga
4364 .SH "DECODING/FILTERING OPTIONS"
4367 .B \-ac <[\-|+]codec1,[\-|+]codec2,...[,]>
4368 Specify a priority list of audio codecs to be used, according to their codec
4369 name in codecs.conf.
4370 Use a '\-' before the codec name to omit it.
4371 Use a '+' before the codec name to force it, this will likely crash!
4372 If the list has a trailing ',' MPlayer will fall back on codecs not
4373 contained in the list.
4376 See \-ac help for a full list of available codecs.
4382 Force the l3codeca.acm MP3 codec.
4384 Try libmad first, then fall back on others.
4385 .IPs "\-ac hwac3,a52,"
4386 Try hardware AC-3 passthrough, software AC-3, then others.
4388 Try hardware DTS passthrough, then fall back on others.
4389 .IPs "\-ac \-ffmp3,"
4390 Skip FFmpeg's MP3 decoder.
4395 .B \-af\-adv <force=(0\-7):list=(filters)> (also see \-af)
4396 Specify advanced audio filter options:
4399 Forces the insertion of audio filters to one of the following:
4401 0: Use completely automatic filter insertion.
4403 1: Optimize for accuracy (default).
4405 2: Optimize for speed.
4407 Some features in the audio filters may silently fail,
4408 and the sound quality may drop.
4410 3: Use no automatic insertion of filters and no optimization.
4412 It may be possible to crash MPlayer using this setting.
4414 4: Use automatic insertion of filters according to 0 above,
4415 but use floating point processing when possible.
4417 5: Use automatic insertion of filters according to 1 above,
4418 but use floating point processing when possible.
4420 6: Use automatic insertion of filters according to 2 above,
4421 but use floating point processing when possible.
4423 7: Use no automatic insertion of filters according to 3 above,
4424 and use floating point processing when possible.
4431 .B \-afm <driver1,driver2,...>
4432 Specify a priority list of audio codec families to be used, according
4433 to their codec name in codecs.conf.
4434 Falls back on the default codecs if none of the given codec families work.
4437 See \-afm help for a full list of available codec families.
4443 Try FFmpeg's libavcodec codecs first.
4444 .IPs "\-afm acm,dshow"
4445 Try Win32 codecs first.
4450 .B \-aspect <ratio> (also see \-zoom)
4451 Override movie aspect ratio, in case aspect information is
4452 incorrect or missing in the file being played.
4457 \-aspect 4:3 or \-aspect 1.3333
4459 \-aspect 16:9 or \-aspect 1.7777
4465 Disable automatic movie aspect ratio compensation.
4468 .B "\-field\-dominance <\-1\-1>"
4469 Set first field for interlaced content.
4470 Useful for deinterlacers that double the framerate: \-vf tfields=1,
4471 \-vf yadif=1, \-vo vdpau:deint and \-vo xvmc:bobdeint.
4475 auto (default): If the decoder does not export the appropriate information,
4476 it falls back to 0 (top field first).
4486 Flip image upside-down.
4489 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
4490 Specify libavcodec decoding parameters.
4491 Separate multiple options with a colon.
4496 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
4501 Available options are:
4505 Only use bit-exact algorithms in all decoding steps (for codec testing).
4507 Manually work around encoder bugs.
4511 1: autodetect bugs (default)
4513 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
4515 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
4517 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
4519 16 (mpeg4): padding bug (autodetected)
4521 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
4523 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
4525 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
4527 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
4529 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
4531 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
4534 Display debugging information.
4545 8: macroblock (MB) type
4547 16: per-block quantization parameter (QP)
4551 0x0040: motion vector visualization (use \-noslices)
4553 0x0080: macroblock (MB) skip
4559 0x0400: error resilience
4561 0x0800: memory management control operations (H.264)
4565 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
4567 0x4000: Visualize block types.
4570 Set error concealment strategy.
4572 1: Use strong deblock filter for damaged MBs.
4574 2: iterative motion vector (MV) search (slow)
4579 Set error resilience strategy.
4584 1: careful (Should work with broken encoders.)
4586 2: normal (default) (Works with compliant encoders.)
4588 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4592 .IPs "fast (MPEG-2, MPEG-4, and H.264 only)"
4593 Enable optimizations which do not comply to the specification and might
4594 potentially cause problems, like simpler dequantization, simpler motion
4595 compensation, assuming use of the default quantization matrix, assuming
4596 YUV 4:2:0 and skipping a few checks to detect damaged bitstreams.
4598 grayscale only decoding (a bit faster than with color)
4599 .IPs "idct=<0\-99> (see \-lavcopts)"
4600 For best decoding quality use the same IDCT algorithm for decoding and encoding.
4601 This may come at a price in accuracy, though.
4602 .IPs lowres=<number>[,<w>]
4603 Decode at lower resolutions.
4604 Low resolution decoding is not supported by all codecs, and it will
4605 often result in ugly artifacts.
4606 This is not a bug, but a side effect of not decoding at full resolution.
4618 If <w> is specified lowres decoding will be used only if the width of the
4619 video is major than or equal to <w>.
4621 .B o=<key>=<value>[,<key>=<value>[,...]]
4622 Pass AVOptions to libavcodec decoder.
4623 Note, a patch to make the o= unneeded and pass all unknown options through
4624 the AVOption system is welcome.
4625 A full list of AVOptions can be found in the FFmpeg manual.
4626 Note that some options may conflict with MEncoder options.
4636 .IPs "sb=<number> (MPEG-2 only)"
4637 Skip the given number of macroblock rows at the bottom.
4638 .IPs "st=<number> (MPEG-2 only)"
4639 Skip the given number of macroblock rows at the top.
4640 .IPs "skiploopfilter=<skipvalue> (H.264 only)"
4641 Skips the loop filter (AKA deblocking) during H.264 decoding.
4642 Since the filtered frame is supposed to be used as reference
4643 for decoding dependent frames this has a worse effect on quality
4644 than not doing deblocking on e.g.\& MPEG-2 video.
4645 But at least for high bitrate HDTV this provides a big speedup with
4646 no visible quality loss.
4648 <skipvalue> can be either one of the following:
4653 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
4655 nonref: Skip frames that are not referenced (i.e.\& not used for
4656 decoding other frames, the error cannot "build up").
4658 bidir: Skip B-Frames.
4660 nonkey: Skip all frames except keyframes.
4662 all: Skip all frames.
4664 .IPs "skipidct=<skipvalue> (MPEG-1/2 only)"
4665 Skips the IDCT step.
4666 This degrades quality a lot of in almost all cases
4667 (see skiploopfilter for available skip values).
4668 .IPs skipframe=<skipvalue>
4669 Skips decoding of frames completely.
4670 Big speedup, but jerky motion and sometimes bad artifacts
4671 (see skiploopfilter for available skip values).
4672 .IPs "threads=<1\-8> (MPEG-1/2 and H.264 only)"
4673 number of threads to use for decoding (default: 1)
4675 Visualize motion vectors.
4680 1: Visualize forward predicted MVs of P-frames.
4682 2: Visualize forward predicted MVs of B-frames.
4684 4: Visualize backward predicted MVs of B-frames.
4687 Prints some statistics and stores them in ./vstats_*.log.
4692 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4693 whole frame in a single run.
4694 May be faster or slower, depending on video card and available cache.
4695 It has effect only with libmpeg2 and libavcodec codecs.
4699 Do not play/\:encode sound.
4700 Useful for benchmarking.
4704 Do not play/\:encode video.
4705 In many cases this will not work, use \-vc null \-vo null instead.
4708 .B \-pp <quality> (also see \-vf pp)
4709 Set the DLL postprocess level.
4710 This option is no longer usable with \-vf pp.
4711 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4712 The valid range of \-pp values varies by codec, it is mostly
4713 0\-6, where 0=disable, 6=slowest/\:best.
4716 .B \-pphelp (also see \-vf pp)
4717 Show a summary about the available postprocess filters and their usage.
4721 Specifies software scaler parameters.
4726 \-vf scale \-ssf lgb=3.0
4732 gaussian blur filter (luma)
4734 gaussian blur filter (chroma)
4735 .IPs ls=<\-100\-100>
4736 sharpen filter (luma)
4737 .IPs cs=<\-100\-100>
4738 sharpen filter (chroma)
4740 chroma horizontal shifting
4742 chroma vertical shifting
4748 Select type of MP2/\:MP3 stereo output.
4761 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
4762 Specify the software scaler algorithm to be used with the \-zoom option.
4763 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4765 Available types are:
4774 bicubic (good quality) (default)
4778 nearest neighbor (bad quality)
4782 luma bicubic / chroma bilinear
4790 natural bicubic spline
4796 Some \-sws options are tunable.
4797 The description of the scale video filter has further information.
4801 .B \-vc <[\-|+]codec1,[\-|+]codec2,...[,]>
4802 Specify a priority list of video codecs to be used, according to their codec
4803 name in codecs.conf.
4804 Use a '\-' before the codec name to omit it.
4805 Use a '+' before the codec name to force it, this will likely crash!
4806 If the list has a trailing ',' MPlayer will fall back on codecs not
4807 contained in the list.
4810 See \-vc help for a full list of available codecs.
4816 Force Win32/\:VfW DivX codec, no fallback.
4817 .IPs "\-vc \-divxds,\-divx,"
4818 Skip Win32 DivX codecs.
4819 .IPs "\-vc ffmpeg12,mpeg12,"
4820 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
4825 .B \-vfm <driver1,driver2,...>
4826 Specify a priority list of video codec families to be used, according
4827 to their names in codecs.conf.
4828 Falls back on the default codecs if none of the given codec families work.
4831 See \-vfm help for a full list of available codec families.
4836 .IPs "\-vfm ffmpeg,dshow,vfw"
4837 Try the libavcodec, then Directshow, then VfW codecs and fall back
4838 on others, if they do not work.
4840 Try XAnim codecs first.
4845 .B \-x <x> (also see \-zoom) (MPlayer only)
4846 Scale image to width <x> (if software/\:hardware scaling is available).
4847 Disables aspect calculations.
4850 .B \-xvidopts <option1:option2:...>
4851 Specify additional parameters when decoding with Xvid.
4854 Since libavcodec is faster than Xvid you might want to use the libavcodec
4855 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
4857 Xvid's internal postprocessing filters:
4860 .IPs "deblock-chroma (also see \-vf pp)"
4861 chroma deblock filter
4862 .IPs "deblock-luma (also see \-vf pp)"
4864 .IPs "dering-luma (also see \-vf pp)"
4865 luma deringing filter
4866 .IPs "dering-chroma (also see \-vf pp)"
4867 chroma deringing filter
4868 .IPs "filmeffect (also see \-vf noise)"
4869 Adds artificial film grain to the video.
4870 May increase perceived quality, while lowering true quality.
4879 Activate direct rendering method 2.
4881 Deactivate direct rendering method 2.
4886 .B \-xy <value> (also see \-zoom)
4890 Scale image by factor <value>.
4892 Set width to value and calculate height to keep correct aspect ratio.
4897 .B \-y <y> (also see \-zoom) (MPlayer only)
4898 Scale image to height <y> (if software/\:hardware scaling is available).
4899 Disables aspect calculations.
4903 Allow software scaling, where available.
4904 This will allow scaling with output drivers (like x11, fbdev) that
4905 do not support hardware scaling where MPlayer disables scaling by
4906 default for performance reasons.
4911 Audio filters allow you to modify the audio stream and its properties.
4915 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
4916 Setup a chain of audio filters.
4919 To get a full list of available audio filters, see \-af help.
4921 Audio filters are managed in lists.
4922 There are a few commands to manage the filter list.
4925 .B \-af\-add <filter1[,filter2,...]>
4926 Appends the filters given as arguments to the filter list.
4929 .B \-af\-pre <filter1[,filter2,...]>
4930 Prepends the filters given as arguments to the filter list.
4933 .B \-af\-del <index1[,index2,...]>
4934 Deletes the filters at the given indexes.
4935 Index numbers start at 0, negative numbers address the end of the
4936 list (\-1 is the last).
4940 Completely empties the filter list.
4942 Available filters are:
4945 .B resample[=srate[:sloppy[:type]]]
4946 Changes the sample rate of the audio stream.
4947 Can be used if you have a fixed frequency sound card or if you are
4948 stuck with an old sound card that is only capable of max 44.1kHz.
4949 This filter is automatically enabled if necessary.
4950 It only supports 16-bit integer and float in native-endian format as input.
4953 With MEncoder, you need to also use \-srate <srate>.
4957 output sample frequency in Hz.
4958 The valid range for this parameter is 8000 to 192000.
4959 If the input and output sample frequency are the same or if this
4960 parameter is omitted the filter is automatically unloaded.
4961 A high sample frequency normally improves the audio quality,
4962 especially when used in combination with other filters.
4964 Allow (1) or disallow (0) the output frequency to differ slightly
4965 from the frequency given by <srate> (default: 1).
4966 Can be used if the startup of the playback is extremely slow.
4968 Selects which resampling method to use.
4970 0: linear interpolation (fast, poor quality especially when upsampling)
4972 1: polyphase filterbank and integer processing
4974 2: polyphase filterbank and floating point processing (slow, best quality)
4984 .IPs "mplayer \-af resample=44100:0:0"
4985 would set the output frequency of the resample filter to 44100Hz using
4986 exact output frequency scaling and linear interpolation.
4991 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
4992 Changes the sample rate of the audio stream to an integer <srate> in Hz.
4993 It only supports the 16-bit native-endian format.
4996 With MEncoder, you need to also use \-srate <srate>.
5000 the output sample rate
5002 length of the filter with respect to the lower sampling rate (default: 16)
5004 if 1 then filters will be linearly interpolated between polyphase entries
5006 log2 of the number of polyphase entries
5007 (..., 10->1024, 11->2048, 12->4096, ...)
5010 cutoff frequency (0.0\-1.0), default set depending upon filter length
5015 .B lavcac3enc[=tospdif[:bitrate[:minchn]]]
5016 Encode multi-channel audio to AC-3 at runtime using libavcodec.
5017 Supports 16-bit native-endian input format, maximum 6 channels.
5018 The output is big-endian when outputting a raw AC-3 stream,
5019 native-endian when outputting to S/PDIF.
5020 The output sample rate of this filter is same with the input sample rate.
5021 When input sample rate is 48kHz, 44.1kHz, or 32kHz, this filter directly use it.
5022 Otherwise a resampling filter is auto-inserted before this filter to make
5023 the input and output sample rate be 48kHz.
5024 You need to specify '\-channels N' to make the decoder decode audio into
5025 N-channel, then the filter can encode the N-channel input to AC-3.
5030 Output raw AC-3 stream if zero or not set,
5031 output to S/PDIF for passthrough when <tospdif> is set non-zero.
5033 The bitrate to encode the AC-3 stream.
5034 Set it to either 384 or 384000 to get 384kbits.
5035 Valid values: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
5036 320, 384, 448, 512, 576, 640
5037 Default bitrate is based on the input channel number:
5038 1ch: 96, 2ch: 192, 3ch: 224, 4ch: 384, 5ch: 448, 6ch: 448
5040 If the input channel number is less than <minchn>, the filter will
5041 detach itself (default: 5).
5047 Produces a sine sweep.
5051 Sine function delta, use very low values to hear the sweep.
5056 .B sinesuppress[=freq:decay]
5057 Remove a sine at the specified frequency.
5058 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
5059 It probably only works on mono input.
5063 The frequency of the sine which should be removed (in Hz) (default: 50)
5065 Controls the adaptivity (a larger value will make the filter adapt to
5066 amplitude and phase changes quicker, a smaller value will make the
5067 adaptation slower) (default: 0.0001).
5068 Reasonable values are around 0.001.
5073 .B bs2b[=option1:option2]
5074 Bauer stereophonic to binaural transformation using libbs2b.
5075 Improves the headphone listening experience by making the sound
5076 similar to that from loudspeakers, allowing each ear to hear both
5077 channels and taking into account the distance difference and the
5078 head shadowing effect.
5079 It is applicable only to 2 channel audio.
5082 .IPs fcut=<300\-1000>
5083 Set cut frequency in Hz.
5085 Set feed level for low frequencies in 0.1*dB.
5086 .IPs profile=<value>
5087 Several profiles are available for convenience:
5089 default: will be used if nothing else was specified (fcut=700,
5092 cmoy: Chu Moy circuit implementation (fcut=700, feed=60);
5094 jmeier: Jan Meier circuit implementation (fcut=650, feed=95).
5100 If fcut or feed options are specified together with a profile, they
5101 will be applied on top of the selected profile.
5107 Head-related transfer function: Converts multichannel audio to
5108 2 channel output for headphones, preserving the spatiality of the sound.
5113 .IPs "m matrix decoding of the rear channel"
5114 .IPs "s 2-channel matrix decoding"
5115 .IPs "0 no matrix decoding (default)"
5120 .B equalizer=[g1:g2:g3:...:g10]
5121 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
5122 This means that it works regardless of what type of audio is being played back.
5123 The center frequencies for the 10 bands are:
5127 .IPs "No. frequency"
5142 If the sample rate of the sound being played is lower than the center
5143 frequency for a frequency band, then that band will be disabled.
5144 A known bug with this filter is that the characteristics for the
5145 uppermost band are not completely symmetric if the sample
5146 rate is close to the center frequency of that band.
5147 This problem can be worked around by upsampling the sound
5148 using the resample filter before it reaches this filter.
5152 .IPs <g1>:<g2>:<g3>:...:<g10>
5153 floating point numbers representing the gain in dB
5154 for each frequency band (\-12\-12)
5161 .IPs "mplayer \-af equalizer=11:11:10:5:0:\-12:0:5:12:12 media.avi"
5162 Would amplify the sound in the upper and lower frequency region
5163 while canceling it almost completely around 1kHz.
5168 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
5169 Can be used for adding, removing, routing and copying audio channels.
5170 If only <nch> is given the default routing is used, it works as
5171 follows: If the number of output channels is bigger than the number of
5172 input channels empty channels are inserted (except mixing from mono to
5173 stereo, then the mono channel is repeated in both of the output
5175 If the number of output channels is smaller than the number
5176 of input channels the exceeding channels are truncated.
5180 number of output channels (1\-6)
5182 number of routes (1\-6)
5183 .IPs <from1:to1:from2:to2:from3:to3:...>
5184 Pairs of numbers between 0 and 5 that define where to route each channel.
5191 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
5192 Would change the number of channels to 4 and set up 4 routes that
5193 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
5194 Observe that if media containing two channels was played back, channels
5195 2 and 3 would contain silence but 0 and 1 would still be swapped.
5196 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
5197 Would change the number of channels to 6 and set up 4 routes
5198 that copy channel 0 to channels 0 to 3.
5199 Channel 4 and 5 will contain silence.
5204 .B format[=format] (also see \-format)
5205 Convert between different sample formats.
5206 Automatically enabled when needed by the sound card or another filter.
5210 Sets the desired format.
5211 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
5212 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
5213 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
5214 and 'ne' the endianness of the computer MPlayer is running on).
5215 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
5216 Exceptions to this rule that are also valid format specifiers: u8, s8,
5217 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
5223 Implements software volume control.
5224 Use this filter with caution since it can reduce the signal
5225 to noise ratio of the sound.
5226 In most cases it is best to set the level for the PCM sound to max,
5227 leave this filter out and control the output level to your
5228 speakers with the master volume control of the mixer.
5229 In case your sound card has a digital PCM mixer instead of an analog
5230 one, and you hear distortion, use the MASTER mixer instead.
5231 If there is an external amplifier connected to the computer (this
5232 is almost always the case), the noise level can be minimized by
5233 adjusting the master level and the volume knob on the amplifier
5234 until the hissing noise in the background is gone.
5236 This filter has a second feature: It measures the overall maximum
5237 sound level and prints out that level when MPlayer exits.
5238 This volume estimate can be used for setting the sound level in
5239 MEncoder such that the maximum dynamic range is utilized.
5242 This filter is not reentrant and can therefore only be enabled
5243 once for every audio stream.
5247 Sets the desired gain in dB for all channels in the stream
5248 from \-200dB to +60dB, where \-200dB mutes the sound
5249 completely and +60dB equals a gain of 1000 (default: 0).
5251 Turns soft clipping on (1) or off (0).
5252 Soft-clipping can make the sound more smooth if very
5253 high volume levels are used.
5254 Enable this option if the dynamic range of the
5255 loudspeakers is very low.
5258 This feature creates distortion and should be considered a last resort.
5265 .IPs "mplayer \-af volume=10.1:0 media.avi"
5266 Would amplify the sound by 10.1dB and hard-clip if the
5267 sound level is too high.
5272 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
5273 Mixes channels arbitrarily.
5274 Basically a combination of the volume and the channels filter
5275 that can be used to down-mix many channels to only a few,
5276 e.g.\& stereo to mono or vary the "width" of the center
5277 speaker in a surround sound system.
5278 This filter is hard to use, and will require some tinkering
5279 before the desired result is obtained.
5280 The number of options for this filter depends on
5281 the number of output channels.
5282 An example how to downmix a six-channel file to two channels with
5283 this filter can be found in the examples section near the end.
5287 number of output channels (1\-6)
5289 How much of input channel i is mixed into output channel j (0\-1).
5290 So in principle you first have n numbers saying what to do with the
5291 first input channel, then n numbers that act on the second input channel
5293 If you do not specify any numbers for some input channels, 0 is assumed.
5300 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
5301 Would down-mix from stereo to mono.
5302 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
5303 Would give 3 channel output leaving channels 0 and 1 intact,
5304 and mix channels 0 and 1 into output channel 2 (which could
5305 be sent to a subwoofer for example).
5311 Adds a subwoofer channel to the audio stream.
5312 The audio data used for creating the subwoofer channel is
5313 an average of the sound in channel 0 and channel 1.
5314 The resulting sound is then low-pass filtered by a 4th order
5315 Butterworth filter with a default cutoff frequency of 60Hz
5316 and added to a separate channel in the audio stream.
5319 Disable this filter when you are playing DVDs with Dolby
5320 Digital 5.1 sound, otherwise this filter will disrupt
5321 the sound to the subwoofer.
5325 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
5326 For the best result try setting the cutoff frequency as low as possible.
5327 This will improve the stereo or surround sound experience.
5329 Determines the channel number in which to insert the sub-channel audio.
5330 Channel number can be between 0 and 5 (default: 5).
5331 Observe that the number of channels will automatically
5332 be increased to <ch> if necessary.
5339 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
5340 Would add a sub-woofer channel with a cutoff frequency of
5341 100Hz to output channel 4.
5347 Creates a center channel from the front channels.
5348 May currently be low quality as it does not implement a
5349 high-pass filter for proper extraction yet, but averages and
5350 halves the channels instead.
5354 Determines the channel number in which to insert the center channel.
5355 Channel number can be between 0 and 5 (default: 5).
5356 Observe that the number of channels will automatically
5357 be increased to <ch> if necessary.
5363 Decoder for matrix encoded surround sound like Dolby Surround.
5364 Many files with 2 channel audio actually contain matrixed surround sound.
5365 Requires a sound card supporting at least 4 channels.
5369 delay time in ms for the rear speakers (0 to 1000) (default: 20)
5370 This delay should be set as follows: If d1 is the distance
5371 from the listening position to the front speakers and d2 is the distance
5372 from the listening position to the rear speakers, then the delay should
5373 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
5380 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
5381 Would add surround sound decoding with 15ms delay for the sound to the
5387 .B delay[=ch1:ch2:...]
5388 Delays the sound to the loudspeakers such that the sound from the
5389 different channels arrives at the listening position simultaneously.
5390 It is only useful if you have more than 2 loudspeakers.
5394 The delay in ms that should be imposed on each channel
5395 (floating point number between 0 and 1000).
5400 To calculate the required delay for the different channels do as follows:
5402 Measure the distance to the loudspeakers in meters in relation
5403 to your listening position, giving you the distances s1 to s5
5405 There is no point in compensating for the subwoofer (you will not hear the
5408 Subtract the distances s1 to s5 from the maximum distance,
5409 i.e.\& s[i] = max(s) \- s[i]; i = 1...5.
5411 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
5419 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
5420 Would delay front left and right by 10.5ms, the two rear channels
5421 and the sub by 0ms and the center channel by 7ms.
5426 .B export[=mmapped_file[:nsamples]]
5427 Exports the incoming signal to other processes using memory mapping (mmap()).
5428 Memory mapped areas contain a header:
5431 int nch /*number of channels*/
5432 int size /*buffer size*/
5433 unsigned long long counter /*Used to keep sync, updated every
5434 time new data is exported.*/
5437 The rest is payload (non-interleaved) 16 bit data.
5441 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
5443 number of samples per channel (default: 512)
5450 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
5451 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
5456 .B extrastereo[=mul]
5457 (Linearly) increases the difference between left and right channels
5458 which adds some sort of "live" effect to playback.
5462 Sets the difference coefficient (default: 2.5).
5463 0.0 means mono sound (average of both channels), with 1.0 sound will be
5464 unchanged, with \-1.0 left and right channels will be swapped.
5469 .B volnorm[=method:target]
5470 Maximizes the volume without distorting the sound.
5474 Sets the used method.
5476 1: Use a single sample to smooth the variations via the standard
5477 weighted mean over past samples (default).
5479 2: Use several samples to smooth the variations via the standard
5480 weighted mean over past samples.
5483 Sets the target amplitude as a fraction of the maximum for the
5484 sample type (default: 0.25).
5489 .B ladspa=file:label[:controls...]
5490 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
5491 This filter is reentrant, so multiple LADSPA plugins can be used at once.
5495 Specifies the LADSPA plugin library file.
5496 If LADSPA_PATH is set, it searches for the specified file.
5497 If it is not set, you must supply a fully specified pathname.
5499 Specifies the filter within the library.
5500 Some libraries contain only one filter, but others contain many of them.
5501 Entering 'help' here, will list all available filters within the specified
5502 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
5504 Controls are zero or more floating point values that determine the
5505 behavior of the loaded plugin (for example delay, threshold or gain).
5506 In verbose mode (add \-v to the MPlayer command line), all available controls
5507 and their valid ranges are printed.
5508 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
5514 Compressor/expander filter usable for microphone input.
5515 Prevents artifacts on very loud sound and raises the volume on
5517 This filter is untested, maybe even unusable.
5521 Noise gate filter similar to the comp audio filter.
5522 This filter is untested, maybe even unusable.
5526 Simple voice removal filter exploiting the fact that voice is
5527 usually recorded with mono gear and later 'center' mixed onto
5528 the final audio stream.
5529 Beware that this filter will turn your signal into mono.
5530 Works well for 2 channel tracks; do not bother trying it
5531 on anything but 2 channel stereo.
5534 .B scaletempo[=option1:option2:...]
5535 Scales audio tempo without altering pitch, optionally synced to playback
5538 This works by playing \'stride\' ms of audio at normal speed then
5539 consuming \'stride*scale\' ms of input audio.
5540 It pieces the strides together by blending \'overlap\'% of stride with
5541 audio following the previous stride.
5542 It optionally performs a short statistical analysis on the next \'search\'
5543 ms of audio to determine the best overlap position.
5547 Nominal amount to scale tempo.
5548 Scales this amount in addition to speed.
5550 .IPs stride=<amount>
5551 Length in milliseconds to output each stride.
5552 Too high of value will cause noticable skips at high scale amounts and
5553 an echo at low scale amounts.
5554 Very low values will alter pitch.
5555 Increasing improves performance.
5557 .IPs overlap=<percent>
5558 Percentage of stride to overlap.
5559 Decreasing improves performance.
5561 .IPs search=<amount>
5562 Length in milliseconds to search for best overlap position.
5563 Decreasing improves performance greatly.
5564 On slow systems, you will probably want to set this very low.
5566 .IPs speed=<tempo|pitch|both|none>
5567 Set response to speed change.
5570 Scale tempo in sync with speed (default).
5572 Reverses effect of filter.
5573 Scales pitch without altering tempo.
5574 Add \'[ speed_mult 0.9438743126816935\' and \'] speed_mult 1.059463094352953\'
5575 to your input.conf to step by musical semi-tones.
5577 Loses sync with video.
5579 Scale both tempo and pitch.
5581 Ignore speed changes.
5589 .IPs "mplayer \-af scaletempo \-speed 1.2 media.ogg"
5590 Would playback media at 1.2x normal speed, with audio at normal pitch.
5591 Changing playback speed, would change audio tempo to match.
5592 .IPs "mplayer \-af scaletempo=scale=1.2:speed=none \-speed 1.2 media.ogg"
5593 Would playback media at 1.2x normal speed, with audio at normal pitch,
5594 but changing playback speed has no effect on audio tempo.
5595 .IPs "mplayer \-af scaletempo=stride=30:overlap=.50:search=10 media.ogg"
5596 Would tweak the quality and performace parameters.
5597 .IPs "mplayer \-af format=floatne,scaletempo media.ogg"
5598 Would make scaletempo use float code.
5599 Maybe faster on some platforms.
5600 .IPs "mplayer \-af scaletempo=scale=1.2:speed=pitch audio.ogg"
5601 Would playback audio file at 1.2x normal speed, with audio at normal pitch.
5602 Changing playback speed, would change pitch, leaving audio tempo at 1.2x.
5608 Collects and prints statistics about the audio stream, especially the volume.
5609 These statistics are especially intended to help adjusting the volume while
5611 The volumes are printed in dB and compatible with the volume audio filter.
5616 Video filters allow you to modify the video stream and its properties.
5620 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
5621 Setup a chain of video filters.
5623 Many parameters are optional and set to default values if omitted.
5624 To explicitly use a default value set a parameter to '\-1'.
5625 Parameters w:h means width x height in pixels, x:y means x;y position counted
5626 from the upper left corner of the bigger image.
5629 To get a full list of available video filters, see \-vf help.
5631 Video filters are managed in lists.
5632 There are a few commands to manage the filter list.
5635 .B \-vf\-add <filter1[,filter2,...]>
5636 Appends the filters given as arguments to the filter list.
5639 .B \-vf\-pre <filter1[,filter2,...]>
5640 Prepends the filters given as arguments to the filter list.
5643 .B \-vf\-del <index1[,index2,...]>
5644 Deletes the filters at the given indexes.
5645 Index numbers start at 0, negative numbers address the end of the
5646 list (\-1 is the last).
5650 Completely empties the filter list.
5652 With filters that support it, you can access parameters by their name.
5655 .B \-vf <filter>=help
5656 Prints the parameter names and parameter value ranges for a particular
5660 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
5661 Sets a named parameter to the given value.
5662 Use on and off or yes and no to set flag parameters.
5664 Available filters are:
5668 Crops the given part of the image and discards the rest.
5669 Useful to remove black bands from widescreen movies.
5673 Cropped width and height, defaults to original width and height.
5675 Position of the cropped picture, defaults to center.
5680 .B cropdetect[=limit:round]
5681 Calculates necessary cropping parameters and prints the recommended parameters
5686 Threshold, which can be optionally specified from nothing (0) to
5687 everything (255) (default: 24).
5690 Value which the width/\:height should be divisible by (default: 16).
5691 The offset is automatically adjusted to center the video.
5692 Use 2 to get only even dimensions (needed for 4:2:2 video).
5693 16 is best when encoding to most video codecs.
5698 .B rectangle[=w:h:x:y]
5699 Draws a rectangle of the requested width and height at the specified
5700 coordinates over the image and prints current rectangle parameters
5702 This can be used to find optimal cropping parameters.
5703 If you bind the input.conf directive 'change_rectangle' to keystrokes,
5704 you can move and resize the rectangle on the fly.
5708 width and height (default: \-1, maximum possible width where boundaries
5711 top left corner position (default: \-1, uppermost leftmost)
5716 .B expand[=w:h:x:y:o:a:r]
5717 Expands (not scales) movie resolution to the given value and places the
5718 unscaled original at coordinates x, y.
5719 Can be used for placing subtitles/\:OSD in the resulting black bands.
5722 Expanded width,height (default: original width,height).
5723 Negative values for w and h are treated as offsets to the original size.
5728 .IP expand=0:\-50:0:0
5729 Adds a 50 pixel border to the bottom of the picture.
5733 position of original image on the expanded image (default: center)
5735 OSD/\:subtitle rendering
5737 0: disable (default)
5742 Expands to fit an aspect instead of a resolution (default: 0).
5747 .IP expand=800:::::4/3
5748 Expands to 800x600, unless the source is higher resolution, in which
5749 case it expands to fill a 4/3 aspect.
5753 Rounds up to make both width and height divisible by <r> (default: 1).
5757 .B flip (also see \-flip)
5758 Flips the image upside down.
5762 Mirrors the image on the Y axis.
5766 Rotates the image by 90 degrees and optionally flips it.
5767 For values between 4\-7 rotation is only done if the movie geometry is
5768 portrait and not landscape.
5771 Rotate by 90 degrees clockwise and flip (default).
5773 Rotate by 90 degrees clockwise.
5775 Rotate by 90 degrees counterclockwise.
5777 Rotate by 90 degrees counterclockwise and flip.
5781 .B scale[=w:h[:ilaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]]
5782 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
5783 colorspace conversion (also see \-sws).
5786 scaled width/\:height (default: original width/\:height)
5789 If \-zoom is used, and underlying filters (including libvo) are
5790 incapable of scaling, it defaults to d_width/\:d_height!
5792 0: scaled d_width/\:d_height
5794 \-1: original width/\:height
5796 \-2: Calculate w/h using the other dimension and the prescaled aspect ratio.
5798 \-3: Calculate w/h using the other dimension and the original aspect ratio.
5800 \-(n+8): Like \-n above, but rounding the dimension to the closest multiple of 16.
5803 Toggle interlaced scaling.
5812 0: Use all available input lines for chroma.
5814 1: Use only every 2. input line for chroma.
5816 2: Use only every 4. input line for chroma.
5818 3: Use only every 8. input line for chroma.
5820 .IPs "<par>[:<par2>] (also see \-sws)"
5821 Set some scaling parameters depending on the type of scaler selected
5824 \-sws 2 (bicubic): B (blurring) and C (ringing)
5828 0.00:0.75 VirtualDub's "precise bicubic"
5830 0.00:0.50 Catmull-Rom spline
5832 0.33:0.33 Mitchell-Netravali spline
5834 1.00:0.00 cubic B-spline
5836 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
5838 \-sws 9 (lanczos): filter length (1\-10)
5841 Scale to preset sizes.
5843 qntsc: 352x240 (NTSC quarter screen)
5845 qpal: 352x288 (PAL quarter screen)
5847 ntsc: 720x480 (standard NTSC)
5849 pal: 720x576 (standard PAL)
5851 sntsc: 640x480 (square pixel NTSC)
5853 spal: 768x576 (square pixel PAL)
5856 Disallow upscaling past the original dimensions.
5858 0: Allow upscaling (default).
5860 1: Disallow upscaling if one dimension exceeds its original value.
5862 2: Disallow upscaling if both dimensions exceed their original values.
5865 Accurate rounding for the vertical scaler, which may be faster
5866 or slower than the default rounding.
5868 0: Disable accurate rounding (default).
5870 1: Enable accurate rounding.
5875 .B dsize[=aspect|w:h:aspect-method:r]
5876 Changes the intended display size/\:aspect at an arbitrary point in the
5878 Aspect can be given as a fraction (4/3) or floating point number
5880 Alternatively, you may specify the exact display width and height
5882 Note that this filter does
5884 do any scaling itself; it just affects
5885 what later scalers (software or hardware) will do when auto-scaling to
5889 New display width and height.
5890 Can also be these special values:
5892 0: original display width and height
5894 \-1: original video width and height (default)
5896 \-2: Calculate w/h using the other dimension and the original display
5899 \-3: Calculate w/h using the other dimension and the original video
5907 Specifies a display resolution of 800x600 for a 4/3 aspect video, or
5908 800x450 for a 16/9 aspect video.
5910 .IPs <aspect-method>
5911 Modifies width and height according to original aspect ratios.
5913 \-1: Ignore original aspect ratio (default).
5915 0: Keep display aspect ratio by using <w> and <h> as maximum
5918 1: Keep display aspect ratio by using <w> and <h> as minimum
5921 2: Keep video aspect ratio by using <w> and <h> as maximum
5924 3: Keep video aspect ratio by using <w> and <h> as minimum
5932 Specifies a display resolution of at most 800x600, or smaller, in order
5937 Rounds up to make both width and height divisible by <r> (default: 1).
5942 Forces software YV12/\:I420/\:422P to YUY2 conversion.
5943 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
5947 Forces software YVU9 to YV12 colorspace conversion.
5948 Deprecated in favor of the software scaler.
5952 Clamps YUV color values to the CCIR 601 range without doing real conversion.
5956 RGB 24/32 <\-> BGR 24/32 colorspace conversion.
5960 Also perform R <\-> B swapping.
5966 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette.
5970 Restricts the colorspace for the next filter without doing any conversion.
5971 Use together with the scale filter for a real conversion.
5974 For a list of available formats see format=fmt=help.
5978 format name like rgb15, bgr24, yv12, etc (default: yuy2)
5983 .B noformat[=fourcc]
5984 Restricts the colorspace for the next filter without doing any conversion.
5985 Unlike the format filter, this will allow any colorspace
5987 the one you specify.
5990 For a list of available formats see noformat=fmt=help.
5994 format name like rgb15, bgr24, yv12, etc (default: yv12)
5999 .B pp[=filter1[:option1[:option2...]]/[\-]filter2...] (also see \-pphelp)
6000 Enables the specified chain of postprocessing subfilters.
6001 Subfilters must be separated by '/' and can be disabled by
6003 Each subfilter and some options have a short and a long name that can be
6004 used interchangeably, i.e.\& dr/dering are the same.
6005 All subfilters share common options to determine their scope:
6009 Automatically switch the subfilter off if the CPU is too slow.
6011 Do chrominance filtering, too (default).
6013 Do luminance filtering only (no chrominance).
6015 Do chrominance filtering only (no luminance).
6022 \-pphelp shows a list of available subfilters.
6024 Available subfilters are
6027 .IPs hb/hdeblock[:difference[:flatness]]
6028 horizontal deblocking filter
6030 <difference>: Difference factor where higher values mean
6031 more deblocking (default: 32).
6033 <flatness>: Flatness threshold where lower values mean
6034 more deblocking (default: 39).
6036 .IPs vb/vdeblock[:difference[:flatness]]
6037 vertical deblocking filter
6039 <difference>: Difference factor where higher values mean
6040 more deblocking (default: 32).
6042 <flatness>: Flatness threshold where lower values mean
6043 more deblocking (default: 39).
6045 .IPs ha/hadeblock[:difference[:flatness]]
6046 accurate horizontal deblocking filter
6048 <difference>: Difference factor where higher values mean
6049 more deblocking (default: 32).
6051 <flatness>: Flatness threshold where lower values mean
6052 more deblocking (default: 39).
6054 .IPs va/vadeblock[:difference[:flatness]]
6055 accurate vertical deblocking filter
6057 <difference>: Difference factor where higher values mean
6058 more deblocking (default: 32).
6060 <flatness>: Flatness threshold where lower values mean
6061 more deblocking (default: 39).
6064 The horizontal and vertical deblocking filters share the
6065 difference and flatness values so you cannot set
6066 different horizontal and vertical thresholds.
6069 experimental horizontal deblocking filter
6071 experimental vertical deblocking filter
6074 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]]
6075 temporal noise reducer
6077 <threshold1>: larger -> stronger filtering
6079 <threshold2>: larger -> stronger filtering
6081 <threshold3>: larger -> stronger filtering
6083 .IPs al/autolevels[:f/fullyrange]
6084 automatic brightness / contrast correction
6086 f/fullyrange: Stretch luminance to (0\-255).
6088 .IPs lb/linblenddeint
6089 Linear blend deinterlacing filter that deinterlaces the given block
6090 by filtering all lines with a (1 2 1) filter.
6091 .IPs li/linipoldeint
6092 Linear interpolating deinterlacing filter that deinterlaces the given block
6093 by linearly interpolating every second line.
6094 .IPs ci/cubicipoldeint
6095 Cubic interpolating deinterlacing filter deinterlaces the given block
6096 by cubically interpolating every second line.
6098 Median deinterlacing filter that deinterlaces the given block
6099 by applying a median filter to every second line.
6101 FFmpeg deinterlacing filter that deinterlaces the given block
6102 by filtering every second line with a (\-1 4 2 4 \-1) filter.
6104 Vertically applied FIR lowpass deinterlacing filter that deinterlaces
6105 the given block by filtering all lines with a (\-1 2 6 2 \-1) filter.
6106 .IPs fq/forceQuant[:quantizer]
6107 Overrides the quantizer table from the input with the constant
6108 quantizer you specify.
6110 <quantizer>: quantizer to use
6113 default pp filter combination (hb:a,vb:a,dr:a)
6115 fast pp filter combination (h1:a,v1:a,dr:a)
6117 high quality pp filter combination (ha:a:128:7,va:a,dr:a)
6125 .IPs "\-vf pp=hb/vb/dr/al"
6126 horizontal and vertical deblocking, deringing and automatic
6127 brightness/\:contrast
6128 .IPs "\-vf pp=de/\-al"
6129 default filters without brightness/\:contrast correction
6130 .IPs "\-vf pp=default/tmpnoise:1:2:3"
6131 Enable default filters & temporal denoiser.
6132 .IPs "\-vf pp=hb:y/vb:a"
6133 Horizontal deblocking on luminance only, and switch vertical deblocking
6134 on or off automatically depending on available CPU time.
6139 .B spp[=quality[:qp[:mode]]]
6140 Simple postprocessing filter that compresses and decompresses the
6141 image at several (or \- in the case of quality level 6 \- all)
6142 shifts and averages the results.
6147 Force quantization parameter (default: 0, use QP from video).
6149 0: hard thresholding (default)
6151 1: soft thresholding (better deringing, but blurrier)
6153 4: like 0, but also use B-frames' QP (may cause flicker)
6155 5: like 1, but also use B-frames' QP (may cause flicker)
6159 .B uspp[=quality[:qp]]
6160 Ultra simple & slow postprocessing filter that compresses and
6161 decompresses the image at several (or \- in the case of quality
6162 level 8 \- all) shifts and averages the results.
6163 The way this differs from the behavior of spp is that uspp actually
6164 encodes & decodes each case with libavcodec Snow, whereas spp uses
6165 a simplified intra only 8x8 DCT similar to MJPEG.
6170 Force quantization parameter (default: 0, use QP from video).
6174 .B fspp[=quality[:qp[:strength[:bframes]]]]
6175 faster version of the simple postprocessing filter
6178 4\-5 (equivalent to spp; default: 4)
6180 Force quantization parameter (default: 0, use QP from video).
6182 Filter strength, lower values mean more details but also more artifacts,
6183 while higher values make the image smoother but also blurrier (default:
6186 0: do not use QP from B-frames (default)
6188 1: use QP from B-frames too (may cause flicker)
6193 Variant of the spp filter, similar to spp=6 with 7 point DCT where
6194 only the center sample is used after IDCT.
6197 Force quantization parameter (default: 0, use QP from video).
6199 0: hard thresholding
6201 1: soft thresholding (better deringing, but blurrier)
6203 2: medium thresholding (default, good results)
6208 quantization parameter (QP) change filter
6211 some equation like "2+2*sin(PI*qp)"
6216 generic equation change filter
6219 Some equation, e.g.\& 'p(W-X\\,Y)' to flip the image horizontally.
6220 You can use whitespace to make the equation more readable.
6221 There are a couple of constants that can be used in the equation:
6227 X / Y: the coordinates of the current sample
6229 W / H: width and height of the image
6231 SW / SH: width/height scale depending on the currently filtered plane, e.g.\&
6232 1,1 and 0.5,0.5 for YUV 4:2:0.
6234 p(x,y): returns the value of the pixel at location x/y of the current plane.
6240 Generate various test patterns.
6243 .B rgbtest[=width:height]
6244 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
6245 You should see a red, green and blue stripe from top to bottom.
6248 Desired width of generated image (default: 0).
6249 0 means width of input image.
6252 Desired height of generated image (default: 0).
6253 0 means height of input image.
6257 .B lavc[=quality:fps]
6258 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV/\:V4L2.
6263 32\-: fixed bitrate in kbits
6265 force output fps (float value) (default: 0, autodetect based on height)
6269 .B dvbscale[=aspect]
6270 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
6271 calculating the y axis scaling in software to keep aspect.
6272 Only useful together with expand and scale.
6275 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
6276 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
6284 .IPs "\-vf dvbscale,scale=\-1:0,expand=\-1:576:\-1:\-1:1,lavc"
6285 FIXME: Explain what this does.
6290 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
6299 uniform noise (gaussian otherwise)
6301 temporal noise (noise pattern changes between frames)
6303 averaged temporal noise (smoother, but a lot slower)
6305 high quality (slightly better looking, slightly slower)
6307 mix random noise with a (semi)regular pattern
6312 .B denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6313 This filter aims to reduce image noise producing smooth images and making still
6314 images really still (This should enhance compressibility.).
6318 spatial luma strength (default: 4)
6319 .IPs <chroma_spatial>
6320 spatial chroma strength (default: 3)
6322 luma temporal strength (default: 6)
6324 chroma temporal strength (default: luma_tmp*chroma_spatial/luma_spatial)
6329 .B hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6330 High precision/\:quality version of the denoise3d filter.
6331 Parameters and usage are the same.
6334 .B ow[=depth[:luma_strength[:chroma_strength]]]
6335 Overcomplete Wavelet denoiser.
6339 Larger depth values will denoise lower frequency components more, but
6340 slow down filtering (default: 8).
6341 .IPs <luma_strength>
6342 luma strength (default: 1.0)
6343 .IPs <chroma_strength>
6344 chroma strength (default: 1.0)
6349 .B eq[=brightness:contrast] (OBSOLETE)
6350 Software equalizer with interactive controls just like the hardware
6351 equalizer, for cards/\:drivers that do not support brightness and
6352 contrast controls in hardware.
6353 Might also be useful with MEncoder, either for fixing poorly captured
6354 movies, or for slightly reducing contrast to mask artifacts and get by
6355 with lower bitrates.
6366 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
6367 Alternative software equalizer that uses lookup tables (very slow),
6368 allowing gamma correction in addition to simple brightness
6369 and contrast adjustment.
6370 Note that it uses the same MMX optimized code as \-vf eq if all
6371 gamma values are 1.0.
6372 The parameters are given as floating point values.
6376 initial gamma value (default: 1.0)
6378 initial contrast, where negative values result in a
6379 negative image (default: 1.0)
6381 initial brightness (default: 0.0)
6383 initial saturation (default: 1.0)
6385 gamma value for the red component (default: 1.0)
6387 gamma value for the green component (default: 1.0)
6389 gamma value for the blue component (default: 1.0)
6391 The weight parameter can be used to reduce the effect of a high gamma value on
6392 bright image areas, e.g.\& keep them from getting overamplified and just plain
6394 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
6395 at its full strength (default: 1.0).
6400 .B hue[=hue:saturation]
6401 Software equalizer with interactive controls just like the hardware
6402 equalizer, for cards/\:drivers that do not support hue and
6403 saturation controls in hardware.
6407 initial hue (default: 0.0)
6409 initial saturation, where negative values result
6410 in a negative chroma (default: 1.0)
6416 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
6417 keeping all chroma samples.
6418 Useful for output to low-resolution display devices when hardware downscaling
6419 is poor quality or is not available.
6420 Can also be used as a primitive luma-only deinterlacer with very low CPU
6425 By default, halfpack averages pairs of lines when downsampling.
6426 Any value different from 0 or 1 gives the default (averaging) behavior.
6428 0: Only use even lines when downsampling.
6430 1: Only use odd lines when downsampling.
6437 When interlaced video is stored in YUV 4:2:0 formats, chroma
6438 interlacing does not line up properly due to vertical downsampling of
6439 the chroma channels.
6440 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
6441 the chroma lines in their proper locations, so that in any given
6442 scanline, the luma and chroma data both come from the same field.
6446 Select the sampling mode.
6448 0: nearest-neighbor sampling, fast but incorrect
6450 1: linear interpolation (default)
6457 Only useful with MEncoder.
6458 If harddup is used when encoding, it will force duplicate frames to be
6459 encoded in the output.
6460 This uses slightly more space, but is necessary for output to MPEG
6461 files or if you plan to demux and remux the video stream after
6463 Should be placed at or near the end of the filter chain unless you
6464 have a good reason to do otherwise.
6468 Only useful with MEncoder.
6469 Softskip moves the frame skipping (dropping) step of encoding from
6470 before the filter chain to some point during the filter chain.
6471 This allows filters which need to see all frames (inverse telecine,
6472 temporal denoising, etc.) to function properly.
6473 Should be placed after the filters which need to see all frames and
6474 before any subsequent filters that are CPU-intensive.
6477 .B decimate[=max:hi:lo:frac]
6478 Drops frames that do not differ greatly from the previous frame in
6479 order to reduce framerate.
6480 The main use of this filter is for very-low-bitrate encoding (e.g.\&
6481 streaming over dialup modem), but it could in theory be used for
6482 fixing movies that were inverse-telecined incorrectly.
6486 Sets the maximum number of consecutive frames which can be
6487 dropped (if positive), or the minimum interval between
6488 dropped frames (if negative).
6489 .IPs <hi>,<lo>,<frac>
6490 A frame is a candidate for dropping if no 8x8 region differs by more
6491 than a threshold of <hi>, and if not more than <frac> portion (1
6492 meaning the whole image) differs by more than a threshold of <lo>.
6493 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
6494 pixel value differences, so a threshold of 64 corresponds to 1 unit of
6495 difference for each pixel, or the same spread out differently over the
6501 .B dint[=sense:level]
6502 The drop-deinterlace (dint) filter detects and drops the first from a set
6503 of interlaced video frames.
6507 relative difference between neighboring pixels (default: 0.1)
6509 What part of the image has to be detected as interlaced to
6510 drop the frame (default: 0.15).
6515 .B lavcdeint (OBSOLETE)
6516 FFmpeg deinterlacing filter, same as \-vf pp=fd
6519 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
6520 Donald Graft's adaptive kernel deinterlacer.
6521 Deinterlaces parts of a video if a configurable threshold is exceeded.
6525 threshold (default: 10)
6528 0: Ignore pixels exceeding the threshold (default).
6530 1: Paint pixels exceeding the threshold white.
6534 0: Leave fields alone (default).
6540 0: Disable additional sharpening (default).
6542 1: Enable additional sharpening.
6546 0: Disable twoway sharpening (default).
6548 1: Enable twoway sharpening.
6554 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
6555 unsharp mask / gaussian blur
6558 Apply effect on luma component.
6560 Apply effect on chroma components.
6561 .IPs <width>x<height>
6562 width and height of the matrix, odd sized in both directions
6563 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
6565 Relative amount of sharpness/\:blur to add to the image
6566 (a sane range should be \-1.5\-1.5).
6579 .B il[=d|i][s][:[d|i][s]]
6580 (De)interleaves lines.
6581 The goal of this filter is to add the ability to process interlaced images
6582 pre-field without deinterlacing them.
6583 You can filter your interlaced DVD and play it on a TV without breaking the
6585 While deinterlacing (with the postprocessing filter) removes interlacing
6586 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
6587 2 fields (so called half pictures), so you can process (filter) them
6588 independently and then re-interleave them.
6592 deinterleave (placing one above the other)
6596 swap fields (exchange even & odd lines)
6602 (De)interleaves lines.
6603 This filter is very similar to the il filter but much faster, the main
6604 disadvantage is that it does not always work.
6605 Especially if combined with other filters it may produce randomly messed
6606 up images, so be happy if it works but do not complain if it does not for
6607 your combination of filters.
6611 Deinterleave fields, placing them side by side.
6613 Interleave fields again (reversing the effect of fil=d).
6619 Extracts a single field from an interlaced image using stride arithmetic
6620 to avoid wasting CPU time.
6621 The optional argument n specifies whether to extract the even or the odd
6622 field (depending on whether n is even or odd).
6625 .B detc[=var1=value1:var2=value2:...]
6626 Attempts to reverse the 'telecine' process to recover a clean,
6627 non-interlaced stream at film framerate.
6628 This was the first and most primitive inverse telecine filter to be
6629 added to MPlayer/\:MEncoder.
6630 It works by latching onto the telecine 3:2 pattern and following it as
6632 This makes it suitable for perfectly-telecined material, even in the
6633 presence of a fair degree of noise, but it will fail in the presence
6634 of complex post-telecine edits.
6635 Development on this filter is no longer taking place, as ivtc, pullup,
6636 and filmdint are better for most applications.
6637 The following arguments (see syntax above) may be used to control
6641 Set the frame dropping mode.
6643 0: Do not drop frames to maintain fixed output framerate (default).
6645 1: Always drop a frame when there have been no drops or telecine
6646 merges in the past 5 frames.
6648 2: Always maintain exact 5:4 input to output frame ratio.
6651 Use mode 1 or 2 with MEncoder.
6656 0: Fixed pattern with initial frame number specified by <fr>.
6658 1: aggressive search for telecine pattern (default)
6661 Set initial frame number in sequence.
6662 0\-2 are the three clean progressive frames; 3 and 4 are the two
6664 The default, \-1, means 'not in telecine sequence'.
6665 The number specified here is the type for the imaginary previous
6666 frame before the movie starts.
6667 .IPs "<t0>, <t1>, <t2>, <t3>"
6668 Threshold values to be used in certain modes.
6673 Experimental 'stateless' inverse telecine filter.
6674 Rather than trying to lock on to a pattern like the detc filter does,
6675 ivtc makes its decisions independently for each frame.
6676 This will give much better results for material that has undergone
6677 heavy editing after telecine was applied, but as a result it is not as
6678 forgiving of noisy input, for example TV capture.
6679 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
6680 detc filter, and should be used with MEncoder but not with MPlayer.
6681 As with detc, you must specify the correct output framerate (\-ofps
6682 24000/1001) when using MEncoder.
6683 Further development on ivtc has stopped, as the pullup and filmdint
6684 filters appear to be much more accurate.
6687 .B pullup[=jl:jr:jt:jb:sb:mp]
6688 Third-generation pulldown reversal (inverse telecine) filter,
6689 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
6690 fps progressive content.
6691 The pullup filter is designed to be much more robust than detc or
6692 ivtc, by taking advantage of future context in making its decisions.
6693 Like ivtc, pullup is stateless in the sense that it does not lock onto
6694 a pattern to follow, but it instead looks forward to the following
6695 fields in order to identify matches and rebuild progressive frames.
6696 It is still under development, but believed to be quite accurate.
6698 .IPs "jl, jr, jt, and jb"
6699 These options set the amount of "junk" to ignore at
6700 the left, right, top, and bottom of the image, respectively.
6701 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
6703 The default is 8 pixels on each side.
6705 .IPs "sb (strict breaks)"
6706 Setting this option to 1 will reduce the chances of
6707 pullup generating an occasional mismatched frame, but it may also
6708 cause an excessive number of frames to be dropped during high motion
6710 Conversely, setting it to \-1 will make pullup match fields more
6712 This may help processing of video where there is slight blurring
6713 between the fields, but may also cause there to be interlaced frames
6716 .IPs "mp (metric plane)"
6717 This option may be set to 1 or 2 to use a chroma
6718 plane instead of the luma plane for doing pullup's computations.
6719 This may improve accuracy on very clean source material, but more
6720 likely will decrease accuracy, especially if there is chroma noise
6721 (rainbow effect) or any grayscale video.
6722 The main purpose of setting mp to a chroma plane is to reduce CPU load
6723 and make pullup usable in realtime on slow machines.
6728 Always follow pullup with the softskip filter when encoding to ensure
6729 that pullup is able to see each frame.
6730 Failure to do so will lead to incorrect output and will usually crash,
6731 due to design limitations in the codec/\:filter layer.
6735 .B filmdint[=options]
6736 Inverse telecine filter, similar to the pullup filter above.
6737 It is designed to handle any pulldown pattern, including mixed soft and
6738 hard telecine and limited support for movies that are slowed down or sped
6739 up from their original framerate for TV.
6740 Only the luma plane is used to find the frame breaks.
6741 If a field has no match, it is deinterlaced with simple linear
6743 If the source is MPEG-2, this must be the first filter to allow
6744 access to the field-flags set by the MPEG-2 decoder.
6745 Depending on the source MPEG, you may be fine ignoring this advice, as
6746 long as you do not see lots of "Bottom-first field" warnings.
6747 With no options it does normal inverse telecine, and should be used
6748 together with mencoder \-fps 30000/1001 \-ofps 24000/1001.
6749 When this filter is used with MPlayer, it will result in an uneven
6750 framerate during playback, but it is still generally better than using
6751 pp=lb or no deinterlacing at all.
6752 Multiple options can be specified separated by /.
6754 .IPs crop=<w>:<h>:<x>:<y>
6755 Just like the crop filter, but faster, and works on mixed hard and soft
6756 telecined content as well as when y is not a multiple of 4.
6757 If x or y would require cropping fractional pixels from the chroma
6758 planes, the crop area is extended.
6759 This usually means that x and y must be even.
6760 .IPs io=<ifps>:<ofps>
6761 For each ifps input frames the filter will output ofps frames.
6762 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio.
6763 This could be used to filter movies that are broadcast on TV at a frame
6764 rate different from their original framerate.
6766 If n is nonzero, the chroma plane is copied unchanged.
6767 This is useful for YV12 sampled TV, which discards one of the chroma
6770 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
6771 optimized functions, otherwise, use plain C.
6772 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
6773 this option to override auto-detection.
6775 The larger n will speed up the filter at the expense of accuracy.
6776 The default value is n=3.
6777 If n is odd, a frame immediately following a frame marked with the
6778 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
6779 will not spend any time on soft-telecined MPEG-2 content.
6780 This is the only effect of this flag if MMX2 or 3DNow! is available.
6781 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
6783 If n=2 or 3, the number of luma levels used to find the frame breaks is
6784 reduced from 256 to 128, which results in a faster filter without losing
6786 If n=4 or 5, a faster, but much less accurate metric will be used to
6787 find the frame breaks, which is more likely to misdetect high vertical
6788 detail as interlaced content.
6790 If n is nonzero, print the detailed metrics for each frame.
6791 Useful for debugging.
6793 Deinterlace threshold.
6794 Used during de-interlacing of unmatched frames.
6795 Larger value means less deinterlacing, use n=256 to completely turn off
6799 Threshold for comparing a top and bottom fields.
6802 Threshold to detect temporal change of a field.
6805 Sum of Absolute Difference threshold, default is 64.
6810 This filter works only correct with MEncoder and acts on the MPEG-2 flags
6811 used for soft 3:2 pulldown (soft telecine).
6812 If you want to use the ivtc or detc filter on movies that are partly soft
6813 telecined, inserting this filter before them should make them more reliable.
6817 Inverse telecine for deinterlaced video.
6818 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
6819 using a method that keeps one field and interpolates the other, the result is
6820 a juddering video that has every fourth frame duplicated.
6821 This filter is intended to find and drop those duplicates and restore the
6822 original film framerate.
6823 When using this filter, you must specify \-ofps that is 4/5 of
6824 the fps of the input file and place the softskip later in the
6825 filter chain to make sure that divtc sees all the frames.
6826 Two different modes are available:
6827 One pass mode is the default and is straightforward to use,
6828 but has the disadvantage that any changes in the telecine
6829 phase (lost frames or bad edits) cause momentary judder
6830 until the filter can resync again.
6831 Two pass mode avoids this by analyzing the whole video
6832 beforehand so it will have forward knowledge about the
6833 phase changes and can resync at the exact spot.
6836 correspond to pass one and two of the encoding process.
6837 You must run an extra pass using divtc pass one before the
6838 actual encoding throwing the resulting video away.
6839 Use \-nosound \-ovc raw \-o /dev/null to avoid
6840 wasting CPU power for this pass.
6841 You may add something like crop=2:2:0:0 after divtc
6842 to speed things up even more.
6843 Then use divtc pass two for the actual encoding.
6844 If you use multiple encoder passes, use divtc
6845 pass two for all of them.
6850 .IPs file=<filename>
6851 Set the two pass log filename (default: "framediff.log").
6852 .IPs threshold=<value>
6853 Set the minimum strength the telecine pattern must have for the filter to
6854 believe in it (default: 0.5).
6855 This is used to avoid recognizing false pattern from the parts of the video
6856 that are very dark or very still.
6857 .IPs window=<numframes>
6858 Set the number of past frames to look at when searching for pattern
6860 Longer window improves the reliability of the pattern search, but shorter
6861 window improves the reaction time to the changes in the telecine phase.
6862 This only affects the one pass mode.
6863 The two pass mode currently uses fixed window that extends to both future
6865 .IPs phase=0|1|2|3|4
6866 Sets the initial telecine phase for one pass mode (default: 0).
6867 The two pass mode can see the future, so it is able to use the correct
6868 phase from the beginning, but one pass mode can only guess.
6869 It catches the correct phase when it finds it, but this option can be used
6870 to fix the possible juddering at the beginning.
6871 The first pass of the two pass mode also uses this, so if you save the output
6872 from the first pass, you get constant phase result.
6873 .IPs deghost=<value>
6874 Set the deghosting threshold (0\-255 for one pass mode, \-255\-255 for two pass
6876 If nonzero, deghosting mode is used.
6877 This is for video that has been deinterlaced by blending the fields
6878 together instead of dropping one of the fields.
6879 Deghosting amplifies any compression artifacts in the blended frames, so the
6880 parameter value is used as a threshold to exclude those pixels from
6881 deghosting that differ from the previous frame less than specified value.
6882 If two pass mode is used, then negative value can be used to make the
6883 filter analyze the whole video in the beginning of pass-2 to determine
6884 whether it needs deghosting or not and then select either zero or the
6885 absolute value of the parameter.
6886 Specify this option for pass-2, it makes no difference on pass-1.
6890 .B phase[=t|b|p|a|u|T|B|A|U][:v]
6891 Delay interlaced video by one field time so that the field order
6893 The intended use is to fix PAL movies that have been captured with the
6894 opposite field order to the film-to-video transfer.
6898 Capture field order top-first, transfer bottom-first.
6899 Filter will delay the bottom field.
6901 Capture bottom-first, transfer top-first.
6902 Filter will delay the top field.
6904 Capture and transfer with the same field order.
6905 This mode only exists for the documentation of the other options to refer to,
6906 but if you actually select it, the filter will faithfully do nothing ;-)
6908 Capture field order determined automatically by field flags, transfer opposite.
6909 Filter selects among t and b modes on a frame by frame basis using field flags.
6910 If no field information is available, then this works just like u.
6912 Capture unknown or varying, transfer opposite.
6913 Filter selects among t and b on a frame by frame basis by analyzing the
6914 images and selecting the alternative that produces best match between the
6917 Capture top-first, transfer unknown or varying.
6918 Filter selects among t and p using image analysis.
6920 Capture bottom-first, transfer unknown or varying.
6921 Filter selects among b and p using image analysis.
6923 Capture determined by field flags, transfer unknown or varying.
6924 Filter selects among t, b and p using field flags and image analysis.
6925 If no field information is available, then this works just like U.
6926 This is the default mode.
6928 Both capture and transfer unknown or varying.
6929 Filter selects among t, b and p using image analysis only.
6932 Prints the selected mode for each frame and the average squared difference
6933 between fields for t, b, and p alternatives.
6938 Apply 3:2 'telecine' process to increase framerate by 20%.
6939 This most likely will not work correctly with MPlayer, but it can
6940 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'.
6941 Both fps options are essential!
6942 (A/V sync will break if they are wrong.)
6943 The optional start parameter tells the filter where in the telecine
6944 pattern to start (0\-3).
6947 .B tinterlace[=mode]
6948 Temporal field interlacing \- merge pairs of frames into an interlaced
6949 frame, halving the framerate.
6950 Even frames are moved into the upper field, odd frames to the lower field.
6951 This can be used to fully reverse the effect of the tfields filter (in mode 0).
6952 Available modes are:
6956 Move odd frames into the upper field, even into the lower field, generating
6957 a full-height frame at half framerate.
6959 Only output odd frames, even frames are dropped; height unchanged.
6961 Only output even frames, odd frames are dropped; height unchanged.
6963 Expand each frame to full height, but pad alternate lines with black;
6964 framerate unchanged.
6966 Interleave even lines from even frames with odd lines from odd frames.
6967 Height unchanged at half framerate.
6972 .B tfields[=mode[:field_dominance]]
6973 Temporal field separation \- split fields into frames, doubling the
6975 Like the telecine filter, tfields will only work properly with
6976 MEncoder, and only if both \-fps and \-ofps are set to the
6977 desired (double) framerate!
6981 0: Leave fields unchanged (will jump/\:flicker).
6983 1: Interpolate missing lines. (The algorithm used might not be so good.)
6985 2: Translate fields by 1/4 pixel with linear interpolation (no jump).
6987 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default).
6988 .IPs <field_dominance>\ (DEPRECATED)
6990 Only works if the decoder exports the appropriate information and
6991 no other filters which discard that information come before tfields
6992 in the filter chain, otherwise it falls back to 0 (top field first).
6996 1: bottom field first
6999 This option will possibly be removed in a future version.
7000 Use \-field\-dominance instead.
7005 .B yadif=[mode[:field_dominance]]
7006 Yet another deinterlacing filter
7010 0: Output 1 frame for each frame.
7012 1: Output 1 frame for each field.
7014 2: Like 0 but skips spatial interlacing check.
7016 3: Like 1 but skips spatial interlacing check.
7017 .IPs <field_dominance>\ (DEPRECATED)
7018 Operates like tfields.
7021 This option will possibly be removed in a future version.
7022 Use \-field\-dominance instead.
7027 .B mcdeint=[mode[:parity[:qp]]]
7028 Motion compensating deinterlacer.
7029 It needs one field per frame as input and must thus be used together
7030 with tfields=1 or yadif=1/3 or equivalent.
7038 2: slow, iterative motion estimation
7040 3: extra slow, like 2 plus multiple reference frames
7042 0 or 1 selects which field to use (note: no autodetection yet!).
7044 Higher values should result in a smoother motion vector
7045 field but less optimal individual vectors.
7050 .B boxblur=radius:power[:radius:power]
7055 blur filter strength
7057 number of filter applications
7062 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
7067 blur filter strength (~0.1\-4.0) (slower if larger)
7069 prefilter strength (~0.1\-2.0)
7071 maximum difference between pixels to still be considered (~0.1\-100.0)
7076 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
7081 blur filter strength (~0.1\-5.0) (slower if larger)
7083 blur (0.0\-1.0) or sharpen (\-1.0\-0.0)
7085 filter all (0), filter flat areas (0\-30) or filter edges (\-30\-0)
7090 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
7091 Correct the perspective of movies not filmed perpendicular to the screen.
7095 coordinates of the top left, top right, bottom left, bottom right corners
7097 linear (0) or cubic resampling (1)
7103 Scale and smooth the image with the 2x scale and interpolate algorithm.
7107 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
7110 .B down3dright[=lines]
7111 Reposition and resize stereoscopic images.
7112 Extracts both stereo fields and places them side by side, resizing
7113 them to maintain the original movie aspect.
7117 number of lines to select from the middle of the image (default: 12)
7122 .B bmovl=hidden:opaque:fifo
7123 The bitmap overlay filter reads bitmaps from a FIFO and displays them
7124 on top of the movie, allowing some transformations on the image.
7125 Also see TOOLS/bmovl-test.c for a small bmovl test program.
7129 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
7131 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
7133 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the
7134 controlling application)
7143 .IPs "RGBA32 width height xpos ypos alpha clear"
7144 followed by width*height*4 Bytes of raw RGBA32 data.
7145 .IPs "ABGR32 width height xpos ypos alpha clear"
7146 followed by width*height*4 Bytes of raw ABGR32 data.
7147 .IPs "RGB24 width height xpos ypos alpha clear"
7148 followed by width*height*3 Bytes of raw RGB24 data.
7149 .IPs "BGR24 width height xpos ypos alpha clear"
7150 followed by width*height*3 Bytes of raw BGR24 data.
7151 .IPs "ALPHA width height xpos ypos alpha"
7152 Change alpha transparency of the specified area.
7153 .IPs "CLEAR width height xpos ypos"
7156 Disable all alpha transparency.
7157 Send "ALPHA 0 0 0 0 0" to enable it again.
7170 .IPs "<width>, <height>"
7172 .IPs "<xpos>, <ypos>"
7173 Start blitting at position x/y.
7175 Set alpha difference.
7176 If you set this to \-255 you can then send a sequence of ALPHA-commands to set
7177 the area to \-225, \-200, \-175 etc for a nice fade-in-effect! ;)
7181 255: Make everything opaque.
7183 \-255: Make everything transparent.
7186 Clear the framebuffer before blitting.
7188 0: The image will just be blitted on top of the old one, so you do not need to
7189 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
7197 .B framestep=I|[i]step
7198 Renders only every nth frame or every intra frame (keyframe).
7200 If you call the filter with I (uppercase) as the parameter, then
7202 keyframes are rendered.
7203 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB),
7204 for AVI it means every scene change or every keyint value (see \-lavcopts
7205 keyint= value if you use MEncoder to encode the video).
7207 When a keyframe is found, an 'I!' string followed by a newline character is
7208 printed, leaving the current line of MPlayer/\:MEncoder output on the screen,
7209 because it contains the time (in seconds) and frame number of the keyframe
7210 (You can use this information to split the AVI.).
7212 If you call the filter with a numeric parameter 'step' then only one in
7213 every 'step' frames is rendered.
7215 If you put an 'i' (lowercase) before the number then an 'I!' is printed
7216 (like the I parameter).
7218 If you give only the i then nothing is done to the frames, only I! is
7222 .B tile=xtiles:ytiles:output:start:delta
7223 Tile a series of images into a single, bigger image.
7224 If you omit a parameter or use a value less than 0, then the default
7226 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
7227 It is probably a good idea to put the scale filter before the tile :-)
7234 number of tiles on the x axis (default: 5)
7236 number of tiles on the y axis (default: 5)
7238 Render the tile when 'output' number of frames are reached, where 'output'
7239 should be a number less than xtile * ytile.
7240 Missing tiles are left blank.
7241 You could, for example, write an 8 * 7 tile every 50 frames to have one
7242 image every 2 seconds @ 25 fps.
7244 outer border thickness in pixels (default: 2)
7246 inner border thickness in pixels (default: 4)
7251 .B delogo[=x:y:w:h:t]
7252 Suppresses a TV station logo by a simple interpolation of the
7254 Just set a rectangle covering the logo and watch it disappear (and
7255 sometimes something even uglier appear \- your mileage may vary).
7259 top left corner of the logo
7261 width and height of the cleared rectangle
7263 Thickness of the fuzzy edge of the rectangle (added to w and h).
7264 When set to \-1, a green rectangle is drawn on the screen to
7265 simplify finding the right x,y,w,h parameters.
7270 .B remove\-logo=/path/to/logo_bitmap_file_name.pgm
7271 Suppresses a TV station logo, using a PGM or PPM image
7272 file to determine which pixels comprise the logo.
7273 The width and height of the image file must match
7274 those of the video stream being processed.
7275 Uses the filter image and a circular blur
7276 algorithm to remove the logo.
7278 .IPs /path/to/logo_bitmap_file_name.pgm
7279 [path] + filename of the filter image.
7283 .B zrmjpeg[=options]
7284 Software YV12 to MJPEG encoder for use with the zr2 video
7287 .IPs maxheight=<h>|maxwidth=<w>
7288 These options set the maximum width and height the zr card
7289 can handle (the MPlayer filter layer currently cannot query those).
7290 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
7291 Use these options to set maxwidth and maxheight automatically to the
7292 values known for card/\:mode combo.
7293 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL)
7295 Select color or black and white encoding.
7296 Black and white encoding is faster.
7297 Color is the default.
7299 Horizontal decimation 1, 2 or 4.
7301 Vertical decimation 1, 2 or 4.
7303 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD].
7305 By default, decimation is only performed if the Zoran hardware
7306 can upscale the resulting MJPEG images to the original size.
7307 The option fd instructs the filter to always perform the requested
7313 Allows acquiring screenshots of the movie using slave mode
7314 commands that can be bound to keypresses.
7315 See the slave mode documentation and the INTERACTIVE CONTROL
7316 section for details.
7317 Files named 'shotNNNN.png' will be saved in the working directory,
7318 using the first available number \- no files will be overwritten.
7319 The filter has no overhead when not used and accepts an arbitrary
7320 colorspace, so it is safe to add it to the configuration file.
7325 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
7326 Only useful with the \-ass option.
7331 .IPs "\-vf ass,screenshot"
7332 Moves SSA/ASS rendering before the screenshot filter.
7333 Screenshots taken this way will contain subtitles.
7338 .B blackframe[=amount:threshold]
7339 Detect frames that are (almost) completely black.
7340 Can be useful to detect chapter transitions or commercials.
7341 Output lines consist of the frame number of the detected frame, the
7342 percentage of blackness, the frame type and the frame number of the last
7343 encountered keyframe.
7346 Percentage of the pixels that have to be below the threshold (default: 98).
7348 Threshold below which a pixel value is considered black (default: 32).
7353 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
7356 .B \-audio\-delay <any floating-point number>
7357 Delays either audio or video by setting a delay field in the header
7359 This does not delay either stream while encoding, but the player will
7360 see the delay field and compensate accordingly.
7361 Positive values delay the audio, and negative values delay the video.
7362 Note that this is the exact opposite of the \-delay option.
7363 For example, if a video plays correctly with \-delay 0.2, you can
7364 fix the video with MEncoder by using \-audio\-delay \-0.2.
7366 Currently, this option only works with the default muxer (\-of avi).
7367 If you are using a different muxer, then you must use \-delay instead.
7370 .B \-audio\-density <1\-50>
7371 Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
7374 CBR only, VBR ignores this as it puts each packet in a new chunk.
7377 .B \-audio\-preload <0.0\-2.0>
7378 Sets up the audio buffering time interval (default: 0.5s).
7381 .B \-fafmttag <format>
7382 Can be used to override the audio format tag of the output file.
7387 .IPs "\-fafmttag 0x55"
7388 Will have the output file contain 0x55 (mp3) as audio format tag.
7393 .B \-ffourcc <fourcc>
7394 Can be used to override the video fourcc of the output file.
7399 .IPs "\-ffourcc div3"
7400 Will have the output file contain 'div3' as video fourcc.
7405 .B \-force\-avi\-aspect <0.2\-3.0>
7406 Override the aspect stored in the AVI OpenDML vprp header.
7407 This can be used to change the aspect ratio with '\-ovc copy'.
7410 .B \-frameno\-file <filename> (DEPRECATED)
7411 Specify the name of the audio file with framenumber mappings created in
7412 the first (audio only) pass of a special three pass encoding mode.
7415 Using this mode will most likely give you A-V desync.
7417 It is kept for backwards compatibility only and will possibly
7418 be removed in a future version.
7422 Use a more precise, but much slower method for skipping areas.
7423 Areas marked for skipping are not seeked over, instead all
7424 frames are decoded, but only the necessary frames are encoded.
7425 This allows starting at non-keyframe boundaries.
7428 Not guaranteed to work right with '\-ovc copy'.
7431 .B \-info <option1:option2:...> (AVI only)
7432 Specify the info header of the resulting AVI file.
7434 Available options are:
7437 Show this description.
7441 artist or author of the work
7443 original work category
7444 .IPs subject=<value>
7445 contents of the work
7446 .IPs copyright=<value>
7447 copyright information
7448 .IPs srcform=<value>
7449 original format of the digitized material
7450 .IPs comment=<value>
7451 general comments about the work
7456 Do not automatically insert the expand filter into the MEncoder filter chain.
7457 Useful to control at which point of the filter chain subtitles are rendered
7458 when hardcoding subtitles onto a movie.
7462 Do not attempt to encode duplicate frames in duplicate; always output
7463 zero-byte frames to indicate duplicates.
7464 Zero-byte frames will be written anyway unless a filter or encoder
7465 capable of doing duplicate encoding is loaded.
7466 Currently the only such filter is harddup.
7469 .B \-noodml (\-of avi only)
7470 Do not write OpenDML index for AVI files >1GB.
7478 Outputs to the given filename.
7480 If you want a default output filename, you can put this option in the
7481 MEncoder config file.
7484 .B \-oac <codec name>
7485 Encode with the given audio codec (no default set).
7488 Use \-oac help to get a list of available audio codecs.
7494 no encoding, just streamcopy
7496 Encode to uncompressed PCM.
7497 .IPs "\-oac mp3lame"
7498 Encode to MP3 (using LAME).
7500 Encode with a libavcodec codec.
7505 .B \-of <format> (BETA CODE!)
7506 Encode to the specified container format (default: AVI).
7509 Use \-of help to get a list of available container formats.
7517 Encode to MPEG (also see \-mpegopts).
7519 Encode with libavformat muxers (also see \-lavfopts).
7520 .IPs "\-of rawvideo"
7521 raw video stream (no muxing \- one video stream only)
7522 .IPs "\-of rawaudio"
7523 raw audio stream (no muxing \- one audio stream only)
7529 Specify a frames per second (fps) value for the output file,
7530 which can be different from that of the source material.
7531 Must be set for variable fps (ASF, some MOV) and progressive
7532 (30000/1001 fps telecined MPEG) files.
7535 .B \-ovc <codec name>
7536 Encode with the given video codec (no default set).
7539 Use \-ovc help to get a list of available video codecs.
7545 no encoding, just streamcopy
7547 Encode to an arbitrary uncompressed format (use '\-vf format' to select).
7549 Encode with a libavcodec codec.
7554 .B \-passlogfile <filename>
7555 Dump first pass information to <filename> instead of the default divx2pass.log
7556 in two pass encoding mode.
7559 .B \-skiplimit <value>
7560 Specify the maximum number of frames that may be skipped after
7561 encoding one frame (\-noskiplimit for unlimited).
7564 .B \-vobsubout <basename>
7565 Specify the basename for the output .idx and .sub files.
7566 This turns off subtitle rendering in the encoded movie and diverts it to
7567 VOBsub subtitle files.
7570 .B \-vobsuboutid <langid>
7571 Specify the language two letter code for the subtitles.
7572 This overrides what is read from the DVD or the .ifo file.
7575 .B \-vobsuboutindex <index>
7576 Specify the index of the subtitles in the output files (default: 0).
7580 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
7581 You can specify codec specific encoding parameters using the following
7585 .B \-<codec>opts <option1[=value1]:option2[=value2]:...>
7588 Where <codec> may be: lavc, xvidenc, mp3lame, toolame, twolame,
7589 nuv, xvfw, faac, x264enc, mpeg, lavf.
7592 .SS mp3lame (\-lameopts)
7600 variable bitrate method
7623 Also forces CBR mode encoding on subsequent ABR presets modes.
7627 bitrate in kbps (CBR and ABR only)
7631 quality (0 \- highest, 9 \- lowest) (VBR only)
7635 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest)
7676 Switch on faster encoding on subsequent VBR presets modes.
7677 This results in slightly lower quality and higher bitrates.
7680 .B highpassfreq=<freq>
7681 Set a highpass filtering frequency in Hz.
7682 Frequencies below the specified one will be cut off.
7683 A value of \-1 will disable filtering, a value of 0
7684 will let LAME choose values automatically.
7687 .B lowpassfreq=<freq>
7688 Set a lowpass filtering frequency in Hz.
7689 Frequencies above the specified one will be cut off.
7690 A value of \-1 will disable filtering, a value of 0
7691 will let LAME choose values automatically.
7698 Print additional options and information about presets settings.
7700 VBR encoding, good quality, 150\-180 kbps bitrate range
7702 VBR encoding, high quality, 170\-210 kbps bitrate range
7704 VBR encoding, very high quality, 200\-240 kbps bitrate range
7706 CBR encoding, highest preset quality, 320 kbps bitrate
7708 ABR encoding at average given kbps bitrate
7716 .IPs fast:preset=standard
7717 suitable for most people and most music types and already quite high quality
7719 Encode with ABR presets at a 192 kbps forced constant bitrate.
7721 Encode with ABR presets at a 172 kbps average bitrate.
7723 for people with extremely good hearing and similar equipment
7728 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively)
7732 In CBR mode this parameter indicates the bitrate in kbps,
7733 when in VBR mode it is the minimum bitrate allowed per frame.
7734 VBR mode will not work with a value below 112.
7737 .B vbr=<\-50\-50> (VBR only)
7738 variability range; if negative the encoder shifts the average bitrate
7739 towards the lower limit, if positive towards the higher.
7740 When set to 0 CBR is used (default).
7743 .B maxvbr=<32\-384> (VBR only)
7744 maximum bitrate allowed per frame, in kbps
7747 .B mode=<stereo | jstereo | mono | dual>
7748 (default: mono for 1-channel audio, stereo otherwise)
7752 psychoacoustic model (default: 2)
7756 Include error protection.
7765 .SS faac (\-faacopts)
7769 average bitrate in kbps (mutually exclusive with quality)
7772 .B quality=<1\-1000>
7773 quality mode, the higher the better (mutually exclusive with br)
7777 object type complexity
7787 LTP (extremely slow)
7793 MPEG version (default: 4)
7797 Enables temporal noise shaping.
7800 .B cutoff=<0\-sampling_rate/2>
7801 cutoff frequency (default: sampling_rate/2)
7805 Stores the bitstream as raw payload with extradata in the container header
7806 (default: 0, corresponds to ADTS).
7807 Do not set this flag if not explicitly required or you will not be able to
7808 remux the audio stream later on.
7813 .SS lavc (\-lavcopts)
7815 Many libavcodec (lavc for short) options are tersely documented.
7816 Read the source for full details.
7821 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
7826 .B o=<key>=<value>[,<key>=<value>[,...]]
7827 Pass AVOptions to libavcodec encoder.
7828 Note, a patch to make the o= unneeded and pass all unknown options through
7829 the AVOption system is welcome.
7830 A full list of AVOptions can be found in the FFmpeg manual.
7831 Note that some AVOptions may conflict with MEncoder options.
7844 audio codec (default: mp2)
7848 Dolby Digital (AC-3)
7850 Adaptive PCM formats \- see the HTML documentation for details.
7852 Free Lossless Audio Codec (FLAC)
7856 3GPP Adaptive Multi-Rate (AMR) narrow-band
7858 3GPP Adaptive Multi-Rate (AMR) wide-band
7860 Advanced Audio Coding (AAC) \- using FAAC
7862 MPEG-1 audio layer 3 (MP3) \- using LAME
7864 MPEG-1 audio layer 2 (MP2)
7866 PCM formats \- see the HTML documentation for details.
7868 Id Software RoQ DPCM
7870 experimental simple lossy codec
7872 experimental simple lossless codec
7876 Windows Media Audio v1
7878 Windows Media Audio v2
7884 audio bitrate in kbps (default: 224)
7888 Use the specified Windows audio format tag (e.g.\& atag=0x55).
7892 Use only bit exact algorithms (except (I)DCT).
7893 Additionally bit_exact disables several optimizations and thus
7894 should only be used for regression tests, which need binary
7895 identical files even if the encoder version changes.
7896 This also suppresses the user_data header in MPEG-4 streams.
7897 Do not use this option unless you know exactly what you are doing.
7901 Maximum number of threads to use (default: 1).
7902 May have a slight negative effect on motion estimation.
7907 Employ the specified codec (default: mpeg4).
7917 FFmpeg's lossless video codec
7919 nonstandard 20% smaller HuffYUV using YV12
7921 Sorenson H.263 used in Flash Video
7933 x264 H.264/AVC MPEG-4 Part 10
7935 Xvid MPEG-4 Part 2 (ASP)
7951 ID Software RoQ Video
7953 an old RealVideo codec
7954 .IPs "snow (also see: vstrict)"
7955 FFmpeg's experimental wavelet-based codec
7957 Apple Sorenson Video 1
7959 Windows Media Video, version 1 (AKA WMV7)
7961 Windows Media Video, version 2 (AKA WMV8)
7970 Not recommended (much larger file, little quality difference and weird side
7971 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
7972 resulting in lower quality and some decoders will not be able to decode it).
7974 Recommended for normal mpeg4/\:mpeg1video encoding (default).
7976 Recommended for h263(p)/\:msmpeg4.
7977 The reason for preferring 3 over 2 is that 2 could lead to overflows.
7978 (This will be fixed for h263(p) by changing the quantizer per MB in
7979 the future, msmpeg4 cannot be fixed as it does not support that.)
7983 .B lmin=<0.01\-255.0>
7984 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0).
7985 Lavc will rarely use quantizers below the value of lmin.
7986 Lowering lmin will make lavc more likely to choose lower quantizers for
7987 some frames, but not lower than the value of vqmin.
7988 Likewise, raising lmin will make lavc less likely to choose low
7989 quantizers, even if vqmin would have allowed them.
7990 You probably want to set lmin approximately equal to vqmin.
7991 When adaptive quantization is in use, changing lmin/lmax may have less
7992 of an effect; see mblmin/mblmax.
7996 .B lmax=<0.01\-255.0>
7997 maximum Lagrange multiplier for ratecontrol (default: 31.0)
8001 .B mblmin=<0.01\-255.0>
8002 Minimum macroblock-level Lagrange multiplier for ratecontrol
8004 This parameter affects adaptive quantization options like qprd,
8009 .B mblmax=<0.01\-255.0>
8010 Maximum macroblock-level Lagrange multiplier for ratecontrol
8016 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
8017 A lower value means better quality but larger files (default: \-1).
8018 In case of snow codec, value 0 means lossless encoding.
8019 Since the other codecs do not support this, vqscale=0 will have an undefined
8021 1 is not recommended (see vqmin for details).
8025 Maximum quantizer, 10\-31 should be a sane range (default: 31).
8037 maximum quantizer difference between consecutive I- or P-frames
8041 .B vmax_b_frames=<0\-4>
8042 maximum number of B-frames between non-B-frames:
8046 no B-frames (default)
8048 sane range for MPEG-4
8054 motion estimation method.
8055 Available methods are:
8059 none (very low quality)
8061 full (slow, currently unmaintained and disabled)
8063 log (low quality, currently unmaintained and disabled)
8065 phods (low quality, currently unmaintained and disabled)
8067 EPZS: size=1 diamond, size can be adjusted with the *dia options
8070 X1 (experimental, currently aliased to EPZS)
8072 iter (iterative overlapped block, only used in snow)
8079 0\-3 currently ignores the amount of bits spent,
8080 so quality may be low.
8084 .B me_range=<0\-9999>
8085 motion estimation search range (default: 0 (unlimited))
8088 .B mbd=<0\-2> (also see *cmp, qpel)
8089 Macroblock decision algorithm (high quality mode), encode each macro
8090 block in all modes and choose the best.
8091 This is slow but results in better quality and file size.
8092 When mbd is set to 1 or 2, the value of mbcmp is ignored when comparing
8093 macroblocks (the mbcmp value is still used in other places though, in particular
8094 the motion search algorithms).
8095 If any comparison setting (precmp, subcmp, cmp, or mbcmp) is nonzero,
8096 however, a slower but better half-pel motion search will be used,
8097 regardless of what mbd is set to.
8098 If qpel is set, quarter-pel motion search will be used regardless.
8102 Use comparison function given by mbcmp (default).
8104 Select the MB mode which needs the fewest bits (=vhq).
8106 Select the MB mode which has the best rate distortion.
8112 Same as mbd=1, kept for compatibility reasons.
8116 Allow 4 motion vectors per macroblock (slightly better quality).
8117 Works better if used with mbd>0.
8121 overlapped block motion compensation (H.263+)
8125 loop filter (H.263+)
8126 note, this is broken
8129 .B inter_threshold <\-1000\-1000>
8130 Does absolutely nothing at the moment.
8134 maximum interval between keyframes in frames (default: 250 or one
8135 keyframe every ten seconds in a 25fps movie.
8136 This is the recommended default for MPEG-4).
8137 Most codecs require regular keyframes in order to limit the accumulation of mismatch error.
8138 Keyframes are also needed for seeking, as seeking is only possible to a keyframe \- but
8139 keyframes need more space than other frames, so larger numbers here mean
8140 slightly smaller files but less precise seeking.
8141 0 is equivalent to 1, which makes every frame a keyframe.
8142 Values >300 are not recommended as the quality might be bad depending upon
8143 decoder, encoder and luck.
8144 It is common for MPEG-1/2 to use values <=30.
8147 .B sc_threshold=<\-1000000000\-1000000000>
8148 Threshold for scene change detection.
8149 A keyframe is inserted by libavcodec when it detects a scene change.
8150 You can specify the sensitivity of the detection with this option.
8151 \-1000000000 means there is a scene change detected at every frame,
8152 1000000000 means no scene changes are detected (default: 0).
8155 .B sc_factor=<any positive integer>
8156 Causes frames with higher quantizers to be more likely to trigger a
8157 scene change detection and make libavcodec use an I-frame (default: 1).
8158 1\-16 is a sane range.
8159 Values between 2 and 6 may yield increasing PSNR (up to approximately
8160 0.04 dB) and better placement of I-frames in high-motion scenes.
8161 Higher values than 6 may give very slightly better PSNR (approximately
8162 0.01 dB more than sc_factor=6), but noticably worse visual quality.
8165 .B vb_strategy=<0\-2> (pass one only)
8166 strategy to choose between I/P/B-frames:
8170 Always use the maximum number of B-frames (default).
8172 Avoid B-frames in high motion scenes.
8173 See the b_sensitivity option to tune this strategy.
8175 Places B-frames more or less optimally to yield maximum quality (slower).
8176 You may want to reduce the speed impact of this option by tuning the
8182 .B b_sensitivity=<any integer greater than 0>
8183 Adjusts how sensitively vb_strategy=1 detects motion and avoids using
8184 B-frames (default: 40).
8185 Lower sensitivities will result in more B-frames.
8186 Using more B-frames usually improves PSNR, but too many B-frames can
8187 hurt quality in high-motion scenes.
8188 Unless there is an extremely high amount of motion, b_sensitivity can
8189 safely be lowered below the default; 10 is a reasonable value in most
8193 .B brd_scale=<0\-10>
8194 Downscales frames for dynamic B-frame decision (default: 0).
8195 Each time brd_scale is increased by one, the frame dimensions are
8196 divided by two, which improves speed by a factor of four.
8197 Both dimensions of the fully downscaled frame must be even numbers, so
8198 brd_scale=1 requires the original dimensions to be multiples of four,
8199 brd_scale=2 requires multiples of eight, etc.
8200 In other words, the dimensions of the original frame must both be
8201 divisible by 2^(brd_scale+1) with no remainder.
8204 .B bidir_refine=<0\-4>
8205 Refine the two motion vectors used in bidirectional macroblocks,
8206 rather than re-using vectors from the forward and backward searches.
8207 This option has no effect without B-frames.
8213 Use a wider search (larger values are slower).
8219 Activates internal two (or more) pass mode, only specify if you wish to
8220 use two (or more) pass encoding.
8224 first pass (also see turbo)
8228 Nth pass (second and subsequent passes of N-pass encoding)
8231 Here is how it works, and how to use it:
8233 The first pass (vpass=1) writes the statistics file.
8234 You might want to deactivate some CPU-hungry options, like "turbo"
8237 In two pass mode, the second pass (vpass=2) reads the statistics file and
8238 bases ratecontrol decisions on it.
8240 In N-pass mode, the second pass (vpass=3, that is not a typo)
8241 does both: It first reads the statistics, then overwrites them.
8242 You might want to backup divx2pass.log before doing this if there is
8243 any possibility that you will have to cancel MEncoder.
8244 You can use all encoding options, except very CPU-hungry options like "qns".
8246 You can run this same pass over and over to refine the encode.
8247 Each subsequent pass will use the statistics from the previous pass to improve.
8248 The final pass can include any CPU-hungry encoding options.
8250 If you want a 2 pass encode, use first vpass=1, and then vpass=2.
8252 If you want a 3 or more pass encode, use vpass=1 for the first pass
8253 and then vpass=3 and then vpass=3 again and again until you are
8254 satisfied with the encode.
8266 Encodes with an optimal Huffman table based upon statistics
8267 from the first pass.
8272 .B turbo (two pass only)
8273 Dramatically speeds up pass one using faster algorithms and disabling
8274 CPU-intensive options.
8275 This will probably reduce global PSNR a little bit (around 0.01dB) and
8276 change individual frame type and PSNR a little bit more (up to 0.03dB).
8280 Store movie aspect internally, just like with MPEG files.
8281 Much nicer than rescaling, because quality is not decreased.
8282 Only MPlayer will play these files correctly, other players will display
8283 them with wrong aspect.
8284 The aspect parameter can be given as a ratio or a floating point number.
8291 .IPs "aspect=16/9 or aspect=1.78"
8297 Same as the aspect option, but automatically computes aspect, taking
8298 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
8300 Does not incur a performance penalty, so you can safely leave it
8305 Specify bitrate (default: 800).
8313 .IPs 16001\-24000000
8320 approximated file size tolerance in kbit.
8321 1000\-100000 is a sane range.
8322 (warning: 1kbit = 1000 bits)
8326 vratetol should not be too large during the second pass or there might
8327 be problems if vrc_(min|max)rate is used.
8330 .B vrc_maxrate=<value>
8331 maximum bitrate in kbit/\:sec
8332 (default: 0, unlimited)
8335 .B vrc_minrate=<value>
8336 minimum bitrate in kbit/\:sec
8337 (default: 0, unlimited)
8340 .B vrc_buf_size=<value>
8342 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
8343 917 for SVCD and 1835 for DVD.
8346 .B vrc_buf_aggressivity
8352 Note that some of the ratecontrol-affecting options will have no effect
8353 if vrc_strategy is not set to 0.
8357 Use internal lavc ratecontrol (default).
8359 Use Xvid ratecontrol (experimental; requires MEncoder to be compiled
8360 with support for Xvid 1.1 or higher).
8365 .B vb_qfactor=<\-31.0\-31.0>
8366 quantizer factor between B- and non-B-frames (default: 1.25)
8369 .B vi_qfactor=<\-31.0\-31.0>
8370 quantizer factor between I- and non-I-frames (default: 0.8)
8373 .B vb_qoffset=<\-31.0\-31.0>
8374 quantizer offset between B- and non-B-frames (default: 1.25)
8377 .B vi_qoffset=<\-31.0\-31.0>
8380 if v{b|i}_qfactor > 0
8382 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
8386 do normal ratecontrol (do not lock to next P-frame quantizer) and
8387 set q= \-q * v{b|i}_qfactor + v{b|i}_qoffset
8390 To do constant quantizer encoding with different quantizers for
8391 I/P- and B-frames you can use:
8392 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>.
8395 .B vqblur=<0.0\-1.0> (pass one)
8396 Quantizer blur (default: 0.5), larger values will average the
8397 quantizer more over time (slower change).
8401 Quantizer blur disabled.
8403 Average the quantizer over all previous frames.
8408 .B vqblur=<0.0\-99.0> (pass two)
8409 Quantizer gaussian blur (default: 0.5), larger values will average
8410 the quantizer more over time (slower change).
8413 .B vqcomp=<0.0\-1.0>
8414 Quantizer compression, vrc_eq depends upon this (default: 0.5).
8416 Perceptual quality will be optimal somewhere in between the range's extremes.
8419 .B vrc_eq=<equation>
8420 main ratecontrol equation
8423 .IPs 1+(tex/\:avgTex-1)*qComp
8424 approximately the equation of the old ratecontrol code
8426 with qcomp 0.5 or something like that (default)
8443 intra, non-intra texture complexity
8445 average texture complexity
8447 average intra texture complexity in I-frames
8449 average intra texture complexity in P-frames
8451 average non-intra texture complexity in P-frames
8453 average non-intra texture complexity in B-frames
8455 bits used for motion vectors
8457 maximum length of motion vector in log2 scale
8459 number of intra macroblocks / number of macroblocks
8465 qcomp from the command line
8466 .IPs "isI, isP, isB"
8467 Is 1 if picture type is I/P/B else 0.
8469 See your favorite math book.
8476 .IPs max(a,b),min(a,b)
8479 is 1 if a>b, 0 otherwise
8481 is 1 if a<b, 0 otherwise
8483 is 1 if a==b, 0 otherwise
8484 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
8488 .B vrc_override=<options>
8489 User specified quality for specific parts (ending, credits, ...).
8490 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
8491 <end-frame>, <quality>[/...]]:
8494 .IPs "quality (2\-31)"
8496 .IPs "quality (\-500\-0)"
8497 quality correction in %
8502 .B vrc_init_cplx=<0\-1000>
8503 initial complexity (pass 1)
8506 .B vrc_init_occupancy=<0.0\-1.0>
8507 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9)
8511 Specify how to keep the quantizer between qmin and qmax.
8517 Use a nice differentiable function (default).
8522 .B vlelim=<\-1000\-1000>
8523 Sets single coefficient elimination threshold for luminance.
8524 Negative values will also consider the DC coefficient (should be at least \-4
8525 or lower for encoding at quant=1):
8536 .B vcelim=<\-1000\-1000>
8537 Sets single coefficient elimination threshold for chrominance.
8538 Negative values will also consider the DC coefficient (should be at least \-4
8539 or lower for encoding at quant=1):
8550 .B vstrict=<\-2|\-1|0|1>
8551 strict standard compliance
8557 Only recommended if you want to feed the output into the
8558 MPEG-4 reference decoder.
8560 Allow libavcodec specific extensions (default).
8562 Enables experimental codecs and features which may not be playable
8563 with future MPlayer versions (snow).
8570 Adds 2 Bytes per video packet, improves error-resistance when transferring over
8571 unreliable channels (e.g.\& streaming over the internet).
8572 Each video packet will be encoded in 3 separate partitions:
8577 .IPs "2. DC coefficients"
8579 .IPs "3. AC coefficients"
8584 MV & DC are most important, losing them looks far worse than losing
8585 the AC and the 1. & 2. partition.
8586 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors
8587 will hit the AC partition much more often than the MV & DC partitions.
8588 Thus, the picture will look better with partitioning than without,
8589 as without partitioning an error will trash AC/\:DC/\:MV equally.
8593 .B vpsize=<0\-10000> (also see vdpart)
8594 Video packet size, improves error-resistance.
8606 slice structured mode for H.263+
8610 grayscale only encoding (faster)
8618 Automatically select a good one (default).
8639 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests.
8643 Automatically select a good one (default).
8645 JPEG reference integer
8651 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100)
8682 .B lumi_mask=<0.0\-1.0>
8683 Luminance masking is a 'psychosensory' setting that is supposed to
8684 make use of the fact that the human eye tends to notice fewer details
8685 in very bright parts of the picture.
8686 Luminance masking compresses bright areas stronger than medium ones,
8687 so it will save bits that can be spent again on other frames, raising
8688 overall subjective quality, while possibly reducing PSNR.
8691 Be careful, overly large values can cause disastrous things.
8694 Large values might look good on some monitors but may look horrible
8706 .B dark_mask=<0.0\-1.0>
8707 Darkness masking is a 'psychosensory' setting that is supposed to
8708 make use of the fact that the human eye tends to notice fewer details
8709 in very dark parts of the picture.
8710 Darkness masking compresses dark areas stronger than medium ones,
8711 so it will save bits that can be spent again on other frames, raising
8712 overall subjective quality, while possibly reducing PSNR.
8715 Be careful, overly large values can cause disastrous things.
8718 Large values might look good on some monitors but may look horrible
8719 on other monitors / TV / TFT.
8730 .B tcplx_mask=<0.0\-1.0>
8731 Temporal complexity masking (default: 0.0 (disabled)).
8732 Imagine a scene with a bird flying across the whole scene; tcplx_mask
8733 will raise the quantizers of the bird's macroblocks (thus decreasing their
8734 quality), as the human eye usually does not have time to see all the bird's
8736 Be warned that if the masked object stops (e.g.\& the bird lands) it is
8737 likely to look horrible for a short period of time, until the encoder
8738 figures out that the object is not moving and needs refined blocks.
8739 The saved bits will be spent on other parts of the video, which may increase
8740 subjective quality, provided that tcplx_mask is carefully chosen.
8743 .B scplx_mask=<0.0\-1.0>
8744 Spatial complexity masking.
8745 Larger values help against blockiness, if no deblocking filter is used for
8746 decoding, which is maybe not a good idea.
8748 Imagine a scene with grass (which usually has great spatial complexity),
8749 a blue sky and a house; scplx_mask will raise the quantizers of the grass'
8750 macroblocks, thus decreasing its quality, in order to spend more bits on
8751 the sky and the house.
8754 Crop any black borders completely as they will reduce the quality
8755 of the macroblocks (also applies without scplx_mask).
8767 This setting does not have the same effect as using a custom matrix that
8768 would compress high frequencies harder, as scplx_mask will reduce the
8769 quality of P blocks even if only DC is changing.
8770 The result of scplx_mask will probably not look as good.
8774 .B p_mask=<0.0\-1.0> (also see vi_qfactor)
8775 Reduces the quality of inter blocks.
8776 This is equivalent to increasing the quality of intra blocks, because the
8777 same average bitrate will be distributed by the rate controller to the
8778 whole video sequence (default: 0.0 (disabled)).
8779 p_mask=1.0 doubles the bits allocated to each intra block.
8782 .B border_mask=<0.0\-1.0>
8783 border-processing for MPEG-style encoders.
8784 Border processing increases the quantizer for macroblocks which are less
8785 than 1/5th of the frame width/height away from the frame border,
8786 since they are often visually less important.
8790 Normalize adaptive quantization (experimental).
8791 When using adaptive quantization (*_mask), the average per-MB quantizer may no
8792 longer match the requested frame-level quantizer.
8793 Naq will attempt to adjust the per-MB quantizers to maintain the proper
8802 Use interlaced motion estimation (mutually exclusive with qpel).
8806 Use alternative scantable.
8809 .B "top=<\-1\-1>\ \ \ "
8830 for HuffYUV, lossless JPEG, dv and ffv1
8832 for lossless JPEG, dv and ffv1
8834 for lossless JPEG, ffv1 and svq1
8836 for lossless JPEG and ffv1
8848 plane/\:gradient prediction
8866 plane/\:gradient prediction
8878 vlc coding (Golomb-Rice)
8880 arithmetic coding (CABAC)
8902 predetermined Huffman tables (builtin or two pass)
8904 adaptive Huffman tables
8910 Use quarter pel motion compensation (mutually exclusive with ilme).
8913 This seems only useful for high bitrate encodings.
8917 Sets the comparison function for the macroblock decision, has only
8919 This is also used for some motion search functions, in which case
8920 it has an effect regardless of mbd setting.
8924 sum of absolute differences, fast (default)
8926 sum of squared errors
8928 sum of absolute Hadamard transformed differences
8930 sum of absolute DCT transformed differences
8932 sum of squared quantization errors (avoid, low quality)
8934 number of bits needed for the block
8936 rate distortion optimal, slow
8940 sum of absolute vertical differences
8942 sum of squared vertical differences
8944 noise preserving sum of squared differences
8946 5/3 wavelet, only used in snow
8948 9/7 wavelet, only used in snow
8950 Also use chroma, currently does not work (correctly) with B-frames.
8955 .B ildctcmp=<0\-2000>
8956 Sets the comparison function for interlaced DCT decision
8957 (see mbcmp for available comparison functions).
8961 Sets the comparison function for motion estimation pre pass
8962 (see mbcmp for available comparison functions) (default: 0).
8966 Sets the comparison function for full pel motion estimation
8967 (see mbcmp for available comparison functions) (default: 0).
8971 Sets the comparison function for sub pel motion estimation
8972 (see mbcmp for available comparison functions) (default: 0).
8975 .B skipcmp=<0\-2000>
8976 FIXME: Document this.
8979 .B nssew=<0\-1000000>
8980 This setting controls NSSE weight, where larger weights will result in
8982 0 NSSE is identical to SSE
8983 You may find this useful if you prefer to keep some noise in your encoded
8984 video rather than filtering it away before encoding (default: 8).
8988 diamond type and size for motion estimation pre-pass
8992 Diamond type & size for motion estimation.
8993 Motion search is an iterative process.
8994 Using a small diamond does not limit the search to finding only small
8996 It is just somewhat more likely to stop before finding the very best motion
8997 vector, especially when noise is involved.
8998 Bigger diamonds allow a wider search for the best motion vector, thus are
8999 slower but result in better quality.
9001 Big normal diamonds are better quality than shape-adaptive diamonds.
9003 Shape-adaptive diamonds are a good tradeoff between speed and quality.
9006 The sizes of the normal diamonds and shape adaptive ones do not have
9010 shape adaptive (fast) diamond with size 3
9012 shape adaptive (fast) diamond with size 2
9014 uneven multi-hexagon search (slow)
9016 normal size=1 diamond (default) =EPZS type diamond
9024 normal size=2 diamond
9037 Trellis searched quantization.
9038 This will find the optimal encoding for each 8x8 block.
9039 Trellis searched quantization is quite simply an optimal quantization in
9040 the PSNR versus bitrate sense (Assuming that there would be no rounding
9041 errors introduced by the IDCT, which is obviously not the case.).
9042 It simply finds a block for the minimum of error and lambda*bits.
9046 quantization parameter (QP) dependent constant
9048 amount of bits needed to encode the block
9050 sum of squared errors of the quantization
9056 Rate distorted optimal coded block pattern.
9057 Will select the coded block pattern which minimizes distortion + lambda*rate.
9058 This can only be used together with trellis quantization.
9062 Try to encode each MB with MV=<0,0> and choose the better one.
9063 This has no effect if mbd=0.
9066 .B mv0_threshold=<any non-negative integer>
9067 When surrounding motion vectors are <0,0> and the motion estimation
9068 score of the current block is less than mv0_threshold, <0,0> is used for
9069 the motion vector and further motion estimation is skipped (default:
9071 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and
9072 possibly make the encoded video look slightly better; raising
9073 mv0_threshold past 320 results in diminished PSNR and visual quality.
9074 Higher values speed up encoding very slightly (usually less than 1%,
9075 depending on the other options used).
9078 This option does not require mv0 to be enabled.
9081 .B qprd (mbd=2 only)
9082 rate distorted optimal quantization parameter (QP) for the given
9083 lambda of each macroblock
9086 .B last_pred=<0\-99>
9087 amount of motion predictors from the previous frame
9093 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the
9100 motion estimation pre-pass
9106 only after I-frames (default)
9114 subpel refinement quality (for qpel) (default: 8 (high quality))
9117 This has a significant effect on speed.
9121 number of reference frames to consider for motion compensation
9122 (Snow only) (default: 1)
9126 print the PSNR (peak signal to noise ratio) for the whole video after encoding
9127 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
9128 Returned values are in dB (decibel), the higher the better.
9132 Use MPEG quantizers instead of H.263.
9136 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+.
9137 This will improve quality very slightly (around 0.02 dB PSNR) and slow
9138 down encoding very slightly (about 1%).
9141 vqmin should be 8 or larger for H.263+ AIC.
9145 alternative inter vlc for H.263+
9149 unlimited MVs (H.263+ only)
9150 Allows encoding of arbitrarily long MVs.
9153 .B ibias=<\-256\-256>
9154 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
9155 H.263 style quantizer default: 0)
9158 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
9159 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
9162 .B pbias=<\-256\-256>
9163 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
9164 H.263 style quantizer default: \-64)
9167 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
9168 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
9171 A more positive bias (\-32 \- \-16 instead of \-64) seems to improve the PSNR.
9175 Noise reduction, 0 means disabled.
9176 0\-600 is a useful range for typical content, but you may want to turn it
9177 up a bit more for very noisy content (default: 0).
9178 Given its small impact on speed, you might want to prefer to use this over
9179 filtering noise away with video filters like denoise3d or hqdn3d.
9183 Quantizer noise shaping.
9184 Rather than choosing quantization to most closely match the source video
9185 in the PSNR sense, it chooses quantization such that noise (usually ringing)
9186 will be masked by similar-frequency content in the image.
9187 Larger values are slower but may not result in better quality.
9188 This can and should be used together with trellis quantization, in which case
9189 the trellis quantization (optimal for constant weight) will be used as
9190 startpoint for the iterative search.
9196 Only lower the absolute value of coefficients.
9198 Only change coefficients before the last non-zero coefficient + 1.
9205 .B inter_matrix=<comma separated matrix>
9206 Use custom inter matrix.
9207 It needs a comma separated string of 64 integers.
9210 .B intra_matrix=<comma separated matrix>
9211 Use custom intra matrix.
9212 It needs a comma separated string of 64 integers.
9216 experimental quantizer modulation
9220 experimental quantizer modulation
9224 intra DC precision in bits (default: 8).
9225 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
9228 .B cgop (also see sc_threshold)
9230 Currently it only works if scene change detection is disabled
9231 (sc_threshold=1000000000).
9235 Enable Global Motion Compensation.
9239 Sets the low delay flag for MPEG-1/2 (disables B-frames).
9243 Control writing global video headers.
9247 Codec decides where to write global headers (default).
9249 Write global headers only in extradata (needed for .mp4/MOV/NUT).
9251 Write global headers only in front of keyframes.
9259 Same as vglobal for audio headers.
9263 Set CodecContext Level.
9264 Use 31 or 41 to play video on a Playstation 3.
9267 .B skip_exp=<0\-1000000>
9268 FIXME: Document this.
9271 .B skip_factor=<0\-1000000>
9272 FIXME: Document this.
9275 .B skip_threshold=<0\-1000000>
9276 FIXME: Document this.
9281 Nuppel video is based on RTJPEG and LZO.
9282 By default frames are first encoded with RTJPEG and then compressed with LZO,
9283 but it is possible to disable either or both of the two passes.
9284 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG,
9285 or the default LZO compressed RTJPEG.
9288 The nuvrec documentation contains some advice and examples about the
9289 settings to use for the most common TV encodings.
9293 chrominance threshold (default: 1)
9297 luminance threshold (default: 1)
9301 Enable LZO compression (default).
9305 Disable LZO compression.
9309 quality level (default: 255)
9313 Disable RTJPEG encoding.
9317 Enable RTJPEG encoding (default).
9320 .SS xvidenc (\-xvidencopts)
9322 There are three modes available: constant bitrate (CBR), fixed quantizer and
9327 Specify the pass in two pass mode.
9330 .B turbo (two pass only)
9331 Dramatically speeds up pass one using faster algorithms and disabling
9332 CPU-intensive options.
9333 This will probably reduce global PSNR a little bit and change individual
9334 frame type and PSNR a little bit more.
9337 .B bitrate=<value> (CBR or two pass mode)
9338 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
9340 If <value> is negative, Xvid will use its absolute value as the target size
9341 (in kBytes) of the video and compute the associated bitrate automagically
9342 (default: 687 kbits/s).
9345 .B fixed_quant=<1\-31>
9346 Switch to fixed quantizer mode and specify the quantizer to be used.
9349 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode)
9350 User specified quality for specific parts (ending, credits, ...).
9351 Each zone is <start-frame>,<mode>,<value> where <mode> may be
9355 Constant quantizer override, where value=<2.0\-31.0>
9356 represents the quantizer value.
9358 Ratecontrol weight override, where value=<0.01\-2.00>
9359 represents the quality correction in %.
9368 .IPs zones=90000,q,20
9369 Encodes all frames starting with frame 90000 at constant quantizer 20.
9370 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20
9371 Encode frames 0\-10000 at 10% bitrate, encode frames 90000
9372 up to the end at constant quantizer 20.
9373 Note that the second zone is needed to delimit the first zone, as
9374 without it everything up until frame 89999 would be encoded at 10%
9380 .B me_quality=<0\-6>
9381 This option controls the motion estimation subsystem.
9382 The higher the value, the more precise the estimation should be (default: 6).
9383 The more precise the motion estimation is, the more bits can be saved.
9384 Precision is gained at the expense of CPU time so decrease this setting if
9385 you need realtime encoding.
9389 MPEG-4 uses a half pixel precision for its motion search by default.
9390 The standard proposes a mode where encoders are allowed to use quarter
9392 This option usually results in a sharper image.
9393 Unfortunately it has a great impact on bitrate and sometimes the
9394 higher bitrate use will prevent it from giving a better image
9395 quality at a fixed bitrate.
9396 It is better to test with and without this option and see whether it
9397 is worth activating.
9401 Enable Global Motion Compensation, which makes Xvid generate special
9402 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images.
9403 Whether or not the use of this option will save bits is highly
9404 dependent on the source material.
9408 Trellis Quantization is a kind of adaptive quantization method that
9409 saves bits by modifying quantized coefficients to make them more
9410 compressible by the entropy encoder.
9411 Its impact on quality is good, and if VHQ uses too much CPU for you,
9412 this setting can be a good alternative to save a few bits (and gain
9413 quality at fixed bitrate) at a lesser cost than with VHQ (default: on).
9417 Activate this if your encoded sequence is an anime/\:cartoon.
9418 It modifies some Xvid internal thresholds so Xvid takes better decisions on
9419 frame types and motion vectors for flat looking cartoons.
9423 The usual motion estimation algorithm uses only the luminance information to
9424 find the best motion vector.
9425 However for some video material, using the chroma planes can help find
9427 This setting toggles the use of chroma planes for motion estimation
9432 Enable a chroma optimizer prefilter.
9433 It will do some extra magic on color information to minimize the
9434 stepped-stairs effect on edges.
9435 It will improve quality at the cost of encoding speed.
9436 It reduces PSNR by nature, as the mathematical deviation to the original
9437 picture will get bigger, but the subjective image quality will raise.
9438 Since it works with color information, you might want to turn it off when
9439 encoding in grayscale.
9443 Activates high-quality prediction of AC coefficients for intra frames from
9444 neighbor blocks (default: on).
9448 The motion search algorithm is based on a search in the usual color domain
9449 and tries to find a motion vector that minimizes the difference between the
9450 reference frame and the encoded frame.
9451 With this setting activated, Xvid will also use the frequency domain (DCT)
9452 to search for a motion vector that minimizes not only the spatial
9453 difference but also the encoding length of the block.
9460 mode decision (inter/\:intra MB) (default)
9472 Adaptive quantization allows the macroblock quantizers to vary inside
9474 This is a 'psychosensory' setting that is supposed to make use of the
9475 fact that the human eye tends to notice fewer details in very bright
9476 and very dark parts of the picture.
9477 It compresses those areas more strongly than medium ones, which will
9478 save bits that can be spent again on other frames, raising overall
9479 subjective quality and possibly reducing PSNR.
9483 Make Xvid discard chroma planes so the encoded video is grayscale only.
9484 Note that this does not speed up encoding, it just prevents chroma data
9485 from being written in the last stage of encoding.
9489 Encode the fields of interlaced video material.
9490 Turn this option on for interlaced content.
9493 Should you rescale the video, you would need an interlace-aware resizer,
9494 which you can activate with \-vf scale=<width>:<height>:1.
9497 .B min_iquant=<0\-31>
9498 minimum I-frame quantizer (default: 2)
9501 .B max_iquant=<0\-31>
9502 maximum I-frame quantizer (default: 31)
9505 .B min_pquant=<0\-31>
9506 minimum P-frame quantizer (default: 2)
9509 .B max_pquant=<0\-31>
9510 maximum P-frame quantizer (default: 31)
9513 .B min_bquant=<0\-31>
9514 minimum B-frame quantizer (default: 2)
9517 .B max_bquant=<0\-31>
9518 maximum B-frame quantizer (default: 31)
9521 .B min_key_interval=<value> (two pass only)
9522 minimum interval between keyframes (default: 0)
9525 .B max_key_interval=<value>
9526 maximum interval between keyframes (default: 10*fps)
9529 .B quant_type=<h263|mpeg>
9530 Sets the type of quantizer to use.
9531 For high bitrates, you will find that MPEG quantization preserves more detail.
9532 For low bitrates, the smoothing of H.263 will give you less block noise.
9533 When using custom matrices, MPEG quantization
9538 .B quant_intra_matrix=<filename>
9539 Load a custom intra matrix file.
9540 You can build such a file with xvid4conf's matrix editor.
9543 .B quant_inter_matrix=<filename>
9544 Load a custom inter matrix file.
9545 You can build such a file with xvid4conf's matrix editor.
9548 .B keyframe_boost=<0\-1000> (two pass mode only)
9549 Shift some bits from the pool for other frame types to intra frames,
9550 thus improving keyframe quality.
9551 This amount is an extra percentage, so a value of 10 will give
9552 your keyframes 10% more bits than normal
9556 .B kfthreshold=<value> (two pass mode only)
9557 Works together with kfreduction.
9558 Determines the minimum distance below which you consider that
9559 two frames are considered consecutive and treated differently
9560 according to kfreduction
9564 .B kfreduction=<0\-100> (two pass mode only)
9565 The above two settings can be used to adjust the size of keyframes that
9566 you consider too close to the first (in a row).
9567 kfthreshold sets the range in which keyframes are reduced, and
9568 kfreduction determines the bitrate reduction they get.
9569 The last I-frame will get treated normally
9573 .B max_bframes=<0\-4>
9574 Maximum number of B-frames to put between I/P-frames (default: 2).
9577 .B bquant_ratio=<0\-1000>
9578 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150)
9581 .B bquant_offset=<\-1000\-1000>
9582 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100)
9585 .B bf_threshold=<\-255\-255>
9586 This setting allows you to specify what priority to place on the use of
9588 The higher the value, the higher the probability of B-frames being used
9590 Do not forget that B-frames usually have a higher quantizer, and therefore
9591 aggressive production of B-frames may cause worse visual quality.
9595 This option tells Xvid to close every GOP (Group Of Pictures bounded
9596 by two I-frames), which makes GOPs independent from each other.
9597 This just implies that the last frame of the GOP is either a P-frame or a
9598 N-frame but not a B-frame.
9599 It is usually a good idea to turn this option on (default: on).
9603 This option is meant to solve frame-order issues when encoding to
9604 container formats like AVI that cannot cope with out-of-order frames.
9605 In practice, most decoders (both software and hardware) are able to deal
9606 with frame-order themselves, and may get confused when this option is
9607 turned on, so you can safely leave if off, unless you really know what
9611 This will generate an illegal bitstream, and will not be
9612 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:Xvid.
9615 This will also store a fake DivX version in the file so the bug
9616 autodetection of some decoders might be confused.
9619 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
9620 This setting allows the creation of variable framerate video streams.
9621 The value of the setting specifies a threshold under which, if the
9622 difference of the following frame to the previous frame is below or equal
9623 to this threshold, a frame gets not coded (a so called n-vop is placed
9625 On playback, when reaching an n-vop the previous frame will be displayed.
9628 Playing with this setting may result in a jerky video, so use it at your
9632 .B rc_reaction_delay_factor=<value>
9633 This parameter controls the number of frames the CBR rate controller
9634 will wait before reacting to bitrate changes and compensating for them
9635 to obtain a constant bitrate over an averaging range of frames.
9638 .B rc_averaging_period=<value>
9639 Real CBR is hard to achieve.
9640 Depending on the video material, bitrate can be variable, and hard to predict.
9641 Therefore Xvid uses an averaging period for which it guarantees a given
9642 amount of bits (minus a small variation).
9643 This settings expresses the "number of frames" for which Xvid averages
9644 bitrate and tries to achieve CBR.
9647 .B rc_buffer=<value>
9648 size of the rate control buffer
9651 .B curve_compression_high=<0\-100>
9652 This setting allows Xvid to take a certain percentage of bits away from
9653 high bitrate scenes and give them back to the bit reservoir.
9654 You could also use this if you have a clip with so many bits allocated
9655 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad
9659 .B curve_compression_low=<0\-100>
9660 This setting allows Xvid to give a certain percentage of extra bits to the
9661 low bitrate scenes, taking a few bits from the entire clip.
9662 This might come in handy if you have a few low-bitrate scenes that are
9663 still blocky (default: 0).
9666 .B overflow_control_strength=<0\-100>
9667 During pass one of two pass encoding, a scaled bitrate curve is computed.
9668 The difference between that expected curve and the result obtained during
9669 encoding is called overflow.
9670 Obviously, the two pass rate controller tries to compensate for that overflow,
9671 distributing it over the next frames.
9672 This setting controls how much of the overflow is distributed every time
9673 there is a new frame.
9674 Low values allow lazy overflow control, big rate bursts are compensated for
9675 more slowly (could lead to lack of precision for small clips).
9676 Higher values will make changes in bit redistribution more abrupt, possibly
9677 too abrupt if you set it too high, creating artifacts (default: 5).
9680 This setting impacts quality a lot, play with it carefully!
9683 .B max_overflow_improvement=<0\-100>
9684 During the frame bit allocation, overflow control may increase the frame
9686 This parameter specifies the maximum percentage by which the overflow
9687 control is allowed to increase the frame size, compared to the ideal curve
9692 .B max_overflow_degradation=<0\-100>
9693 During the frame bit allocation, overflow control may decrease the frame
9695 This parameter specifies the maximum percentage by which the overflow
9696 control is allowed to decrease the frame size, compared to the ideal curve
9701 .B container_frame_overhead=<0...>
9702 Specifies a frame average overhead per frame, in bytes.
9703 Most of the time users express their target bitrate for video w/o taking
9704 care of the video container overhead.
9705 This small but (mostly) constant overhead can cause the target file size
9707 Xvid allows users to set the amount of overhead per frame the
9708 container generates (give only an average per frame).
9709 0 has a special meaning, it lets Xvid use its own default values
9710 (default: 24 \- AVI average overhead).
9713 .B profile=<profile_name>
9714 Restricts options and VBV (peak bitrate over a short period) according to
9715 the Simple, Advanced Simple and DivX profiles.
9716 The resulting videos should be playable on standalone players adhering to these
9717 profile specifications.
9721 no restrictions (default)
9723 simple profile at level 0
9725 simple profile at level 1
9727 simple profile at level 2
9729 simple profile at level 3
9731 advanced simple profile at level 0
9733 advanced simple profile at level 1
9735 advanced simple profile at level 2
9737 advanced simple profile at level 3
9739 advanced simple profile at level 4
9741 advanced simple profile at level 5
9743 DXN handheld profile
9745 DXN portable NTSC profile
9747 DXN portable PAL profile
9749 DXN home theater NTSC profile
9751 DXN home theater PAL profile
9758 These profiles should be used in conjunction with an appropriate \-ffourcc.
9759 Generally DX50 is applicable, as some players do not recognize Xvid but
9760 most recognize DivX.
9765 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR,
9766 the Display Aspect Ratio).
9767 PAR is the ratio of the width and height of a single pixel.
9768 So both are related like this: DAR = PAR * (width/height).
9770 MPEG-4 defines 5 pixel aspect ratios and one extended
9771 one, giving the opportunity to specify a specific pixel aspect
9773 5 standard modes can be specified:
9777 It is the usual PAR for PC content.
9778 Pixels are a square unit.
9780 PAL standard 4:3 PAR.
9781 Pixels are rectangles.
9787 same as above (Do not forget to give the exact ratio.)
9789 Allows you to specify your own pixel aspect ratio with par_width and
9795 In general, setting aspect and autoaspect options is enough.
9799 .B par_width=<1\-255> (par=ext only)
9800 Specifies the width of the custom pixel aspect ratio.
9803 .B par_height=<1\-255> (par=ext only)
9804 Specifies the height of the custom pixel aspect ratio.
9807 .B aspect=<x/y | f (float value)>
9808 Store movie aspect internally, just like MPEG files.
9809 Much nicer solution than rescaling, because quality is not decreased.
9810 MPlayer and a few others players will play these files correctly, others
9811 will display them with the wrong aspect.
9812 The aspect parameter can be given as a ratio or a floating point number.
9816 Same as the aspect option, but automatically computes aspect, taking
9817 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
9822 Print the PSNR (peak signal to noise ratio) for the whole video after encoding
9823 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
9824 the current directory.
9825 Returned values are in dB (decibel), the higher the better.
9829 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control
9835 The following option is only available in Xvid 1.1.x.
9839 This setting allows vector candidates for B-frames to be used for
9840 the encoding chosen using a rate distortion optimized operator,
9841 which is what is done for P-frames by the vhq option.
9842 This produces nicer-looking B-frames while incurring almost no
9843 performance penalty (default: 1).
9847 The following option is only available in the 1.2.x version of Xvid.
9851 Create n threads to run the motion estimation (default: 0).
9852 The maximum number of threads that can be used is the picture height
9856 .SS x264enc (\-x264encopts)
9860 Sets the average bitrate to be used in kbits/\:second (default: off).
9861 Since local bitrate may vary, this average may be inaccurate for
9862 very short videos (see ratetol).
9863 Constant bitrate can be achieved by combining this with vbv_maxrate,
9864 at significant reduction in quality.
9868 This selects the quantizer to use for P-frames.
9869 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively.
9870 20\-40 is a useful range.
9871 Lower values result in better fidelity, but higher bitrates.
9873 Note that quantization in H.264 works differently from MPEG-1/2/4:
9874 H.264's quantization parameter (QP) is on a logarithmic scale.
9875 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP).
9876 For example, MPEG at QP=2 is equivalent to H.264 at QP=18.
9880 Enables constant quality mode, and selects the quality.
9881 The scale is similar to QP.
9882 Like the bitrate-based modes, this allows each frame to use a
9883 different QP based on the frame's complexity.
9887 Enable 2 or 3-pass mode.
9888 It is recommended to always encode in 2 or 3-pass mode as it leads to a
9889 better bit distribution and improves overall quality.
9895 second pass (of two pass encoding)
9897 Nth pass (second and third passes of three pass encoding)
9900 Here is how it works, and how to use it:
9902 The first pass (pass=1) collects statistics on the video and writes them
9904 You might want to deactivate some CPU-hungry options, apart from the ones
9905 that are on by default.
9907 In two pass mode, the second pass (pass=2) reads the statistics file and
9908 bases ratecontrol decisions on it.
9910 In three pass mode, the second pass (pass=3, that is not a typo)
9911 does both: It first reads the statistics, then overwrites them.
9912 You can use all encoding options, except very CPU-hungry options.
9914 The third pass (pass=3) is the same as the second pass, except that it has
9915 the second pass' statistics to work from.
9916 You can use all encoding options, including CPU-hungry ones.
9918 The first pass may use either average bitrate or constant quantizer.
9919 ABR is recommended, since it does not require guessing a quantizer.
9920 Subsequent passes are ABR, and must specify bitrate.
9925 Fast first pass mode.
9926 During the first pass of a two or more pass encode it is possible to gain
9927 speed by disabling some options with negligible or even no impact on the
9928 final pass output quality.
9934 Reduce subq, frameref and disable some inter-macroblock partition analysis
9937 Reduce subq and frameref to 1, use a diamond ME search and disable all
9938 partition analysis modes.
9941 Level 1 can increase first pass speed up to 2x with no change in the global
9942 PSNR of the final pass compared to a full quality first pass.
9944 Level 2 can increase first pass speed up to 4x with about +/\- 0.05dB change
9945 in the global PSNR of the final pass compared to a full quality first pass.
9950 Sets maximum interval between IDR-frames (default: 250).
9951 Larger values save bits, thus improve quality, at the cost of seeking
9953 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large
9957 .B keyint_min=<1\-keyint/2>
9958 Sets minimum interval between IDR-frames (default: 25).
9959 If scenecuts appear within this interval, they are still encoded as
9960 I-frames, but do not start a new GOP.
9961 In H.264, I-frames do not necessarily bound a closed GOP because it is
9962 allowable for a P-frame to be predicted from more frames than just the one
9963 frame before it (also see frameref).
9964 Therefore, I-frames are not necessarily seekable.
9965 IDR-frames restrict subsequent P-frames from referring to any frame
9966 prior to the IDR-frame.
9969 .B scenecut=<\-1\-100>
9970 Controls how aggressively to insert extra I-frames (default: 40).
9971 With small values of scenecut, the codec often has to force an I-frame
9972 when it would exceed keyint.
9973 Good values of scenecut may find a better location for the I-frame.
9974 Large values use more I-frames than necessary, thus wasting bits.
9975 \-1 disables scene-cut detection, so I-frames are inserted only once
9976 every other keyint frames, even if a scene-cut occurs earlier.
9977 This is not recommended and wastes bitrate as scenecuts encoded as P-frames
9978 are just as big as I-frames, but do not reset the "keyint counter".
9982 Number of previous frames used as predictors in B- and P-frames (default: 1).
9983 This is effective in anime, but in live-action material the improvements
9984 usually drop off very rapidly above 6 or so reference frames.
9985 This has no effect on decoding speed, but does increase the memory needed for
9987 Some decoders can only handle a maximum of 15 reference frames.
9991 maximum number of consecutive B-frames between I- and P-frames (default: 0)
9995 Automatically decides when to use B-frames and how many, up to the maximum
9996 specified above (default: on).
9997 If this option is disabled, then the maximum number of B-frames is used.
10000 .B b_bias=<\-100\-100>
10001 Controls the decision performed by b_adapt.
10002 A higher b_bias produces more B-frames (default: 0).
10006 Allows B-frames to be used as references for predicting other frames.
10007 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4.
10008 Without this option, B-frames follow the same pattern as MPEG-[124].
10009 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames
10010 are predicted from I0 and P4.
10011 With this option, they are coded as I0 P4 B2 B1 B3.
10012 B2 is the same as above, but B1 is predicted from I0 and B2, and
10013 B3 is predicted from B2 and P4.
10014 This usually results in slightly improved compression, at almost no
10016 However, this is an experimental option: it is not fully tuned and
10017 may not always help.
10018 Requires bframes >= 2.
10019 Disadvantage: increases decoding delay to 2 frames.
10023 Use deblocking filter (default: on).
10024 As it takes very little time compared to its quality gain, it is not
10025 recommended to disable it.
10028 .B deblock=<\-6\-6>,<\-6\-6>
10029 The first parameter is AlphaC0 (default: 0).
10030 This adjusts thresholds for the H.264 in-loop deblocking filter.
10031 First, this parameter adjusts the maximum amount of change that the filter is
10032 allowed to cause on any one pixel.
10033 Secondly, this parameter affects the threshold for difference across the
10034 edge being filtered.
10035 A positive value reduces blocking artifacts more, but will also smear details.
10037 The second parameter is Beta (default: 0).
10038 This affects the detail threshold.
10039 Very detailed blocks are not filtered, since the smoothing caused by the
10040 filter would be more noticeable than the original blocking.
10042 The default behavior of the filter almost always achieves optimal quality,
10043 so it is best to either leave it alone, or make only small adjustments.
10044 However, if your source material already has some blocking or noise which
10045 you would like to remove, it may be a good idea to turn it up a little bit.
10049 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on).
10050 Slightly slows down encoding and decoding, but should save 10\-15% bitrate.
10051 Unless you are looking for decoding speed, you should not disable it.
10054 .B qp_min=<1\-51> (ABR or two pass)
10055 Minimum quantizer, 10\-30 seems to be a useful range (default: 10).
10058 .B qp_max=<1\-51> (ABR or two pass)
10059 maximum quantizer (default: 51)
10062 .B qp_step=<1\-50> (ABR or two pass)
10063 maximum value by which the quantizer may be incremented/decremented between
10064 frames (default: 4)
10067 .B ratetol=<0.1\-100.0> (ABR or two pass)
10068 allowed variance in average bitrate (no particular units) (default: 1.0)
10071 .B vbv_maxrate=<value> (ABR or two pass)
10072 maximum local bitrate, in kbits/\:second (default: disabled)
10075 .B vbv_bufsize=<value> (ABR or two pass)
10076 averaging period for vbv_maxrate, in kbits
10077 (default: none, must be specified if vbv_maxrate is enabled)
10080 .B vbv_init=<0.0\-1.0> (ABR or two pass)
10081 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9)
10084 .B ip_factor=<value>
10085 quantizer factor between I- and P-frames (default: 1.4)
10088 .B pb_factor=<value>
10089 quantizer factor between P- and B-frames (default: 1.3)
10092 .B qcomp=<0\-1> (ABR or two pass)
10093 quantizer compression (default: 0.6).
10094 A lower value makes the bitrate more constant,
10095 while a higher value makes the quantization parameter more constant.
10098 .B cplx_blur=<0\-999> (two pass only)
10099 Temporal blur of the estimated frame complexity, before curve compression
10101 Lower values allow the quantizer value to jump around more,
10102 higher values force it to vary more smoothly.
10103 cplx_blur ensures that each I-frame has quality comparable to the following
10104 P-frames, and ensures that alternating high and low complexity frames
10105 (e.g.\& low fps animation) do not waste bits on fluctuating quantizer.
10108 .B qblur=<0\-99> (two pass only)
10109 Temporal blur of the quantization parameter, after curve compression
10111 Lower values allow the quantizer value to jump around more,
10112 higher values force it to vary more smoothly.
10115 .B zones=<zone0>[/<zone1>[/...]]
10116 User specified quality for specific parts (ending, credits, ...).
10117 Each zone is <start-frame>,<end-frame>,<option> where option may be
10122 .IPs "b=<0.01\-100.0>"
10128 The quantizer option is not strictly enforced.
10129 It affects only the planning stage of ratecontrol, and is still subject
10130 to overflow compensation and qp_min/qp_max.
10134 .B direct_pred=<name>
10135 Determines the type of motion prediction used for direct macroblocks
10140 Direct macroblocks are not used.
10142 Motion vectors are extrapolated from neighboring blocks.
10145 Motion vectors are extrapolated from the following P-frame.
10147 The codec selects between spatial and temporal for each frame.
10151 Spatial and temporal are approximately the same speed and PSNR,
10152 the choice between them depends on the video content.
10153 Auto is slightly better, but slower.
10154 Auto is most effective when combined with multipass.
10155 direct_pred=none is both slower and lower quality.
10160 Use weighted prediction in B-frames.
10161 Without this option, bidirectionally predicted macroblocks give
10162 equal weight to each reference frame.
10163 With this option, the weights are determined by the temporal position
10164 of the B-frame relative to the references.
10165 Requires bframes > 1.
10168 .B partitions=<list>
10169 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4).
10173 Enable types p16x8, p8x16, p8x8.
10175 Enable types p8x4, p4x8, p4x4.
10176 p4x4 is recommended only with subq >= 5, and only at low resolutions.
10178 Enable types b16x8, b8x16, b8x8.
10181 i8x8 has no effect unless 8x8dct is enabled.
10185 Enable all of the above types.
10187 Disable all of the above types.
10191 Regardless of this option, macroblock types p16x16, b16x16, and i16x16
10192 are always enabled.
10194 The idea is to find the type and size that best describe a certain area
10196 For example, a global pan is better represented by 16x16 blocks, while
10197 small moving objects are better represented by smaller blocks.
10202 Adaptive spatial transform size: allows macroblocks to choose between
10204 Also allows the i8x8 macroblock type.
10205 Without this option, only 4x4 DCT is used.
10209 Select fullpixel motion estimation algorithm.
10213 diamond search, radius 1 (fast)
10215 hexagon search, radius 2 (default)
10217 uneven multi-hexagon search (slow)
10219 exhaustive search (very slow, and no better than umh)
10224 .B me_range=<4\-64>
10225 radius of exhaustive or multi-hexagon motion search (default: 16)
10229 Adjust subpel refinement quality.
10230 This parameter controls quality versus speed tradeoffs involved in the motion
10231 estimation decision process.
10232 subq=5 can compress up to 10% better than subq=1.
10236 Runs fullpixel precision motion estimation on all candidate
10238 Then selects the best type with SAD metric (faster than subq=1, not recommended
10239 unless you're looking for ultra-fast encoding).
10241 Does as 0, then refines the motion of that type to fast quarterpixel precision
10244 Runs halfpixel precision motion estimation on all candidate macroblock types.
10245 Then selects the best type with SATD metric.
10246 Then refines the motion of that type to fast quarterpixel precision.
10248 As 2, but uses a slower quarterpixel refinement.
10250 Runs fast quarterpixel precision motion estimation on all candidate
10252 Then selects the best type with SATD metric.
10253 Then finishes the quarterpixel refinement for that type.
10255 Runs best quality quarterpixel precision motion estimation on all
10256 candidate macroblock types, before selecting the best type.
10257 Also refines the two motion vectors used in bidirectional macroblocks with
10258 SATD metric, rather than reusing vectors from the forward and backward
10261 Enables rate-distortion optimization of macroblock types in
10262 I- and P-frames (default).
10264 Enables rate-distortion optimization of macroblock types in all frames.
10266 Enables rate-distortion optimization of motion vectors and intra prediction modes in I- and P-frames.
10268 Enables rate-distortion optimization of motion vectors and intra prediction modes in all frames (best).
10272 In the above, "all candidates" does not exactly mean all enabled types:
10273 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16.
10278 Takes into account chroma information during subpixel motion search
10279 (default: enabled).
10284 Allows each 8x8 or 16x8 motion partition to independently select a
10286 Without this option, a whole macroblock must use the same reference.
10287 Requires frameref>1.
10290 .B trellis=<0\-2> (cabac only)
10291 rate-distortion optimal quantization
10297 enabled only for the final encode
10299 enabled during all mode decisions (slow, requires subq>=6)
10304 .B psy-rd=rd[,trell]
10305 Sets the strength of the psychovisual optimization.
10308 .IPs rd=<0.0\-10.0>
10309 psy optimization strength (requires subq>=6) (default: 1.0)
10310 .IPs trell=<0.0\-10.0>
10311 trellis (requires trellis, experimental) (default: 0.0)
10317 .B deadzone_inter=<0\-32>
10318 Set the size of the inter luma quantization deadzone for non-trellis
10319 quantization (default: 21).
10320 Lower values help to preserve fine details and film grain (typically useful
10321 for high bitrate/quality encode), while higher values help filter out
10322 these details to save bits that can be spent again on other macroblocks
10323 and frames (typically useful for bitrate-starved encodes).
10324 It is recommended that you start by tweaking deadzone_intra before changing
10328 .B deadzone_intra=<0\-32>
10329 Set the size of the intra luma quantization deadzone for non-trellis
10330 quantization (default: 11).
10331 This option has the same effect as deadzone_inter except that it affects
10333 It is recommended that you start by tweaking this parameter before changing
10338 Performs early skip detection in P-frames (default: enabled).
10339 This usually improves speed at no cost, but it can sometimes produce
10340 artifacts in areas with no details, like sky.
10343 .B (no)dct_decimate
10344 Eliminate dct blocks in P-frames containing only a small single coefficient
10345 (default: enabled).
10346 This will remove some details, so it will save bits that can be spent
10347 again on other frames, hopefully raising overall subjective quality.
10348 If you are compressing non-anime content with a high target bitrate, you
10349 may want to disable this to preserve as much detail as possible.
10353 Noise reduction, 0 means disabled.
10354 100\-1000 is a useful range for typical content, but you may want to turn it
10355 up a bit more for very noisy content (default: 0).
10356 Given its small impact on speed, you might want to prefer to use this over
10357 filtering noise away with video filters like denoise3d or hqdn3d.
10360 .B chroma_qp_offset=<\-12\-12>
10361 Use a different quantizer for chroma as compared to luma.
10362 Useful values are in the range <\-2\-2> (default: 0).
10366 Defines how adaptive quantization (AQ) distributes bits:
10372 Avoid moving bits between frames.
10374 Move bits between frames (by default).
10379 .B aq_strength=<positive float value>
10380 Controls how much adaptive quantization (AQ) reduces blocking and blurring
10381 in flat and textured areas (default: 1.0).
10382 A value of 0.5 will lead to weak AQ and less details, when a value of 1.5
10383 will lead to strong AQ and more details.
10386 .B cqm=<flat|jvt|<filename>>
10387 Either uses a predefined custom quantization matrix or loads a JM format
10392 Use the predefined flat 16 matrix (default).
10394 Use the predefined JVT matrix.
10396 Use the provided JM format matrix file.
10401 Windows CMD.EXE users may experience problems with parsing the command line
10402 if they attempt to use all the CQM lists.
10403 This is due to a command line length limitation.
10404 In this case it is recommended the lists be put into a JM format CQM
10405 file and loaded as specified above.
10409 .B cqm4iy=<list> (also see cqm)
10410 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated
10411 values in the 1\-255 range.
10414 .B cqm4ic=<list> (also see cqm)
10415 Custom 4x4 intra chrominance matrix, given as a list of 16 comma
10416 separated values in the 1\-255 range.
10419 .B cqm4py=<list> (also see cqm)
10420 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated
10421 values in the 1\-255 range.
10424 .B cqm4pc=<list> (also see cqm)
10425 Custom 4x4 inter chrominance matrix, given as a list of 16 comma
10426 separated values in the 1\-255 range.
10429 .B cqm8iy=<list> (also see cqm)
10430 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated
10431 values in the 1\-255 range.
10434 .B cqm8py=<list> (also see cqm)
10435 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated
10436 values in the 1\-255 range.
10439 .B level_idc=<10\-51>
10440 Set the bitstream's level as defined by annex A of the H.264 standard
10441 (default: 51 \- level 5.1).
10442 This is used for telling the decoder what capabilities it needs to support.
10443 Use this parameter only if you know what it means,
10444 and you have a need to set it.
10448 Spawn threads to encode in parallel on multiple CPUs (default: 1).
10449 This has a slight penalty to compression quality.
10450 0 or 'auto' tells x264 to detect how many CPUs you have and pick an
10451 appropriate number of threads.
10454 .B (no)global_header
10455 Causes SPS and PPS to appear only once, at the beginning of the bitstream
10456 (default: disabled).
10457 Some players, such as the Sony PSP, require the use of this option.
10458 The default behavior causes SPS and PPS to repeat prior to each IDR frame.
10462 Treat the video content as interlaced.
10466 Adjust the amount of logging info printed to the screen.
10476 PSNR and other analysis statistics when the encode finishes (default)
10478 PSNR, QP, frametype, size, and other statistics for every frame
10484 Print signal-to-noise ratio statistics.
10487 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not
10488 mathematically sound (they are simply the average of per-frame PSNRs).
10489 They are kept only for comparison to the JM reference codec.
10490 For all other purposes, please use either the 'Global' PSNR, or the per-frame
10491 PSNRs printed by log=3.
10495 Print the Structural Similarity Metric results.
10496 This is an alternative to PSNR, and may be better correlated with the
10497 perceived quality of the compressed video.
10501 Enable x264 visualizations during encoding.
10502 If the x264 on your system supports it, a new window will be opened during
10503 the encoding process, in which x264 will attempt to present an overview of
10504 how each frame gets encoded.
10505 Each block type on the visualized movie will be colored as follows:
10519 This feature can be considered experimental and subject to change.
10520 In particular, it depends on x264 being compiled with visualizations enabled.
10521 Note that as of writing this, x264 pauses after encoding and visualizing
10522 each frame, waiting for the user to press a key, at which point the next
10523 frame will be encoded.
10527 .SS xvfw (\-xvfwopts)
10529 Encoding with Video for Windows codecs is mostly obsolete unless you wish
10530 to encode to some obscure fringe codec.
10534 The name of the binary codec file with which to encode.
10538 The name of the codec settings file (like firstpass.mcf) created by vfw2menc.
10541 .SS MPEG muxer (\-mpegopts)
10543 The MPEG muxer can generate 5 types of streams, each of which has reasonable
10544 default parameters that the user can override.
10545 Generally, when generating MPEG files, it is advisable to disable
10546 MEncoder's frame-skip code (see \-noskip, \-mc as well as the
10547 harddup and softskip video filters).
10552 .IPs format=mpeg2:tsaf:vbitrate=8000
10557 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd | pes1 | pes2>
10558 stream format (default: mpeg2).
10559 pes1 and pes2 are very broken formats (no pack header and no padding),
10560 but VDR uses them; do not choose them unless you know exactly what you
10564 .B size=<up to 65535>
10565 Pack size in bytes, do not change unless you know exactly what
10566 you are doing (default: 2048).
10570 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s).
10571 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'.
10575 Sets timestamps on all frames, if possible; recommended when format=dvd.
10576 If dvdauthor complains with a message like "..audio sector out of range...",
10577 you probably did not enable this option.
10581 Uses a better algorithm to interleave audio and video packets, based on the
10582 principle that the muxer will always try to fill the stream with the largest
10583 percentage of free space.
10586 .B vdelay=<1\-32760>
10587 Initial video delay time, in milliseconds (default: 0),
10588 use it if you want to delay video with respect to audio.
10589 It doesn't work with :drop.
10592 .B adelay=<1\-32760>
10593 Initial audio delay time, in milliseconds (default: 0),
10594 use it if you want to delay audio with respect to video.
10598 When used with vdelay the muxer drops the part of audio that was
10602 .B vwidth, vheight=<1\-4095>
10603 Set the video width and height when video is MPEG-1/2.
10606 .B vpswidth, vpsheight=<1\-4095>
10607 Set pan and scan video width and height when video is MPEG-2.
10610 .B vaspect=<1 | 4/3 | 16/9 | 221/100>
10611 Sets the display aspect ratio for MPEG-2 video.
10612 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong.
10616 Sets the video bitrate in kbit/s for MPEG-1/2 video.
10619 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 >
10620 Sets the framerate for MPEG-1/2 video.
10621 This option will be ignored if used with the telecine option.
10625 Enables 3:2 pulldown soft telecine mode: The muxer will make the
10626 video stream look like it was encoded at 30000/1001 fps.
10627 It only works with MPEG-2 video when the output framerate is
10628 24000/1001 fps, convert it with \-ofps if necessary.
10629 Any other framerate is incompatible with this option.
10633 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer
10634 will make the video stream look like it was encoded at 25 fps.
10635 It only works with MPEG-2 video when the output framerate is
10636 24000/1001 fps, convert it with \-ofps if necessary.
10637 Any other framerate is incompatible with this option.
10640 .B tele_src and tele_dest
10641 Enables arbitrary telecining using Donand Graft's DGPulldown code.
10642 You need to specify the original and the desired framerate; the
10643 muxer will make the video stream look like it was encoded at
10644 the desired framerate.
10645 It only works with MPEG-2 video when the input framerate is smaller
10646 than the output framerate and the framerate increase is <= 1.5.
10653 .IPs tele_src=25,tele_dest=30000/1001
10654 PAL to NTSC telecining
10659 .B vbuf_size=<40\-1194>
10660 Sets the size of the video decoder's buffer, expressed in kilobytes.
10661 Specify it only if the bitrate of the video stream is too high for
10662 the chosen format and if you know perfectly well what you are doing.
10663 A too high value may lead to an unplayable movie, depending on the player's
10665 When muxing HDTV video a value of 400 should suffice.
10668 .B abuf_size=<4\-64>
10669 Sets the size of the audio decoder's buffer, expressed in kilobytes.
10670 The same principle as for vbuf_size applies.
10673 .SS FFmpeg libavformat demuxers (\-lavfdopts)
10676 .B analyzeduration=<value>
10677 Maximum length in seconds to analyze the stream properties.
10681 Force a specific libavformat demuxer.
10684 .B o=<key>=<value>[,<key>=<value>[,...]]
10685 Pass AVOptions to libavformat demuxer.
10686 Note, a patch to make the o= unneeded and pass all unknown options through
10687 the AVOption system is welcome.
10688 A full list of AVOptions can be found in the FFmpeg manual.
10689 Note that some options may conflict with MPlayer/MEncoder options.
10701 .B probesize=<value>
10702 Maximum amount of data to probe during the detection phase.
10703 In the case of MPEG-TS this value identifies the maximum number
10704 of TS packets to scan.
10707 .B cryptokey=<hexstring>
10708 Encryption key the demuxer should use.
10709 This is the raw binary data of the key converted to a hexadecimal string.
10712 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf)
10716 Currently only meaningful for MPEG[12]: Maximum allowed distance,
10717 in seconds, between the reference timer of the output stream (SCR)
10718 and the decoding timestamp (DTS) for any stream present
10719 (demux to decode delay).
10720 Default is 0.7 (as mandated by the standards defined by MPEG).
10721 Higher values require larger buffers and must not be used.
10724 .B format=<container_format>
10725 Override which container format to mux into
10726 (default: autodetect from output file extension).
10730 MPEG-1 systems and MPEG-2 PS
10732 Advanced Streaming Format
10734 Audio Video Interleave file
10740 Macromedia Flash video files
10742 RealAudio and RealVideo
10746 NUT open container format (experimental)
10752 MPEG-4 format with extra header flags required by Apple iPod firmware
10754 Sony Digital Video container
10755 .IPs "matroska\ \ \ "
10761 Nominal bitrate of the multiplex, in bits per second;
10762 currently it is meaningful only for MPEG[12].
10763 Sometimes raising it is necessary in order to avoid "buffer underflows".
10766 .B o=<key>=<value>[,<key>=<value>[,...]]
10767 Pass AVOptions to libavformat muxer.
10768 Note, a patch to make the o= unneeded and pass all unknown options through
10769 the AVOption system is welcome.
10770 A full list of AVOptions can be found in the FFmpeg manual.
10771 Note that some options may conflict with MEncoder options.
10778 .IPs o=packetsize=100
10783 .B packetsize=<size>
10784 Size, expressed in bytes, of the unitary packet for the chosen format.
10785 When muxing to MPEG[12] implementations the default values are:
10786 2324 for [S]VCD, 2048 for all others formats.
10789 .B preload=<distance>
10790 Currently only meaningful for MPEG[12]: Initial distance,
10791 in seconds, between the reference timer of the output stream (SCR)
10792 and the decoding timestamp (DTS) for any stream present
10793 (demux to decode delay).
10797 .\" --------------------------------------------------------------------------
10798 .\" environment variables
10799 .\" --------------------------------------------------------------------------
10801 .SH ENVIRONMENT VARIABLES
10803 There are a number of environment variables that can be used to
10804 control the behavior of MPlayer and MEncoder.
10807 .B MPLAYER_CHARSET (also see \-msgcharset)
10808 Convert console messages to the specified charset (default: autodetect).
10809 A value of "noconv" means no conversion.
10813 Directory where MPlayer looks for user settings.
10816 .B MPLAYER_VERBOSE (also see \-v and \-msglevel)
10817 Set the initial verbosity level across all message modules (default: 0).
10818 The resulting verbosity corresponds to that of \-msglevel 5 plus the
10819 value of MPLAYER_VERBOSE.
10825 If LADSPA_PATH is set, it searches for the specified file.
10826 If it is not set, you must supply a fully specified pathname.
10827 FIXME: This is also mentioned in the ladspa section.
10833 Specify a directory in which to store title key values.
10834 This will speed up descrambling of DVDs which are in the cache.
10835 The DVDCSS_CACHE directory is created if it does not exist,
10836 and a subdirectory is created named after the DVD's title
10837 or manufacturing date.
10838 If DVDCSS_CACHE is not set or is empty, libdvdcss will use
10839 the default value which is "${HOME}/.dvdcss/" under Unix and
10840 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" under Win32.
10841 The special value "off" disables caching.
10845 Sets the authentication and decryption method that
10846 libdvdcss will use to read scrambled discs.
10847 Can be one of title, key or disc.
10851 is the default method.
10852 libdvdcss will use a set of calculated player keys to try and get the disc key.
10853 This can fail if the drive does not recognize any of the player keys.
10855 is a fallback method when key has failed.
10856 Instead of using player keys, libdvdcss will crack the disc key using
10857 a brute force algorithm.
10858 This process is CPU intensive and requires 64 MB of memory to store
10861 is the fallback when all other methods have failed.
10862 It does not rely on a key exchange with the DVD drive, but rather uses
10863 a crypto attack to guess the title key.
10864 On rare cases this may fail because there is not enough encrypted data
10865 on the disc to perform a statistical attack, but in the other hand it
10866 is the only way to decrypt a DVD stored on a hard disc, or a DVD with
10867 the wrong region on an RPC2 drive.
10872 .B DVDCSS_RAW_DEVICE
10873 Specify the raw device to use.
10874 Exact usage will depend on your operating system, the Linux
10875 utility to set up raw devices is raw(8) for instance.
10876 Please note that on most operating systems, using a raw device
10877 requires highly aligned buffers: Linux requires a 2048 bytes
10878 alignment (which is the size of a DVD sector).
10882 Sets the libdvdcss verbosity level.
10886 Outputs no messages at all.
10888 Outputs error messages to stderr.
10890 Outputs error messages and debug messages to stderr.
10896 Skip retrieving all keys on startup.
10897 Currently disabled.
10901 FIXME: Document this.
10906 .B AO_SUN_DISABLE_SAMPLE_TIMING
10907 FIXME: Document this.
10911 FIXME: Document this.
10915 Specifies the Network Audio System server to which the
10916 nas audio output driver should connect and the transport
10917 that should be used.
10918 If unset DISPLAY is used instead.
10919 The transport can be one of tcp and unix.
10920 Syntax is tcp/<somehost>:<someport>, <somehost>:<instancenumber>
10921 or [unix]:<instancenumber>.
10922 The NAS base port is 8000 and <instancenumber> is added to that.
10929 .IPs AUDIOSERVER=somehost:0
10930 Connect to NAS server on somehost using default port and transport.
10931 .IPs AUDIOSERVER=tcp/somehost:8000
10932 Connect to NAS server on somehost listening on TCP port 8000.
10933 .IPs AUDIOSERVER=(unix)?:0
10934 Connect to NAS server instance 0 on localhost using unix domain sockets.
10940 FIXME: Document this.
10946 FIXME: Document this.
10950 Set this to 'disable' in order to stop the VIDIX driver from controlling
10951 alphablending settings.
10952 You can then manipulate it yourself with 'ivtvfbctl'.
10958 FIXME: Document this.
10964 FIXME: Document this.
10968 FIXME: Document this.
10972 FIXME: Document this.
10978 FIXME: Document this.
10982 FIXME: Document this.
10986 FIXME: Document this.
10990 FIXME: Document this.
10994 FIXME: Document this.
11000 FIXME: Document this.
11006 FIXME: Document this.
11010 FIXME: Document this.
11014 FIXME: Document this.
11020 FIXME: Document this.
11024 FIXME: Document this.
11028 FIXME: Document this.
11032 FIXME: Document this.
11036 FIXME: Document this.
11040 FIXME: Document this.
11044 .\" --------------------------------------------------------------------------
11046 .\" --------------------------------------------------------------------------
11051 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
11052 MPlayer system-wide settings
11055 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf
11056 MEncoder system-wide settings
11059 ~/.mplayer/\:config
11060 MPlayer user settings
11063 ~/.mplayer/\:mencoder.conf
11064 MEncoder user settings
11067 ~/.mplayer/\:input.conf
11068 input bindings (see '\-input keylist' for the full list)
11071 ~/.mplayer/\:gui.conf
11072 GUI configuration file
11075 ~/.mplayer/\:gui.pl
11080 font directory (There must be a font.desc file and files with .RAW extension.)
11083 ~/.mplayer/\:DVDkeys/
11087 Assuming that /path/\:to/\:movie.avi is played, MPlayer searches for sub files
11090 /path/\:to/\:movie.sub
11092 ~/.mplayer/\:sub/\:movie.sub
11097 .\" --------------------------------------------------------------------------
11099 .\" --------------------------------------------------------------------------
11101 .SH EXAMPLES OF MPLAYER USAGE
11104 .B Quickstart DVD playing:
11110 .B Play in Japanese with English subtitles:
11112 mplayer dvd://1 \-alang ja \-slang en
11116 .B Play only chapters 5, 6, 7:
11118 mplayer dvd://1 \-chapter 5\-7
11122 .B Play only titles 5, 6, 7:
11128 .B Play a multiangle DVD:
11130 mplayer dvd://1 \-dvdangle 2
11134 .B Play from a different DVD device:
11136 mplayer dvd://1 \-dvd\-device /dev/\:dvd2
11140 .B Play DVD video from a directory with VOB files:
11142 mplayer dvd://1 \-dvd\-device /path/\:to/\:directory/
11146 .B Copy a DVD title to hard disk, saving to file "title1.vob":
11148 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
11152 .B Play a DVD with dvdnav from path /dev/sr1:
11154 mplayer dvdnav:////dev/sr1
11158 .B Stream from HTTP:
11160 mplayer http://mplayer.hq/example.avi
11164 .B Stream using RTSP:
11166 mplayer rtsp://server.example.com/streamName
11170 .B Convert subtitles to MPsub format:
11172 mplayer dummy.avi \-sub source.sub \-dumpmpsub
11176 .B Convert subtitles to MPsub format without watching the movie:
11178 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub
11182 .B input from standard V4L:
11184 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
11188 .B Playback on Zoran cards (old style, deprecated):
11190 mplayer \-vo zr \-vf scale=352:288 file.avi
11194 .B Playback on Zoran cards (new style):
11196 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
11200 .B Play DTS-CD with passthrough:
11202 mplayer \-ac hwdts \-rawaudio format=0x2001 \-cdrom\-device /dev/cdrom cdda://
11205 You can also use \-afm hwac3 instead of \-ac hwdts.
11206 Adjust '/dev/cdrom' to match the CD-ROM device on your system.
11207 If your external receiver supports decoding raw DTS streams,
11208 you can directly play it via cdda:// without setting format, hwac3 or hwdts.
11211 .B Play a 6-channel AAC file with only two speakers:
11213 mplayer \-rawaudio format=0xff \-demuxer rawaudio \-af pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac
11216 You might want to play a bit with the pan values (e.g multiply with a value) to
11217 increase volume or avoid clipping.
11220 .B checkerboard invert with geq filter:
11222 mplayer \-vf geq='128+(p(X\,Y)\-128)*(0.5\-gt(mod(X/SW\,128)\,64))*(0.5\-gt(mod(Y/SH\,128)\,64))*4'
11226 .SH EXAMPLES OF MENCODER USAGE
11229 .B Encode DVD title #2, only selected chapters:
11231 mencoder dvd://2 \-chapter 10\-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11235 .B Encode DVD title #2, resizing to 640x480:
11237 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11241 .B Encode DVD title #2, resizing to 512xHHH (keep aspect ratio):
11243 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11247 .B The same, but with bitrate set to 1800kbit and optimized macroblocks:
11249 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
11253 .B The same, but with MJPEG compression:
11255 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800
11259 .B Encode all *.jpg files in the current directory:
11261 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
11265 .B Encode from a tuner (specify a format with \-vf format):
11267 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
11271 .B Encode from a pipe:
11273 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
11277 .\" --------------------------------------------------------------------------
11278 .\" Bugs, authors, standard disclaimer
11279 .\" --------------------------------------------------------------------------
11283 If you find one, report it to us, but please make sure you have read all
11284 of the documentation first.
11285 Also look out for smileys. :)
11286 Many bugs are the result of incorrect setup or parameter usage.
11287 The bug reporting section of the documentation
11288 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:bugreports.html)
11289 explains how to create useful bug reports.
11294 MPlayer was initially written by Arpad Gereoffy.
11295 See the AUTHORS file for a list of some of the many other contributors.
11297 MPlayer is (C) 2000\-2009 The MPlayer Team
11299 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
11300 It is maintained by Diego Biurrun.
11301 Please send mails about it to the MPlayer-DOCS mailing list.
11302 Translation specific mails belong on the MPlayer-translations mailing list.