2 .\" MPlayer (C) 2000-2010 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 [br]://[title][/device]
69 [dvd|dvdnav]://[title|[start_title]\-end_title][/device]
78 tv://[channel][/input_id]
83 radio://[channel|frequency][/capture]
93 dvb://[card_number@]channel
98 mf://[filemask|@listfile]
99 [\-mf options] [options]
103 [cdda|cddb]://track[\-endtrack][:speed][/device]
113 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
114 [user:pass@]URL[:port] [options]
123 mpst://host[:port]/URL
128 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, Blu\-ray, 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, Blu-ray, 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.
276 .IPs "C (\-capture only)"
277 Start/stop capturing the primary stream.
279 Move subtitles up/down.
280 .IPs "i (\-edlout mode only)"
281 Set start or end of an EDL skip and write it out to the given file.
282 .IPs "s (\-vf screenshot only)"
284 .IPs "S (\-vf screenshot only)"
285 Start/stop taking screenshots.
287 Show filename on the OSD.
289 Show progression bar, elapsed time and total duration on the OSD.
291 Seek to the beginning of the previous/next chapter.
292 .IPs "D (\-vo xvmc, \-vo vdpau, \-vf yadif, \-vf kerndeint only)"
293 Activate/deactivate deinterlacer.
295 Cycle through the available DVD angles.
296 .IPs "c (currently -vo vdpau and -vo xv only)"
297 Change YUV colorspace.
302 (The following keys are valid only when using a hardware accelerated video
303 output (xv, (x)vidix, (x)mga, etc), the software equalizer
304 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
321 (The following keys are valid only when using the quartz or corevideo
322 video output driver.)
328 Resize movie window to half its original size.
330 Resize movie window to its original size.
332 Resize movie window to double its original size.
334 Toggle fullscreen (also see \-fs).
335 .IPs "command + [ and command + ]"
336 Set movie window alpha.
341 (The following keys are valid only when using the sdl
342 video output driver.)
348 Cycle through available fullscreen modes.
350 Restore original mode.
355 (The following keys are valid if you have a keyboard
356 with multimedia keys.)
364 Stop playing and quit.
365 .IPs "PREVIOUS and NEXT"
366 Seek backward/\:forward 1 minute.
371 (The following keys are only valid if you compiled with TV or DVB input
372 support and will take precedence over the keys defined above.)
378 Select previous/\:next channel.
387 (The following keys are only valid if you compiled with dvdnav
388 support: They are used to navigate the menus.)
404 Return to nearest menu (the order of preference is: chapter->title->root).
412 (The following keys are used for controlling TV teletext. The data may
413 come from either an analog TV source or an MPEG transport stream.)
419 Switch teletext on/\:off.
421 Go to next/\:prev teletext page.
429 .IPs "button 3 and button 4"
430 Seek backward/\:forward 1 minute.
431 .IPs "button 5 and button 6"
432 Decrease/\:increase volume.
440 .IPs "left and right"
441 Seek backward/\:forward 10 seconds.
443 Seek forward/\:backward 1 minute.
447 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
448 .IPs "button 3 and button 4"
449 Decrease/\:increase volume.
454 .\" --------------------------------------------------------------------------
456 .\" --------------------------------------------------------------------------
459 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
460 \-fs option is \-nofs.
462 If an option is marked as (XXX only), it will only work in combination with
463 the XXX option or if XXX is compiled in.
466 The suboption parser (used for example for \-ao pcm suboptions) supports
467 a special kind of string-escaping intended for use with external GUIs.
469 It has the following format:
471 %n%string_of_length_n
475 mplayer \-ao pcm:file=%10%C:test.wav test.avi
479 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
482 .\" --------------------------------------------------------------------------
483 .\" Configuration files
484 .\" --------------------------------------------------------------------------
486 .SH "CONFIGURATION FILES"
487 You can put all of the options in configuration files which will be read
488 every time MPlayer/MEncoder is run.
489 The system-wide configuration file 'mplayer.conf' is in your configuration
490 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
491 specific one is '~/\:.mplayer/\:config'.
492 The configuration file for MEncoder is 'mencoder.conf' in your configuration
493 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the
494 user specific one is '~/\:.mplayer/\:mencoder.conf'.
495 User specific options override system-wide options and options given on the
496 command line override either.
497 The syntax of the configuration files is 'option=<value>', everything after
498 a '#' is considered a comment.
499 Options that work without values can be enabled by setting them to 'yes'
500 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
501 Even suboptions can be specified in this way.
503 You can also write file-specific configuration files.
504 If you wish to have a configuration file for a file called 'movie.avi', create a file
505 named 'movie.avi.conf' with the file-specific options in it and put it in
507 You can also put the configuration file in the same directory as the file to
508 be played, as long as you give the \-use\-filedir\-conf option (either on the
509 command line or in your global config file).
510 If a file-specific configuration file is found in the same directory, no
511 file-specific configuration is loaded from ~/.mplayer.
512 In addition, the \-use\-filedir\-conf option enables directory-specific
514 For this, MPlayer first tries to load a mplayer.conf from the same directory as
515 the file played and then tries to load any file-specific configuration.
517 .I EXAMPLE MPLAYER CONFIGURATION FILE:
520 # Use Matrox driver by default.
522 # I love practicing handstands while watching videos.
524 # Decode/encode multiple files from PNG,
525 # start with mf://filemask
527 # Eerie negative images are cool.
531 .I "EXAMPLE MENCODER CONFIGURATION FILE:"
534 # Make MEncoder output to a default filename.
536 # The next 4 lines allow mencoder tv:// to start capturing immediately.
539 lavcopts=vcodec=mjpeg
540 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
541 # more complex default encoding option set
542 lavcopts=vcodec=mpeg4:autoaspect=1
546 passlogfile=pass1stats.log
556 .\" --------------------------------------------------------------------------
558 .\" --------------------------------------------------------------------------
561 To ease working with different configurations profiles can be defined in the
563 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
564 All following options will be part of the profile.
565 A description (shown by \-profile help) can be defined with the profile-desc
567 To end the profile, start another one or use the profile name 'default'
568 to continue with normal options.
571 .I "EXAMPLE MPLAYER PROFILE:"
576 profile-desc="profile for dvd:// streams"
581 profile-desc="profile for dvdnav:// streams"
587 profile-desc="profile for .flv files"
597 .I "EXAMPLE MENCODER PROFILE:"
602 profile-desc="MPEG4 encoding"
604 lavcopts=vcodec=mpeg4:vbitrate=1200
607 profile-desc="HQ MPEG4 encoding"
609 lavcopts=mbd=2:trell=yes:v4mv=yes
612 .\" --------------------------------------------------------------------------
614 .\" --------------------------------------------------------------------------
616 .SH "GENERAL OPTIONS"
620 Specify a directory for binary codecs.
623 .B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
624 Override the standard search path and use the specified file
625 instead of the builtin codecs.conf.
628 .B \-include <configuration file>
629 Specify configuration file to be parsed after the default ones.
633 Prints all available options.
636 .B \-msgcharset <charset>
637 Convert console messages to the specified character set (default: autodetect).
638 Text will be in the encoding specified with the \-\-charset configure option.
639 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
642 The option takes effect after command line parsing has finished.
643 The MPLAYER_CHARSET environment variable can help you get rid of
644 the first lines of garbled output.
648 Enable colorful console output on terminals that support ANSI color.
651 .B \-msglevel <all=<level>:<module>=<level>:...>
652 Control verbosity directly for each module.
653 The 'all' module changes the verbosity of all the modules not
654 explicitly specified on the command line.
655 See '\-msglevel help' for a list of all modules.
658 Some messages are printed before the command line is parsed and are
659 therefore not affected by \-msglevel.
660 To control these messages you have to use the MPLAYER_VERBOSE environment
661 variable, see its description below for details.
677 informational messages
679 status messages (default)
693 Prepend module name in front of each console message.
696 .B \-noconfig <options>
697 Do not parse selected configuration files.
700 If \-include or \-use\-filedir\-conf options are
701 specified at the command line, they will be honoured.
703 Available options are:
707 all configuration files
709 system configuration file
711 user configuration file
717 Make console output less verbose; in particular, prevents the status line
718 (i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed.
719 Particularly useful on slow terminals or broken ones which do not properly
720 handle carriage return (i.e.\& \\r).
723 .B \-priority <prio> (Windows and OS/2 only)
724 Set process priority for MPlayer according to the predefined
725 priorities available under Windows and OS/2.
726 Possible values of <prio>:
728 idle|belownormal|normal|abovenormal|high|realtime
733 Using realtime priority can cause system lockup.
737 .B \-profile <profile1,profile2,...>
738 Use the given profile(s), \-profile help displays a list of the defined profiles.
741 .B \-really\-quiet (also see \-quiet)
742 Display even less output and status messages than with \-quiet.
745 .B \-show\-profile <profile>
746 Show the description and content of a profile.
749 .B \-use\-filedir\-conf
750 Look for a file-specific configuration file in the same directory as
751 the file that is being played.
754 May be dangerous if playing from untrusted media.
758 Increment verbosity level, one level for each \-v
759 found on the command line.
763 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
766 .B \-autoq <quality> (use with \-vf [s]pp)
767 Dynamically changes the level of postprocessing depending on the available spare
769 The number you specify will be the maximum level used.
770 Usually you can use some big number.
771 You have to use \-vf [s]pp without parameters in order for this to work.
774 .B \-autosync <factor>
775 Gradually adjusts the A/V sync based on audio delay measurements.
776 Specifying \-autosync 0, the default, will cause frame timing to be based
777 entirely on audio delay measurements.
778 Specifying \-autosync 1 will do the same, but will subtly change the A/V
779 correction algorithm.
780 An uneven video framerate in a movie which plays fine with \-nosound can
781 often be helped by setting this to an integer value greater than 1.
782 The higher the value, the closer the timing will be to \-nosound.
783 Try \-autosync 30 to smooth out problems with sound drivers which do
784 not implement a perfect audio delay measurement.
785 With this value, if large A/V sync offsets occur, they will only take about
786 1 or 2 seconds to settle out.
787 This delay in reaction time to sudden A/V offsets should be the only
788 side-effect of turning this option on, for all sound drivers.
792 Prints some statistics on CPU usage and dropped frames at the end of playback.
793 Use in combination with \-nosound and \-vo null for benchmarking only the
797 With this option MPlayer will also ignore frame duration when playing
798 only video (you can think of that as infinite fps).
801 .B \-chapter\-merge\-threshold <number>
802 Threshold for merging almost consecutive ordered chapter parts
803 in milliseconds (default: 100).
804 Some Matroska files with ordered chapters have inaccurate chapter
805 end timestamps, causing a small gap between the end of one chapter and
806 the start of the next one when they should match.
807 If the end of one playback part is less than the given threshold away
808 from the start of the next one then keep playing video normally over the
809 chapter change instead of doing a seek.
812 .B \-colorkey <number>
813 Changes the colorkey to an RGB value of your choice.
814 0x000000 is black and 0xffffff is white.
815 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
816 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
821 Disables colorkeying.
822 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
823 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
828 Switches MPlayer to a mode where timestamps for video frames
829 are calculated differently and video filters which add new frames or
830 modify timestamps of existing ones are supported.
831 The more accurate timestamps can be visible for example when playing
832 subtitles timed to scene changes with the \-ass option.
833 Without \-correct\-pts the subtitle timing will typically be off by some frames.
834 This option does not work correctly with some demuxers and codecs.
837 .B \-crash\-debug (DEBUG CODE)
838 Automatically attaches gdb upon crash or SIGTRAP.
839 Support must be compiled in by configuring with \-\-enable\-crash\-debug.
842 .B \-doubleclick\-time
843 Time in milliseconds to recognize two consecutive button presses as
844 a double-click (default: 300).
845 Set to 0 to let your windowing system decide what a double-click is
849 You will get slightly different behaviour depending on whether you bind
850 MOUSE_BTN0_DBL or MOUSE_BTN0\-MOUSE_BTN0_DBL.
853 .B \-edlout <filename>
854 Creates a new file and writes edit decision list (EDL) records to it.
855 During playback, the user hits 'i' to mark the start or end of a skip block.
856 This provides a starting point from which the user can fine-tune EDL entries
858 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
862 \-fixed\-vo enforces a fixed video system for multiple files (one
863 (un)initialization for all files).
864 Therefore only one window will be opened for all files.
865 Now enabled by default, use \-nofixed\-vo to disable and create a new window
866 whenever the video stream changes.
867 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
868 xmga, xv, xvidix and dfbmga.
871 .B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
872 Skip displaying some frames to maintain A/V sync on slow systems.
873 Video filters are not applied to such frames.
874 For B-frames even decoding is skipped completely.
877 .B \-h, \-help, \-\-help
878 Show short summary of options.
881 .B \-hardframedrop (experimental without \-nocorrect\-pts)
882 More intense frame dropping (breaks decoding).
883 Leads to image distortion!
884 Note that especially the libmpeg2 decoder may crash with this,
885 so consider using "\-vc ffmpeg12,".
889 Command that is executed every 30 seconds during playback via system() -
890 i.e.\& using the shell.
893 MPlayer uses this command without any checking, it is your responsibility
894 to ensure it does not cause security problems (e.g.\& make sure to use full
895 paths if "." is in your path like on Windows).
896 It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
898 This can be "misused" to disable screensavers that do not support the proper
899 X API (also see \-stop\-xscreensaver).
900 If you think this is too complicated, ask the author of the screensaver
901 program to support the proper X APIs.
903 .I EXAMPLE for xscreensaver:
904 mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
906 .I EXAMPLE for GNOME screensaver:
907 mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
913 Shorthand for \-msglevel identify=4.
914 Show file parameters in an easily parseable format.
915 Also prints more detailed information about subtitle and audio
916 track languages and IDs.
917 In some cases you can get more information by using \-msglevel identify=6.
918 For example, for a DVD or Blu\-ray it will list the chapters and time length
919 of each title, as well as a disk ID.
920 Combine this with \-frames 0 to suppress all video output.
921 The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
922 (hopefully) shellescapes the filenames.
925 .B \-idle (also see \-slave)
926 Makes MPlayer wait idly instead of quitting when there is no file to play.
927 Mostly useful in slave mode where MPlayer can be controlled
928 through input commands.
931 .B \-input <commands>
932 This option can be used to configure certain parts of the input system.
933 Paths are relative to ~/.mplayer/.
936 Autorepeat is currently only supported by joysticks.
938 Available commands are:
943 Specify input configuration file other than the default
944 ~/\:.mplayer/\:input.conf.
945 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
947 Device to be used for Apple IR Remote (default is autodetected, Linux only).
949 Delay in milliseconds before we start to autorepeat a key (0 to disable).
951 Number of key presses to generate per second on autorepeat.
952 .IPs (no)default-bindings
953 Use the key bindings that MPlayer ships with by default.
955 Prints all keys that can be bound to commands.
957 Prints all commands that can be bound to keys.
959 Specifies the joystick device to use (default: /dev/\:input/\:js0).
961 Read commands from the given file.
962 Mostly useful with a FIFO.
965 When the given file is a FIFO MPlayer opens both ends so you can do
966 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
971 .B \-key\-fifo\-size <2\-65000>
972 Specify the size of the FIFO that buffers key events (default: 7).
973 A FIFO of size n can buffer (n\-1) events.
974 If it is too small some events may be lost
975 (leading to "stuck mouse buttons" and similar effects).
976 If it is too big, MPlayer may seem to hang while it
977 processes the buffered events.
978 To get the same behavior as before this option was introduced,
979 set it to 2 for Linux or 1024 for Windows.
982 .B \-lircconf <filename> (LIRC only)
983 Specifies a configuration file for LIRC (default: ~/.lircrc).
986 .B \-list\-properties
987 Print a list of the available properties.
991 Loops movie playback <number> times.
995 .B \-menu (OSD menu only)
996 Turn on OSD menu support.
999 .B \-menu\-cfg <filename> (OSD menu only)
1000 Use an alternative menu.conf.
1003 .B \-menu\-chroot <path> (OSD menu only)
1004 Chroot the file selection menu to a specific location.
1009 .IPs "\-menu\-chroot /home"
1010 Will restrict the file selection menu to /\:home and downward (i.e.\& no
1011 access to / will be possible, but /home/user_name will).
1016 .B \-menu\-keepdir (OSD menu only)
1017 File browser starts from the last known location instead of current directory.
1020 .B \-menu\-root <value> (OSD menu only)
1021 Specify the main menu.
1024 .B \-menu\-startup (OSD menu only)
1025 Display the main menu at MPlayer startup.
1028 .B \-mouse\-movements
1029 Permit MPlayer to receive pointer events reported by the video
1031 Necessary to select the buttons in DVD menus.
1032 Supported for X11-based VOs (x11, xv, xvmc, etc) and the gl, gl2, direct3d and
1037 Turns off AppleIR remote support.
1040 .B \-noconsolecontrols
1041 Prevent MPlayer from reading key events from standard input.
1042 Useful when reading data from standard input.
1043 This is automatically enabled when \- is found on the command line.
1044 There are situations where you have to set it manually, e.g.\&
1045 if you open /dev/\:stdin (or the equivalent on your system), use stdin
1046 in a playlist or intend to read from stdin later on via the loadfile or
1047 loadlist slave commands.
1050 .B \-noinitial-audio-sync
1051 When starting a video file or after events such as seeking MPlayer will by
1052 default modify the audio stream to make it start from the same timestamp as
1053 video, by either inserting silence at the start or cutting away the first
1055 This option disables that functionality and makes the player behave like
1056 older MPlayer versions did: video and audio are both started immediately
1057 even if their start timestamps differ, and then video timing is gradually
1058 adjusted if necessary to reach correct synchronization later.
1062 Turns off joystick support.
1066 Turns off LIRC support.
1070 Disable mouse button press/\:release input (mozplayerxp's context menu relies
1073 .B \-noordered\-chapters
1074 Disable support for Matroska ordered chapters.
1075 MPlayer will not load or search for video segments from other files,
1076 and will also ignore any chapter order specified for the main file.
1079 .B \-pts\-association\-mode <mode number>
1080 Select the method used to determine which container packet timestamp
1081 corresponds to a particular output frame from the video decoder.
1085 Try to pick a working mode from the ones below automatically (default)
1087 Use decoder reordering functionality.
1089 Maintain a buffer of unused pts values and use the lowest value for the frame.
1095 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
1097 This wakes up the process every 1/1024 seconds to check the current time.
1098 Useless with modern Linux kernels configured for desktop use as they already
1099 wake up the process with similar accuracy when using normal timed sleep.
1102 .B \-playing\-msg <string>
1103 Print out a string before starting playback.
1104 The following expansions are supported:
1107 Expand to the value of the property NAME.
1109 Expand TEXT only if the property NAME is available.
1111 Expand TEXT only if the property NAME is not available.
1115 .B \-playlist <filename>
1116 Play files according to a playlist file (ASX, Winamp, SMIL, or
1117 one-file-per-line format).
1120 This option is considered an entry so options found after it will apply
1121 only to the elements of this playlist.
1123 FIXME: This needs to be clarified and documented thoroughly.
1126 .B \-rtc\-device <device>
1127 Use the specified device for RTC timing.
1131 Play files in random order.
1134 .B \-slave (also see \-input)
1135 Switches on slave mode, in which MPlayer works as a backend for other programs.
1136 Instead of intercepting keyboard events, MPlayer will read commands separated
1137 by a newline (\\n) from stdin.
1140 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
1141 for their description.
1142 Also, this is not intended to disable other inputs, e.g.\& via the video window,
1143 use some other method like \-input nodefault\-bindings:conf=/dev/null for that.
1147 Time frames by repeatedly checking the current time instead of asking the
1148 kernel to wake up MPlayer at the correct time.
1149 Useful if your kernel timing is imprecise and you cannot use the RTC either.
1150 Comes at the price of higher CPU consumption.
1154 Skip <sec> seconds after every frame.
1155 The normal framerate of the movie is kept, so playback is accelerated.
1156 Since MPlayer can only seek to the next keyframe this may be inexact.
1160 .SH "DEMUXER/STREAM OPTIONS"
1164 Select the Dynamic Range Compression level for AC-3 audio streams.
1165 <level> is a float value ranging from 0 to 1, where 0 means no compression
1166 and 1 (which is the default) means full compression (make loud passages more
1167 silent and vice versa).
1168 Values up to 2 are also accepted, but are purely experimental.
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 <Bytes> (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.
1241 .B \-bluray\-angle <angle ID> (Blu\-ray only)
1242 Some Blu\-ray discs contain scenes that can be viewed from multiple angles.
1243 Here you can tell MPlayer which angles to use (default: 1).
1246 .B \-bluray\-chapter <chapter ID> (Blu\-ray only)
1247 Tells MPlayer which Blu\-ray chapter to start the current title from (default: 1).
1250 .B \-bluray\-device <path to disc> (Blu\-ray only)
1251 Specify the Blu\-ray disc location. Must be a directory with Blu\-ray structure.
1255 This option specifies how much memory (in kBytes) to use when precaching a
1257 Especially useful on slow media.
1264 .B \-cache\-min <percentage>
1265 Playback will start when the cache has been filled up to <percentage>
1269 .B \-cache\-seek\-min <percentage>
1270 If a seek is to be made to a position within <percentage> of the cache size
1271 from the current position, MPlayer will wait for the cache to be filled to
1272 this position rather than performing a stream seek (default: 50).
1275 .B \-capture (MPlayer only)
1276 Allows capturing the primary stream (not additional audio tracks or other
1277 kind of streams) into the file specified by \-dumpfile or \"stream.dump\"
1279 If this option is given, capturing can be started and stopped by pressing
1280 the key bound to this function (see section INTERACTIVE CONTROL).
1281 Same as for \-dumpstream, this will likely not produce usable results for
1282 anything else than MPEG streams.
1283 Note that, due to cache latencies, captured data may begin and end
1284 somewhat delayed compared to what you see displayed.
1287 .B \-cdda <option1:option2> (CDDA only)
1288 This option can be used to tune the CD Audio reading feature of MPlayer.
1290 Available options are:
1294 .IPs paranoia=<0\-2>
1296 Values other than 0 seem to break playback of anything but the first track.
1298 0: disable checking (default)
1300 1: overlap checking only
1302 2: full data correction and verification
1304 .IPs generic-dev=<value>
1305 Use specified generic SCSI device.
1306 .IPs sector-size=<value>
1307 Set atomic read size.
1308 .IPs overlap=<value>
1309 Force minimum overlap search during verification to <value> sectors.
1311 Assume that the beginning offset of track 1 as reported in the TOC will be
1313 Some Toshiba drives need this for getting track boundaries correct.
1314 .IPs toc-offset=<value>
1315 Add <value> sectors to the values reported when addressing tracks.
1318 (Never) accept imperfect data reconstruction.
1322 .B \-cdrom\-device <path to device>
1323 Specify the CD-ROM device (default: /dev/\:cdrom).
1326 .B \-channels <number> (also see \-af channels)
1327 Request the number of playback channels (default: 2).
1328 MPlayer asks the decoder to decode the audio into as many channels as
1330 Then it is up to the decoder to fulfill the requirement.
1331 This is usually only important when playing videos with AC-3 audio (like DVDs).
1332 In that case liba52 does the decoding by default and correctly downmixes the
1333 audio into the requested number of channels.
1334 To directly control the number of output channels independently of how many
1335 channels are decoded, use the channels filter.
1338 This option is honored by codecs (AC-3 only), filters (surround) and audio
1339 output drivers (OSS at least).
1341 Available options are:
1357 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1358 Specify which chapter to start playing at.
1359 Optionally specify which chapter to end playing at (default: 1).
1362 .B \-edition <edition ID> (Matroska, MPlayer only)
1363 Specify the edition (set of chapters) to use, where 0 is the first. If set to
1364 -1 (the default), MPlayer will choose the first edition declared as a default,
1365 or if there is no default, the first edition defined.
1368 .B \-cookies (network only)
1369 Send cookies when making HTTP requests.
1372 .B \-cookies\-file <filename> (network only)
1373 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1374 and skip reading from default locations.
1375 The file is assumed to be in Netscape format.
1379 audio delay in seconds (positive or negative float value)
1381 Negative values delay the audio, and positive values delay the video.
1382 Note that this is the exact opposite of the \-audio\-delay MEncoder option.
1385 When used with MEncoder, this is not guaranteed to work correctly
1386 with \-ovc copy; use \-audio\-delay instead.
1390 Ignore the specified starting time for streams in AVI files.
1391 In MPlayer, this nullifies stream delays in files encoded with
1392 the \-audio\-delay option.
1393 During encoding, this option prevents MEncoder from transferring
1394 original stream start times to the new file; the \-audio\-delay option is
1396 Note that MEncoder sometimes adjusts stream starting times
1397 automatically to compensate for anticipated decoding delays, so do not
1398 use this option for encoding without testing it first.
1401 .B \-demuxer <[+]name>
1403 Use a '+' before the name to force it, this will skip some checks!
1404 Give the demuxer name as printed by \-demuxer help.
1405 For backward compatibility it also accepts the demuxer ID as defined in
1406 libmpdemux/\:demuxer.h.
1409 .B \-dumpaudio (MPlayer only)
1410 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
1411 in most other cases the resulting file will not be playable).
1412 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1413 on the command line only the last one will work.
1416 .B \-dumpfile <filename> (MPlayer only)
1417 Specify which file MPlayer should dump to.
1418 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream /
1422 .B \-dumpstream (MPlayer only)
1423 Dumps the raw stream to ./stream.dump.
1424 Useful when ripping from DVD or network.
1425 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1426 on the command line only the last one will work.
1429 .B \-dumpvideo (MPlayer only)
1430 Dump raw compressed video stream to ./stream.dump (not very usable).
1431 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1432 on the command line only the last one will work.
1435 .B \-dvbin <options> (DVB only)
1436 Pass the following parameters to the DVB input module, in order to override
1442 Specifies using card number 1\-4 (default: 1).
1443 .IPs file=<filename>
1444 Instructs MPlayer to read the channels list from <filename>.
1445 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1446 or ~/.mplayer/\:channels.conf as a last resort.
1447 .IPs timeout=<1\-30>
1448 Maximum number of seconds to wait when trying to tune a
1449 frequency before giving up (default: 30).
1454 .B \-dvd\-device <path to device> (DVD only)
1455 Specify the DVD device or .iso filename (default: /dev/\:dvd).
1456 You can also specify a directory that contains files previously copied directly
1457 from a DVD (with e.g.\& vobcopy).
1460 .B \-dvd\-speed <factor or speed in KB/s> (DVD only)
1461 Try to limit DVD speed (default: 0, no change).
1462 DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
1464 Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
1465 quiet and fast enough.
1466 MPlayer resets the speed to the drive default value on close.
1467 Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
1471 You need write access to the DVD device to change the speed.
1474 .B \-dvdangle <angle ID> (DVD only)
1475 Some DVD discs contain scenes that can be viewed from multiple angles.
1476 Here you can tell MPlayer which angles to use (default: 1).
1480 Enables edit decision list (EDL) actions during playback.
1481 Video will be skipped over and audio will be muted and unmuted according to
1482 the entries in the given file.
1483 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1487 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1488 Stop at given time or byte position.
1491 Byte position is enabled only for MEncoder and will not be accurate, as it can
1492 only stop at a frame boundary.
1493 When used in conjunction with \-ss option, \-endpos time will shift forward by
1494 seconds specified with \-ss.
1501 .IPs "\-endpos 01:10:00"
1502 Stop at 1 hour 10 minutes.
1503 .IPs "\-ss 10 \-endpos 56"
1504 Stop at 1 minute 6 seconds.
1505 .IPs "\-endpos 100mb"
1512 Force index rebuilding.
1513 Useful for files with broken index (A/V desync, etc).
1514 This will enable seeking in files where seeking was not possible.
1515 You can fix the index permanently with MEncoder (see the documentation).
1518 This option only works if the underlying media supports seeking
1519 (i.e.\& not with stdin, pipe, etc).
1522 .B \-fps <float value>
1523 Override video framerate.
1524 Useful if the original value is wrong or missing.
1527 .B \-frames <number>
1528 Play/\:convert only first <number> frames, then quit.
1531 .B \-hr\-mp3\-seek (MP3 only)
1533 Enabled when playing from an external MP3 file, as we need to seek
1534 to the very exact position to keep A/V sync.
1535 Can be slow especially when seeking backwards since it has to rewind
1536 to the beginning to find an exact frame position.
1539 .B \-idx (also see \-forceidx)
1540 Rebuilds index of files if no index was found, allowing seeking.
1541 Useful with broken/\:incomplete downloads, or badly created files.
1544 This option only works if the underlying media supports seeking
1545 (i.e.\& not with stdin, pipe, etc).
1549 Skip rebuilding index file.
1550 MEncoder skips writing the index with this option.
1553 .B \-ipv4\-only\-proxy (network only)
1554 Skip the proxy for IPv6 addresses.
1555 It will still be used for IPv4 connections.
1558 .B \-loadidx <index file>
1559 The file from which to read the video index data saved by \-saveidx.
1560 This index will be used for seeking, overriding any index data
1561 contained in the AVI itself.
1562 MPlayer will not prevent you from loading an index file generated
1563 from a different AVI, but this is sure to cause unfavorable results.
1566 This option is obsolete now that MPlayer has OpenDML support.
1569 .B \-mc <seconds/frame>
1570 maximum A-V sync correction per frame (in seconds)
1572 \-mc 0 should always be combined with \-noskip for mencoder, otherwise
1573 it will almost certainly cause A-V desync.
1576 .B \-mf <option1:option2:...>
1577 Used when decoding from multiple PNG or JPEG files.
1579 Available options are:
1584 input file width (default: autodetect)
1586 input file height (default: autodetect)
1588 output fps (default: 25)
1590 input file type (available: jpeg, png, tga, sgi)
1596 Force usage of non-interleaved AVI parser (fixes playback
1597 of some bad AVI files).
1600 .B \-nobps (AVI only)
1601 Do not use average byte/\:second value for A-V sync.
1602 Helps with some AVI files with broken header.
1606 Disables extension-based demuxer selection.
1607 By default, when the file type (demuxer) cannot be detected reliably
1608 (the file has no header or it is not reliable enough), the filename
1609 extension is used to select the demuxer.
1610 Always falls back on content-based demuxer selection.
1613 .B \-passwd <password> (also see \-user) (network only)
1614 Specify password for HTTP authentication.
1617 .B \-prefer\-ipv4 (network only)
1618 Use IPv4 on network connections.
1619 Falls back on IPv6 automatically.
1622 .B \-prefer\-ipv6 (IPv6 network only)
1623 Use IPv6 on network connections.
1624 Falls back on IPv4 automatically.
1627 .B \-psprobe <byte position>
1628 When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
1629 how many bytes in the stream you want MPlayer to scan in order to identify
1630 the video codec used.
1631 This option is needed to play EVO or VDR files containing H.264 streams.
1634 .B \-pvr <option1:option2:...> (PVR only)
1635 This option tunes various encoding properties of the PVR capture module.
1636 It has to be used with any hardware MPEG encoder based card supported by the
1638 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1639 cards are known as PVR capture cards.
1640 Be aware that only Linux 2.6.18 kernel
1641 and above is able to handle MPEG stream through V4L2 layer.
1642 For hardware capture of an MPEG stream and watching it with
1643 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1645 Available options are:
1648 Specify input aspect ratio:
1658 .IPs arate=<32000\-48000>
1659 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1662 Specify MPEG audio layer encoding (default: 2).
1663 .IPs abitrate=<32\-448>
1664 Specify audio encoding bitrate in kbps (default: 384).
1666 Specify audio encoding mode.
1667 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1668 .IPs vbitrate=<value>
1669 Specify average video bitrate encoding in Mbps (default: 6).
1671 Specify video encoding mode:
1673 vbr: Variable BitRate (default)
1675 cbr: Constant BitRate
1678 Specify peak video bitrate encoding in Mbps
1679 (only useful for VBR encoding, default: 9.6).
1681 Choose an MPEG format for encoding:
1683 ps: MPEG-2 Program Stream (default)
1685 ts: MPEG-2 Transport Stream
1687 mpeg1: MPEG-1 System Stream
1689 vcd: Video CD compatible stream
1691 svcd: Super Video CD compatible stream
1693 dvd: DVD compatible stream
1699 .B \-radio <option1:option2:...> (radio only)
1700 These options set various parameters of the radio capture module.
1701 For listening to radio with MPlayer use 'radio://<frequency>'
1702 (if channels option is not given) or 'radio://<channel_number>'
1703 (if channels option is given) as a movie URL.
1704 You can see allowed frequency range by running MPlayer with '\-v'.
1705 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1706 If the capture keyword is not given you can listen to radio
1707 using the line-in cable only.
1708 Using capture to listen is not recommended due to synchronization
1709 problems, which makes this process uncomfortable.
1711 Available options are:
1714 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1716 Radio driver to use (default: v4l2 if available, otherwise v4l).
1717 Currently, v4l and v4l2 drivers are supported.
1718 .IPs volume=<0..100>
1719 sound volume for radio device (default 100)
1720 .IPs "freq_min=<value> (*BSD BT848 only)"
1721 minimum allowed frequency (default: 87.50)
1722 .IPs "freq_max=<value> (*BSD BT848 only)"
1723 maximum allowed frequency (default: 108.00)
1724 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1726 Use _ for spaces in names (or play with quoting ;-).
1727 The channel names will then be written using OSD and the slave commands
1728 radio_step_channel and radio_set_channel will be usable for
1729 a remote control (see LIRC).
1730 If given, number in movie URL will be treated as channel position in
1734 radio://1, radio://104.4, radio_set_channel 1
1735 .IPs "adevice=<value> (radio capture only)"
1736 Name of device to capture sound from.
1737 Without such a name capture will be disabled,
1738 even if the capture keyword appears in the URL.
1739 For ALSA devices use it in the form hw=<card>.<device>.
1740 If the device name contains a '=', the module will use
1741 ALSA to capture, otherwise OSS.
1742 .IPs "arate=<value> (radio capture only)"
1743 Rate in samples per second (default: 44100).
1746 When using audio capture set also \-rawaudio rate=<value> option
1747 with the same value as arate.
1748 If you have problems with sound speed (runs too quickly), try to play
1749 with different rate values (e.g.\& 48000,44100,32000,...).
1750 .IPs "achannels=<value> (radio capture only)"
1751 Number of audio channels to capture.
1755 .B \-rawaudio <option1:option2:...>
1756 This option lets you play raw audio files.
1757 You have to use \-demuxer rawaudio as well.
1758 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1759 For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1761 Available options are:
1765 .IPs channels=<value>
1768 rate in samples per second
1769 .IPs samplesize=<value>
1770 sample size in bytes
1771 .IPs bitrate=<value>
1772 bitrate for rawaudio files
1779 .B \-rawvideo <option1:option2:...>
1780 This option lets you play raw video files.
1781 You have to use \-demuxer rawvideo as well.
1783 Available options are:
1788 rate in frames per second (default: 25.0)
1789 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1790 set standard image size
1792 image width in pixels
1794 image height in pixels
1795 .IPs i420|yv12|yuy2|y8
1798 colorspace (fourcc) in hex or string constant.
1799 Use \-rawvideo format=help for a list of possible strings.
1809 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1810 Play the famous "foreman" sample video.
1811 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1812 Play a raw YUV sample.
1817 .B \-referrer <string> (network only)
1818 Specify a referrer path or URL for HTTP requests.
1822 Used with 'rtsp://' URLs to force the client's port number.
1823 This option may be useful if you are behind a router and want to forward
1824 the RTSP stream from the server to a specific client.
1827 .B \-rtsp\-destination
1828 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1829 This option may be useful with some RTSP server which do not
1830 send RTP packets to the right interface.
1831 If the connection to the RTSP server fails, use \-v to see
1832 which IP address MPlayer tries to bind to and try to force
1833 it to one assigned to your computer instead.
1836 .B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
1837 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1838 packets be streamed over TCP (using the same TCP connection as RTSP).
1839 This option may be useful if you have a broken internet connection that does
1840 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1843 .B \-rtsp\-stream\-over\-http (LIVE555 only)
1844 Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP
1845 packets be streamed over HTTP.
1848 .B \-saveidx <filename>
1849 Force index rebuilding and dump the index to <filename>.
1850 Currently this only works with AVI files.
1853 This option is obsolete now that MPlayer has OpenDML support.
1856 .B \-sb <byte position> (also see \-ss)
1857 Seek to byte position.
1858 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1861 .B \-speed <0.01\-100>
1862 Slow down or speed up playback by the factor given as parameter.
1863 Not guaranteed to work correctly with \-oac copy.
1867 Select the output sample rate to be used
1868 (of course sound cards have limits on this).
1869 If the sample frequency selected is different from that
1870 of the current media, the resample or lavcresample audio filter will be inserted
1871 into the audio filter layer to compensate for the difference.
1872 The type of resampling can be controlled by the \-af\-adv option.
1873 The default is fast resampling that may cause distortion.
1876 .B \-ss <time> (also see \-sb)
1877 Seek to given time position.
1883 Seeks to 56 seconds.
1884 .IPs "\-ss 01:10:00"
1885 Seeks to 1 hour 10 min.
1891 Tells MPlayer not to discard TS packets reported as broken in the stream.
1892 Sometimes needed to play corrupted MPEG-TS files.
1895 .B \-tsprobe <byte position>
1896 When playing an MPEG-TS stream, this option lets you specify how many
1897 bytes in the stream you want MPlayer to search for the desired
1898 audio and video IDs.
1901 .B \-tsprog <1\-65534>
1902 When playing an MPEG-TS stream, you can specify with this option which
1903 program (if present) you want to play.
1904 Can be used with \-vid and \-aid.
1907 .B \-tv <option1:option2:...> (TV/\:PVR only)
1908 This option tunes various properties of the TV capture module.
1909 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
1910 or even 'tv://<channel_name> (see option channels for channel_name below)
1912 You can also use 'tv:///<input_id>' to start watching a
1913 movie from a composite or S-Video input (see option input for details).
1915 Available options are:
1919 .IPs "automute=<0\-255> (v4l and v4l2 only)"
1920 If signal strength reported by device is less than this value,
1921 audio and video will be muted.
1922 In most cases automute=100 will be enough.
1923 Default is 0 (automute disabled).
1925 See \-tv driver=help for a list of compiled-in TV input drivers.
1926 available: dummy, v4l, v4l2, bsdbt848 (default: autodetect)
1928 Specify TV device (default: /dev/\:video0).
1930 For the bsdbt848 driver you can provide both bktr and tuner device
1931 names separating them with a comma, tuner after
1932 bktr (e.g.\& -tv device=/dev/bktr1,/dev/tuner1).
1934 Specify input (default: 0 (TV), see console output for available inputs).
1936 Specify the frequency to set the tuner to (e.g.\& 511.250).
1937 Not compatible with the channels parameter.
1939 Specify the output format of the tuner with a preset value supported by the
1940 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1941 arbitrary format given as hex value.
1942 Try outfmt=help for a list of all available formats.
1946 output window height
1948 framerate at which to capture video (frames per second)
1949 .IPs buffersize=<value>
1950 maximum size of the capture buffer in megabytes (default: dynamical)
1952 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
1953 For v4l2, see the console output for a list of all available norms,
1954 also see the normid option below.
1955 .IPs "normid=<value> (v4l2 only)"
1956 Sets the TV norm to the given numeric ID.
1957 The TV norm depends on the capture card.
1958 See the console output for a list of available TV norms.
1959 .IPs channel=<value>
1960 Set tuner to <value> channel.
1961 .IPs chanlist=<value>
1962 available: argentina, australia, china-bcast, europe-east, europe-west, france,
1963 ireland, italy, japan-bcast, japan-cable, newzealand, russia, southafrica,
1964 us-bcast, us-cable, us-cable-hrc
1965 .IPs channels=<chan>\-<name>[=<norm>],<chan>\-<name>[=<norm>],...
1966 Set names for channels.
1968 If <chan> is an integer greater than 1000, it will be treated as frequency (in kHz)
1969 rather than channel name from frequency table.
1971 Use _ for spaces in names (or play with quoting ;-).
1972 The channel names will then be written using OSD, and the slave commands
1973 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
1974 a remote control (see LIRC).
1975 Not compatible with the frequency parameter.
1978 The channel number will then be the position in the 'channels' list,
1982 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
1983 .IPs [brightness|contrast|hue|saturation]=<\-100\-100>
1984 Set the image equalizer on the card.
1985 .IPs audiorate=<value>
1986 Set audio capture bitrate.
1988 Capture audio even if there are no audio sources reported by v4l.
1992 Choose an audio mode:
2002 .IPs forcechan=<1\-2>
2003 By default, the count of recorded audio channels is determined automatically
2004 by querying the audio mode from the TV card.
2005 This option allows forcing stereo/\:mono recording regardless of the amode
2006 option and the values returned by v4l.
2007 This can be used for troubleshooting when the TV card is unable to report the
2009 .IPs adevice=<value>
2010 Set an audio device.
2011 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
2012 You must replace any ':' by a '.' in the hardware ID for ALSA.
2013 .IPs audioid=<value>
2014 Choose an audio output of the capture card, if it has more than one.
2015 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
2016 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
2017 These options set parameters of the mixer on the video capture card.
2018 They will have no effect, if your card does not have one.
2019 For v4l2 50 maps to the default value of the
2020 control, as reported by the driver.
2021 .IPs "gain=<0\-100> (v4l2)"
2022 Set gain control for video devices (usually webcams) to the desired
2023 value and switch off automatic control.
2024 A value of 0 enables automatic control.
2025 If this option is omitted, gain control will not be modified.
2026 .IPs immediatemode=<bool>
2027 A value of 0 means capture and buffer audio and video together
2028 (default for MEncoder).
2029 A value of 1 (default for MPlayer) means to do video capture only and let the
2030 audio go through a loopback cable from the TV card to the sound card.
2032 Use hardware MJPEG compression (if the card supports it).
2033 When using this option, you do not need to specify the width and height
2034 of the output window, because MPlayer will determine it automatically
2035 from the decimation value (see below).
2036 .IPs decimation=<1|2|4>
2037 choose the size of the picture that will be compressed by hardware
2052 .IPs quality=<0\-100>
2053 Choose the quality of the JPEG compression
2054 (< 60 recommended for full size).
2055 .IPs tdevice=<value>
2056 Specify TV teletext device (example: /dev/\:vbi0) (default: none).
2057 .IPs tformat=<format>
2058 Specify TV teletext display format (default: 0):
2064 2: opaque with inverted colors
2066 3: transparent with inverted colors
2068 .IPs tpage=<100\-899>
2069 Specify initial TV teletext page number (default: 100).
2070 .IPs tlang=<\-1\-127>
2071 Specify default teletext language code (default: 0), which will be used
2072 as primary language until a type 28 packet is received.
2073 Useful when the teletext system uses a non-latin character set, but language
2074 codes are not transmitted via teletext type 28 packets for some reason.
2075 To see a list of supported language codes set this option to \-1.
2076 .IPs "hidden_video_renderer (dshow only)"
2077 Terminate stream with video renderer instead of Null renderer (default: off).
2078 Will help if video freezes but audio does not.
2080 May not work with \-vo directx and \-vf crop combination.
2081 .IPs "hidden_vp_renderer (dshow only)"
2082 Terminate VideoPort pin stream with video renderer
2083 instead of removing it from the graph (default: off).
2084 Useful if your card has a VideoPort pin and video is choppy.
2086 May not work with \-vo directx and \-vf crop combination.
2087 .IPs "system_clock (dshow only)"
2088 Use the system clock as sync source instead of the default graph clock
2089 (usually the clock from one of the live sources in graph).
2090 .IPs "normalize_audio_chunks (dshow only)"
2091 Create audio chunks with a time length equal to
2092 video frame time length (default: off).
2093 Some audio cards create audio chunks about 0.5s in size, resulting in
2094 choppy video when using immediatemode=0.
2098 .B \-tvscan <option1:option2:...> (TV and MPlayer only)
2099 Tune the TV channel scanner.
2100 MPlayer will also print value for "-tv channels=" option,
2101 including existing and just found channels.
2103 Available suboptions are:
2106 Begin channel scanning immediately after startup (default: disabled).
2107 .IPs period=<0.1\-2.0>
2108 Specify delay in seconds before switching to next channel (default: 0.5).
2109 Lower values will cause faster scanning, but can detect
2110 inactive TV channels as active.
2111 .IPs threshold=<1\-100>
2112 Threshold value for the signal strength (in percent), as reported
2113 by the device (default: 50).
2114 A signal strength higher than this value will indicate that the
2115 currently scanning channel is active.
2119 .B \-user <username> (also see \-passwd) (network only)
2120 Specify username for HTTP authentication.
2123 .B \-user\-agent <string>
2124 Use <string> as user agent for HTTP streaming.
2128 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
2129 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
2130 (if present) with the chosen video stream.
2133 .B \-vivo <suboption> (DEBUG CODE)
2134 Force audio parameters for the VIVO demuxer (for debugging purposes).
2135 FIXME: Document this.
2139 .SH "OSD/SUBTITLE OPTIONS"
2141 Also see \-vf expand.
2144 .B \-ass (FreeType only)
2145 Turn on SSA/ASS subtitle rendering.
2146 With this option, libass will be used for SSA/ASS
2147 external subtitles and Matroska tracks.
2150 Unlike normal OSD, libass uses fontconfig by default. To disable it, use
2154 .B \-ass\-border\-color <value>
2155 Sets the border (outline) color for text subtitles.
2156 The color format is RRGGBBAA.
2159 .B \-ass\-bottom\-margin <value>
2160 Adds a black band at the bottom of the frame.
2161 The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
2164 .B \-ass\-color <value>
2165 Sets the color for text subtitles.
2166 The color format is RRGGBBAA.
2169 .B \-ass\-font\-scale <value>
2170 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
2173 .B \-ass\-force\-style <[Style.]Param=Value[,...]>
2174 Override some style or script info parameters.
2179 \-ass\-force\-style FontName=Arial,Default.Bold=1
2181 \-ass\-force\-style PlayResY=768
2186 .B \-ass\-hinting <type>
2194 FreeType autohinter, light mode
2196 FreeType autohinter, normal mode
2200 The same, but hinting will only be performed if the OSD is rendered at
2201 screen resolution and will therefore not be scaled.
2204 The default value is 5 (use light hinter for unscaled OSD and no hinting otherwise).
2209 .B \-ass\-line\-spacing <value>
2210 Set line spacing value for SSA/ASS renderer.
2213 .B \-ass\-styles <filename>
2214 Load all SSA/ASS styles found in the specified file and use them for
2215 rendering text subtitles.
2216 The syntax of the file is exactly like the
2217 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
2220 .B \-ass\-top\-margin <value>
2221 Adds a black band at the top of the frame.
2222 The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
2225 .B \-ass\-use\-margins
2226 Enables placing toptitles and subtitles in black borders when they
2230 .B \-dumpjacosub (MPlayer only)
2231 Convert the given subtitle (specified with the \-sub option) to the time-based
2232 JACOsub subtitle format.
2233 Creates a dumpsub.js file in the current directory.
2236 .B \-dumpmicrodvdsub (MPlayer only)
2237 Convert the given subtitle (specified with the \-sub option) to the
2238 MicroDVD subtitle format.
2239 Creates a dumpsub.sub file in the current directory.
2242 .B \-dumpmpsub (MPlayer only)
2243 Convert the given subtitle (specified with the \-sub option) to MPlayer's
2244 subtitle format, MPsub.
2245 Creates a dump.mpsub file in the current directory.
2248 .B \-dumpsami (MPlayer only)
2249 Convert the given subtitle (specified with the \-sub option) to the time-based
2250 SAMI subtitle format.
2251 Creates a dumpsub.smi file in the current directory.
2254 .B \-dumpsrtsub (MPlayer only)
2255 Convert the given subtitle (specified with the \-sub option) to the time-based
2256 SubViewer (SRT) subtitle format.
2257 Creates a dumpsub.srt file in the current directory.
2260 Some broken hardware players choke on SRT subtitle files with Unix
2262 If you are unlucky enough to have such a box, pass your subtitle
2263 files through unix2dos or a similar program to replace Unix line
2264 endings with DOS/Windows line endings.
2267 .B \-dumpsub (MPlayer only) (BETA CODE)
2268 Dumps the subtitle substream from VOB streams.
2269 Also see the \-dump*sub and \-vobsubout* options.
2272 .B \-noembeddedfonts
2273 Disables use of fonts embedded in Matroska containers and ASS scripts (default: enabled).
2274 These fonts can be used for SSA/ASS subtitle
2275 rendering (\-ass option).
2278 .B \-ffactor <number>
2279 Resample the font alphamap.
2286 very narrow black outline (default)
2288 narrow black outline
2295 .B \-flip\-hebrew (FriBiDi only)
2296 Turns on flipping subtitles using FriBiDi.
2299 .B \-noflip\-hebrew\-commas
2300 Change FriBiDi's assumptions about the placements of commas in subtitles.
2301 Use this if commas in subtitles are shown at the start of a sentence
2302 instead of at the end.
2305 .B \-font <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
2306 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
2307 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
2308 ~/.mplayer/\:subfont.ttf).
2311 With FreeType, this option determines the path to the text font file.
2312 With Fontconfig, this option determines the Fontconfig font pattern.
2317 \-font ~/\:.mplayer/\:arial-14/\:font.desc
2319 \-font ~/\:.mplayer/\:arialuni.ttf
2321 \-font 'Bitstream Vera Sans'
2323 \-font 'Bitstream Vera Sans:style=Bold'
2328 .B \-fontconfig (fontconfig only)
2329 Enables the usage of fontconfig managed fonts.
2332 By default fontconfig is used for libass-rendered subtitles and not used for
2333 OSD. With \-fontconfig it is used for both libass and OSD, with \-nofontconfig
2334 it is not used at all.
2338 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
2342 .B \-fribidi\-charset <charset name> (FriBiDi only)
2343 Specifies the character set that will be passed to FriBiDi when
2344 decoding non-UTF-8 subtitles (default: ISO8859-8).
2347 .B \-ifo <VOBsub IFO file>
2348 Indicate the file that will be used to load palette and frame size for VOBsub
2353 Turns off automatic subtitle file loading.
2356 .B \-osd\-duration <time>
2357 Set the duration of the OSD messages in ms (default: 1000).
2360 .B \-osdlevel <0\-3> (MPlayer only)
2361 Specifies which mode the OSD should start in.
2367 volume + seek (default)
2369 volume + seek + timer + percentage
2371 volume + seek + timer + percentage + total time
2377 Allows the next subtitle to be displayed while the current one is
2378 still visible (default is to enable the support only for specific
2382 .B \-sid <ID> (also see \-slang, \-vobsubid)
2383 Display the subtitle stream specified by <ID> (0\-31).
2384 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2385 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2389 Disables any otherwise auto-selected internal subtitles (as e.g.\& the Matroska/mkv
2391 Use \-noautosub to disable the loading of external subtitle files.
2394 .B \-slang <language code[,language code,...]> (also see \-sid)
2395 Specify a priority list of subtitle languages to use.
2396 Different container formats employ different language codes.
2397 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2398 three letter language codes while OGM uses a free-form identifier.
2399 MPlayer prints the available languages when run in verbose (\-v) mode.
2404 .IPs "mplayer dvd://1 \-slang hu,en"
2405 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2406 Hungarian is not available.
2407 .IPs "mplayer \-slang jpn example.mkv"
2408 Plays a Matroska file with Japanese subtitles.
2414 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2415 A value of 16 may be added to <mode> in order to force scaling even
2416 when original and scaled frame size already match.
2417 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2418 Available modes are:
2422 none (fastest, very ugly)
2424 approximate (broken?)
2428 bilinear (default, fast and not too bad)
2430 uses swscaler gaussian blur (looks very good)
2435 .B \-spualign <\-1\-2>
2436 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2442 Align at top (original behavior, default).
2451 .B \-spugauss <0.0\-3.0>
2452 Variance parameter of gaussian used by \-spuaa 4.
2453 Higher means more blur (default: 1.0).
2456 .B \-sub <subtitlefile1,subtitlefile2,...>
2457 Use/\:display these subtitle files.
2458 Only one file can be displayed at the same time.
2461 .B \-sub\-bg\-alpha <0\-255>
2462 Specify the alpha channel value for subtitles and OSD backgrounds.
2463 Big values mean more transparency.
2464 0 means completely transparent.
2467 .B \-sub\-bg\-color <0\-255>
2468 Specify the color value for subtitles and OSD backgrounds.
2469 Currently subtitles are grayscale so this value is equivalent to the
2470 intensity of the color.
2471 255 means white and 0 black.
2474 .B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
2475 Force subtitle demuxer type for \-subfile.
2476 Use a '+' before the name to force it, this will skip some checks!
2477 Give the demuxer name as printed by \-sub\-demuxer help.
2478 For backward compatibility it also accepts the demuxer ID as defined in
2482 .B \-sub\-fuzziness <mode>
2483 Adjust matching fuzziness when searching for subtitles:
2489 Load all subs containing movie name.
2491 Load all subs in the current directory.
2496 .B \-sub\-no\-text\-pp
2497 Disables any kind of text post processing done after loading the subtitles.
2498 Used for debug purposes.
2501 .B \-subalign <0\-2>
2502 Specify which edge of the subtitles should be aligned at the height
2507 Align subtitle top edge (original behavior).
2509 Align subtitle center.
2511 Align subtitle bottom edge (default).
2516 .B "\-subcc <1\-4>\ "
2517 Display DVD Closed Caption (CC) subtitles from the specified channel.
2520 the VOB subtitles, these are special ASCII subtitles for the
2521 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2522 CC subtitles have not been spotted on DVDs from other regions so far.
2525 .B \-subcp <codepage> (iconv only)
2526 If your system supports iconv(3), you can use this option to
2527 specify the subtitle codepage.
2539 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2540 You can specify your language using a two letter language code to
2541 make ENCA detect the codepage automatically.
2542 If unsure, enter anything and watch mplayer \-v output for available
2544 Fallback codepage specifies the codepage to use, when autodetection fails.
2549 .IPs "\-subcp enca:cs:latin2"
2550 Guess the encoding, assuming the subtitles are Czech, fall back on
2551 latin 2, if the detection fails.
2552 .IPs "\-subcp enca:pl:cp1250"
2553 Guess the encoding for Polish, fall back on cp1250.
2559 Delays subtitles by <sec> seconds.
2563 .B \-subfile <filename> (BETA CODE)
2565 Same as \-audiofile, but for subtitle streams (OggDS?).
2568 .B \-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
2569 Sets the subtitle font (see \-font).
2570 If no \-subfont is given, \-font is used.
2573 .B \-subfont\-autoscale <0\-3> (FreeType only)
2574 Sets the autoscale mode.
2577 0 means that text scale and OSD scale are font heights in points.
2586 proportional to movie height
2588 proportional to movie width
2590 proportional to movie diagonal (default)
2595 .B \-subfont\-blur <0\-8> (FreeType only)
2596 Sets the font blur radius (default: 2).
2599 .B \-subfont\-encoding <value> (FreeType only)
2600 Sets the font encoding.
2601 When set to 'unicode', all the glyphs from the font file will be rendered and
2602 unicode will be used (default: unicode).
2605 .B \-subfont\-osd\-scale <0\-100> (FreeType only)
2606 Sets the autoscale coefficient of the OSD elements (default: 6).
2609 .B \-subfont\-outline <0\-8> (FreeType only)
2610 Sets the font outline thickness (default: 2).
2613 .B \-subfont\-text\-scale <0\-100> (FreeType only)
2614 Sets the subtitle text autoscale coefficient as percentage of the
2615 screen size (default: 5).
2619 Specify the framerate of the subtitle file (default: movie fps).
2622 <rate> > movie fps speeds the subtitles up for frame-based subtitle files and
2623 slows them down for time-based ones.
2626 .B \-subpos <0\-100> (useful with \-vf expand)
2627 Specify the position of subtitles on the screen.
2628 The value is the vertical position of the subtitle in % of the screen height.
2631 .B \-subwidth <10\-100>
2632 Specify the maximum width of subtitles on the screen.
2634 The value is the width of the subtitle in % of the screen width.
2638 Disable the display of OSD messages on the console when no video output is
2642 .B \-term\-osd\-esc <escape sequence>
2643 Specify the escape sequence to use before writing an OSD message on the
2645 The escape sequence should move the pointer to the beginning of the line
2646 used for the OSD and clear it (default: ^[[A\\r^[[K).
2650 Tells MPlayer to handle the subtitle file as unicode.
2653 .B \-unrarexec <path to unrar executable> (not supported on MingW)
2654 Specify the path to the unrar executable so MPlayer can use it to access
2655 rar-compressed VOBsub files (default: not set, so the feature is off).
2656 The path must include the executable's filename, i.e.\& /usr/local/bin/unrar.
2660 Tells MPlayer to handle the subtitle file as UTF-8.
2663 .B \-vobsub <VOBsub file without extension>
2664 Specify a VOBsub file to use for subtitles.
2665 Has to be the full pathname without extension, i.e.\& without
2666 the '.idx', '.ifo' or '.sub'.
2669 .B \-vobsubid <0\-31>
2670 Specify the VOBsub subtitle ID.
2674 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
2677 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2678 Override audio driver/\:card buffer size detection.
2681 .B \-format <format> (also see the format audio filter)
2682 Select the sample format used for output from the audio filter
2683 layer to the sound card.
2684 The values that <format> can adopt are listed below in the
2685 description of the format audio filter.
2689 Try to play consecutive audio files with no silence or disruption
2690 at the point of file change.
2691 This feature is implemented in a simple manner and relies on audio output
2692 device buffering to continue playback while moving from one file to another.
2693 If playback of the new file starts slowly, for example because it's played from
2694 a remote network location or because you have specified cache settings that
2695 require time for the initial cache fill, then the buffered audio may run out
2696 before playback of the new file can start.
2700 Use a mixer device different from the default /dev/\:mixer.
2701 For ALSA this is the mixer name.
2704 .B \-mixer\-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2705 This option will tell MPlayer to use a different channel for controlling
2706 volume than the default PCM.
2707 Options for OSS include
2709 For a complete list of options look for SOUND_DEVICE_NAMES in
2710 /usr/\:include/\:linux/\:soundcard.h.
2711 For ALSA you can use the names e.g.\& alsamixer displays, like
2712 .B Master, Line, PCM.
2715 ALSA mixer channel names followed by a number must be specified in the
2716 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2722 Force the use of the software mixer, instead of using the sound card
2726 .B \-softvol\-max <10.0\-10000.0>
2727 Set the maximum amplification level in percent (default: 110).
2728 A value of 200 will allow you to adjust the volume up to a maximum of
2729 double the current level.
2730 With values below 100 the initial volume (which is 100%) will be above
2731 the maximum, which e.g.\& the OSD cannot display correctly.
2734 .B \-volstep <0\-100>
2735 Set the step size of mixer volume changes in percent of the whole range
2739 .B \-volume <-1\-100> (also see \-af volume)
2740 Set the startup volume in the mixer, either hardware or software (if
2741 used with \-softvol).
2742 A value of -1 (the default) will not change the volume.
2746 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
2747 Audio output drivers are interfaces to different audio output facilities.
2751 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2752 Specify a priority list of audio output drivers to be used.
2754 If the list has a trailing ',' MPlayer will fall back on drivers not
2755 contained in the list.
2756 Suboptions are optional and can mostly be omitted.
2759 See \-ao help for a list of compiled-in audio output drivers.
2764 .IPs "\-ao alsa,oss,"
2765 Try the ALSA driver, then the OSS driver, then others.
2766 .IPs "\-ao alsa:noblock:device=hw=0.3"
2767 Sets noblock-mode and the device-name as first card, fourth device.
2771 Available audio output drivers are:
2775 ALSA 0.9/1.x audio output driver
2780 .IPs device=<device>
2781 Sets the device name.
2782 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2783 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2784 you really know how to set it correctly.
2790 ALSA 0.5 audio output driver
2794 OSS audio output driver
2798 Sets the audio output device (default: /dev/\:dsp).
2800 Sets the audio mixer device (default: /dev/\:mixer).
2801 .IPs <mixer-channel>
2802 Sets the audio mixer channel (default: pcm).
2808 highly platform independent SDL (Simple Directmedia Layer) library
2813 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2819 audio output through the aRts daemon
2823 audio output through the ESD daemon
2827 Explicitly choose the ESD server to use (default: localhost).
2833 audio output through JACK (Jack Audio Connection Kit)
2837 Connects to the ports with the given name (default: physical ports).
2838 .IPs name=<client name>
2839 Client name that is passed to JACK (default: MPlayer [<PID>]).
2840 Useful if you want to have certain connections established automatically.
2842 Estimate the audio delay, supposed to make the video playback smoother
2845 Automatically start jackd if necessary (default: disabled).
2846 Note that this seems unreliable and will spam stdout with server messages.
2852 audio output through NAS
2855 .B coreaudio (Mac OS X only)
2856 native Mac OS X audio output driver
2860 ID of output device to use (0 = default device)
2862 List all available output devices with their IDs.
2868 Experimental OpenAL audio output driver
2872 PulseAudio audio output driver
2875 .IPs "[<host>][:<output sink>]"
2876 Specify the host and optionally output sink to use.
2877 An empty <host> string uses a local connection, "localhost"
2878 uses network transfer (most likely not what you want).
2884 native SGI audio output driver
2887 .IPs "<output device name>"
2888 Explicitly choose the output device/\:interface to use
2889 (default: system-wide default).
2890 For example, 'Analog Out' or 'Digital Out'.
2896 native Sun audio output driver
2900 Explicitly choose the audio device to use (default: /dev/\:audio).
2905 .B win32 (Windows only)
2906 native Windows waveout audio output driver
2909 .B dsound (Windows only)
2910 DirectX DirectSound audio output driver
2913 .IPs device=<devicenum>
2914 Sets the device number to use.
2915 Playing a file with \-v will show a list of available devices.
2921 OS/2 KAI audio output driver
2929 Open audio in shareable or exclusive mode.
2931 Set buffer size to <size> in samples (default: 2048).
2937 OS/2 DART audio output driver
2941 Open DART in shareable or exclusive mode.
2943 Set buffer size to <size> in samples (default: 2048).
2948 .B dxr2 (also see \-dxr2) (DXR2 only)
2949 Creative DXR2 specific output driver
2953 IVTV specific MPEG audio output driver.
2954 Works with \-ac hwmpa only.
2957 .B v4l2 (requires Linux 2.6.22+ kernel)
2958 Audio output driver for V4L2 cards with hardware MPEG decoder.
2961 .B mpegpes (DVB only)
2962 Audio output driver for DVB cards that writes the output to an MPEG-PES
2963 file if no DVB card is installed.
2967 DVB card to use if more than one card is present.
2968 If not specified MPlayer will search the first usable card.
2969 .IPs file=<filename>
2976 Produces no audio output but maintains video playback speed.
2977 Use \-nosound for benchmarking.
2981 raw PCM/wave file writer audio output
2985 Include or do not include the wave header (default: included).
2986 When not included, raw PCM will be generated.
2987 .IPs file=<filename>
2988 Write the sound to <filename> instead of the default
2990 If nowaveheader is specified, the default is audiodump.pcm.
2992 Try to dump faster than realtime.
2993 Make sure the output does not get truncated (usually with
2994 "Too many video packets in buffer" message).
2995 It is normal that you get a "Your system is too SLOW to play this!" message.
3001 plugin audio output driver
3005 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
3008 .B \-adapter <value>
3009 Set the graphics card that will receive the image.
3010 You can get a list of available cards when you run this option with \-v.
3011 Currently only works with the directx video output driver.
3015 Override the autodetected color depth.
3016 Only supported by the fbdev, dga, svga, vesa video output drivers.
3020 Play movie with window border and decorations.
3021 Since this is on by default, use \-noborder to disable the standard window
3025 .B \-brightness <\-100\-100>
3026 Adjust the brightness of the video signal (default: 0).
3027 Not supported by all video output drivers.
3030 .B \-contrast <\-100\-100>
3031 Adjust the contrast of the video signal (default: 0).
3032 Not supported by all video output drivers.
3035 .B \-display <name> (X11 only)
3036 Specify the hostname and display number of the X server you want to display
3042 \-display xtest.localdomain:0
3048 Turns on direct rendering (not supported by all codecs and video outputs)
3051 May cause OSD/SUB corruption!
3054 .B \-dxr2 <option1:option2:...>
3055 This option is used to control the dxr2 video output driver.
3057 .IPs ar-mode=<value>
3058 aspect ratio mode (0 = normal, 1 = pan-and-scan, 2 = letterbox (default))
3060 Set iec958 output mode to encoded.
3062 Set iec958 output mode to decoded (default).
3063 .IPs macrovision=<value>
3064 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
3065 3 = agc 4 colorstripe)
3071 path to the microcode
3079 enable 7.5 IRE output mode
3081 disable 7.5 IRE output mode (default)
3085 color TV output (default)
3087 interlaced TV output (default)
3089 disable interlaced TV output
3091 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
3093 set pixel mode to square
3095 set pixel mode to ccir601
3102 .IPs cr-left=<0\-500>
3103 Set the left cropping value (default: 50).
3104 .IPs cr-right=<0\-500>
3105 Set the right cropping value (default: 300).
3106 .IPs cr-top=<0\-500>
3107 Set the top cropping value (default: 0).
3108 .IPs cr-bottom=<0\-500>
3109 Set the bottom cropping value (default: 0).
3110 .IPs ck-[r|g|b]=<0\-255>
3111 Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.
3112 .IPs ck-[r|g|b]min=<0\-255>
3113 minimum value for the respective color key
3114 .IPs ck-[r|g|b]max=<0\-255>
3115 maximum value for the respective color key
3117 Ignore cached overlay settings.
3119 Update cached overlay settings.
3121 Enable overlay onscreen display.
3123 Disable overlay onscreen display (default).
3124 .IPs ol[h|w|x|y]-cor=<\-20\-20>
3125 Adjust the overlay size (h,w) and position (x,y) in case it does not
3126 match the window perfectly (default: 0).
3128 Activate overlay (default).
3131 .IPs overlay-ratio=<1\-2500>
3132 Tune the overlay (default: 1000).
3136 .B \-fbmode <modename> (\-vo fbdev only)
3137 Change video mode to the one that is labeled as <modename> in
3141 VESA framebuffer does not support mode changing.
3144 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3145 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
3148 .B \-force\-window\-position
3149 Forcefully move MPlayer's video output window to default location whenever
3150 there is a change in video parameters, video stream or file.
3151 This used to be the default behavior.
3152 Currently only affects X11 VOs.
3155 .B \-fs (also see \-zoom)
3156 Fullscreen playback (centers movie, and paints black bands around it).
3157 Not supported by all video output drivers.
3160 .B \-fsmode\-dontuse <0\-31> (OBSOLETE, use the \-fs option)
3161 Try this option if you still experience fullscreen problems.
3164 .B \-fstype <type1,type2,...> (X11 only)
3165 Specify a priority list of fullscreen modes to be used.
3166 You can negate the modes by prefixing them with '\-'.
3167 If you experience problems like the fullscreen window being covered
3168 by other windows try using a different order.
3171 See \-fstype help for a full list of available modes.
3173 The available types are:
3178 Use the _NETWM_STATE_ABOVE hint if available.
3180 Use the _NETWM_STATE_BELOW hint if available.
3182 Use the _NETWM_STATE_FULLSCREEN hint if available.
3184 Use the _WIN_LAYER hint with the default layer.
3186 Use the _WIN_LAYER hint with the given layer number.
3190 Clear the list of modes; you can add modes to enable afterward.
3192 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
3200 .IPs layer,stays_on_top,above,fullscreen
3201 Default order, will be used as a fallback if incorrect or
3202 unsupported modes are specified.
3204 Fixes fullscreen switching on OpenBox 1.x.
3209 .B \-geometry x[%][:y[%]] or [WxH][+-x+-y]
3210 Adjust where the output is on the screen initially.
3211 The x and y specifications are in pixels measured from the top-left of the
3212 screen to the top-left of the image being displayed, however if a percentage
3213 sign is given after the argument it turns the value into a percentage of the
3214 screen size in that direction.
3215 It also supports the standard X11 \-geometry option format, in which e.g.
3216 +10-50 means "place 10 pixels from the left border and 50 pixels from the lower
3217 border" and "--20+-10" means "place 20 pixels beyond the right and 10 pixels
3218 beyond the top border".
3219 If an external window is specified using the \-wid option, then the x and
3220 y coordinates are relative to the top-left corner of the window rather
3222 The coordinates are relative to the screen given with \-xineramascreen for
3223 the video output drivers that fully support \-xineramascreen (direct3d, gl, gl2,
3224 vdpau, x11, xv, xvmc, corevideo).
3227 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
3228 gl, gl2, directx, fbdev, tdfxfb and corevideo video output drivers.
3234 Places the window at x=50, y=40.
3236 Places the window in the middle of the screen.
3238 Places the window at the middle of the right edge of the screen.
3240 Places the window at the bottom right corner of the screen.
3245 .B \-hue <\-100\-100>
3246 Adjust the hue of the video signal (default: 0).
3247 You can get a colored negative of the image with this option.
3248 Not supported by all video output drivers.
3251 .B \-monitor\-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
3252 Specify the dotclock or pixelclock range of the monitor.
3255 .B \-monitor\-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
3256 Specify the horizontal frequency range of the monitor.
3259 .B \-monitor\-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
3260 Specify the vertical frequency range of the monitor.
3263 .B \-monitoraspect <ratio> (also see \-aspect)
3264 Set the aspect ratio of your monitor or TV screen.
3265 A value of 0 disables a previous setting (e.g.\& in the config file).
3266 Overrides the \-monitorpixelaspect setting if enabled.
3271 \-monitoraspect 4:3 or 1.3333
3273 \-monitoraspect 16:9 or 1.7777
3278 .B \-monitorpixelaspect <ratio> (also see \-aspect)
3279 Set the aspect of a single pixel of your monitor or TV screen (default: 1).
3280 A value of 1 means square pixels
3281 (correct for (almost?) all LCDs).
3284 .B \-name (X11 only)
3285 Set the window class name.
3289 Disables double buffering, mostly for debugging purposes.
3290 Double buffering fixes flicker by storing two frames in memory, and
3291 displaying one while decoding another.
3292 It can affect OSD negatively, but often removes OSD flickering.
3296 Do not grab the mouse pointer after a video mode change (\-vm).
3297 Useful for multihead setups.
3301 Do not keep window aspect ratio when resizing windows.
3302 By default MPlayer tries to keep the correct video aspect ratio by
3303 instructing the window manager to maintain window aspect when resizing,
3304 and by adding black bars if the window manager nevertheless allows
3305 window shape to change.
3306 This option disables window manager aspect hints and scales the video
3307 to completely fill the window without regard for aspect ratio.
3311 Makes the player window stay on top of other windows.
3312 Supported by video output drivers which use X11, except SDL,
3313 as well as directx, corevideo, quartz, ggi and gl2.
3316 .B \-panscan <0.0\-1.0>
3317 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
3318 movie to make it fit a 4:3 display without black bands).
3319 The range controls how much of the image is cropped.
3320 Only works with the xv, xmga, mga, gl, gl2, quartz, corevideo and xvidix
3321 video output drivers.
3324 Values between \-1 and 0 are allowed as well, but highly experimental
3325 and may crash or worse.
3326 Use at your own risk!
3329 .B \-panscanrange <\-19.0\-99.0> (experimental)
3330 Change the range of the pan-and-scan functionality (default: 1).
3331 Positive values mean multiples of the default range.
3332 Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
3333 E.g.\& \-panscanrange \-3 allows a zoom factor of up to 4.
3334 This feature is experimental.
3335 Do not report bugs unless you are using \-vo gl.
3338 .B \-refreshrate <Hz>
3339 Set the monitor refreshrate in Hz.
3340 Currently only supported by \-vo directx combined with the \-vm option.
3344 Play movie in the root window (desktop background).
3345 Desktop background images may cover the movie window, though.
3346 Only works with the x11, xv, xmga, xvidix, quartz, corevideo and directx video output drivers.
3349 .B \-saturation <\-100\-100>
3350 Adjust the saturation of the video signal (default: 0).
3351 You can get grayscale output with this option.
3352 Not supported by all video output drivers.
3355 .B \-screenh <pixels>
3356 Specify the screen height for video output drivers which
3357 do not know the screen resolution like fbdev, x11 and TV-out.
3360 .B \-screenw <pixels>
3361 Specify the screen width for video output drivers which
3362 do not know the screen resolution like fbdev, x11 and TV-out.
3365 .B \-stop\-xscreensaver (X11 only)
3366 Turns off xscreensaver at startup and turns it on again on exit.
3367 If your screensaver supports neither the XSS nor XResetScreenSaver
3368 API please use \-heartbeat\-cmd instead.
3371 .B \-title (also see \-use\-filename\-title)
3372 Set the window title.
3373 Supported by X11-based video output drivers.
3376 .B \-use\-filename\-title (also see \-title)
3377 Set the window title using the media filename, when not set with \-title.
3378 Supported by X11-based video output drivers.
3382 Try to change to a different video mode.
3383 Supported by the dga, x11, xv, sdl and directx video output drivers.
3384 If used with the directx video output driver the \-screenw,
3385 \-screenh, \-bpp and \-refreshrate options can be used to set
3386 the new display mode.
3390 Enables VBI for the vesa, dfbmga and svga video output drivers.
3393 .B \-wid <window ID> (X11, OpenGL and DirectX only)
3394 This tells MPlayer to attach to an existing window.
3395 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
3396 This option fills the given window completely, thus aspect scaling,
3397 panscan, etc are no longer handled by MPlayer but must be managed by the
3398 application that created the window.
3401 .B \-xineramascreen <\-2\-...>
3402 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
3403 displays) this option tells MPlayer which screen to display the movie on.
3404 A value of \-2 means fullscreen across the whole virtual display (in this case
3405 Xinerama information is completely ignored), \-1 means
3406 fullscreen on the display the window currently is on.
3407 The initial position set via the \-geometry option is relative to the
3409 Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
3410 This option is not suitable to only set the startup screen (because
3411 it will always display on the given screen in fullscreen mode),
3412 \-geometry is the best that is available for that purpose
3414 Supported by at least the direct3d, gl, gl2, x11, xv and corevideo video output
3418 .B \-zrbw (\-vo zr only)
3419 Display in black and white.
3420 For optimal performance, this can be combined with '\-lavdopts gray'.
3423 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
3424 Select a part of the input image to display, multiple occurrences
3425 of this option switch on cinerama mode.
3426 In cinerama mode the movie is distributed over more than one TV
3427 (or beamer) to create a larger image.
3428 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
3429 card should at least have a \-zrdev in addition to the \-zrcrop.
3430 For examples, see the output of \-zrhelp and the Zr section of the
3434 .B \-zrdev <device> (\-vo zr only)
3435 Specify the device special file that belongs to your MJPEG card, by default
3436 the zr video output driver takes the first v4l device it can find.
3439 .B \-zrfd (\-vo zr only)
3440 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
3441 happens if the hardware scaler can stretch the image to its original size.
3442 Use this option to force decimation.
3445 .B \-zrhdec <1|2|4> (\-vo zr only)
3446 Horizontal decimation: Ask the driver to send only every 2nd or 4th
3447 line/\:pixel of the input image to the MJPEG card and use the scaler
3448 of the MJPEG card to stretch the image to its original size.
3451 .B \-zrhelp (\-vo zr only)
3452 Display a list of all \-zr* options, their default values and a
3453 cinerama mode example.
3456 .B \-zrnorm <norm> (\-vo zr only)
3457 Specify the TV norm as PAL or NTSC (default: no change).
3460 .B \-zrquality <1\-20> (\-vo zr only)
3461 A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
3464 .B \-zrvdec <1|2|4> (\-vo zr only)
3465 Vertical decimation: Ask the driver to send only every 2nd or 4th
3466 line/\:pixel of the input image to the MJPEG card and use the scaler
3467 of the MJPEG card to stretch the image to its original size.
3470 .B \-zrxdoff <x display offset> (\-vo zr only)
3471 If the movie is smaller than the TV screen, this option specifies the x
3472 offset from the upper-left corner of the TV screen (default: centered).
3475 .B \-zrydoff <y display offset> (\-vo zr only)
3476 If the movie is smaller than the TV screen, this option specifies the y
3477 offset from the upper-left corner of the TV screen (default: centered).
3481 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
3482 Video output drivers are interfaces to different video output facilities.
3486 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
3487 Specify a priority list of video output drivers to be used.
3489 If the list has a trailing ',' MPlayer will fall back on drivers not
3490 contained in the list.
3491 Suboptions are optional and can mostly be omitted.
3494 See \-vo help for a list of compiled-in video output drivers.
3499 .IPs "\-vo xmga,xv,"
3500 Try the Matrox X11 driver, then the Xv driver, then others.
3501 .IPs "\-vo directx:noaccel"
3502 Uses the DirectX driver with acceleration features turned off.
3506 Available video output drivers are:
3510 Uses the XVideo extension of XFree86 4.x to enable hardware
3511 accelerated playback.
3512 If you cannot use a hardware specific driver, this is probably
3514 For information about what colorkey is used and how it is drawn run MPlayer
3515 with \-v option and look out for the lines tagged with [xv common] at the
3519 .IPs adaptor=<number>
3520 Select a specific XVideo adaptor (check xvinfo results).
3522 Select a specific XVideo port.
3523 .IPs ck=<cur|use|set>
3524 Select the source from which the colorkey is taken (default: cur).
3527 The default takes the colorkey currently set in Xv.
3529 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
3532 Same as use but also sets the supplied colorkey.
3534 .IPs ck-method=<man|bg|auto>
3535 Sets the colorkey drawing method (default: man).
3538 Draw the colorkey manually (reduces flicker in some cases).
3540 Set the colorkey as window background.
3542 Let Xv draw the colorkey.
3549 Shared memory video output driver without hardware acceleration that
3550 works whenever X11 is present.
3554 Adds X11 support to all overlay based video output drivers.
3555 Currently only supported by tdfx_vid.
3559 Select the driver to use as source to overlay on top of X11.
3564 .B vdpau (with \-vc ffmpeg12vdpau, ffwmv3vdpau, ffvc1vdpau, ffh264vdpau or ffodivxvdpau)
3565 Video output that uses VDPAU to decode video via hardware.
3566 Also supports displaying of software-decoded video.
3569 .IPs sharpen=<\-1\-1>
3570 For positive values, apply a sharpening algorithm to the video,
3571 for negative values a blurring algorithm (default: 0).
3573 Apply a noise reduction algorithm to the video (default: 0, no noise reduction).
3575 Select the deinterlacer (default: 0).
3576 All modes > 0 respect \-field\-dominance.
3581 Show only first field, similar to \-vf field.
3583 Bob deinterlacing, similar to \-vf tfields=1.
3585 motion adaptive temporal deinterlacing
3586 May lead to A/V desync with slow video hardware and/or high resolution.
3587 This is the default if "D" is used to enable deinterlacing.
3589 motion adaptive temporal deinterlacing with edge-guided spatial interpolation
3590 Needs fast video hardware.
3593 Makes temporal deinterlacers operate both on luma and chroma (default).
3594 Use nochroma\-deint to solely use luma and speed up advanced deinterlacing.
3595 Useful with slow video memory.
3597 Try to apply inverse telecine, needs motion adaptive temporal deinterlacing.
3598 .IPs colorspace=<0-3>
3599 Select the color space for YUV to RGB conversion.
3600 In general BT.601 should be used for standard definition (SD) content and
3601 BT.709 for high definition (HD) content.
3602 Using incorrect color space results in slightly under or over saturated and
3606 Guess the color space based on video resolution.
3607 Video with width >= 1280 or height > 576 is assumed to be HD and BT.709 color
3610 Use ITU-R BT.601 color space (default).
3612 Use ITU-R BT.709 color space.
3614 Use SMPTE-240M color space.
3616 .IPs hqscaling=<0-9>
3619 Use default VDPAU scaling (default).
3621 Apply high quality VDPAU scaling (needs capable hardware).
3624 Output video in studio level RGB (16-235).
3625 This is what TVs and video monitors generally expect.
3626 By default PC level RGB (0-255) suitable for PC monitors is used.
3627 Providing studio level output to a device expecting PC level input results in
3628 grey blacks and dim whites, the reverse in crushed blacks and whites.
3630 Override autodetected display refresh rate value (the value is needed for framedrop to allow video playback rates higher than display refresh rate, and for vsync-aware frame timing adjustments).
3631 Default 0 means use autodetected value.
3632 A positive value is interpreted as a refresh rate in Hz and overrides the autodetected value.
3633 A negative value disables all timing adjustment and framedrop logic.
3634 .IPs queuetime_windowed=<number>
3635 .IPs queuetime_fs=<number>
3636 Use VDPAU's presentation queue functionality to queue future video frame
3637 changes at most this many milliseconds in advance (default: 50).
3638 See below for additional information.
3639 .IPs output_surfaces=<2-15>
3640 Allocate this many output surfaces to display video frames (default: 3).
3641 See below for additional information.
3645 Using the VDPAU frame queueing functionality controlled by the queuetime
3646 options makes MPlayer's frame flip timing less sensitive to system CPU load
3647 and allows MPlayer to start decoding the next frame(s) slightly earlier
3648 which can reduce jitter caused by individual slow-to-decode frames.
3649 However the NVIDIA graphics drivers can make other window behavior such as
3650 window moves choppy if VDPAU is using the blit queue (mainly happens
3651 if you have the composite extension enabled) and this feature is active.
3652 If this happens on your system and it bothers you then you can set the
3653 queuetime value to 0 to disable this feature.
3654 The settings to use in windowed and fullscreen mode are separate because there
3655 should be less reason to disable this for fullscreen mode (as the driver issue
3656 shouldn't affect the video itself).
3658 You can queue more frames ahead by increasing the queuetime values and the
3659 output_surfaces count (to ensure enough surfaces to buffer video for a
3660 certain time ahead you need at least as many surfaces as the video has
3661 frames during that time, plus two).
3662 This could help make video smoother in some cases.
3663 The main downsides are increased video RAM requirements for the surfaces
3664 and laggier display response to user commands (display changes only become
3665 visible some time after they're queued). The graphics driver implementation may
3666 also have limits on the length of maximum queuing time or number of queued
3667 surfaces that work well or at all.
3672 .B xvmc (X11 with \-vc ffmpeg12mc only)
3673 Video output driver that uses the XvMC (X Video Motion Compensation)
3674 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
3677 .IPs adaptor=<number>
3678 Select a specific XVideo adaptor (check xvinfo results).
3680 Select a specific XVideo port.
3682 Disables image display.
3683 Necessary for proper benchmarking of drivers that change
3684 image buffers on monitor retrace only (nVidia).
3685 Default is not to disable image display (nobenchmark).
3687 Very simple deinterlacer.
3688 Might not look better than \-vf tfields=1,
3689 but it is the only deinterlacer for xvmc (default: nobobdeint).
3691 Queue frames for display to allow more parallel work of the video hardware.
3692 May add a small (not noticeable) constant A/V desync (default: noqueue).
3694 Use sleep function while waiting for rendering to finish
3695 (not recommended on Linux) (default: nosleep).
3697 Same as \-vo xv:ck (see \-vo xv).
3698 .IPs ck-method=man|bg|auto
3699 Same as \-vo xv:ck-method (see \-vo xv).
3705 Play video through the XFree86 Direct Graphics Access extension.
3706 Considered obsolete.
3709 .B sdl (SDL only, buggy/outdated)
3710 Highly platform independent SDL (Simple Directmedia Layer) library
3711 video output driver.
3712 Since SDL uses its own X11 layer, MPlayer X11 options do not have
3714 Note that it has several minor bugs (\-vm/\-novm is mostly ignored,
3715 \-fs behaves like \-novm should, window is in top-left corner when
3716 returning from fullscreen, panscan is not supported, ...).
3719 .IPs driver=<driver>
3720 Explicitly choose the SDL driver to use.
3722 Use XVideo through the sdl video output driver (default: forcexv).
3724 Use hardware accelerated scaler (default: hwaccel).
3730 VIDIX (VIDeo Interface for *niX) is an interface to the
3731 video acceleration features of different graphics cards.
3732 Very fast video output driver on cards that support it.
3736 Explicitly choose the VIDIX subdevice driver to use.
3737 Available subdevice drivers are cyberblade, ivtv, mach64,
3738 mga_crtc2, mga, nvidia, pm2, pm3, radeon, rage128, s3, sh_veu,
3739 sis_vid and unichrome.
3744 .B xvidix (X11 only)
3745 X11 frontend for VIDIX
3755 Generic and platform independent VIDIX frontend, can even run in a
3756 text console with nVidia cards.
3765 .B winvidix (Windows only)
3766 Windows frontend for VIDIX
3775 .B direct3d (Windows only) (BETA CODE!)
3776 Video output driver that uses the Direct3D interface (useful for Vista).
3779 .B directx (Windows only)
3780 Video output driver that uses the DirectX interface.
3784 Turns off hardware acceleration.
3785 Try this option if you have display problems.
3791 Video output driver that uses the libkva interface.
3797 Force WarpOverlay! mode.
3801 Enable or disable workaround for T23 laptop (default: disabled).
3802 Try to enable this option if your video card supports upscaling only.
3807 .B quartz (Mac OS X only)
3808 Mac OS X Quartz video output driver.
3809 Under some circumstances, it might be more efficient to force a
3810 packed YUV output format, with e.g.\& \-vf format=yuy2.
3813 .IPs device_id=<number>
3814 Choose the display device to use in fullscreen.
3815 .IPs fs_res=<width>:<height>
3816 Specify the fullscreen resolution (useful on slow systems).
3821 .B corevideo (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
3822 Mac OS X CoreVideo video output driver
3825 .IPs device_id=<number>
3826 Choose the display device to use for fullscreen or set it to \-1 to
3827 always use the same screen the video window is on (default: \-1 \- auto).
3829 Write output to a shared memory buffer instead of displaying it and
3830 try to open an existing NSConnection for communication with a GUI.
3831 .IPs buffer_name=<name>
3832 Name of the shared buffer created with shm_open as well as the name of
3833 the NSConnection MPlayer will try to open (default: "mplayerosx").
3834 Setting buffer_name implicitly enables shared_buffer.
3839 .B fbdev (Linux only)
3840 Uses the kernel framebuffer to play video.
3844 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
3845 name of the VIDIX subdevice if the device name starts with 'vidix'
3846 (e.g.\& 'vidixsis_vid' for the sis driver).
3851 .B fbdev2 (Linux only)
3852 Uses the kernel framebuffer to play video,
3853 alternative implementation.
3857 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3863 Very general video output driver that should work on any VESA VBE 2.0
3868 Turns DGA mode on or off (default: on).
3870 Activate the NeoMagic TV out and set it to PAL norm.
3872 Activate the NeoMagic TV out and set it to NTSC norm.
3874 Use the VIDIX driver.
3876 Activate the Linux Video Overlay on top of VESA mode.
3882 Play video using the SVGA library.
3886 Specify video mode to use.
3887 The mode can be given in a <width>x<height>x<colors> format,
3888 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
3890 Draw OSD into black bands below the movie (slower).
3892 Use only native drawing functions.
3893 This avoids direct rendering, OSD and hardware acceleration.
3895 Force frame switch on vertical retrace.
3896 Usable only with \-double.
3897 It has the same effect as the \-vsync option.
3899 Try to select a video mode with square pixels.
3901 Use svga with VIDIX.
3907 OpenGL video output driver, simple version.
3908 Video size must be smaller than
3909 the maximum texture size of your OpenGL implementation.
3910 Intended to work even with the most basic OpenGL implementations,
3911 but also makes use of newer extensions, which allow support for more
3912 colorspaces and direct rendering.
3913 For optimal speed try adding the options
3917 The code performs very few checks, so if a feature does not work, this
3918 might be because it is not supported by your card/OpenGL implementation
3919 even if you do not get any error message.
3920 Use glxinfo or a similar tool to display the supported OpenGL extensions.
3924 ATI drivers may give a corrupted image when PBOs are used (when using \-dr
3926 This option fixes this, at the expense of using a bit more memory.
3928 Always uses PBOs to transfer textures even if this involves an extra copy.
3929 Currently this gives a little extra speed with NVidia drivers and a lot more
3930 speed with ATI drivers.
3931 May need \-noslices and the ati\-hack suboption to work correctly.
3933 Changes the way the OSD behaves when the size of the
3934 window changes (default: disabled).
3935 When enabled behaves more like the other video output drivers,
3936 which is better for fixed-size fonts.
3937 Disabled looks much better with FreeType fonts and uses the
3938 borders in fullscreen mode.
3939 Does not work correctly with ass subtitles (see \-ass), you can instead
3940 render them without OpenGL support via \-vf ass.
3941 .IPs osdcolor=<0xAARRGGBB>
3942 Color for OSD (default: 0x00ffffff, corresponds to non-transparent white).
3943 .IPs rectangle=<0,1,2>
3944 Select usage of rectangular textures which saves video RAM, but often is
3945 slower (default: 0).
3947 0: Use power-of-two textures (default).
3949 1: Use the GL_ARB_texture_rectangle extension.
3951 2: Use the GL_ARB_texture_non_power_of_two extension.
3952 In some cases only supported in software and thus very slow.
3954 .IPs swapinterval=<n>
3955 Minimum interval between two buffer swaps, counted in
3956 displayed frames (default: 1).
3957 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
3958 Values below 0 will leave it at the system default.
3959 This limits the framerate to (horizontal refresh rate / n).
3960 Requires GLX_SGI_swap_control support to work.
3961 With some (most/all?) implementations this only works in fullscreen mode.
3963 Use the GL_MESA_ycbcr_texture extension to convert YUV to RGB.
3964 In most cases this is probably slower than doing software conversion to RGB.
3966 Select the type of YUV to RGB conversion.
3967 The default is auto-detection deciding between values 0 and 2.
3969 0: Use software conversion.
3970 Compatible with all OpenGL versions.
3971 Provides brightness, contrast and saturation control.
3973 1: Use register combiners.
3974 This uses an nVidia-specific extension (GL_NV_register_combiners).
3975 At least three texture units are needed.
3976 Provides saturation and hue control.
3977 This method is fast but inexact.
3979 2: Use a fragment program.
3980 Needs the GL_ARB_fragment_program extension and at least three texture units.
3981 Provides brightness, contrast, saturation and hue control.
3983 3: Use a fragment program using the POW instruction.
3984 Needs the GL_ARB_fragment_program extension and at least three texture units.
3985 Provides brightness, contrast, saturation, hue and gamma control.
3986 Gamma can also be set independently for red, green and blue.
3987 Method 4 is usually faster.
3989 4: Use a fragment program with additional lookup.
3990 Needs the GL_ARB_fragment_program extension and at least four texture units.
3991 Provides brightness, contrast, saturation, hue and gamma control.
3992 Gamma can also be set independently for red, green and blue.
3994 5: Use ATI-specific method (for older cards).
3995 This uses an ATI-specific extension (GL_ATI_fragment_shader \- not
3996 GL_ARB_fragment_shader!).
3997 At least three texture units are needed.
3998 Provides saturation and hue control.
3999 This method is fast but inexact.
4001 6: Use a 3D texture to do conversion via lookup.
4002 Needs the GL_ARB_fragment_program extension and at least four texture units.
4003 Extremely slow (software emulation) on some (all?) ATI cards since it uses
4004 a texture with border pixels.
4005 Provides brightness, contrast, saturation, hue and gamma control.
4006 Gamma can also be set independently for red, green and blue.
4007 Speed depends more on GPU memory bandwidth than other methods.
4010 Select the color space for YUV to RGB conversion.
4013 Use the formula used normally by MPlayer (default).
4015 Use ITU-R BT.601 color space.
4017 Use ITU-R BT.709 color space.
4019 Use SMPTE-240M color space.
4022 Select the brightness level conversion to use for the YUV to RGB conversion
4025 Convert TV to PC levels (default).
4027 Convert PC to TV levels.
4029 Do not do any conversion.
4032 Select the scaling function to use for luminance scaling.
4033 Only valid for yuv modes 2, 3, 4 and 6.
4035 0: Use simple linear filtering (default).
4037 1: Use bicubic B-spline filtering (better quality).
4038 Needs one additional texture unit.
4039 Older cards will not be able to handle this for chroma at least in fullscreen mode.
4041 2: Use cubic filtering in horizontal, linear filtering in vertical direction.
4042 Works on a few more cards than method 1.
4044 3: Same as 1 but does not use a lookup texture.
4045 Might be faster on some cards.
4047 4: Use experimental unsharp masking with 3x3 support and a default strength of 0.5 (see filter-strength).
4049 5: Use experimental unsharp masking with 5x5 support and a default strength of 0.5 (see filter-strength).
4052 Select the scaling function to use for chrominance scaling.
4053 For details see lscale.
4054 .IPs filter-strength=<value>
4055 Set the effect strength for the lscale/cscale filters that support it.
4057 Select a method for stereo display.
4058 You may have to use -aspect to fix the aspect value.
4059 Experimental, do not expect too much from it.
4061 0: Normal 2D display
4063 1: left-right split input to full-color red-cyan stereo.
4065 2: left-right split input to full-color red-cyan stereo.
4067 3: left-right split input to quadbuffered stereo.
4068 Only supported by very few OpenGL cards.
4073 The following options are only useful if writing your own fragment programs.
4077 .IPs customprog=<filename>
4078 Load a custom fragment program from <filename>.
4079 See TOOLS/edgedect.fp for an example.
4080 .IPs customtex=<filename>
4081 Load a custom "gamma ramp" texture from <filename>.
4082 This can be used in combination with yuv=4 or with the customprog option.
4084 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
4085 for customtex texture.
4086 .IPs (no)customtrect
4087 If enabled, use texture_rectangle for customtex texture.
4088 Default is disabled.
4090 If enabled, mipmaps for the video are automatically generated.
4091 This should be useful together with the customprog and the TXB
4092 instruction to implement blur filters with a large radius.
4093 For most OpenGL implementations this is very slow for any non-RGB
4095 Default is disabled.
4099 Normally there is no reason to use the following options, they mostly
4100 exist for testing purposes.
4105 Call glFinish() before swapping buffers.
4106 Slower but in some cases more correct output (default: disabled).
4108 Enables support for more (RGB and BGR) color formats (default: enabled).
4109 Needs OpenGL version >= 1.2.
4110 .IPs slice-height=<0\-...>
4111 Number of lines copied to texture in one piece (default: 0).
4115 If YUV colorspace is used (see yuv suboption), special rules apply:
4117 If the decoder uses slice rendering (see \-noslices), this setting
4118 has no effect, the size of the slices as provided by the decoder is used.
4120 If the decoder does not use slice rendering, the default is 16.
4123 Enable or disable support for OSD rendering via OpenGL (default: enabled).
4124 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
4126 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
4127 Disabling might increase speed.
4134 Variant of the OpenGL video output driver.
4135 Supports videos larger than the maximum texture size but lacks many of the
4136 advanced features and optimizations of the gl driver and is unlikely to be
4141 same as gl (default: enabled)
4143 Select the type of YUV to RGB conversion.
4144 If set to anything except 0 OSD will be disabled and brightness, contrast and
4145 gamma setting is only available via the global X server settings.
4146 Apart from this the values have the same meaning as for \-vo gl.
4151 OpenGL-based renderer creating a Matrix-like running-text effect.
4155 Number of text columns to display.
4156 Very low values (< 16) will probably fail due to scaler limitations.
4157 Values not divisible by 16 may cause issues as well.
4159 Number of text rows to display.
4160 Very low values (< 16) will probably fail due to scaler limitations.
4161 Values not divisible by 16 may cause issues as well.
4166 Produces no video output.
4167 Useful for benchmarking.
4171 ASCII art video output driver that works on a text console.
4172 You can get a list and an explanation of available suboptions
4173 by executing 'mplayer \-vo aa:help'.
4176 The driver does not handle \-aspect correctly.
4179 You probably have to specify \-monitorpixelaspect.
4180 Try 'mplayer \-vo aa \-monitorpixelaspect 0.5'.
4184 Color ASCII art video output driver that works on a text console.
4188 Video playback using the Blinkenlights UDP protocol.
4189 This driver is highly hardware specific.
4193 Explicitly choose the Blinkenlights subdevice driver to use.
4194 It is something like arcade:host=localhost:2323 or
4195 hdl:file=name1,file=name2.
4196 You must specify a subdevice.
4202 GGI graphics system video output driver
4206 Explicitly choose the GGI driver to use.
4207 Replace any ',' that would appear in the driver string by a '.'.
4213 Play video using the DirectFB library.
4217 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
4218 .IPs buffermode=single|double|triple
4219 Double and triple buffering give best results if you want to avoid tearing issues.
4220 Triple buffering is more efficient than double buffering as it does
4221 not block MPlayer while waiting for the vertical retrace.
4222 Single buffering should be avoided (default: single).
4223 .IPs fieldparity=top|bottom
4224 Control the output order for interlaced frames (default: disabled).
4225 Valid values are top = top fields first, bottom = bottom fields first.
4226 This option does not have any effect on progressive film material
4227 like most MPEG movies are.
4228 You need to enable this option if you have tearing issues or unsmooth
4229 motions watching interlaced film material.
4231 Will force layer with ID N for playback (default: \-1 \- auto).
4233 Specify a parameter list for DirectFB.
4239 Matrox G400/\:G450/\:G550 specific video output driver that uses the
4240 DirectFB library to make use of special hardware features.
4241 Enables CRTC2 (second head), displaying video independently of the first head.
4245 same as directfb (default: disabled)
4246 .IPs buffermode=single|double|triple
4247 same as directfb (default: triple)
4248 .IPs fieldparity=top|bottom
4251 Enable the use of the Matrox BES (backend scaler) (default: disabled).
4252 Gives very good results concerning speed and output quality as interpolated
4253 picture processing is done in hardware.
4254 Works only on the primary head.
4256 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
4258 Turn on TV-out on the second head (default: enabled).
4259 The output quality is amazing as it is a full interlaced picture
4260 with proper sync to every odd/\:even field.
4261 .IPs tvnorm=pal|ntsc|auto
4262 Will set the TV norm of the Matrox card without the need
4263 for modifying /etc/\:directfbrc (default: disabled).
4264 Valid norms are pal = PAL, ntsc = NTSC.
4265 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
4266 which norm to use by looking at the framerate of the movie.
4272 Matrox specific video output driver that makes use of the YUV back
4273 end scaler on Gxxx cards through a kernel module.
4274 If you have a Matrox card, this is the fastest option.
4278 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4283 .B xmga (Linux, X11 only)
4284 The mga video output driver, running in an X11 window.
4288 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4293 .B s3fb (Linux only) (also see \-dr)
4294 S3 Virge specific video output driver.
4295 This driver supports the card's YUV conversion and scaling, double
4296 buffering and direct rendering features.
4297 Use \-vf format=yuy2 to get hardware-accelerated YUY2 rendering, which is
4298 much faster than YV12 on this card.
4302 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4308 Nintendo Wii/GameCube specific video output driver.
4311 .B 3dfx (Linux only)
4312 3dfx-specific video output driver that directly uses
4313 the hardware on top of X11.
4314 Only 16 bpp are supported.
4317 .B tdfxfb (Linux only)
4318 This driver employs the tdfxfb framebuffer driver to play movies with
4319 YUV acceleration on 3dfx cards.
4323 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4328 .B tdfx_vid (Linux only)
4329 3dfx-specific video output driver that works in combination with
4330 the tdfx_vid kernel module.
4334 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
4339 .B dxr2 (also see \-dxr2) (DXR2 only)
4340 Creative DXR2 specific video output driver.
4344 Output video subdriver to use as overlay (x11, xv).
4350 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
4351 Hollywood Plus) specific video output driver.
4352 Also see the lavc video filter.
4356 Activates the overlay instead of TV-out.
4358 Turns on prebuffering.
4360 Will turn on the new sync-engine.
4362 Specifies the TV norm.
4364 0: Does not change current norm (default).
4366 1: Auto-adjust using PAL/\:NTSC.
4368 2: Auto-adjust using PAL/\:PAL-60.
4377 Specifies the device number to use if you have more than one em8300 card.
4383 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
4384 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
4385 specific video output driver for TV-out.
4386 Also see the lavc video filter.
4390 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4392 Explicitly choose the TV-out output to be used for the video signal.
4397 .B v4l2 (requires Linux 2.6.22+ kernel)
4398 Video output driver for V4L2 compliant cards with built-in hardware MPEG decoder.
4399 Also see the lavc video filter.
4403 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4405 Explicitly choose the TV-out output to be used for the video signal.
4410 .B mpegpes (DVB only)
4411 Video output driver for DVB cards that writes the output to an MPEG-PES file
4412 if no DVB card is installed.
4416 Specifies the device number to use if you have more than one DVB output card
4417 (V3 API only, such as 1.x.y series drivers).
4418 If not specified MPlayer will search the first usable card.
4420 output filename (default: ./grab.mpg)
4425 .B zr (also see \-zr* and \-zrhelp)
4426 Video output driver for a number of MJPEG capture/\:playback cards.
4429 .B zr2 (also see the zrmjpeg video filter)
4430 Video output driver for a number of MJPEG capture/\:playback cards,
4435 Specifies the video device to use.
4436 .IPs norm=<PAL|NTSC|SECAM|auto>
4437 Specifies the video norm to use (default: auto).
4439 (De)Activate prebuffering, not yet supported.
4445 Calculate MD5 sums of each frame and write them to a file.
4446 Supports RGB24 and YV12 colorspaces.
4447 Useful for debugging.
4450 .IPs outfile=<value>
4451 Specify the output filename (default: ./md5sums).
4457 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
4458 images and stores it in a file (default: ./stream.yuv).
4459 The format is the same as the one employed by mjpegtools, so this is
4460 useful if you want to process the video with the mjpegtools suite.
4461 It supports the YV12 format.
4462 If your source file has a different format and is interlaced, make sure
4463 to use -vf scale=::1 to ensure the conversion uses interlaced mode.
4464 You can combine it with the \-fixed\-vo option to concatenate files
4465 with the same dimensions and fps value.
4469 Write the output as interlaced frames, top field first.
4471 Write the output as interlaced frames, bottom field first.
4472 .IPs file=<filename>
4473 Write the output to <filename> instead of the default stream.yuv.
4479 If you do not specify any option the output is progressive
4480 (i.e.\& not interlaced).
4485 Output each frame into a single animated GIF file in the current directory.
4486 It supports only RGB format with 24 bpp and the output is converted to 256
4491 Float value to specify framerate (default: 5.0).
4493 Specify the output filename (default: ./out.gif).
4499 You must specify the framerate before the filename or the framerate will
4500 be part of the filename.
4506 mplayer video.nut \-vo gif89a:fps=15:output=test.gif
4512 Output each frame into a JPEG file in the current directory.
4513 Each file takes the frame number padded with leading zeros as name.
4516 .IPs [no]progressive
4517 Specify standard or progressive JPEG (default: noprogressive).
4519 Specify use of baseline or not (default: baseline).
4520 .IPs optimize=<0\-100>
4521 optimization factor (default: 100)
4522 .IPs smooth=<0\-100>
4523 smooth factor (default: 0)
4524 .IPs quality=<0\-100>
4525 quality factor (default: 75)
4526 .IPs outdir=<dirname>
4527 Specify the directory to save the JPEG files to (default: ./).
4528 .IPs subdirs=<prefix>
4529 Create numbered subdirectories with the specified prefix to
4530 save the files in instead of the current directory.
4531 .IPs "maxfiles=<value> (subdirs only)"
4532 Maximum number of files to be saved per subdirectory.
4533 Must be equal to or larger than 1 (default: 1000).
4539 Output each frame into a PNM file in the current directory.
4540 Each file takes the frame number padded with leading zeros as name.
4541 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
4542 Also see pnm(5), ppm(5) and pgm(5).
4546 Write PPM files (default).
4551 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
4552 bottom of the picture.
4554 Write PNM files in raw mode (default).
4556 Write PNM files in ASCII mode.
4557 .IPs outdir=<dirname>
4558 Specify the directory to save the PNM files to (default: ./).
4559 .IPs subdirs=<prefix>
4560 Create numbered subdirectories with the specified prefix to
4561 save the files in instead of the current directory.
4562 .IPs "maxfiles=<value> (subdirs only)"
4563 Maximum number of files to be saved per subdirectory.
4564 Must be equal to or larger than 1 (default: 1000).
4570 Output each frame into a PNG file in the current directory.
4571 Each file takes the frame number padded with leading zeros as name.
4572 24bpp RGB and BGR formats are supported.
4576 Specifies the compression level.
4577 0 is no compression, 9 is maximum compression.
4578 .IPs alpha (default: noalpha)
4579 Create PNG files with an alpha channel.
4580 Note that MPlayer in general does not support alpha, so this will only
4581 be useful in some rare cases.
4587 Output each frame into a Targa file in the current directory.
4588 Each file takes the frame number padded with leading zeros as name.
4589 The purpose of this video output driver is to have a simple lossless
4590 image writer to use without any external library.
4591 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
4592 You can force a particular format with the format video filter.
4598 mplayer video.nut \-vf format=bgr15 \-vo tga
4604 .SH "DECODING/FILTERING OPTIONS"
4607 .B \-ac <[\-|+]codec1,[\-|+]codec2,...[,]>
4608 Specify a priority list of audio codecs to be used, according to their codec
4609 name in codecs.conf.
4610 Use a '\-' before the codec name to omit it.
4611 Use a '+' before the codec name to force it, this will likely crash!
4612 If the list has a trailing ',' MPlayer will fall back on codecs not
4613 contained in the list.
4616 See \-ac help for a full list of available codecs.
4622 Force the l3codeca.acm MP3 codec.
4624 Try libmad first, then fall back on others.
4625 .IPs "\-ac hwac3,a52,"
4626 Try hardware AC-3 passthrough, software AC-3, then others.
4628 Try hardware DTS passthrough, then fall back on others.
4629 .IPs "\-ac \-ffmp3,"
4630 Skip FFmpeg's MP3 decoder.
4635 .B \-af\-adv <force=(0\-7):list=(filters)> (also see \-af)
4636 Specify advanced audio filter options:
4639 Forces the insertion of audio filters to one of the following:
4641 0: Use completely automatic filter insertion (currently identical to 1).
4643 1: Optimize for accuracy (default).
4645 2: Optimize for speed.
4647 Some features in the audio filters may silently fail,
4648 and the sound quality may drop.
4650 3: Use no automatic insertion of filters and no optimization.
4652 It may be possible to crash MPlayer using this setting.
4654 4: Use automatic insertion of filters according to 0 above,
4655 but use floating point processing when possible.
4657 5: Use automatic insertion of filters according to 1 above,
4658 but use floating point processing when possible.
4660 6: Use automatic insertion of filters according to 2 above,
4661 but use floating point processing when possible.
4663 7: Use no automatic insertion of filters according to 3 above,
4664 and use floating point processing when possible.
4671 .B \-afm <driver1,driver2,...>
4672 Specify a priority list of audio codec families to be used, according
4673 to their codec name in codecs.conf.
4674 Falls back on the default codecs if none of the given codec families work.
4677 See \-afm help for a full list of available codec families.
4683 Try FFmpeg's libavcodec codecs first.
4684 .IPs "\-afm acm,dshow"
4685 Try Win32 codecs first.
4690 .B \-aspect <ratio> (also see \-zoom)
4691 Override movie aspect ratio, in case aspect information is
4692 incorrect or missing in the file being played.
4697 \-aspect 4:3 or \-aspect 1.3333
4699 \-aspect 16:9 or \-aspect 1.7777
4705 Disable automatic movie aspect ratio compensation.
4708 .B "\-field\-dominance <\-1\-1>"
4709 Set first field for interlaced content.
4710 Useful for deinterlacers that double the framerate: \-vf tfields=1,
4711 \-vf yadif=1, \-vo vdpau:deint and \-vo xvmc:bobdeint.
4715 auto (default): If the decoder does not export the appropriate information,
4716 it falls back to 0 (top field first).
4726 Flip image upside-down.
4729 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
4730 Specify libavcodec decoding parameters.
4731 Separate multiple options with a colon.
4736 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
4741 Available options are:
4745 Only use bit-exact algorithms in all decoding steps (for codec testing).
4747 Manually work around encoder bugs.
4751 1: autodetect bugs (default)
4753 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
4755 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
4757 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
4759 16 (mpeg4): padding bug (autodetected)
4761 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
4763 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
4765 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
4767 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
4769 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
4771 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
4774 Display debugging information.
4785 8: macroblock (MB) type
4787 16: per-block quantization parameter (QP)
4791 0x0040: motion vector visualization (use \-noslices)
4793 0x0080: macroblock (MB) skip
4799 0x0400: error resilience
4801 0x0800: memory management control operations (H.264)
4805 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
4807 0x4000: Visualize block types.
4810 Set error concealment strategy.
4812 1: Use strong deblock filter for damaged MBs.
4814 2: iterative motion vector (MV) search (slow)
4819 Set error resilience strategy.
4824 1: careful (Should work with broken encoders.)
4826 2: normal (default) (Works with compliant encoders.)
4828 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4832 .IPs "fast (MPEG-2, MPEG-4, and H.264 only)"
4833 Enable optimizations which do not comply to the specification and might
4834 potentially cause problems, like simpler dequantization, simpler motion
4835 compensation, assuming use of the default quantization matrix, assuming
4836 YUV 4:2:0 and skipping a few checks to detect damaged bitstreams.
4838 grayscale only decoding (a bit faster than with color)
4839 .IPs "idct=<0\-99> (see \-lavcopts)"
4840 For best decoding quality use the same IDCT algorithm for decoding and encoding.
4841 This may come at a price in accuracy, though.
4842 .IPs lowres=<number>[,<w>]
4843 Decode at lower resolutions.
4844 Low resolution decoding is not supported by all codecs, and it will
4845 often result in ugly artifacts.
4846 This is not a bug, but a side effect of not decoding at full resolution.
4858 If <w> is specified lowres decoding will be used only if the width of the
4859 video is major than or equal to <w>.
4861 .B o=<key>=<value>[,<key>=<value>[,...]]
4862 Pass AVOptions to libavcodec decoder.
4863 Note, a patch to make the o= unneeded and pass all unknown options through
4864 the AVOption system is welcome.
4865 A full list of AVOptions can be found in the FFmpeg manual.
4866 Note that some options may conflict with MEncoder options.
4876 .IPs "sb=<number> (MPEG-2 only)"
4877 Skip the given number of macroblock rows at the bottom.
4878 .IPs "st=<number> (MPEG-2 only)"
4879 Skip the given number of macroblock rows at the top.
4880 .IPs "skiploopfilter=<skipvalue> (H.264 only)"
4881 Skips the loop filter (AKA deblocking) during H.264 decoding.
4882 Since the filtered frame is supposed to be used as reference
4883 for decoding dependent frames this has a worse effect on quality
4884 than not doing deblocking on e.g.\& MPEG-2 video.
4885 But at least for high bitrate HDTV this provides a big speedup with
4886 no visible quality loss.
4888 <skipvalue> can be either one of the following:
4893 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
4895 nonref: Skip frames that are not referenced (i.e.\& not used for
4896 decoding other frames, the error cannot "build up").
4898 bidir: Skip B-Frames.
4900 nonkey: Skip all frames except keyframes.
4902 all: Skip all frames.
4904 .IPs "skipidct=<skipvalue> (MPEG-1/2 only)"
4905 Skips the IDCT step.
4906 This degrades quality a lot of in almost all cases
4907 (see skiploopfilter for available skip values).
4908 .IPs skipframe=<skipvalue>
4909 Skips decoding of frames completely.
4910 Big speedup, but jerky motion and sometimes bad artifacts
4911 (see skiploopfilter for available skip values).
4912 .IPs "threads=<1\-8> (MPEG-1/2 and H.264 only)"
4913 number of threads to use for decoding (default: 1)
4915 Visualize motion vectors.
4920 1: Visualize forward predicted MVs of P-frames.
4922 2: Visualize forward predicted MVs of B-frames.
4924 4: Visualize backward predicted MVs of B-frames.
4927 Prints some statistics and stores them in ./vstats_*.log.
4932 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4933 whole frame in a single run.
4934 May be faster or slower, depending on video card and available cache.
4935 It has effect only with libmpeg2 and libavcodec codecs.
4939 Do not play/\:encode sound.
4940 Useful for benchmarking.
4944 Do not play/\:encode video.
4945 In many cases this will not work, use \-vc null \-vo null instead.
4948 .B \-pp <quality> (also see \-vf pp)
4949 Set the DLL postprocess level.
4950 This option is no longer usable with \-vf pp.
4951 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4952 The valid range of \-pp values varies by codec, it is mostly
4953 0\-6, where 0=disable, 6=slowest/\:best.
4956 .B \-pphelp (also see \-vf pp)
4957 Show a summary about the available postprocess filters and their usage.
4961 Specifies software scaler parameters.
4966 \-vf scale \-ssf lgb=3.0
4972 gaussian blur filter (luma)
4974 gaussian blur filter (chroma)
4975 .IPs ls=<\-100\-100>
4976 sharpen filter (luma)
4977 .IPs cs=<\-100\-100>
4978 sharpen filter (chroma)
4980 chroma horizontal shifting
4982 chroma vertical shifting
4988 Select type of MP2/\:MP3 stereo output.
5001 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
5002 Specify the software scaler algorithm to be used with the \-zoom option.
5003 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
5005 Available types are:
5014 bicubic (good quality) (default)
5018 nearest neighbor (bad quality)
5022 luma bicubic / chroma bilinear
5030 natural bicubic spline
5036 Some \-sws options are tunable.
5037 The description of the scale video filter has further information.
5041 .B \-vc <[\-|+]codec1,[\-|+]codec2,...[,]>
5042 Specify a priority list of video codecs to be used, according to their codec
5043 name in codecs.conf.
5044 Use a '\-' before the codec name to omit it.
5045 Use a '+' before the codec name to force it, this will likely crash!
5046 If the list has a trailing ',' MPlayer will fall back on codecs not
5047 contained in the list.
5050 See \-vc help for a full list of available codecs.
5056 Force Win32/\:VfW DivX codec, no fallback.
5057 .IPs "\-vc \-divxds,\-divx,"
5058 Skip Win32 DivX codecs.
5059 .IPs "\-vc ffmpeg12,mpeg12,"
5060 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
5065 .B \-vfm <driver1,driver2,...>
5066 Specify a priority list of video codec families to be used, according
5067 to their names in codecs.conf.
5068 Falls back on the default codecs if none of the given codec families work.
5071 See \-vfm help for a full list of available codec families.
5076 .IPs "\-vfm ffmpeg,dshow,vfw"
5077 Try the libavcodec, then Directshow, then VfW codecs and fall back
5078 on others, if they do not work.
5080 Try XAnim codecs first.
5085 .B \-x <x> (also see \-zoom) (MPlayer only)
5086 Scale image to width <x> (if software/\:hardware scaling is available).
5087 Disables aspect calculations.
5090 .B \-xvidopts <option1:option2:...>
5091 Specify additional parameters when decoding with Xvid.
5094 Since libavcodec is faster than Xvid you might want to use the libavcodec
5095 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
5097 Xvid's internal postprocessing filters:
5100 .IPs "deblock-chroma (also see \-vf pp)"
5101 chroma deblock filter
5102 .IPs "deblock-luma (also see \-vf pp)"
5104 .IPs "dering-luma (also see \-vf pp)"
5105 luma deringing filter
5106 .IPs "dering-chroma (also see \-vf pp)"
5107 chroma deringing filter
5108 .IPs "filmeffect (also see \-vf noise)"
5109 Adds artificial film grain to the video.
5110 May increase perceived quality, while lowering true quality.
5119 Activate direct rendering method 2.
5121 Deactivate direct rendering method 2.
5126 .B \-xy <value> (also see \-zoom)
5130 Scale image by factor <value>.
5132 Set width to value and calculate height to keep correct aspect ratio.
5137 .B \-y <y> (also see \-zoom) (MPlayer only)
5138 Scale image to height <y> (if software/\:hardware scaling is available).
5139 Disables aspect calculations.
5143 Allow software scaling, where available.
5144 This will allow scaling with output drivers (like x11, fbdev) that
5145 do not support hardware scaling where MPlayer disables scaling by
5146 default for performance reasons.
5151 Audio filters allow you to modify the audio stream and its properties.
5155 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
5156 Setup a chain of audio filters.
5159 To get a full list of available audio filters, see \-af help.
5161 Audio filters are managed in lists.
5162 There are a few commands to manage the filter list.
5165 .B \-af\-add <filter1[,filter2,...]>
5166 Appends the filters given as arguments to the filter list.
5169 .B \-af\-pre <filter1[,filter2,...]>
5170 Prepends the filters given as arguments to the filter list.
5173 .B \-af\-del <index1[,index2,...]>
5174 Deletes the filters at the given indexes.
5175 Index numbers start at 0, negative numbers address the end of the
5176 list (\-1 is the last).
5180 Completely empties the filter list.
5182 Available filters are:
5185 .B resample[=srate[:sloppy[:type]]]
5186 Changes the sample rate of the audio stream.
5187 Can be used if you have a fixed frequency sound card or if you are
5188 stuck with an old sound card that is only capable of max 44.1kHz.
5189 This filter is automatically enabled if necessary.
5190 It only supports 16-bit integer and float in native-endian format as input.
5193 With MEncoder, you need to also use \-srate <srate>.
5197 output sample frequency in Hz.
5198 The valid range for this parameter is 8000 to 192000.
5199 If the input and output sample frequency are the same or if this
5200 parameter is omitted the filter is automatically unloaded.
5201 A high sample frequency normally improves the audio quality,
5202 especially when used in combination with other filters.
5204 Allow (1) or disallow (0) the output frequency to differ slightly
5205 from the frequency given by <srate> (default: 1).
5206 Can be used if the startup of the playback is extremely slow.
5208 Select which resampling method to use.
5210 0: linear interpolation (fast, poor quality especially when upsampling)
5212 1: polyphase filterbank and integer processing
5214 2: polyphase filterbank and floating point processing (slow, best quality)
5224 .IPs "mplayer \-af resample=44100:0:0"
5225 would set the output frequency of the resample filter to 44100Hz using
5226 exact output frequency scaling and linear interpolation.
5231 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
5232 Changes the sample rate of the audio stream to an integer <srate> in Hz.
5233 It only supports the 16-bit native-endian format.
5236 With MEncoder, you need to also use \-srate <srate>.
5240 the output sample rate
5242 length of the filter with respect to the lower sampling rate (default: 16)
5244 if 1 then filters will be linearly interpolated between polyphase entries
5246 log2 of the number of polyphase entries
5247 (..., 10->1024, 11->2048, 12->4096, ...)
5250 cutoff frequency (0.0\-1.0), default set depending upon filter length
5255 .B lavcac3enc[=tospdif[:bitrate[:minchn]]]
5256 Encode multi-channel audio to AC-3 at runtime using libavcodec.
5257 Supports 16-bit native-endian input format, maximum 6 channels.
5258 The output is big-endian when outputting a raw AC-3 stream,
5259 native-endian when outputting to S/PDIF.
5260 The output sample rate of this filter is same with the input sample rate.
5261 When input sample rate is 48kHz, 44.1kHz, or 32kHz, this filter directly use it.
5262 Otherwise a resampling filter is auto-inserted before this filter to make
5263 the input and output sample rate be 48kHz.
5264 You need to specify '\-channels N' to make the decoder decode audio into
5265 N-channel, then the filter can encode the N-channel input to AC-3.
5270 Output raw AC-3 stream if zero or not set,
5271 output to S/PDIF for passthrough when <tospdif> is set non-zero.
5273 The bitrate to encode the AC-3 stream.
5274 Set it to either 384 or 384000 to get 384kbits.
5275 Valid values: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
5276 320, 384, 448, 512, 576, 640
5277 Default bitrate is based on the input channel number:
5278 1ch: 96, 2ch: 192, 3ch: 224, 4ch: 384, 5ch: 448, 6ch: 448
5280 If the input channel number is less than <minchn>, the filter will
5281 detach itself (default: 5).
5287 Produces a sine sweep.
5291 Sine function delta, use very low values to hear the sweep.
5296 .B sinesuppress[=freq:decay]
5297 Remove a sine at the specified frequency.
5298 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
5299 It probably only works on mono input.
5303 The frequency of the sine which should be removed (in Hz) (default: 50)
5305 Controls the adaptivity (a larger value will make the filter adapt to
5306 amplitude and phase changes quicker, a smaller value will make the
5307 adaptation slower) (default: 0.0001).
5308 Reasonable values are around 0.001.
5313 .B bs2b[=option1:option2:...]
5314 Bauer stereophonic to binaural transformation using libbs2b.
5315 Improves the headphone listening experience by making the sound
5316 similar to that from loudspeakers, allowing each ear to hear both
5317 channels and taking into account the distance difference and the
5318 head shadowing effect.
5319 It is applicable only to 2 channel audio.
5322 .IPs fcut=<300\-1000>
5323 Set cut frequency in Hz.
5325 Set feed level for low frequencies in 0.1*dB.
5326 .IPs profile=<value>
5327 Several profiles are available for convenience:
5331 will be used if nothing else was specified (fcut=700, feed=45)
5333 Chu Moy circuit implementation (fcut=700, feed=60)
5335 Jan Meier circuit implementation (fcut=650, feed=95)
5340 If fcut or feed options are specified together with a profile, they
5341 will be applied on top of the selected profile.
5347 Head-related transfer function: Converts multichannel audio to
5348 2 channel output for headphones, preserving the spatiality of the sound.
5353 .IPs "m matrix decoding of the rear channel"
5354 .IPs "s 2-channel matrix decoding"
5355 .IPs "0 no matrix decoding (default)"
5360 .B equalizer=[g1:g2:g3:...:g10]
5361 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
5362 This means that it works regardless of what type of audio is being played back.
5363 The center frequencies for the 10 bands are:
5367 .IPs "No. frequency"
5382 If the sample rate of the sound being played is lower than the center
5383 frequency for a frequency band, then that band will be disabled.
5384 A known bug with this filter is that the characteristics for the
5385 uppermost band are not completely symmetric if the sample
5386 rate is close to the center frequency of that band.
5387 This problem can be worked around by upsampling the sound
5388 using the resample filter before it reaches this filter.
5392 .IPs <g1>:<g2>:<g3>:...:<g10>
5393 floating point numbers representing the gain in dB
5394 for each frequency band (\-12\-12)
5401 .IPs "mplayer \-af equalizer=11:11:10:5:0:\-12:0:5:12:12 media.avi"
5402 Would amplify the sound in the upper and lower frequency region
5403 while canceling it almost completely around 1kHz.
5408 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
5409 Can be used for adding, removing, routing and copying audio channels.
5410 If only <nch> is given the default routing is used, it works as
5411 follows: If the number of output channels is bigger than the number of
5412 input channels empty channels are inserted (except mixing from mono to
5413 stereo, then the mono channel is repeated in both of the output
5415 If the number of output channels is smaller than the number
5416 of input channels the exceeding channels are truncated.
5420 number of output channels (1\-8)
5422 number of routes (1\-8)
5423 .IPs <from1:to1:from2:to2:from3:to3:...>
5424 Pairs of numbers between 0 and 7 that define where to route each channel.
5431 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
5432 Would change the number of channels to 4 and set up 4 routes that
5433 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
5434 Observe that if media containing two channels was played back, channels
5435 2 and 3 would contain silence but 0 and 1 would still be swapped.
5436 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
5437 Would change the number of channels to 6 and set up 4 routes
5438 that copy channel 0 to channels 0 to 3.
5439 Channel 4 and 5 will contain silence.
5444 .B format[=format] (also see \-format)
5445 Convert between different sample formats.
5446 Automatically enabled when needed by the sound card or another filter.
5450 Sets the desired format.
5451 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
5452 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
5453 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
5454 and 'ne' the endianness of the computer MPlayer is running on).
5455 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
5456 Exceptions to this rule that are also valid format specifiers: u8, s8,
5457 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
5463 Implements software volume control.
5464 Use this filter with caution since it can reduce the signal
5465 to noise ratio of the sound.
5466 In most cases it is best to set the level for the PCM sound to max,
5467 leave this filter out and control the output level to your
5468 speakers with the master volume control of the mixer.
5469 In case your sound card has a digital PCM mixer instead of an analog
5470 one, and you hear distortion, use the MASTER mixer instead.
5471 If there is an external amplifier connected to the computer (this
5472 is almost always the case), the noise level can be minimized by
5473 adjusting the master level and the volume knob on the amplifier
5474 until the hissing noise in the background is gone.
5476 This filter has a second feature: It measures the overall maximum
5477 sound level and prints out that level when MPlayer exits.
5478 This volume estimate can be used for setting the sound level in
5479 MEncoder such that the maximum dynamic range is utilized.
5480 This feature currently only works with floating-point data,
5481 use e.g. \-af\-adv force=5, or use \-af stats.
5484 This filter is not reentrant and can therefore only be enabled
5485 once for every audio stream.
5489 Sets the desired gain in dB for all channels in the stream
5490 from \-200dB to +60dB, where \-200dB mutes the sound
5491 completely and +60dB equals a gain of 1000 (default: 0).
5493 Turns soft clipping on (1) or off (0).
5494 Soft-clipping can make the sound more smooth if very
5495 high volume levels are used.
5496 Enable this option if the dynamic range of the
5497 loudspeakers is very low.
5500 This feature creates distortion and should be considered a last resort.
5507 .IPs "mplayer \-af volume=10.1:0 media.avi"
5508 Would amplify the sound by 10.1dB and hard-clip if the
5509 sound level is too high.
5514 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
5515 Mixes channels arbitrarily.
5516 Basically a combination of the volume and the channels filter
5517 that can be used to down-mix many channels to only a few,
5518 e.g.\& stereo to mono or vary the "width" of the center
5519 speaker in a surround sound system.
5520 This filter is hard to use, and will require some tinkering
5521 before the desired result is obtained.
5522 The number of options for this filter depends on
5523 the number of output channels.
5524 An example how to downmix a six-channel file to two channels with
5525 this filter can be found in the examples section near the end.
5529 number of output channels (1\-8)
5531 How much of input channel i is mixed into output channel j (0\-1).
5532 So in principle you first have n numbers saying what to do with the
5533 first input channel, then n numbers that act on the second input channel
5535 If you do not specify any numbers for some input channels, 0 is assumed.
5542 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
5543 Would down-mix from stereo to mono.
5544 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
5545 Would give 3 channel output leaving channels 0 and 1 intact,
5546 and mix channels 0 and 1 into output channel 2 (which could
5547 be sent to a subwoofer for example).
5553 Adds a subwoofer channel to the audio stream.
5554 The audio data used for creating the subwoofer channel is
5555 an average of the sound in channel 0 and channel 1.
5556 The resulting sound is then low-pass filtered by a 4th order
5557 Butterworth filter with a default cutoff frequency of 60Hz
5558 and added to a separate channel in the audio stream.
5561 Disable this filter when you are playing DVDs with Dolby
5562 Digital 5.1 sound, otherwise this filter will disrupt
5563 the sound to the subwoofer.
5567 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
5568 For the best result try setting the cutoff frequency as low as possible.
5569 This will improve the stereo or surround sound experience.
5571 Determines the channel number in which to insert the sub-channel audio.
5572 Channel number can be between 0 and 7 (default: 5).
5573 Observe that the number of channels will automatically
5574 be increased to <ch> if necessary.
5581 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
5582 Would add a sub-woofer channel with a cutoff frequency of
5583 100Hz to output channel 4.
5589 Creates a center channel from the front channels.
5590 May currently be low quality as it does not implement a
5591 high-pass filter for proper extraction yet, but averages and
5592 halves the channels instead.
5596 Determines the channel number in which to insert the center channel.
5597 Channel number can be between 0 and 7 (default: 5).
5598 Observe that the number of channels will automatically
5599 be increased to <ch> if necessary.
5605 Decoder for matrix encoded surround sound like Dolby Surround.
5606 Many files with 2 channel audio actually contain matrixed surround sound.
5607 Requires a sound card supporting at least 4 channels.
5611 delay time in ms for the rear speakers (0 to 1000) (default: 20)
5612 This delay should be set as follows: If d1 is the distance
5613 from the listening position to the front speakers and d2 is the distance
5614 from the listening position to the rear speakers, then the delay should
5615 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
5622 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
5623 Would add surround sound decoding with 15ms delay for the sound to the
5629 .B delay[=ch1:ch2:...]
5630 Delays the sound to the loudspeakers such that the sound from the
5631 different channels arrives at the listening position simultaneously.
5632 It is only useful if you have more than 2 loudspeakers.
5636 The delay in ms that should be imposed on each channel
5637 (floating point number between 0 and 1000).
5642 To calculate the required delay for the different channels do as follows:
5644 Measure the distance to the loudspeakers in meters in relation
5645 to your listening position, giving you the distances s1 to s5
5647 There is no point in compensating for the subwoofer (you will not hear the
5650 Subtract the distances s1 to s5 from the maximum distance,
5651 i.e.\& s[i] = max(s) \- s[i]; i = 1...5.
5653 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
5661 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
5662 Would delay front left and right by 10.5ms, the two rear channels
5663 and the sub by 0ms and the center channel by 7ms.
5668 .B export[=mmapped_file[:nsamples]]
5669 Exports the incoming signal to other processes using memory mapping (mmap()).
5670 Memory mapped areas contain a header:
5673 int nch /*number of channels*/
5674 int size /*buffer size*/
5675 unsigned long long counter /*Used to keep sync, updated every
5676 time new data is exported.*/
5679 The rest is payload (non-interleaved) 16 bit data.
5683 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
5685 number of samples per channel (default: 512)
5692 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
5693 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
5698 .B extrastereo[=mul]
5699 (Linearly) increases the difference between left and right channels
5700 which adds some sort of "live" effect to playback.
5704 Sets the difference coefficient (default: 2.5).
5705 0.0 means mono sound (average of both channels), with 1.0 sound will be
5706 unchanged, with \-1.0 left and right channels will be swapped.
5711 .B volnorm[=method:target]
5712 Maximizes the volume without distorting the sound.
5716 Sets the used method.
5718 1: Use a single sample to smooth the variations via the standard
5719 weighted mean over past samples (default).
5721 2: Use several samples to smooth the variations via the standard
5722 weighted mean over past samples.
5725 Sets the target amplitude as a fraction of the maximum for the
5726 sample type (default: 0.25).
5731 .B ladspa=file:label[:controls...]
5732 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
5733 This filter is reentrant, so multiple LADSPA plugins can be used at once.
5737 Specifies the LADSPA plugin library file.
5738 If LADSPA_PATH is set, it searches for the specified file.
5739 If it is not set, you must supply a fully specified pathname.
5741 Specifies the filter within the library.
5742 Some libraries contain only one filter, but others contain many of them.
5743 Entering 'help' here, will list all available filters within the specified
5744 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
5746 Controls are zero or more floating point values that determine the
5747 behavior of the loaded plugin (for example delay, threshold or gain).
5748 In verbose mode (add \-v to the MPlayer command line), all available controls
5749 and their valid ranges are printed.
5750 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
5756 Compressor/expander filter usable for microphone input.
5757 Prevents artifacts on very loud sound and raises the volume on
5759 This filter is untested, maybe even unusable.
5763 Noise gate filter similar to the comp audio filter.
5764 This filter is untested, maybe even unusable.
5768 Simple voice removal filter exploiting the fact that voice is
5769 usually recorded with mono gear and later 'center' mixed onto
5770 the final audio stream.
5771 Beware that this filter will turn your signal into mono.
5772 Works well for 2 channel tracks; do not bother trying it
5773 on anything but 2 channel stereo.
5776 .B scaletempo[=option1:option2:...]
5777 Scales audio tempo without altering pitch, optionally synced to playback
5780 This works by playing \'stride\' ms of audio at normal speed then
5781 consuming \'stride*scale\' ms of input audio.
5782 It pieces the strides together by blending \'overlap\'% of stride with
5783 audio following the previous stride.
5784 It optionally performs a short statistical analysis on the next \'search\'
5785 ms of audio to determine the best overlap position.
5789 Nominal amount to scale tempo.
5790 Scales this amount in addition to speed.
5792 .IPs stride=<amount>
5793 Length in milliseconds to output each stride.
5794 Too high of value will cause noticable skips at high scale amounts and
5795 an echo at low scale amounts.
5796 Very low values will alter pitch.
5797 Increasing improves performance.
5799 .IPs overlap=<percent>
5800 Percentage of stride to overlap.
5801 Decreasing improves performance.
5803 .IPs search=<amount>
5804 Length in milliseconds to search for best overlap position.
5805 Decreasing improves performance greatly.
5806 On slow systems, you will probably want to set this very low.
5808 .IPs speed=<tempo|pitch|both|none>
5809 Set response to speed change.
5812 Scale tempo in sync with speed (default).
5814 Reverses effect of filter.
5815 Scales pitch without altering tempo.
5816 Add \'[ speed_mult 0.9438743126816935\' and \'] speed_mult 1.059463094352953\'
5817 to your input.conf to step by musical semi-tones.
5819 Loses sync with video.
5821 Scale both tempo and pitch.
5823 Ignore speed changes.
5831 .IPs "mplayer \-af scaletempo \-speed 1.2 media.ogg"
5832 Would playback media at 1.2x normal speed, with audio at normal pitch.
5833 Changing playback speed, would change audio tempo to match.
5834 .IPs "mplayer \-af scaletempo=scale=1.2:speed=none \-speed 1.2 media.ogg"
5835 Would playback media at 1.2x normal speed, with audio at normal pitch,
5836 but changing playback speed has no effect on audio tempo.
5837 .IPs "mplayer \-af scaletempo=stride=30:overlap=.50:search=10 media.ogg"
5838 Would tweak the quality and performace parameters.
5839 .IPs "mplayer \-af format=floatne,scaletempo media.ogg"
5840 Would make scaletempo use float code.
5841 Maybe faster on some platforms.
5842 .IPs "mplayer \-af scaletempo=scale=1.2:speed=pitch audio.ogg"
5843 Would playback audio file at 1.2x normal speed, with audio at normal pitch.
5844 Changing playback speed, would change pitch, leaving audio tempo at 1.2x.
5850 Collects and prints statistics about the audio stream, especially the volume.
5851 These statistics are especially intended to help adjusting the volume while
5853 The volumes are printed in dB and compatible with the volume audio filter.
5858 Video filters allow you to modify the video stream and its properties.
5862 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
5863 Setup a chain of video filters.
5865 Many parameters are optional and set to default values if omitted.
5866 To explicitly use a default value set a parameter to '\-1'.
5867 Parameters w:h means width x height in pixels, x:y means x;y position counted
5868 from the upper left corner of the bigger image.
5871 To get a full list of available video filters, see \-vf help.
5873 Video filters are managed in lists.
5874 There are a few commands to manage the filter list.
5877 .B \-vf\-add <filter1[,filter2,...]>
5878 Appends the filters given as arguments to the filter list.
5881 .B \-vf\-pre <filter1[,filter2,...]>
5882 Prepends the filters given as arguments to the filter list.
5885 .B \-vf\-del <index1[,index2,...]>
5886 Deletes the filters at the given indexes.
5887 Index numbers start at 0, negative numbers address the end of the
5888 list (\-1 is the last).
5892 Completely empties the filter list.
5894 With filters that support it, you can access parameters by their name.
5897 .B \-vf <filter>=help
5898 Prints the parameter names and parameter value ranges for a particular
5902 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
5903 Sets a named parameter to the given value.
5904 Use on and off or yes and no to set flag parameters.
5906 Available filters are:
5910 Crops the given part of the image and discards the rest.
5911 Useful to remove black bands from widescreen movies.
5915 Cropped width and height, defaults to original width and height.
5917 Position of the cropped picture, defaults to center.
5922 .B cropdetect[=limit:round[:reset]]
5923 Calculates necessary cropping parameters and prints the recommended parameters
5928 Threshold, which can be optionally specified from nothing (0) to
5929 everything (255) (default: 24).
5932 Value which the width/\:height should be divisible by (default: 16).
5933 The offset is automatically adjusted to center the video.
5934 Use 2 to get only even dimensions (needed for 4:2:2 video).
5935 16 is best when encoding to most video codecs.
5938 Counter that determines after how many frames cropdetect will reset the
5939 previously detected largest video area and start over to detect the current
5940 optimal crop area (default: 0).
5941 This can be useful when channel logos distort the video area.
5942 0 indicates never reset and return the largest area encountered during playback.
5947 .B rectangle[=w:h:x:y]
5948 Draws a rectangle of the requested width and height at the specified
5949 coordinates over the image and prints current rectangle parameters
5951 This can be used to find optimal cropping parameters.
5952 If you bind the input.conf directive 'change_rectangle' to keystrokes,
5953 you can move and resize the rectangle on the fly.
5957 width and height (default: \-1, maximum possible width where boundaries
5960 top left corner position (default: \-1, uppermost leftmost)
5965 .B expand[=w:h:x:y:o:a:r]
5966 Expands (not scales) movie resolution to the given value and places the
5967 unscaled original at coordinates x, y.
5968 Can be used for placing subtitles/\:OSD in the resulting black bands.
5971 Expanded width,height (default: original width,height).
5972 Negative values for w and h are treated as offsets to the original size.
5977 .IP expand=0:\-50:0:0
5978 Adds a 50 pixel border to the bottom of the picture.
5982 position of original image on the expanded image (default: center)
5984 OSD/\:subtitle rendering
5986 0: disable (default)
5991 Expands to fit an aspect instead of a resolution (default: 0).
5996 .IP expand=800:::::4/3
5997 Expands to 800x600, unless the source is higher resolution, in which
5998 case it expands to fill a 4/3 aspect.
6002 Rounds up to make both width and height divisible by <r> (default: 1).
6006 .B flip (also see \-flip)
6007 Flips the image upside down.
6011 Mirrors the image on the Y axis.
6015 Rotates the image by 90 degrees and optionally flips it.
6016 For values between 4\-7 rotation is only done if the movie geometry is
6017 portrait and not landscape.
6020 Rotate by 90 degrees clockwise and flip (default).
6022 Rotate by 90 degrees clockwise.
6024 Rotate by 90 degrees counterclockwise.
6026 Rotate by 90 degrees counterclockwise and flip.
6030 .B scale[=w:h[:interlaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]]
6031 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
6032 colorspace conversion (also see \-sws).
6035 scaled width/\:height (default: original width/\:height)
6038 If \-zoom is used, and underlying filters (including libvo) are
6039 incapable of scaling, it defaults to d_width/\:d_height!
6041 0: scaled d_width/\:d_height
6043 \-1: original width/\:height
6045 \-2: Calculate w/h using the other dimension and the prescaled aspect ratio.
6047 \-3: Calculate w/h using the other dimension and the original aspect ratio.
6049 \-(n+8): Like \-n above, but rounding the dimension to the closest multiple of 16.
6052 Toggle interlaced scaling.
6061 0: Use all available input lines for chroma.
6063 1: Use only every 2. input line for chroma.
6065 2: Use only every 4. input line for chroma.
6067 3: Use only every 8. input line for chroma.
6069 .IPs "<par>[:<par2>] (also see \-sws)"
6070 Set some scaling parameters depending on the type of scaler selected
6073 \-sws 2 (bicubic): B (blurring) and C (ringing)
6077 0.00:0.75 VirtualDub's "precise bicubic"
6079 0.00:0.50 Catmull-Rom spline
6081 0.33:0.33 Mitchell-Netravali spline
6083 1.00:0.00 cubic B-spline
6085 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
6087 \-sws 9 (lanczos): filter length (1\-10)
6090 Scale to preset sizes.
6092 qntsc: 352x240 (NTSC quarter screen)
6094 qpal: 352x288 (PAL quarter screen)
6096 ntsc: 720x480 (standard NTSC)
6098 pal: 720x576 (standard PAL)
6100 sntsc: 640x480 (square pixel NTSC)
6102 spal: 768x576 (square pixel PAL)
6105 Disallow upscaling past the original dimensions.
6107 0: Allow upscaling (default).
6109 1: Disallow upscaling if one dimension exceeds its original value.
6111 2: Disallow upscaling if both dimensions exceed their original values.
6114 Accurate rounding for the vertical scaler, which may be faster
6115 or slower than the default rounding.
6117 0: Disable accurate rounding (default).
6119 1: Enable accurate rounding.
6124 .B dsize[=aspect|w:h:aspect-method:r]
6125 Changes the intended display size/\:aspect at an arbitrary point in the
6127 Aspect can be given as a fraction (4/3) or floating point number
6129 Alternatively, you may specify the exact display width and height
6131 Note that this filter does
6133 do any scaling itself; it just affects
6134 what later scalers (software or hardware) will do when auto-scaling to
6138 New display width and height.
6139 Can also be these special values:
6141 0: original display width and height
6143 \-1: original video width and height (default)
6145 \-2: Calculate w/h using the other dimension and the original display
6148 \-3: Calculate w/h using the other dimension and the original video
6156 Specifies a display resolution of 800x600 for a 4/3 aspect video, or
6157 800x450 for a 16/9 aspect video.
6159 .IPs <aspect-method>
6160 Modifies width and height according to original aspect ratios.
6162 \-1: Ignore original aspect ratio (default).
6164 0: Keep display aspect ratio by using <w> and <h> as maximum
6167 1: Keep display aspect ratio by using <w> and <h> as minimum
6170 2: Keep video aspect ratio by using <w> and <h> as maximum
6173 3: Keep video aspect ratio by using <w> and <h> as minimum
6181 Specifies a display resolution of at most 800x600, or smaller, in order
6186 Rounds up to make both width and height divisible by <r> (default: 1).
6191 Forces software YVU9 to YV12 colorspace conversion.
6192 Deprecated in favor of the software scaler.
6196 Clamps YUV color values to the CCIR 601 range without doing real conversion.
6200 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette.
6203 .B format[=fourcc[:outfourcc]]
6204 Restricts the colorspace for the next filter without doing any conversion.
6205 Use together with the scale filter for a real conversion.
6208 For a list of available formats see format=fmt=help.
6212 format name like rgb15, bgr24, yv12, etc (default: yuy2)
6214 Format name that should be substituted for the output.
6215 If this is not 100% compatible with the <fourcc> value it will crash.
6219 format=rgb24:bgr24 format=yuyv:yuy2
6221 Invalid examples (will crash):
6228 .B noformat[=fourcc]
6229 Restricts the colorspace for the next filter without doing any conversion.
6230 Unlike the format filter, this will allow any colorspace
6232 the one you specify.
6235 For a list of available formats see noformat=fmt=help.
6239 format name like rgb15, bgr24, yv12, etc (default: yv12)
6244 .B pp[=filter1[:option1[:option2...]]/[\-]filter2...] (also see \-pphelp)
6245 Enables the specified chain of postprocessing subfilters.
6246 Subfilters must be separated by '/' and can be disabled by
6248 Each subfilter and some options have a short and a long name that can be
6249 used interchangeably, i.e.\& dr/dering are the same.
6250 All subfilters share common options to determine their scope:
6254 Automatically switch the subfilter off if the CPU is too slow.
6256 Do chrominance filtering, too (default).
6258 Do luminance filtering only (no chrominance).
6260 Do chrominance filtering only (no luminance).
6267 \-pphelp shows a list of available subfilters.
6269 Available subfilters are
6272 .IPs hb/hdeblock[:difference[:flatness]]
6273 horizontal deblocking filter
6275 <difference>: Difference factor where higher values mean
6276 more deblocking (default: 32).
6278 <flatness>: Flatness threshold where lower values mean
6279 more deblocking (default: 39).
6281 .IPs vb/vdeblock[:difference[:flatness]]
6282 vertical deblocking filter
6284 <difference>: Difference factor where higher values mean
6285 more deblocking (default: 32).
6287 <flatness>: Flatness threshold where lower values mean
6288 more deblocking (default: 39).
6290 .IPs ha/hadeblock[:difference[:flatness]]
6291 accurate horizontal deblocking filter
6293 <difference>: Difference factor where higher values mean
6294 more deblocking (default: 32).
6296 <flatness>: Flatness threshold where lower values mean
6297 more deblocking (default: 39).
6299 .IPs va/vadeblock[:difference[:flatness]]
6300 accurate vertical deblocking filter
6302 <difference>: Difference factor where higher values mean
6303 more deblocking (default: 32).
6305 <flatness>: Flatness threshold where lower values mean
6306 more deblocking (default: 39).
6309 The horizontal and vertical deblocking filters share the
6310 difference and flatness values so you cannot set
6311 different horizontal and vertical thresholds.
6314 experimental horizontal deblocking filter
6316 experimental vertical deblocking filter
6319 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]]
6320 temporal noise reducer
6322 <threshold1>: larger -> stronger filtering
6324 <threshold2>: larger -> stronger filtering
6326 <threshold3>: larger -> stronger filtering
6328 .IPs al/autolevels[:f/fullyrange]
6329 automatic brightness / contrast correction
6331 f/fullyrange: Stretch luminance to (0\-255).
6333 .IPs lb/linblenddeint
6334 Linear blend deinterlacing filter that deinterlaces the given block
6335 by filtering all lines with a (1 2 1) filter.
6336 .IPs li/linipoldeint
6337 Linear interpolating deinterlacing filter that deinterlaces the given block
6338 by linearly interpolating every second line.
6339 .IPs ci/cubicipoldeint
6340 Cubic interpolating deinterlacing filter deinterlaces the given block
6341 by cubically interpolating every second line.
6343 Median deinterlacing filter that deinterlaces the given block
6344 by applying a median filter to every second line.
6346 FFmpeg deinterlacing filter that deinterlaces the given block
6347 by filtering every second line with a (\-1 4 2 4 \-1) filter.
6349 Vertically applied FIR lowpass deinterlacing filter that deinterlaces
6350 the given block by filtering all lines with a (\-1 2 6 2 \-1) filter.
6351 .IPs fq/forceQuant[:quantizer]
6352 Overrides the quantizer table from the input with the constant
6353 quantizer you specify.
6355 <quantizer>: quantizer to use
6358 default pp filter combination (hb:a,vb:a,dr:a)
6360 fast pp filter combination (h1:a,v1:a,dr:a)
6362 high quality pp filter combination (ha:a:128:7,va:a,dr:a)
6370 .IPs "\-vf pp=hb/vb/dr/al"
6371 horizontal and vertical deblocking, deringing and automatic
6372 brightness/\:contrast
6373 .IPs "\-vf pp=de/\-al"
6374 default filters without brightness/\:contrast correction
6375 .IPs "\-vf pp=default/tmpnoise:1:2:3"
6376 Enable default filters & temporal denoiser.
6377 .IPs "\-vf pp=hb:y/vb:a"
6378 Horizontal deblocking on luminance only, and switch vertical deblocking
6379 on or off automatically depending on available CPU time.
6384 .B spp[=quality[:qp[:mode]]]
6385 Simple postprocessing filter that compresses and decompresses the
6386 image at several (or \- in the case of quality level 6 \- all)
6387 shifts and averages the results.
6392 Force quantization parameter (default: 0, use QP from video).
6394 0: hard thresholding (default)
6396 1: soft thresholding (better deringing, but blurrier)
6398 4: like 0, but also use B-frames' QP (may cause flicker)
6400 5: like 1, but also use B-frames' QP (may cause flicker)
6404 .B uspp[=quality[:qp]]
6405 Ultra simple & slow postprocessing filter that compresses and
6406 decompresses the image at several (or \- in the case of quality
6407 level 8 \- all) shifts and averages the results.
6408 The way this differs from the behavior of spp is that uspp actually
6409 encodes & decodes each case with libavcodec Snow, whereas spp uses
6410 a simplified intra only 8x8 DCT similar to MJPEG.
6415 Force quantization parameter (default: 0, use QP from video).
6419 .B fspp[=quality[:qp[:strength[:bframes]]]]
6420 faster version of the simple postprocessing filter
6423 4\-5 (equivalent to spp; default: 4)
6425 Force quantization parameter (default: 0, use QP from video).
6427 Filter strength, lower values mean more details but also more artifacts,
6428 while higher values make the image smoother but also blurrier (default:
6431 0: do not use QP from B-frames (default)
6433 1: use QP from B-frames too (may cause flicker)
6438 Variant of the spp filter, similar to spp=6 with 7 point DCT where
6439 only the center sample is used after IDCT.
6442 Force quantization parameter (default: 0, use QP from video).
6444 0: hard thresholding
6446 1: soft thresholding (better deringing, but blurrier)
6448 2: medium thresholding (default, good results)
6453 quantization parameter (QP) change filter
6456 some equation like "2+2*sin(PI*qp)"
6461 generic equation change filter
6464 Some equation, e.g.\& 'p(W-X\\,Y)' to flip the image horizontally.
6465 You can use whitespace to make the equation more readable.
6466 There are a couple of constants that can be used in the equation:
6472 X / Y: the coordinates of the current sample
6474 W / H: width and height of the image
6476 SW / SH: width/height scale depending on the currently filtered plane, e.g.\&
6477 1,1 and 0.5,0.5 for YUV 4:2:0.
6479 p(x,y): returns the value of the pixel at location x/y of the current plane.
6485 Generate various test patterns.
6488 .B rgbtest[=width:height]
6489 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
6490 You should see a red, green and blue stripe from top to bottom.
6493 Desired width of generated image (default: 0).
6494 0 means width of input image.
6497 Desired height of generated image (default: 0).
6498 0 means height of input image.
6502 .B lavc[=quality:fps]
6503 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV/\:V4L2.
6508 32\-: fixed bitrate in kbits
6510 force output fps (float value) (default: 0, autodetect based on height)
6514 .B dvbscale[=aspect]
6515 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
6516 calculating the y axis scaling in software to keep aspect.
6517 Only useful together with expand and scale.
6520 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
6521 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
6529 .IPs "\-vf dvbscale,scale=\-1:0,expand=\-1:576:\-1:\-1:1,lavc"
6530 FIXME: Explain what this does.
6535 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
6544 uniform noise (gaussian otherwise)
6546 temporal noise (noise pattern changes between frames)
6548 averaged temporal noise (smoother, but a lot slower)
6550 high quality (slightly better looking, slightly slower)
6552 mix random noise with a (semi)regular pattern
6557 .B denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6558 This filter aims to reduce image noise producing smooth images and making still
6559 images really still (This should enhance compressibility.).
6563 spatial luma strength (default: 4)
6564 .IPs <chroma_spatial>
6565 spatial chroma strength (default: 3)
6567 luma temporal strength (default: 6)
6569 chroma temporal strength (default: luma_tmp*chroma_spatial/luma_spatial)
6574 .B hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6575 High precision/\:quality version of the denoise3d filter.
6576 Parameters and usage are the same.
6579 .B ow[=depth[:luma_strength[:chroma_strength]]]
6580 Overcomplete Wavelet denoiser.
6584 Larger depth values will denoise lower frequency components more, but
6585 slow down filtering (default: 8).
6586 .IPs <luma_strength>
6587 luma strength (default: 1.0)
6588 .IPs <chroma_strength>
6589 chroma strength (default: 1.0)
6594 .B eq[=brightness:contrast] (OBSOLETE)
6595 Software equalizer with interactive controls just like the hardware
6596 equalizer, for cards/\:drivers that do not support brightness and
6597 contrast controls in hardware.
6598 Might also be useful with MEncoder, either for fixing poorly captured
6599 movies, or for slightly reducing contrast to mask artifacts and get by
6600 with lower bitrates.
6611 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
6612 Alternative software equalizer that uses lookup tables (very slow),
6613 allowing gamma correction in addition to simple brightness
6614 and contrast adjustment.
6615 Note that it uses the same MMX optimized code as \-vf eq if all
6616 gamma values are 1.0.
6617 The parameters are given as floating point values.
6621 initial gamma value (default: 1.0)
6623 initial contrast, where negative values result in a
6624 negative image (default: 1.0)
6626 initial brightness (default: 0.0)
6628 initial saturation (default: 1.0)
6630 gamma value for the red component (default: 1.0)
6632 gamma value for the green component (default: 1.0)
6634 gamma value for the blue component (default: 1.0)
6636 The weight parameter can be used to reduce the effect of a high gamma value on
6637 bright image areas, e.g.\& keep them from getting overamplified and just plain
6639 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
6640 at its full strength (default: 1.0).
6645 .B hue[=hue:saturation]
6646 Software equalizer with interactive controls just like the hardware
6647 equalizer, for cards/\:drivers that do not support hue and
6648 saturation controls in hardware.
6652 initial hue (default: 0.0)
6654 initial saturation, where negative values result
6655 in a negative chroma (default: 1.0)
6661 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
6662 keeping all chroma samples.
6663 Useful for output to low-resolution display devices when hardware downscaling
6664 is poor quality or is not available.
6665 Can also be used as a primitive luma-only deinterlacer with very low CPU
6670 By default, halfpack averages pairs of lines when downsampling.
6671 Any value different from 0 or 1 gives the default (averaging) behavior.
6673 0: Only use even lines when downsampling.
6675 1: Only use odd lines when downsampling.
6682 When interlaced video is stored in YUV 4:2:0 formats, chroma
6683 interlacing does not line up properly due to vertical downsampling of
6684 the chroma channels.
6685 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
6686 the chroma lines in their proper locations, so that in any given
6687 scanline, the luma and chroma data both come from the same field.
6691 Select the sampling mode.
6693 0: nearest-neighbor sampling, fast but incorrect
6695 1: linear interpolation (default)
6702 Only useful with MEncoder.
6703 If harddup is used when encoding, it will force duplicate frames to be
6704 encoded in the output.
6705 This uses slightly more space, but is necessary for output to MPEG
6706 files or if you plan to demux and remux the video stream after
6708 Should be placed at or near the end of the filter chain unless you
6709 have a good reason to do otherwise.
6713 Only useful with MEncoder.
6714 Softskip moves the frame skipping (dropping) step of encoding from
6715 before the filter chain to some point during the filter chain.
6716 This allows filters which need to see all frames (inverse telecine,
6717 temporal denoising, etc.) to function properly.
6718 Should be placed after the filters which need to see all frames and
6719 before any subsequent filters that are CPU-intensive.
6722 .B decimate[=max:hi:lo:frac]
6723 Drops frames that do not differ greatly from the previous frame in
6724 order to reduce framerate.
6725 The main use of this filter is for very-low-bitrate encoding (e.g.\&
6726 streaming over dialup modem), but it could in theory be used for
6727 fixing movies that were inverse-telecined incorrectly.
6731 Sets the maximum number of consecutive frames which can be
6732 dropped (if positive), or the minimum interval between
6733 dropped frames (if negative).
6734 .IPs <hi>,<lo>,<frac>
6735 A frame is a candidate for dropping if no 8x8 region differs by more
6736 than a threshold of <hi>, and if not more than <frac> portion (1
6737 meaning the whole image) differs by more than a threshold of <lo>.
6738 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
6739 pixel value differences, so a threshold of 64 corresponds to 1 unit of
6740 difference for each pixel, or the same spread out differently over the
6746 .B dint[=sense:level]
6747 The drop-deinterlace (dint) filter detects and drops the first from a set
6748 of interlaced video frames.
6752 relative difference between neighboring pixels (default: 0.1)
6754 What part of the image has to be detected as interlaced to
6755 drop the frame (default: 0.15).
6760 .B lavcdeint (OBSOLETE)
6761 FFmpeg deinterlacing filter, same as \-vf pp=fd
6764 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
6765 Donald Graft's adaptive kernel deinterlacer.
6766 Deinterlaces parts of a video if a configurable threshold is exceeded.
6770 threshold (default: 10)
6773 0: Ignore pixels exceeding the threshold (default).
6775 1: Paint pixels exceeding the threshold white.
6779 0: Leave fields alone (default).
6785 0: Disable additional sharpening (default).
6787 1: Enable additional sharpening.
6791 0: Disable twoway sharpening (default).
6793 1: Enable twoway sharpening.
6799 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
6800 unsharp mask / gaussian blur
6803 Apply effect on luma component.
6805 Apply effect on chroma components.
6806 .IPs <width>x<height>
6807 width and height of the matrix, odd sized in both directions
6808 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
6810 Relative amount of sharpness/\:blur to add to the image
6811 (a sane range should be \-1.5\-1.5).
6824 .B il[=d|i][s][:[d|i][s]]
6825 (De)interleaves lines.
6826 The goal of this filter is to add the ability to process interlaced images
6827 pre-field without deinterlacing them.
6828 You can filter your interlaced DVD and play it on a TV without breaking the
6830 While deinterlacing (with the postprocessing filter) removes interlacing
6831 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
6832 2 fields (so called half pictures), so you can process (filter) them
6833 independently and then re-interleave them.
6837 deinterleave (placing one above the other)
6841 swap fields (exchange even & odd lines)
6847 (De)interleaves lines.
6848 This filter is very similar to the il filter but much faster, the main
6849 disadvantage is that it does not always work.
6850 Especially if combined with other filters it may produce randomly messed
6851 up images, so be happy if it works but do not complain if it does not for
6852 your combination of filters.
6856 Deinterleave fields, placing them side by side.
6858 Interleave fields again (reversing the effect of fil=d).
6864 Extracts a single field from an interlaced image using stride arithmetic
6865 to avoid wasting CPU time.
6866 The optional argument n specifies whether to extract the even or the odd
6867 field (depending on whether n is even or odd).
6870 .B detc[=var1=value1:var2=value2:...]
6871 Attempts to reverse the 'telecine' process to recover a clean,
6872 non-interlaced stream at film framerate.
6873 This was the first and most primitive inverse telecine filter to be
6874 added to MPlayer/\:MEncoder.
6875 It works by latching onto the telecine 3:2 pattern and following it as
6877 This makes it suitable for perfectly-telecined material, even in the
6878 presence of a fair degree of noise, but it will fail in the presence
6879 of complex post-telecine edits.
6880 Development on this filter is no longer taking place, as ivtc, pullup,
6881 and filmdint are better for most applications.
6882 The following arguments (see syntax above) may be used to control
6886 Set the frame dropping mode.
6888 0: Do not drop frames to maintain fixed output framerate (default).
6890 1: Always drop a frame when there have been no drops or telecine
6891 merges in the past 5 frames.
6893 2: Always maintain exact 5:4 input to output frame ratio.
6896 Use mode 1 or 2 with MEncoder.
6901 0: Fixed pattern with initial frame number specified by <fr>.
6903 1: aggressive search for telecine pattern (default)
6906 Set initial frame number in sequence.
6907 0\-2 are the three clean progressive frames; 3 and 4 are the two
6909 The default, \-1, means 'not in telecine sequence'.
6910 The number specified here is the type for the imaginary previous
6911 frame before the movie starts.
6912 .IPs "<t0>, <t1>, <t2>, <t3>"
6913 Threshold values to be used in certain modes.
6918 Experimental 'stateless' inverse telecine filter.
6919 Rather than trying to lock on to a pattern like the detc filter does,
6920 ivtc makes its decisions independently for each frame.
6921 This will give much better results for material that has undergone
6922 heavy editing after telecine was applied, but as a result it is not as
6923 forgiving of noisy input, for example TV capture.
6924 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
6925 detc filter, and should be used with MEncoder but not with MPlayer.
6926 As with detc, you must specify the correct output framerate (\-ofps
6927 24000/1001) when using MEncoder.
6928 Further development on ivtc has stopped, as the pullup and filmdint
6929 filters appear to be much more accurate.
6932 .B pullup[=jl:jr:jt:jb:sb:mp]
6933 Third-generation pulldown reversal (inverse telecine) filter,
6934 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
6935 fps progressive content.
6936 The pullup filter is designed to be much more robust than detc or
6937 ivtc, by taking advantage of future context in making its decisions.
6938 Like ivtc, pullup is stateless in the sense that it does not lock onto
6939 a pattern to follow, but it instead looks forward to the following
6940 fields in order to identify matches and rebuild progressive frames.
6941 It is still under development, but believed to be quite accurate.
6943 .IPs "jl, jr, jt, and jb"
6944 These options set the amount of "junk" to ignore at
6945 the left, right, top, and bottom of the image, respectively.
6946 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
6948 The default is 8 pixels on each side.
6950 .IPs "sb (strict breaks)"
6951 Setting this option to 1 will reduce the chances of
6952 pullup generating an occasional mismatched frame, but it may also
6953 cause an excessive number of frames to be dropped during high motion
6955 Conversely, setting it to \-1 will make pullup match fields more
6957 This may help processing of video where there is slight blurring
6958 between the fields, but may also cause there to be interlaced frames
6961 .IPs "mp (metric plane)"
6962 This option may be set to 1 or 2 to use a chroma
6963 plane instead of the luma plane for doing pullup's computations.
6964 This may improve accuracy on very clean source material, but more
6965 likely will decrease accuracy, especially if there is chroma noise
6966 (rainbow effect) or any grayscale video.
6967 The main purpose of setting mp to a chroma plane is to reduce CPU load
6968 and make pullup usable in realtime on slow machines.
6973 Always follow pullup with the softskip filter when encoding to ensure
6974 that pullup is able to see each frame.
6975 Failure to do so will lead to incorrect output and will usually crash,
6976 due to design limitations in the codec/\:filter layer.
6980 .B filmdint[=options]
6981 Inverse telecine filter, similar to the pullup filter above.
6982 It is designed to handle any pulldown pattern, including mixed soft and
6983 hard telecine and limited support for movies that are slowed down or sped
6984 up from their original framerate for TV.
6985 Only the luma plane is used to find the frame breaks.
6986 If a field has no match, it is deinterlaced with simple linear
6988 If the source is MPEG-2, this must be the first filter to allow
6989 access to the field-flags set by the MPEG-2 decoder.
6990 Depending on the source MPEG, you may be fine ignoring this advice, as
6991 long as you do not see lots of "Bottom-first field" warnings.
6992 With no options it does normal inverse telecine, and should be used
6993 together with mencoder \-fps 30000/1001 \-ofps 24000/1001.
6994 When this filter is used with MPlayer, it will result in an uneven
6995 framerate during playback, but it is still generally better than using
6996 pp=lb or no deinterlacing at all.
6997 Multiple options can be specified separated by /.
6999 .IPs crop=<w>:<h>:<x>:<y>
7000 Just like the crop filter, but faster, and works on mixed hard and soft
7001 telecined content as well as when y is not a multiple of 4.
7002 If x or y would require cropping fractional pixels from the chroma
7003 planes, the crop area is extended.
7004 This usually means that x and y must be even.
7005 .IPs io=<ifps>:<ofps>
7006 For each ifps input frames the filter will output ofps frames.
7007 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio.
7008 This could be used to filter movies that are broadcast on TV at a frame
7009 rate different from their original framerate.
7011 If n is nonzero, the chroma plane is copied unchanged.
7012 This is useful for YV12 sampled TV, which discards one of the chroma
7015 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
7016 optimized functions, otherwise, use plain C.
7017 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
7018 this option to override auto-detection.
7020 The larger n will speed up the filter at the expense of accuracy.
7021 The default value is n=3.
7022 If n is odd, a frame immediately following a frame marked with the
7023 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
7024 will not spend any time on soft-telecined MPEG-2 content.
7025 This is the only effect of this flag if MMX2 or 3DNow! is available.
7026 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
7028 If n=2 or 3, the number of luma levels used to find the frame breaks is
7029 reduced from 256 to 128, which results in a faster filter without losing
7031 If n=4 or 5, a faster, but much less accurate metric will be used to
7032 find the frame breaks, which is more likely to misdetect high vertical
7033 detail as interlaced content.
7035 If n is nonzero, print the detailed metrics for each frame.
7036 Useful for debugging.
7038 Deinterlace threshold.
7039 Used during de-interlacing of unmatched frames.
7040 Larger value means less deinterlacing, use n=256 to completely turn off
7044 Threshold for comparing a top and bottom fields.
7047 Threshold to detect temporal change of a field.
7050 Sum of Absolute Difference threshold, default is 64.
7055 This filter works only correct with MEncoder and acts on the MPEG-2 flags
7056 used for soft 3:2 pulldown (soft telecine).
7057 If you want to use the ivtc or detc filter on movies that are partly soft
7058 telecined, inserting this filter before them should make them more reliable.
7062 Inverse telecine for deinterlaced video.
7063 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
7064 using a method that keeps one field and interpolates the other, the result is
7065 a juddering video that has every fourth frame duplicated.
7066 This filter is intended to find and drop those duplicates and restore the
7067 original film framerate.
7068 When using this filter, you must specify \-ofps that is 4/5 of
7069 the fps of the input file and place the softskip later in the
7070 filter chain to make sure that divtc sees all the frames.
7071 Two different modes are available:
7072 One pass mode is the default and is straightforward to use,
7073 but has the disadvantage that any changes in the telecine
7074 phase (lost frames or bad edits) cause momentary judder
7075 until the filter can resync again.
7076 Two pass mode avoids this by analyzing the whole video
7077 beforehand so it will have forward knowledge about the
7078 phase changes and can resync at the exact spot.
7081 correspond to pass one and two of the encoding process.
7082 You must run an extra pass using divtc pass one before the
7083 actual encoding throwing the resulting video away.
7084 Use \-nosound \-ovc raw \-o /dev/null to avoid
7085 wasting CPU power for this pass.
7086 You may add something like crop=2:2:0:0 after divtc
7087 to speed things up even more.
7088 Then use divtc pass two for the actual encoding.
7089 If you use multiple encoder passes, use divtc
7090 pass two for all of them.
7095 .IPs file=<filename>
7096 Set the two pass log filename (default: "framediff.log").
7097 .IPs threshold=<value>
7098 Set the minimum strength the telecine pattern must have for the filter to
7099 believe in it (default: 0.5).
7100 This is used to avoid recognizing false pattern from the parts of the video
7101 that are very dark or very still.
7102 .IPs window=<numframes>
7103 Set the number of past frames to look at when searching for pattern
7105 Longer window improves the reliability of the pattern search, but shorter
7106 window improves the reaction time to the changes in the telecine phase.
7107 This only affects the one pass mode.
7108 The two pass mode currently uses fixed window that extends to both future
7110 .IPs phase=0|1|2|3|4
7111 Sets the initial telecine phase for one pass mode (default: 0).
7112 The two pass mode can see the future, so it is able to use the correct
7113 phase from the beginning, but one pass mode can only guess.
7114 It catches the correct phase when it finds it, but this option can be used
7115 to fix the possible juddering at the beginning.
7116 The first pass of the two pass mode also uses this, so if you save the output
7117 from the first pass, you get constant phase result.
7118 .IPs deghost=<value>
7119 Set the deghosting threshold (0\-255 for one pass mode, \-255\-255 for two pass
7121 If nonzero, deghosting mode is used.
7122 This is for video that has been deinterlaced by blending the fields
7123 together instead of dropping one of the fields.
7124 Deghosting amplifies any compression artifacts in the blended frames, so the
7125 parameter value is used as a threshold to exclude those pixels from
7126 deghosting that differ from the previous frame less than specified value.
7127 If two pass mode is used, then negative value can be used to make the
7128 filter analyze the whole video in the beginning of pass-2 to determine
7129 whether it needs deghosting or not and then select either zero or the
7130 absolute value of the parameter.
7131 Specify this option for pass-2, it makes no difference on pass-1.
7135 .B phase[=t|b|p|a|u|T|B|A|U][:v]
7136 Delay interlaced video by one field time so that the field order
7138 The intended use is to fix PAL movies that have been captured with the
7139 opposite field order to the film-to-video transfer.
7143 Capture field order top-first, transfer bottom-first.
7144 Filter will delay the bottom field.
7146 Capture bottom-first, transfer top-first.
7147 Filter will delay the top field.
7149 Capture and transfer with the same field order.
7150 This mode only exists for the documentation of the other options to refer to,
7151 but if you actually select it, the filter will faithfully do nothing ;-)
7153 Capture field order determined automatically by field flags, transfer opposite.
7154 Filter selects among t and b modes on a frame by frame basis using field flags.
7155 If no field information is available, then this works just like u.
7157 Capture unknown or varying, transfer opposite.
7158 Filter selects among t and b on a frame by frame basis by analyzing the
7159 images and selecting the alternative that produces best match between the
7162 Capture top-first, transfer unknown or varying.
7163 Filter selects among t and p using image analysis.
7165 Capture bottom-first, transfer unknown or varying.
7166 Filter selects among b and p using image analysis.
7168 Capture determined by field flags, transfer unknown or varying.
7169 Filter selects among t, b and p using field flags and image analysis.
7170 If no field information is available, then this works just like U.
7171 This is the default mode.
7173 Both capture and transfer unknown or varying.
7174 Filter selects among t, b and p using image analysis only.
7177 Prints the selected mode for each frame and the average squared difference
7178 between fields for t, b, and p alternatives.
7183 Apply 3:2 'telecine' process to increase framerate by 20%.
7184 This most likely will not work correctly with MPlayer, but it can
7185 be used with 'mencoder \-fps 30000/1001 \-ofps 30000/1001 \-vf telecine'.
7186 Both fps options are essential!
7187 (A/V sync will break if they are wrong.)
7188 The optional start parameter tells the filter where in the telecine
7189 pattern to start (0\-3).
7192 .B tinterlace[=mode]
7193 Temporal field interlacing \- merge pairs of frames into an interlaced
7194 frame, halving the framerate.
7195 Even frames are moved into the upper field, odd frames to the lower field.
7196 This can be used to fully reverse the effect of the tfields filter (in mode 0).
7197 Available modes are:
7201 Move odd frames into the upper field, even into the lower field, generating
7202 a full-height frame at half framerate.
7204 Only output odd frames, even frames are dropped; height unchanged.
7206 Only output even frames, odd frames are dropped; height unchanged.
7208 Expand each frame to full height, but pad alternate lines with black;
7209 framerate unchanged.
7211 Interleave even lines from even frames with odd lines from odd frames.
7212 Height unchanged at half framerate.
7217 .B tfields[=mode[:field_dominance]]
7218 Temporal field separation \- split fields into frames, doubling the
7220 Like the telecine filter, tfields might not work completely right unless
7221 used with MEncoder and both \-fps and \-ofps set to the
7222 desired (double) framerate!
7226 0: Leave fields unchanged (will jump/\:flicker).
7228 1: Interpolate missing lines. (The algorithm used might not be so good.)
7230 2: Translate fields by 1/4 pixel with linear interpolation (no jump).
7232 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default).
7233 .IPs <field_dominance>\ (DEPRECATED)
7235 Only works if the decoder exports the appropriate information and
7236 no other filters which discard that information come before tfields
7237 in the filter chain, otherwise it falls back to 0 (top field first).
7241 1: bottom field first
7244 This option will possibly be removed in a future version.
7245 Use \-field\-dominance instead.
7250 .B yadif=[mode[:field_dominance]]
7251 Yet another deinterlacing filter
7255 0: Output 1 frame for each frame.
7257 1: Output 1 frame for each field.
7259 2: Like 0 but skips spatial interlacing check.
7261 3: Like 1 but skips spatial interlacing check.
7262 .IPs <field_dominance>\ (DEPRECATED)
7263 Operates like tfields.
7266 This option will possibly be removed in a future version.
7267 Use \-field\-dominance instead.
7272 .B mcdeint=[mode[:parity[:qp]]]
7273 Motion compensating deinterlacer.
7274 It needs one field per frame as input and must thus be used together
7275 with tfields=1 or yadif=1/3 or equivalent.
7283 2: slow, iterative motion estimation
7285 3: extra slow, like 2 plus multiple reference frames
7287 0 or 1 selects which field to use (note: no autodetection yet!).
7289 Higher values should result in a smoother motion vector
7290 field but less optimal individual vectors.
7295 .B boxblur=radius:power[:radius:power]
7300 blur filter strength
7302 number of filter applications
7307 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
7312 blur filter strength (~0.1\-4.0) (slower if larger)
7314 prefilter strength (~0.1\-2.0)
7316 maximum difference between pixels to still be considered (~0.1\-100.0)
7321 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
7326 blur filter strength (~0.1\-5.0) (slower if larger)
7328 blur (0.0\-1.0) or sharpen (\-1.0\-0.0)
7330 filter all (0), filter flat areas (0\-30) or filter edges (\-30\-0)
7335 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
7336 Correct the perspective of movies not filmed perpendicular to the screen.
7340 coordinates of the top left, top right, bottom left, bottom right corners
7342 linear (0) or cubic resampling (1)
7348 Scale and smooth the image with the 2x scale and interpolate algorithm.
7352 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
7355 .B down3dright[=lines]
7356 Reposition and resize stereoscopic images.
7357 Extracts both stereo fields and places them side by side, resizing
7358 them to maintain the original movie aspect.
7362 number of lines to select from the middle of the image (default: 12)
7367 .B bmovl=hidden:opaque:fifo
7368 The bitmap overlay filter reads bitmaps from a FIFO and displays them
7369 on top of the movie, allowing some transformations on the image.
7370 Also see TOOLS/bmovl-test.c for a small bmovl test program.
7374 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
7376 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
7378 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the
7379 controlling application)
7388 .IPs "RGBA32 width height xpos ypos alpha clear"
7389 followed by width*height*4 Bytes of raw RGBA32 data.
7390 .IPs "ABGR32 width height xpos ypos alpha clear"
7391 followed by width*height*4 Bytes of raw ABGR32 data.
7392 .IPs "RGB24 width height xpos ypos alpha clear"
7393 followed by width*height*3 Bytes of raw RGB24 data.
7394 .IPs "BGR24 width height xpos ypos alpha clear"
7395 followed by width*height*3 Bytes of raw BGR24 data.
7396 .IPs "ALPHA width height xpos ypos alpha"
7397 Change alpha transparency of the specified area.
7398 .IPs "CLEAR width height xpos ypos"
7401 Disable all alpha transparency.
7402 Send "ALPHA 0 0 0 0 0" to enable it again.
7415 .IPs "<width>, <height>"
7417 .IPs "<xpos>, <ypos>"
7418 Start blitting at position x/y.
7420 Set alpha difference.
7421 If you set this to \-255 you can then send a sequence of ALPHA-commands to set
7422 the area to \-225, \-200, \-175 etc for a nice fade-in-effect! ;)
7426 255: Make everything opaque.
7428 \-255: Make everything transparent.
7431 Clear the framebuffer before blitting.
7433 0: The image will just be blitted on top of the old one, so you do not need to
7434 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
7442 .B framestep=I|[i]step
7443 Renders only every nth frame or every intra frame (keyframe).
7445 If you call the filter with I (uppercase) as the parameter, then
7447 keyframes are rendered.
7448 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB),
7449 for AVI it means every scene change or every keyint value (see \-lavcopts
7450 keyint= value if you use MEncoder to encode the video).
7452 When a keyframe is found, an 'I!' string followed by a newline character is
7453 printed, leaving the current line of MPlayer/\:MEncoder output on the screen,
7454 because it contains the time (in seconds) and frame number of the keyframe
7455 (You can use this information to split the AVI.).
7457 If you call the filter with a numeric parameter 'step' then only one in
7458 every 'step' frames is rendered.
7460 If you put an 'i' (lowercase) before the number then an 'I!' is printed
7461 (like the I parameter).
7463 If you give only the i then nothing is done to the frames, only I! is
7467 .B tile=xtiles:ytiles:output:start:delta
7468 Tile a series of images into a single, bigger image.
7469 If you omit a parameter or use a value less than 0, then the default
7471 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
7472 It is probably a good idea to put the scale filter before the tile :-)
7479 number of tiles on the x axis (default: 5)
7481 number of tiles on the y axis (default: 5)
7483 Render the tile when 'output' number of frames are reached, where 'output'
7484 should be a number less than xtile * ytile.
7485 Missing tiles are left blank.
7486 You could, for example, write an 8 * 7 tile every 50 frames to have one
7487 image every 2 seconds @ 25 fps.
7489 outer border thickness in pixels (default: 2)
7491 inner border thickness in pixels (default: 4)
7496 .B delogo[=x:y:w:h:t]
7497 Suppresses a TV station logo by a simple interpolation of the
7499 Just set a rectangle covering the logo and watch it disappear (and
7500 sometimes something even uglier appear \- your mileage may vary).
7504 top left corner of the logo
7506 width and height of the cleared rectangle
7508 Thickness of the fuzzy edge of the rectangle (added to w and h).
7509 When set to \-1, a green rectangle is drawn on the screen to
7510 simplify finding the right x,y,w,h parameters.
7515 .B remove\-logo=/path/to/logo_bitmap_file_name.pgm
7516 Suppresses a TV station logo, using a PGM or PPM image
7517 file to determine which pixels comprise the logo.
7518 The width and height of the image file must match
7519 those of the video stream being processed.
7520 Uses the filter image and a circular blur
7521 algorithm to remove the logo.
7523 .IPs /path/to/logo_bitmap_file_name.pgm
7524 [path] + filename of the filter image.
7528 .B zrmjpeg[=options]
7529 Software YV12 to MJPEG encoder for use with the zr2 video
7532 .IPs maxheight=<h>|maxwidth=<w>
7533 These options set the maximum width and height the zr card
7534 can handle (the MPlayer filter layer currently cannot query those).
7535 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
7536 Use these options to set maxwidth and maxheight automatically to the
7537 values known for card/\:mode combo.
7538 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL)
7540 Select color or black and white encoding.
7541 Black and white encoding is faster.
7542 Color is the default.
7544 Horizontal decimation 1, 2 or 4.
7546 Vertical decimation 1, 2 or 4.
7548 Set JPEG compression quality [BEST] 1 \- 20 [VERY BAD].
7550 By default, decimation is only performed if the Zoran hardware
7551 can upscale the resulting MJPEG images to the original size.
7552 The option fd instructs the filter to always perform the requested
7558 Allows acquiring screenshots of the movie using slave mode
7559 commands that can be bound to keypresses.
7560 See the slave mode documentation and the INTERACTIVE CONTROL
7561 section for details.
7562 Files named 'shotNNNN.png' will be saved in the working directory,
7563 using the first available number \- no files will be overwritten.
7564 The filter has no overhead when not used and accepts an arbitrary
7565 colorspace, so it is safe to add it to the configuration file.
7566 Make sure that the screenshot filter is added after all other filters
7567 whose effect you want to record on the saved image.
7568 E.g.\& it should be the last filter if you want to have an exact
7569 screenshot of what you see on the monitor.
7574 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
7575 Only useful with the \-ass option.
7580 .IPs "\-vf ass,screenshot"
7581 Moves SSA/ASS rendering before the screenshot filter.
7582 Screenshots taken this way will contain subtitles.
7587 .B blackframe[=amount:threshold]
7588 Detect frames that are (almost) completely black.
7589 Can be useful to detect chapter transitions or commercials.
7590 Output lines consist of the frame number of the detected frame, the
7591 percentage of blackness, the frame type and the frame number of the last
7592 encountered keyframe.
7595 Percentage of the pixels that have to be below the threshold (default: 98).
7597 Threshold below which a pixel value is considered black (default: 32).
7602 .B stereo3d[=in:out]
7603 Stereo3d converts between different stereoscopic image formats.
7606 Stereoscopic image format of input. Possible values:
7608 .B sbsl or side_by_side_left_first
7610 side by side parallel (left eye left, right eye right)
7612 .B sbsr or side_by_side_right_first
7614 side by side crosseye (right eye left, left eye right)
7616 .B abl or above_below_left_first
7618 above-below (left eye above, right eye below)
7620 .B abl or above_below_right_first
7622 above-below (right eye above, left eye below)
7624 .B ab2l or above_below_half_height_left_first
7626 above-below with half height resolution (left eye above, right eye below)
7628 .B ab2r or above_below_half_height_right_first
7630 above-below with half height resolution (right eye above, left eye below)
7634 Stereoscopic image format of output. Possible values are all the input formats
7637 .B arcg or anaglyph_red_cyan_gray
7639 anaglyph red/cyan gray (red filter on left eye, cyan filter on right eye)
7641 .B arch or anaglyph_red_cyan_half_color
7643 anaglyph red/cyan half colored (red filter on left eye, cyan filter on right
7646 .B arcc or anaglyph_red_cyan_color
7648 anaglyph red/cyan color (red filter on left eye, cyan filter on right eye)
7650 .B arcd or anaglyph_red_cyan_dubois
7652 anaglyph red/cyan color optimized with the least squares projection of dubois
7653 (red filter on left eye, cyan filter on right eye)
7655 .B agmg or anaglyph_green_magenta_gray
7657 anaglyph green/magenta gray (green filter on left eye, magenta filter on right
7660 .B agmh or anaglyph_green_magenta_half_color
7662 anaglyph green/magenta half colored (green filter on left eye, magenta filter on
7665 .B agmc or anaglyph_green_magenta_color
7667 anaglyph green/magenta colored (green filter on left eye, magenta filter on
7670 .B aybg or anaglyph_yellow_blue_gray
7672 anaglyph yellow/blue gray (yellow filter on left eye, blue filter on right eye)
7674 .B aybh or anaglyph_yellow_blue_half_color
7676 anaglyph yellow/blue half colored (yellow filter on left eye, blue filter on
7679 .B aybc or anaglyph_yellow_blue_color
7681 anaglyph yellow/blue colored (yellow filter on left eye, blue filter on right
7686 mono output (left eye only)
7690 mono output (right eye only)
7697 .B gradfun[=strength[:radius]]
7698 Fix the banding artifacts that are sometimes introduced into nearly flat
7699 regions by truncation to 8bit colordepth.
7700 Interpolates the gradients that should go where the bands are, and
7703 This filter is designed for playback only.
7704 Do not use it prior to lossy compression, because compression tends
7705 to lose the dither and bring back the bands.
7708 Maximum amount by which the filter will change any one pixel.
7709 Also the threshold for detecting nearly flat regions (default: 1.2).
7711 Neighborhood to fit the gradient to.
7712 Larger radius makes for smoother gradients, but also prevents the filter
7713 from modifying pixels near detailed regions (default: 16).
7718 Fixes the presentation timestamps (PTS) of the frames.
7719 By default, the PTS passed to the next filter is dropped, but the following
7720 options can change that:
7723 Print the incoming PTS.
7725 Specify a frame per second value.
7727 Specify an initial value for the PTS.
7731 incoming PTS as the initial PTS.
7732 All previous PTS are kept, so setting a huge value or \-1 keeps the PTS
7737 incoming PTS after the end of autostart to determine the framerate.
7745 .IPs "\-vf fixpts=fps=24000/1001,ass,fixpts"
7746 Generates a new sequence of PTS, uses it for ASS subtitles, then drops it.
7747 Generating a new sequence is useful when the timestamps are reset during the
7748 program; this is frequent on DVDs.
7749 Dropping it may be necessary to avoid confusing encoders.
7755 Using this filter together with any sort of seeking (including -ss and EDLs)
7756 may make demons fly out of your nose.
7760 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
7763 .B \-audio\-delay <any floating-point number>
7764 Delays either audio or video by setting a delay field in the header
7766 This does not delay either stream while encoding, but the player will
7767 see the delay field and compensate accordingly.
7768 Positive values delay the audio, and negative values delay the video.
7769 Note that this is the exact opposite of the \-delay option.
7770 For example, if a video plays correctly with \-delay 0.2, you can
7771 fix the video with MEncoder by using \-audio\-delay \-0.2.
7773 Currently, this option only works with the default muxer (\-of avi).
7774 If you are using a different muxer, then you must use \-delay instead.
7777 .B \-audio\-density <1\-50>
7778 Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
7781 CBR only, VBR ignores this as it puts each packet in a new chunk.
7784 .B \-audio\-preload <0.0\-2.0>
7785 Sets up the audio buffering time interval (default: 0.5s).
7788 .B \-fafmttag <format>
7789 Can be used to override the audio format tag of the output file.
7794 .IPs "\-fafmttag 0x55"
7795 Will have the output file contain 0x55 (mp3) as audio format tag.
7800 .B \-ffourcc <fourcc>
7801 Can be used to override the video fourcc of the output file.
7806 .IPs "\-ffourcc div3"
7807 Will have the output file contain 'div3' as video fourcc.
7812 .B \-force\-avi\-aspect <0.2\-3.0>
7813 Override the aspect stored in the AVI OpenDML vprp header.
7814 This can be used to change the aspect ratio with '\-ovc copy'.
7817 .B \-frameno\-file <filename> (DEPRECATED)
7818 Specify the name of the audio file with framenumber mappings created in
7819 the first (audio only) pass of a special three pass encoding mode.
7822 Using this mode will most likely give you A-V desync.
7824 It is kept for backwards compatibility only and will possibly
7825 be removed in a future version.
7829 Use a more precise, but much slower method for skipping areas.
7830 Areas marked for skipping are not seeked over, instead all
7831 frames are decoded, but only the necessary frames are encoded.
7832 This allows starting at non-keyframe boundaries.
7835 Not guaranteed to work right with '\-ovc copy'.
7838 .B \-info <option1:option2:...> (AVI only)
7839 Specify the info header of the resulting AVI file.
7841 Available options are:
7844 Show this description.
7848 artist or author of the work
7850 original work category
7851 .IPs subject=<value>
7852 contents of the work
7853 .IPs copyright=<value>
7854 copyright information
7855 .IPs srcform=<value>
7856 original format of the digitized material
7857 .IPs comment=<value>
7858 general comments about the work
7863 Do not automatically insert the expand filter into the MEncoder filter chain.
7864 Useful to control at which point of the filter chain subtitles are rendered
7865 when hardcoding subtitles onto a movie.
7869 Do not attempt to encode duplicate frames in duplicate; always output
7870 zero-byte frames to indicate duplicates.
7871 Zero-byte frames will be written anyway unless a filter or encoder
7872 capable of doing duplicate encoding is loaded.
7873 Currently the only such filter is harddup.
7876 .B \-noodml (\-of avi only)
7877 Do not write OpenDML index for AVI files >1GB.
7885 Outputs to the given filename.
7887 If you want a default output filename, you can put this option in the
7888 MEncoder config file.
7891 .B \-oac <codec name>
7892 Encode with the given audio codec (no default set).
7895 Use \-oac help to get a list of available audio codecs.
7901 no encoding, just streamcopy
7903 Encode to uncompressed PCM.
7904 .IPs "\-oac mp3lame"
7905 Encode to MP3 (using LAME).
7907 Encode with a libavcodec codec.
7912 .B \-of <format> (BETA CODE!)
7913 Encode to the specified container format (default: AVI).
7916 Use \-of help to get a list of available container formats.
7924 Encode to MPEG (also see \-mpegopts).
7926 Encode with libavformat muxers (also see \-lavfopts).
7927 .IPs "\-of rawvideo"
7928 raw video stream (no muxing \- one video stream only)
7929 .IPs "\-of rawaudio"
7930 raw audio stream (no muxing \- one audio stream only)
7936 Specify a frames per second (fps) value for the output file,
7937 which can be different from that of the source material.
7938 Must be set for variable fps (ASF, some MOV) and progressive
7939 (30000/1001 fps telecined MPEG) files.
7942 .B \-ovc <codec name>
7943 Encode with the given video codec (no default set).
7946 Use \-ovc help to get a list of available video codecs.
7952 no encoding, just streamcopy
7954 Encode to an arbitrary uncompressed format (use '\-vf format' to select).
7956 Encode with a libavcodec codec.
7961 .B \-passlogfile <filename>
7962 Dump first pass information to <filename> instead of the default divx2pass.log
7963 in two pass encoding mode.
7966 .B \-skiplimit <value>
7967 Specify the maximum number of frames that may be skipped after
7968 encoding one frame (\-noskiplimit for unlimited).
7971 .B \-vobsubout <basename>
7972 Specify the basename for the output .idx and .sub files.
7973 This turns off subtitle rendering in the encoded movie and diverts it to
7974 VOBsub subtitle files.
7977 .B \-vobsuboutid <langid>
7978 Specify the language two letter code for the subtitles.
7979 This overrides what is read from the DVD or the .ifo file.
7982 .B \-vobsuboutindex <index>
7983 Specify the index of the subtitles in the output files (default: 0).
7987 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
7988 You can specify codec specific encoding parameters using the following
7992 .B \-<codec>opts <option1[=value1]:option2[=value2]:...>
7995 Where <codec> may be: lavc, xvidenc, mp3lame, toolame, twolame,
7996 nuv, xvfw, faac, x264enc, mpeg, lavf.
7999 .SS mp3lame (\-lameopts)
8007 variable bitrate method
8030 Also forces CBR mode encoding on subsequent ABR presets modes.
8034 bitrate in kbps (CBR and ABR only)
8038 quality (0 \- highest, 9 \- lowest) (VBR only)
8042 algorithmic quality (0 \- best/slowest, 9 \- worst/fastest)
8083 Switch on faster encoding on subsequent VBR presets modes.
8084 This results in slightly lower quality and higher bitrates.
8087 .B highpassfreq=<freq>
8088 Set a highpass filtering frequency in Hz.
8089 Frequencies below the specified one will be cut off.
8090 A value of \-1 will disable filtering, a value of 0
8091 will let LAME choose values automatically.
8094 .B lowpassfreq=<freq>
8095 Set a lowpass filtering frequency in Hz.
8096 Frequencies above the specified one will be cut off.
8097 A value of \-1 will disable filtering, a value of 0
8098 will let LAME choose values automatically.
8105 Print additional options and information about presets settings.
8107 VBR encoding, good quality, 150\-180 kbps bitrate range
8109 VBR encoding, high quality, 170\-210 kbps bitrate range
8111 VBR encoding, very high quality, 200\-240 kbps bitrate range
8113 CBR encoding, highest preset quality, 320 kbps bitrate
8115 ABR encoding at average given kbps bitrate
8123 .IPs fast:preset=standard
8124 suitable for most people and most music types and already quite high quality
8126 Encode with ABR presets at a 192 kbps forced constant bitrate.
8128 Encode with ABR presets at a 172 kbps average bitrate.
8130 for people with extremely good hearing and similar equipment
8135 .SS toolame and twolame (\-toolameopts and \-twolameopts respectively)
8139 In CBR mode this parameter indicates the bitrate in kbps,
8140 when in VBR mode it is the minimum bitrate allowed per frame.
8141 VBR mode will not work with a value below 112.
8144 .B vbr=<\-50\-50> (VBR only)
8145 variability range; if negative the encoder shifts the average bitrate
8146 towards the lower limit, if positive towards the higher.
8147 When set to 0 CBR is used (default).
8150 .B maxvbr=<32\-384> (VBR only)
8151 maximum bitrate allowed per frame, in kbps
8154 .B mode=<stereo | jstereo | mono | dual>
8155 (default: mono for 1-channel audio, stereo otherwise)
8159 psychoacoustic model (default: 2)
8163 Include error protection.
8172 .SS faac (\-faacopts)
8176 average bitrate in kbps (mutually exclusive with quality)
8179 .B quality=<1\-1000>
8180 quality mode, the higher the better (mutually exclusive with br)
8184 object type complexity
8194 LTP (extremely slow)
8200 MPEG version (default: 4)
8204 Enables temporal noise shaping.
8207 .B cutoff=<0\-sampling_rate/2>
8208 cutoff frequency (default: sampling_rate/2)
8212 Stores the bitstream as raw payload with extradata in the container header
8213 (default: 0, corresponds to ADTS).
8214 Do not set this flag if not explicitly required or you will not be able to
8215 remux the audio stream later on.
8220 .SS lavc (\-lavcopts)
8222 Many libavcodec (lavc for short) options are tersely documented.
8223 Read the source for full details.
8228 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
8233 .B o=<key>=<value>[,<key>=<value>[,...]]
8234 Pass AVOptions to libavcodec encoder.
8235 Note, a patch to make the o= unneeded and pass all unknown options through
8236 the AVOption system is welcome.
8237 A full list of AVOptions can be found in the FFmpeg manual.
8238 Note that some AVOptions may conflict with MEncoder options.
8251 audio codec (default: mp2)
8255 Dolby Digital (AC-3)
8257 Adaptive PCM formats \- see the HTML documentation for details.
8259 Free Lossless Audio Codec (FLAC)
8263 Advanced Audio Coding (AAC) \- using FAAC
8265 MPEG-1 audio layer 3 (MP3) \- using LAME
8267 MPEG-1 audio layer 2 (MP2)
8269 PCM formats \- see the HTML documentation for details.
8271 Id Software RoQ DPCM
8273 experimental simple lossy codec
8275 experimental simple lossless codec
8279 Windows Media Audio v1
8281 Windows Media Audio v2
8287 audio bitrate in kbps (default: 224)
8291 Use the specified Windows audio format tag (e.g.\& atag=0x55).
8295 Use only bit exact algorithms (except (I)DCT).
8296 Additionally bit_exact disables several optimizations and thus
8297 should only be used for regression tests, which need binary
8298 identical files even if the encoder version changes.
8299 This also suppresses the user_data header in MPEG-4 streams.
8300 Do not use this option unless you know exactly what you are doing.
8304 Maximum number of threads to use (default: 1).
8305 May have a slight negative effect on motion estimation.
8310 Employ the specified codec (default: mpeg4).
8320 FFmpeg's lossless video codec
8322 nonstandard 20% smaller HuffYUV using YV12
8324 Sorenson H.263 used in Flash Video
8336 x264 H.264/AVC MPEG-4 Part 10
8338 Xvid MPEG-4 Part 2 (ASP)
8354 ID Software RoQ Video
8356 an old RealVideo codec
8357 .IPs "snow (also see: vstrict)"
8358 FFmpeg's experimental wavelet-based codec
8360 Apple Sorenson Video 1
8362 Windows Media Video, version 1 (AKA WMV7)
8364 Windows Media Video, version 2 (AKA WMV8)
8373 Not recommended (much larger file, little quality difference and weird side
8374 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
8375 resulting in lower quality and some decoders will not be able to decode it).
8377 Recommended for normal mpeg4/\:mpeg1video encoding (default).
8379 Recommended for h263(p)/\:msmpeg4.
8380 The reason for preferring 3 over 2 is that 2 could lead to overflows.
8381 (This will be fixed for h263(p) by changing the quantizer per MB in
8382 the future, msmpeg4 cannot be fixed as it does not support that.)
8386 .B lmin=<0.01\-255.0>
8387 Minimum frame-level Lagrange multiplier for ratecontrol (default: 2.0).
8388 Lavc will rarely use quantizers below the value of lmin.
8389 Lowering lmin will make lavc more likely to choose lower quantizers for
8390 some frames, but not lower than the value of vqmin.
8391 Likewise, raising lmin will make lavc less likely to choose low
8392 quantizers, even if vqmin would have allowed them.
8393 You probably want to set lmin approximately equal to vqmin.
8394 When adaptive quantization is in use, changing lmin/lmax may have less
8395 of an effect; see mblmin/mblmax.
8399 .B lmax=<0.01\-255.0>
8400 maximum Lagrange multiplier for ratecontrol (default: 31.0)
8404 .B mblmin=<0.01\-255.0>
8405 Minimum macroblock-level Lagrange multiplier for ratecontrol
8407 This parameter affects adaptive quantization options like qprd,
8412 .B mblmax=<0.01\-255.0>
8413 Maximum macroblock-level Lagrange multiplier for ratecontrol
8419 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
8420 A lower value means better quality but larger files (default: \-1).
8421 In case of snow codec, value 0 means lossless encoding.
8422 Since the other codecs do not support this, vqscale=0 will have an undefined
8424 1 is not recommended (see vqmin for details).
8428 Maximum quantizer, 10\-31 should be a sane range (default: 31).
8440 maximum quantizer difference between consecutive I- or P-frames
8444 .B vmax_b_frames=<0\-4>
8445 maximum number of B-frames between non-B-frames:
8449 no B-frames (default)
8451 sane range for MPEG-4
8457 motion estimation method.
8458 Available methods are:
8462 none (very low quality)
8464 full (slow, currently unmaintained and disabled)
8466 log (low quality, currently unmaintained and disabled)
8468 phods (low quality, currently unmaintained and disabled)
8470 EPZS: size=1 diamond, size can be adjusted with the *dia options
8473 X1 (experimental, currently aliased to EPZS)
8475 iter (iterative overlapped block, only used in snow)
8482 0\-3 currently ignores the amount of bits spent,
8483 so quality may be low.
8487 .B me_range=<0\-9999>
8488 motion estimation search range (default: 0 (unlimited))
8491 .B mbd=<0\-2> (also see *cmp, qpel)
8492 Macroblock decision algorithm (high quality mode), encode each macro
8493 block in all modes and choose the best.
8494 This is slow but results in better quality and file size.
8495 When mbd is set to 1 or 2, the value of mbcmp is ignored when comparing
8496 macroblocks (the mbcmp value is still used in other places though, in particular
8497 the motion search algorithms).
8498 If any comparison setting (precmp, subcmp, cmp, or mbcmp) is nonzero,
8499 however, a slower but better half-pel motion search will be used,
8500 regardless of what mbd is set to.
8501 If qpel is set, quarter-pel motion search will be used regardless.
8505 Use comparison function given by mbcmp (default).
8507 Select the MB mode which needs the fewest bits (=vhq).
8509 Select the MB mode which has the best rate distortion.
8515 Same as mbd=1, kept for compatibility reasons.
8519 Allow 4 motion vectors per macroblock (slightly better quality).
8520 Works better if used with mbd>0.
8524 overlapped block motion compensation (H.263+)
8528 loop filter (H.263+)
8529 note, this is broken
8532 .B inter_threshold <\-1000\-1000>
8533 Does absolutely nothing at the moment.
8537 maximum interval between keyframes in frames (default: 250 or one
8538 keyframe every ten seconds in a 25fps movie.
8539 This is the recommended default for MPEG-4).
8540 Most codecs require regular keyframes in order to limit the accumulation of mismatch error.
8541 Keyframes are also needed for seeking, as seeking is only possible to a keyframe \- but
8542 keyframes need more space than other frames, so larger numbers here mean
8543 slightly smaller files but less precise seeking.
8544 0 is equivalent to 1, which makes every frame a keyframe.
8545 Values >300 are not recommended as the quality might be bad depending upon
8546 decoder, encoder and luck.
8547 It is common for MPEG-1/2 to use values <=30.
8550 .B sc_threshold=<\-1000000000\-1000000000>
8551 Threshold for scene change detection.
8552 A keyframe is inserted by libavcodec when it detects a scene change.
8553 You can specify the sensitivity of the detection with this option.
8554 \-1000000000 means there is a scene change detected at every frame,
8555 1000000000 means no scene changes are detected (default: 0).
8558 .B sc_factor=<any positive integer>
8559 Causes frames with higher quantizers to be more likely to trigger a
8560 scene change detection and make libavcodec use an I-frame (default: 1).
8561 1\-16 is a sane range.
8562 Values between 2 and 6 may yield increasing PSNR (up to approximately
8563 0.04 dB) and better placement of I-frames in high-motion scenes.
8564 Higher values than 6 may give very slightly better PSNR (approximately
8565 0.01 dB more than sc_factor=6), but noticably worse visual quality.
8568 .B vb_strategy=<0\-2> (pass one only)
8569 strategy to choose between I/P/B-frames:
8573 Always use the maximum number of B-frames (default).
8575 Avoid B-frames in high motion scenes.
8576 See the b_sensitivity option to tune this strategy.
8578 Places B-frames more or less optimally to yield maximum quality (slower).
8579 You may want to reduce the speed impact of this option by tuning the
8585 .B b_sensitivity=<any integer greater than 0>
8586 Adjusts how sensitively vb_strategy=1 detects motion and avoids using
8587 B-frames (default: 40).
8588 Lower sensitivities will result in more B-frames.
8589 Using more B-frames usually improves PSNR, but too many B-frames can
8590 hurt quality in high-motion scenes.
8591 Unless there is an extremely high amount of motion, b_sensitivity can
8592 safely be lowered below the default; 10 is a reasonable value in most
8596 .B brd_scale=<0\-10>
8597 Downscales frames for dynamic B-frame decision (default: 0).
8598 Each time brd_scale is increased by one, the frame dimensions are
8599 divided by two, which improves speed by a factor of four.
8600 Both dimensions of the fully downscaled frame must be even numbers, so
8601 brd_scale=1 requires the original dimensions to be multiples of four,
8602 brd_scale=2 requires multiples of eight, etc.
8603 In other words, the dimensions of the original frame must both be
8604 divisible by 2^(brd_scale+1) with no remainder.
8607 .B bidir_refine=<0\-4>
8608 Refine the two motion vectors used in bidirectional macroblocks,
8609 rather than re-using vectors from the forward and backward searches.
8610 This option has no effect without B-frames.
8616 Use a wider search (larger values are slower).
8622 Activates internal two (or more) pass mode, only specify if you wish to
8623 use two (or more) pass encoding.
8627 first pass (also see turbo)
8631 Nth pass (second and subsequent passes of N-pass encoding)
8634 Here is how it works, and how to use it:
8636 The first pass (vpass=1) writes the statistics file.
8637 You might want to deactivate some CPU-hungry options, like "turbo"
8640 In two pass mode, the second pass (vpass=2) reads the statistics file and
8641 bases ratecontrol decisions on it.
8643 In N-pass mode, the second pass (vpass=3, that is not a typo)
8644 does both: It first reads the statistics, then overwrites them.
8645 You might want to backup divx2pass.log before doing this if there is
8646 any possibility that you will have to cancel MEncoder.
8647 You can use all encoding options, except very CPU-hungry options like "qns".
8649 You can run this same pass over and over to refine the encode.
8650 Each subsequent pass will use the statistics from the previous pass to improve.
8651 The final pass can include any CPU-hungry encoding options.
8653 If you want a 2 pass encode, use first vpass=1, and then vpass=2.
8655 If you want a 3 or more pass encode, use vpass=1 for the first pass
8656 and then vpass=3 and then vpass=3 again and again until you are
8657 satisfied with the encode.
8669 Encodes with an optimal Huffman table based upon statistics
8670 from the first pass.
8675 .B turbo (two pass only)
8676 Dramatically speeds up pass one using faster algorithms and disabling
8677 CPU-intensive options.
8678 This will probably reduce global PSNR a little bit (around 0.01dB) and
8679 change individual frame type and PSNR a little bit more (up to 0.03dB).
8683 Store movie aspect internally, just like with MPEG files.
8684 Much nicer than rescaling, because quality is not decreased.
8685 Only MPlayer will play these files correctly, other players will display
8686 them with wrong aspect.
8687 The aspect parameter can be given as a ratio or a floating point number.
8694 .IPs "aspect=16/9 or aspect=1.78"
8700 Same as the aspect option, but automatically computes aspect, taking
8701 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
8703 Does not incur a performance penalty, so you can safely leave it
8708 Specify bitrate (default: 800).
8716 .IPs 16001\-24000000
8723 approximated file size tolerance in kbit.
8724 1000\-100000 is a sane range.
8725 (warning: 1kbit = 1000 bits)
8729 vratetol should not be too large during the second pass or there might
8730 be problems if vrc_(min|max)rate is used.
8733 .B vrc_maxrate=<value>
8734 maximum bitrate in kbit/\:sec
8735 (default: 0, unlimited)
8738 .B vrc_minrate=<value>
8739 minimum bitrate in kbit/\:sec
8740 (default: 0, unlimited)
8743 .B vrc_buf_size=<value>
8745 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
8746 917 for SVCD and 1835 for DVD.
8749 .B vrc_buf_aggressivity
8755 Note that some of the ratecontrol-affecting options will have no effect
8756 if vrc_strategy is not set to 0.
8760 Use internal lavc ratecontrol (default).
8762 Use Xvid ratecontrol (experimental; requires MEncoder to be compiled
8763 with support for Xvid 1.1 or higher).
8768 .B vb_qfactor=<\-31.0\-31.0>
8769 quantizer factor between B- and non-B-frames (default: 1.25)
8772 .B vi_qfactor=<\-31.0\-31.0>
8773 quantizer factor between I- and non-I-frames (default: 0.8)
8776 .B vb_qoffset=<\-31.0\-31.0>
8777 quantizer offset between B- and non-B-frames (default: 1.25)
8780 .B vi_qoffset=<\-31.0\-31.0>
8783 if v{b|i}_qfactor > 0
8785 I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
8789 do normal ratecontrol (do not lock to next P-frame quantizer) and
8790 set q= \-q * v{b|i}_qfactor + v{b|i}_qoffset
8793 To do constant quantizer encoding with different quantizers for
8794 I/P- and B-frames you can use:
8795 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>.
8798 .B vqblur=<0.0\-1.0> (pass one)
8799 Quantizer blur (default: 0.5), larger values will average the
8800 quantizer more over time (slower change).
8804 Quantizer blur disabled.
8806 Average the quantizer over all previous frames.
8811 .B vqblur=<0.0\-99.0> (pass two)
8812 Quantizer gaussian blur (default: 0.5), larger values will average
8813 the quantizer more over time (slower change).
8816 .B vqcomp=<0.0\-1.0>
8817 Quantizer compression, vrc_eq depends upon this (default: 0.5).
8819 Perceptual quality will be optimal somewhere in between the range's extremes.
8822 .B vrc_eq=<equation>
8823 main ratecontrol equation
8826 .IPs 1+(tex/\:avgTex-1)*qComp
8827 approximately the equation of the old ratecontrol code
8829 with qcomp 0.5 or something like that (default)
8846 intra, non-intra texture complexity
8848 average texture complexity
8850 average intra texture complexity in I-frames
8852 average intra texture complexity in P-frames
8854 average non-intra texture complexity in P-frames
8856 average non-intra texture complexity in B-frames
8858 bits used for motion vectors
8860 maximum length of motion vector in log2 scale
8862 number of intra macroblocks / number of macroblocks
8868 qcomp from the command line
8869 .IPs "isI, isP, isB"
8870 Is 1 if picture type is I/P/B else 0.
8872 See your favorite math book.
8879 .IPs max(a,b),min(a,b)
8882 is 1 if a>b, 0 otherwise
8884 is 1 if a<b, 0 otherwise
8886 is 1 if a==b, 0 otherwise
8887 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
8891 .B vrc_override=<options>
8892 User specified quality for specific parts (ending, credits, ...).
8893 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
8894 <end-frame>, <quality>[/...]]:
8897 .IPs "quality (2\-31)"
8899 .IPs "quality (\-500\-0)"
8900 quality correction in %
8905 .B vrc_init_cplx=<0\-1000>
8906 initial complexity (pass 1)
8909 .B vrc_init_occupancy=<0.0\-1.0>
8910 initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9)
8914 Specify how to keep the quantizer between qmin and qmax.
8920 Use a nice differentiable function (default).
8925 .B vlelim=<\-1000\-1000>
8926 Sets single coefficient elimination threshold for luminance.
8927 Negative values will also consider the DC coefficient (should be at least \-4
8928 or lower for encoding at quant=1):
8939 .B vcelim=<\-1000\-1000>
8940 Sets single coefficient elimination threshold for chrominance.
8941 Negative values will also consider the DC coefficient (should be at least \-4
8942 or lower for encoding at quant=1):
8953 .B vstrict=<\-2|\-1|0|1>
8954 strict standard compliance
8960 Only recommended if you want to feed the output into the
8961 MPEG-4 reference decoder.
8963 Allow libavcodec specific extensions (default).
8965 Enables experimental codecs and features which may not be playable
8966 with future MPlayer versions (snow).
8973 Adds 2 Bytes per video packet, improves error-resistance when transferring over
8974 unreliable channels (e.g.\& streaming over the internet).
8975 Each video packet will be encoded in 3 separate partitions:
8980 .IPs "2. DC coefficients"
8982 .IPs "3. AC coefficients"
8987 MV & DC are most important, losing them looks far worse than losing
8988 the AC and the 1. & 2. partition.
8989 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors
8990 will hit the AC partition much more often than the MV & DC partitions.
8991 Thus, the picture will look better with partitioning than without,
8992 as without partitioning an error will trash AC/\:DC/\:MV equally.
8996 .B vpsize=<0\-10000> (also see vdpart)
8997 Video packet size, improves error-resistance.
9009 slice structured mode for H.263+
9013 grayscale only encoding (faster)
9021 Automatically select a good one (default).
9042 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests.
9046 Automatically select a good one (default).
9048 JPEG reference integer
9054 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100)
9085 .B lumi_mask=<0.0\-1.0>
9086 Luminance masking is a 'psychosensory' setting that is supposed to
9087 make use of the fact that the human eye tends to notice fewer details
9088 in very bright parts of the picture.
9089 Luminance masking compresses bright areas stronger than medium ones,
9090 so it will save bits that can be spent again on other frames, raising
9091 overall subjective quality, while possibly reducing PSNR.
9094 Be careful, overly large values can cause disastrous things.
9097 Large values might look good on some monitors but may look horrible
9109 .B dark_mask=<0.0\-1.0>
9110 Darkness masking is a 'psychosensory' setting that is supposed to
9111 make use of the fact that the human eye tends to notice fewer details
9112 in very dark parts of the picture.
9113 Darkness masking compresses dark areas stronger than medium ones,
9114 so it will save bits that can be spent again on other frames, raising
9115 overall subjective quality, while possibly reducing PSNR.
9118 Be careful, overly large values can cause disastrous things.
9121 Large values might look good on some monitors but may look horrible
9122 on other monitors / TV / TFT.
9133 .B tcplx_mask=<0.0\-1.0>
9134 Temporal complexity masking (default: 0.0 (disabled)).
9135 Imagine a scene with a bird flying across the whole scene; tcplx_mask
9136 will raise the quantizers of the bird's macroblocks (thus decreasing their
9137 quality), as the human eye usually does not have time to see all the bird's
9139 Be warned that if the masked object stops (e.g.\& the bird lands) it is
9140 likely to look horrible for a short period of time, until the encoder
9141 figures out that the object is not moving and needs refined blocks.
9142 The saved bits will be spent on other parts of the video, which may increase
9143 subjective quality, provided that tcplx_mask is carefully chosen.
9146 .B scplx_mask=<0.0\-1.0>
9147 Spatial complexity masking.
9148 Larger values help against blockiness, if no deblocking filter is used for
9149 decoding, which is maybe not a good idea.
9151 Imagine a scene with grass (which usually has great spatial complexity),
9152 a blue sky and a house; scplx_mask will raise the quantizers of the grass'
9153 macroblocks, thus decreasing its quality, in order to spend more bits on
9154 the sky and the house.
9157 Crop any black borders completely as they will reduce the quality
9158 of the macroblocks (also applies without scplx_mask).
9170 This setting does not have the same effect as using a custom matrix that
9171 would compress high frequencies harder, as scplx_mask will reduce the
9172 quality of P blocks even if only DC is changing.
9173 The result of scplx_mask will probably not look as good.
9177 .B p_mask=<0.0\-1.0> (also see vi_qfactor)
9178 Reduces the quality of inter blocks.
9179 This is equivalent to increasing the quality of intra blocks, because the
9180 same average bitrate will be distributed by the rate controller to the
9181 whole video sequence (default: 0.0 (disabled)).
9182 p_mask=1.0 doubles the bits allocated to each intra block.
9185 .B border_mask=<0.0\-1.0>
9186 border-processing for MPEG-style encoders.
9187 Border processing increases the quantizer for macroblocks which are less
9188 than 1/5th of the frame width/height away from the frame border,
9189 since they are often visually less important.
9193 Normalize adaptive quantization (experimental).
9194 When using adaptive quantization (*_mask), the average per-MB quantizer may no
9195 longer match the requested frame-level quantizer.
9196 Naq will attempt to adjust the per-MB quantizers to maintain the proper
9205 Use interlaced motion estimation (mutually exclusive with qpel).
9209 Use alternative scantable.
9212 .B "top=<\-1\-1>\ \ \ "
9233 for HuffYUV, lossless JPEG, dv and ffv1
9235 for lossless JPEG, dv and ffv1
9237 for lossless JPEG, ffv1 and svq1
9239 for lossless JPEG and ffv1
9251 plane/\:gradient prediction
9269 plane/\:gradient prediction
9281 vlc coding (Golomb-Rice)
9283 arithmetic coding (CABAC)
9305 predetermined Huffman tables (builtin or two pass)
9307 adaptive Huffman tables
9313 Use quarter pel motion compensation (mutually exclusive with ilme).
9316 This seems only useful for high bitrate encodings.
9320 Sets the comparison function for the macroblock decision, has only
9322 This is also used for some motion search functions, in which case
9323 it has an effect regardless of mbd setting.
9327 sum of absolute differences, fast (default)
9329 sum of squared errors
9331 sum of absolute Hadamard transformed differences
9333 sum of absolute DCT transformed differences
9335 sum of squared quantization errors (avoid, low quality)
9337 number of bits needed for the block
9339 rate distortion optimal, slow
9343 sum of absolute vertical differences
9345 sum of squared vertical differences
9347 noise preserving sum of squared differences
9349 5/3 wavelet, only used in snow
9351 9/7 wavelet, only used in snow
9353 Also use chroma, currently does not work (correctly) with B-frames.
9358 .B ildctcmp=<0\-2000>
9359 Sets the comparison function for interlaced DCT decision
9360 (see mbcmp for available comparison functions).
9364 Sets the comparison function for motion estimation pre pass
9365 (see mbcmp for available comparison functions) (default: 0).
9369 Sets the comparison function for full pel motion estimation
9370 (see mbcmp for available comparison functions) (default: 0).
9374 Sets the comparison function for sub pel motion estimation
9375 (see mbcmp for available comparison functions) (default: 0).
9378 .B skipcmp=<0\-2000>
9379 FIXME: Document this.
9382 .B nssew=<0\-1000000>
9383 This setting controls NSSE weight, where larger weights will result in
9385 0 NSSE is identical to SSE
9386 You may find this useful if you prefer to keep some noise in your encoded
9387 video rather than filtering it away before encoding (default: 8).
9391 diamond type and size for motion estimation pre-pass
9395 Diamond type & size for motion estimation.
9396 Motion search is an iterative process.
9397 Using a small diamond does not limit the search to finding only small
9399 It is just somewhat more likely to stop before finding the very best motion
9400 vector, especially when noise is involved.
9401 Bigger diamonds allow a wider search for the best motion vector, thus are
9402 slower but result in better quality.
9404 Big normal diamonds are better quality than shape-adaptive diamonds.
9406 Shape-adaptive diamonds are a good tradeoff between speed and quality.
9409 The sizes of the normal diamonds and shape adaptive ones do not have
9413 shape adaptive (fast) diamond with size 3
9415 shape adaptive (fast) diamond with size 2
9417 uneven multi-hexagon search (slow)
9419 normal size=1 diamond (default) =EPZS type diamond
9427 normal size=2 diamond
9440 Trellis searched quantization.
9441 This will find the optimal encoding for each 8x8 block.
9442 Trellis searched quantization is quite simply an optimal quantization in
9443 the PSNR versus bitrate sense (Assuming that there would be no rounding
9444 errors introduced by the IDCT, which is obviously not the case.).
9445 It simply finds a block for the minimum of error and lambda*bits.
9449 quantization parameter (QP) dependent constant
9451 amount of bits needed to encode the block
9453 sum of squared errors of the quantization
9459 Rate distorted optimal coded block pattern.
9460 Will select the coded block pattern which minimizes distortion + lambda*rate.
9461 This can only be used together with trellis quantization.
9465 Try to encode each MB with MV=<0,0> and choose the better one.
9466 This has no effect if mbd=0.
9469 .B mv0_threshold=<any non-negative integer>
9470 When surrounding motion vectors are <0,0> and the motion estimation
9471 score of the current block is less than mv0_threshold, <0,0> is used for
9472 the motion vector and further motion estimation is skipped (default:
9474 Lowering mv0_threshold to 0 can give a slight (0.01dB) PSNR increase and
9475 possibly make the encoded video look slightly better; raising
9476 mv0_threshold past 320 results in diminished PSNR and visual quality.
9477 Higher values speed up encoding very slightly (usually less than 1%,
9478 depending on the other options used).
9481 This option does not require mv0 to be enabled.
9484 .B qprd (mbd=2 only)
9485 rate distorted optimal quantization parameter (QP) for the given
9486 lambda of each macroblock
9489 .B last_pred=<0\-99>
9490 amount of motion predictors from the previous frame
9496 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the
9503 motion estimation pre-pass
9509 only after I-frames (default)
9517 subpel refinement quality (for qpel) (default: 8 (high quality))
9520 This has a significant effect on speed.
9524 number of reference frames to consider for motion compensation
9525 (Snow only) (default: 1)
9529 print the PSNR (peak signal to noise ratio) for the whole video after encoding
9530 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
9531 Returned values are in dB (decibel), the higher the better.
9535 Use MPEG quantizers instead of H.263.
9539 Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+.
9540 This will improve quality very slightly (around 0.02 dB PSNR) and slow
9541 down encoding very slightly (about 1%).
9544 vqmin should be 8 or larger for H.263+ AIC.
9548 alternative inter vlc for H.263+
9552 unlimited MVs (H.263+ only)
9553 Allows encoding of arbitrarily long MVs.
9556 .B ibias=<\-256\-256>
9557 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
9558 H.263 style quantizer default: 0)
9561 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
9562 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
9565 .B pbias=<\-256\-256>
9566 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
9567 H.263 style quantizer default: \-64)
9570 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
9571 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
9574 A more positive bias (\-32 \- \-16 instead of \-64) seems to improve the PSNR.
9578 Noise reduction, 0 means disabled.
9579 0\-600 is a useful range for typical content, but you may want to turn it
9580 up a bit more for very noisy content (default: 0).
9581 Given its small impact on speed, you might want to prefer to use this over
9582 filtering noise away with video filters like denoise3d or hqdn3d.
9586 Quantizer noise shaping.
9587 Rather than choosing quantization to most closely match the source video
9588 in the PSNR sense, it chooses quantization such that noise (usually ringing)
9589 will be masked by similar-frequency content in the image.
9590 Larger values are slower but may not result in better quality.
9591 This can and should be used together with trellis quantization, in which case
9592 the trellis quantization (optimal for constant weight) will be used as
9593 startpoint for the iterative search.
9599 Only lower the absolute value of coefficients.
9601 Only change coefficients before the last non-zero coefficient + 1.
9608 .B inter_matrix=<comma separated matrix>
9609 Use custom inter matrix.
9610 It needs a comma separated string of 64 integers.
9613 .B intra_matrix=<comma separated matrix>
9614 Use custom intra matrix.
9615 It needs a comma separated string of 64 integers.
9619 experimental quantizer modulation
9623 experimental quantizer modulation
9627 intra DC precision in bits (default: 8).
9628 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
9631 .B cgop (also see sc_threshold)
9633 Currently it only works if scene change detection is disabled
9634 (sc_threshold=1000000000).
9638 Enable Global Motion Compensation.
9642 Sets the low delay flag for MPEG-1/2 (disables B-frames).
9646 Control writing global video headers.
9650 Codec decides where to write global headers (default).
9652 Write global headers only in extradata (needed for .mp4/MOV/NUT).
9654 Write global headers only in front of keyframes.
9662 Same as vglobal for audio headers.
9666 Set CodecContext Level.
9667 Use 31 or 41 to play video on a Playstation 3.
9670 .B skip_exp=<0\-1000000>
9671 FIXME: Document this.
9674 .B skip_factor=<0\-1000000>
9675 FIXME: Document this.
9678 .B skip_threshold=<0\-1000000>
9679 FIXME: Document this.
9684 Nuppel video is based on RTJPEG and LZO.
9685 By default frames are first encoded with RTJPEG and then compressed with LZO,
9686 but it is possible to disable either or both of the two passes.
9687 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG,
9688 or the default LZO compressed RTJPEG.
9691 The nuvrec documentation contains some advice and examples about the
9692 settings to use for the most common TV encodings.
9696 chrominance threshold (default: 1)
9700 luminance threshold (default: 1)
9704 Enable LZO compression (default).
9708 Disable LZO compression.
9712 quality level (default: 255)
9716 Disable RTJPEG encoding.
9720 Enable RTJPEG encoding (default).
9723 .SS xvidenc (\-xvidencopts)
9725 There are three modes available: constant bitrate (CBR), fixed quantizer and
9730 Specify the pass in two pass mode.
9733 .B turbo (two pass only)
9734 Dramatically speeds up pass one using faster algorithms and disabling
9735 CPU-intensive options.
9736 This will probably reduce global PSNR a little bit and change individual
9737 frame type and PSNR a little bit more.
9740 .B bitrate=<value> (CBR or two pass mode)
9741 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
9743 If <value> is negative, Xvid will use its absolute value as the target size
9744 (in kBytes) of the video and compute the associated bitrate automagically
9745 (default: 687 kbits/s).
9748 .B fixed_quant=<1\-31>
9749 Switch to fixed quantizer mode and specify the quantizer to be used.
9752 .B zones=<zone0>[/<zone1>[/...]] (CBR or two pass mode)
9753 User specified quality for specific parts (ending, credits, ...).
9754 Each zone is <start-frame>,<mode>,<value> where <mode> may be
9758 Constant quantizer override, where value=<2.0\-31.0>
9759 represents the quantizer value.
9761 Ratecontrol weight override, where value=<0.01\-2.00>
9762 represents the quality correction in %.
9771 .IPs zones=90000,q,20
9772 Encodes all frames starting with frame 90000 at constant quantizer 20.
9773 .IPs zones=0,w,0.1/10001,w,1.0/90000,q,20
9774 Encode frames 0\-10000 at 10% bitrate, encode frames 90000
9775 up to the end at constant quantizer 20.
9776 Note that the second zone is needed to delimit the first zone, as
9777 without it everything up until frame 89999 would be encoded at 10%
9783 .B me_quality=<0\-6>
9784 This option controls the motion estimation subsystem.
9785 The higher the value, the more precise the estimation should be (default: 6).
9786 The more precise the motion estimation is, the more bits can be saved.
9787 Precision is gained at the expense of CPU time so decrease this setting if
9788 you need realtime encoding.
9792 MPEG-4 uses a half pixel precision for its motion search by default.
9793 The standard proposes a mode where encoders are allowed to use quarter
9795 This option usually results in a sharper image.
9796 Unfortunately it has a great impact on bitrate and sometimes the
9797 higher bitrate use will prevent it from giving a better image
9798 quality at a fixed bitrate.
9799 It is better to test with and without this option and see whether it
9800 is worth activating.
9804 Enable Global Motion Compensation, which makes Xvid generate special
9805 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images.
9806 Whether or not the use of this option will save bits is highly
9807 dependent on the source material.
9811 Trellis Quantization is a kind of adaptive quantization method that
9812 saves bits by modifying quantized coefficients to make them more
9813 compressible by the entropy encoder.
9814 Its impact on quality is good, and if VHQ uses too much CPU for you,
9815 this setting can be a good alternative to save a few bits (and gain
9816 quality at fixed bitrate) at a lesser cost than with VHQ (default: on).
9820 Activate this if your encoded sequence is an anime/\:cartoon.
9821 It modifies some Xvid internal thresholds so Xvid takes better decisions on
9822 frame types and motion vectors for flat looking cartoons.
9826 The usual motion estimation algorithm uses only the luminance information to
9827 find the best motion vector.
9828 However for some video material, using the chroma planes can help find
9830 This setting toggles the use of chroma planes for motion estimation
9835 Enable a chroma optimizer prefilter.
9836 It will do some extra magic on color information to minimize the
9837 stepped-stairs effect on edges.
9838 It will improve quality at the cost of encoding speed.
9839 It reduces PSNR by nature, as the mathematical deviation to the original
9840 picture will get bigger, but the subjective image quality will raise.
9841 Since it works with color information, you might want to turn it off when
9842 encoding in grayscale.
9846 Activates high-quality prediction of AC coefficients for intra frames from
9847 neighbor blocks (default: on).
9851 The motion search algorithm is based on a search in the usual color domain
9852 and tries to find a motion vector that minimizes the difference between the
9853 reference frame and the encoded frame.
9854 With this setting activated, Xvid will also use the frequency domain (DCT)
9855 to search for a motion vector that minimizes not only the spatial
9856 difference but also the encoding length of the block.
9863 mode decision (inter/\:intra MB) (default)
9875 Adaptive quantization allows the macroblock quantizers to vary inside
9877 This is a 'psychosensory' setting that is supposed to make use of the
9878 fact that the human eye tends to notice fewer details in very bright
9879 and very dark parts of the picture.
9880 It compresses those areas more strongly than medium ones, which will
9881 save bits that can be spent again on other frames, raising overall
9882 subjective quality and possibly reducing PSNR.
9886 Make Xvid discard chroma planes so the encoded video is grayscale only.
9887 Note that this does not speed up encoding, it just prevents chroma data
9888 from being written in the last stage of encoding.
9892 Encode the fields of interlaced video material.
9893 Turn this option on for interlaced content.
9896 Should you rescale the video, you would need an interlace-aware resizer,
9897 which you can activate with \-vf scale=<width>:<height>:1.
9900 .B min_iquant=<0\-31>
9901 minimum I-frame quantizer (default: 2)
9904 .B max_iquant=<0\-31>
9905 maximum I-frame quantizer (default: 31)
9908 .B min_pquant=<0\-31>
9909 minimum P-frame quantizer (default: 2)
9912 .B max_pquant=<0\-31>
9913 maximum P-frame quantizer (default: 31)
9916 .B min_bquant=<0\-31>
9917 minimum B-frame quantizer (default: 2)
9920 .B max_bquant=<0\-31>
9921 maximum B-frame quantizer (default: 31)
9924 .B min_key_interval=<value> (two pass only)
9925 minimum interval between keyframes (default: 0)
9928 .B max_key_interval=<value>
9929 maximum interval between keyframes (default: 10*fps)
9932 .B quant_type=<h263|mpeg>
9933 Sets the type of quantizer to use.
9934 For high bitrates, you will find that MPEG quantization preserves more detail.
9935 For low bitrates, the smoothing of H.263 will give you less block noise.
9936 When using custom matrices, MPEG quantization
9941 .B quant_intra_matrix=<filename>
9942 Load a custom intra matrix file.
9943 You can build such a file with xvid4conf's matrix editor.
9946 .B quant_inter_matrix=<filename>
9947 Load a custom inter matrix file.
9948 You can build such a file with xvid4conf's matrix editor.
9951 .B keyframe_boost=<0\-1000> (two pass mode only)
9952 Shift some bits from the pool for other frame types to intra frames,
9953 thus improving keyframe quality.
9954 This amount is an extra percentage, so a value of 10 will give
9955 your keyframes 10% more bits than normal
9959 .B kfthreshold=<value> (two pass mode only)
9960 Works together with kfreduction.
9961 Determines the minimum distance below which you consider that
9962 two frames are considered consecutive and treated differently
9963 according to kfreduction
9967 .B kfreduction=<0\-100> (two pass mode only)
9968 The above two settings can be used to adjust the size of keyframes that
9969 you consider too close to the first (in a row).
9970 kfthreshold sets the range in which keyframes are reduced, and
9971 kfreduction determines the bitrate reduction they get.
9972 The last I-frame will get treated normally
9976 .B max_bframes=<0\-4>
9977 Maximum number of B-frames to put between I/P-frames (default: 2).
9980 .B bquant_ratio=<0\-1000>
9981 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150)
9984 .B bquant_offset=<\-1000\-1000>
9985 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100)
9988 .B bf_threshold=<\-255\-255>
9989 This setting allows you to specify what priority to place on the use of
9991 The higher the value, the higher the probability of B-frames being used
9993 Do not forget that B-frames usually have a higher quantizer, and therefore
9994 aggressive production of B-frames may cause worse visual quality.
9998 This option tells Xvid to close every GOP (Group Of Pictures bounded
9999 by two I-frames), which makes GOPs independent from each other.
10000 This just implies that the last frame of the GOP is either a P-frame or a
10001 N-frame but not a B-frame.
10002 It is usually a good idea to turn this option on (default: on).
10006 This option is meant to solve frame-order issues when encoding to
10007 container formats like AVI that cannot cope with out-of-order frames.
10008 In practice, most decoders (both software and hardware) are able to deal
10009 with frame-order themselves, and may get confused when this option is
10010 turned on, so you can safely leave if off, unless you really know what
10014 This will generate an illegal bitstream, and will not be
10015 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:Xvid.
10018 This will also store a fake DivX version in the file so the bug
10019 autodetection of some decoders might be confused.
10022 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
10023 This setting allows the creation of variable framerate video streams.
10024 The value of the setting specifies a threshold under which, if the
10025 difference of the following frame to the previous frame is below or equal
10026 to this threshold, a frame gets not coded (a so called n-vop is placed
10028 On playback, when reaching an n-vop the previous frame will be displayed.
10031 Playing with this setting may result in a jerky video, so use it at your
10035 .B rc_reaction_delay_factor=<value>
10036 This parameter controls the number of frames the CBR rate controller
10037 will wait before reacting to bitrate changes and compensating for them
10038 to obtain a constant bitrate over an averaging range of frames.
10041 .B rc_averaging_period=<value>
10042 Real CBR is hard to achieve.
10043 Depending on the video material, bitrate can be variable, and hard to predict.
10044 Therefore Xvid uses an averaging period for which it guarantees a given
10045 amount of bits (minus a small variation).
10046 This settings expresses the "number of frames" for which Xvid averages
10047 bitrate and tries to achieve CBR.
10050 .B rc_buffer=<value>
10051 size of the rate control buffer
10054 .B curve_compression_high=<0\-100>
10055 This setting allows Xvid to take a certain percentage of bits away from
10056 high bitrate scenes and give them back to the bit reservoir.
10057 You could also use this if you have a clip with so many bits allocated
10058 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad
10062 .B curve_compression_low=<0\-100>
10063 This setting allows Xvid to give a certain percentage of extra bits to the
10064 low bitrate scenes, taking a few bits from the entire clip.
10065 This might come in handy if you have a few low-bitrate scenes that are
10066 still blocky (default: 0).
10069 .B overflow_control_strength=<0\-100>
10070 During pass one of two pass encoding, a scaled bitrate curve is computed.
10071 The difference between that expected curve and the result obtained during
10072 encoding is called overflow.
10073 Obviously, the two pass rate controller tries to compensate for that overflow,
10074 distributing it over the next frames.
10075 This setting controls how much of the overflow is distributed every time
10076 there is a new frame.
10077 Low values allow lazy overflow control, big rate bursts are compensated for
10078 more slowly (could lead to lack of precision for small clips).
10079 Higher values will make changes in bit redistribution more abrupt, possibly
10080 too abrupt if you set it too high, creating artifacts (default: 5).
10083 This setting impacts quality a lot, play with it carefully!
10086 .B max_overflow_improvement=<0\-100>
10087 During the frame bit allocation, overflow control may increase the frame
10089 This parameter specifies the maximum percentage by which the overflow
10090 control is allowed to increase the frame size, compared to the ideal curve
10095 .B max_overflow_degradation=<0\-100>
10096 During the frame bit allocation, overflow control may decrease the frame
10098 This parameter specifies the maximum percentage by which the overflow
10099 control is allowed to decrease the frame size, compared to the ideal curve
10104 .B container_frame_overhead=<0...>
10105 Specifies a frame average overhead per frame, in bytes.
10106 Most of the time users express their target bitrate for video w/o taking
10107 care of the video container overhead.
10108 This small but (mostly) constant overhead can cause the target file size
10110 Xvid allows users to set the amount of overhead per frame the
10111 container generates (give only an average per frame).
10112 0 has a special meaning, it lets Xvid use its own default values
10113 (default: 24 \- AVI average overhead).
10116 .B profile=<profile_name>
10117 Restricts options and VBV (peak bitrate over a short period) according to
10118 the Simple, Advanced Simple and DivX profiles.
10119 The resulting videos should be playable on standalone players adhering to these
10120 profile specifications.
10124 no restrictions (default)
10126 simple profile at level 0
10128 simple profile at level 1
10130 simple profile at level 2
10132 simple profile at level 3
10134 advanced simple profile at level 0
10136 advanced simple profile at level 1
10138 advanced simple profile at level 2
10140 advanced simple profile at level 3
10142 advanced simple profile at level 4
10144 advanced simple profile at level 5
10146 DXN handheld profile
10148 DXN portable NTSC profile
10150 DXN portable PAL profile
10152 DXN home theater NTSC profile
10154 DXN home theater PAL profile
10161 These profiles should be used in conjunction with an appropriate \-ffourcc.
10162 Generally DX50 is applicable, as some players do not recognize Xvid but
10163 most recognize DivX.
10168 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR,
10169 the Display Aspect Ratio).
10170 PAR is the ratio of the width and height of a single pixel.
10171 So both are related like this: DAR = PAR * (width/height).
10173 MPEG-4 defines 5 pixel aspect ratios and one extended
10174 one, giving the opportunity to specify a specific pixel aspect
10176 5 standard modes can be specified:
10180 It is the usual PAR for PC content.
10181 Pixels are a square unit.
10183 PAL standard 4:3 PAR.
10184 Pixels are rectangles.
10190 same as above (Do not forget to give the exact ratio.)
10192 Allows you to specify your own pixel aspect ratio with par_width and
10198 In general, setting aspect and autoaspect options is enough.
10202 .B par_width=<1\-255> (par=ext only)
10203 Specifies the width of the custom pixel aspect ratio.
10206 .B par_height=<1\-255> (par=ext only)
10207 Specifies the height of the custom pixel aspect ratio.
10210 .B aspect=<x/y | f (float value)>
10211 Store movie aspect internally, just like MPEG files.
10212 Much nicer solution than rescaling, because quality is not decreased.
10213 MPlayer and a few others players will play these files correctly, others
10214 will display them with the wrong aspect.
10215 The aspect parameter can be given as a ratio or a floating point number.
10219 Same as the aspect option, but automatically computes aspect, taking
10220 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
10225 Print the PSNR (peak signal to noise ratio) for the whole video after encoding
10226 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
10227 the current directory.
10228 Returned values are in dB (decibel), the higher the better.
10232 Save per-frame statistics in ./xvid.dbg. (This is not the two pass control
10238 The following option is only available in Xvid 1.1.x.
10242 This setting allows vector candidates for B-frames to be used for
10243 the encoding chosen using a rate distortion optimized operator,
10244 which is what is done for P-frames by the vhq option.
10245 This produces nicer-looking B-frames while incurring almost no
10246 performance penalty (default: 1).
10250 The following option is only available in the 1.2.x version of Xvid.
10254 Create n threads to run the motion estimation (default: 0).
10255 The maximum number of threads that can be used is the picture height
10259 .SS x264enc (\-x264encopts)
10263 Sets the average bitrate to be used in kbits/\:second (default: off).
10264 Since local bitrate may vary, this average may be inaccurate for
10265 very short videos (see ratetol).
10266 Constant bitrate can be achieved by combining this with vbv_maxrate,
10267 at significant reduction in quality.
10271 This selects the quantizer to use for P-frames.
10272 I- and B-frames are offset from this value by ip_factor and pb_factor, respectively.
10273 20\-40 is a useful range.
10274 Lower values result in better fidelity, but higher bitrates.
10276 Note that quantization in H.264 works differently from MPEG-1/2/4:
10277 H.264's quantization parameter (QP) is on a logarithmic scale.
10278 The mapping is approximately H264QP = 12 + 6*log2(MPEGQP).
10279 For example, MPEG at QP=2 is equivalent to H.264 at QP=18.
10283 Enables constant quality mode, and selects the quality.
10284 The scale is similar to QP.
10285 Like the bitrate-based modes, this allows each frame to use a
10286 different QP based on the frame's complexity.
10290 Enable 2 or 3-pass mode.
10291 It is recommended to always encode in 2 or 3-pass mode as it leads to a
10292 better bit distribution and improves overall quality.
10298 second pass (of two pass encoding)
10300 Nth pass (second and third passes of three pass encoding)
10303 Here is how it works, and how to use it:
10305 The first pass (pass=1) collects statistics on the video and writes them
10307 You might want to deactivate some CPU-hungry options, apart from the ones
10308 that are on by default.
10310 In two pass mode, the second pass (pass=2) reads the statistics file and
10311 bases ratecontrol decisions on it.
10313 In three pass mode, the second pass (pass=3, that is not a typo)
10314 does both: It first reads the statistics, then overwrites them.
10315 You can use all encoding options, except very CPU-hungry options.
10317 The third pass (pass=3) is the same as the second pass, except that it has
10318 the second pass' statistics to work from.
10319 You can use all encoding options, including CPU-hungry ones.
10321 The first pass may use either average bitrate or constant quantizer.
10322 ABR is recommended, since it does not require guessing a quantizer.
10323 Subsequent passes are ABR, and must specify bitrate.
10328 Fast first pass mode.
10329 During the first pass of a two or more pass encode it is possible to gain
10330 speed by disabling some options with negligible or even no impact on the
10331 final pass output quality.
10337 Reduce subq, frameref and disable some inter-macroblock partition analysis
10340 Reduce subq and frameref to 1, use a diamond ME search and disable all
10341 partition analysis modes.
10344 Level 1 can increase first pass speed up to 2x with no change in the global
10345 PSNR of the final pass compared to a full quality first pass.
10347 Level 2 can increase first pass speed up to 4x with about +/\- 0.05dB change
10348 in the global PSNR of the final pass compared to a full quality first pass.
10353 Sets maximum interval between IDR-frames (default: 250).
10354 Larger values save bits, thus improve quality, at the cost of seeking
10356 Unlike MPEG-1/2/4, H.264 does not suffer from DCT drift with large
10360 .B keyint_min=<1\-keyint/2>
10361 Sets minimum interval between IDR-frames (default: 25).
10362 If scenecuts appear within this interval, they are still encoded as
10363 I-frames, but do not start a new GOP.
10364 In H.264, I-frames do not necessarily bound a closed GOP because it is
10365 allowable for a P-frame to be predicted from more frames than just the one
10366 frame before it (also see frameref).
10367 Therefore, I-frames are not necessarily seekable.
10368 IDR-frames restrict subsequent P-frames from referring to any frame
10369 prior to the IDR-frame.
10372 .B scenecut=<\-1\-100>
10373 Controls how aggressively to insert extra I-frames (default: 40).
10374 With small values of scenecut, the codec often has to force an I-frame
10375 when it would exceed keyint.
10376 Good values of scenecut may find a better location for the I-frame.
10377 Large values use more I-frames than necessary, thus wasting bits.
10378 \-1 disables scene-cut detection, so I-frames are inserted only once
10379 every other keyint frames, even if a scene-cut occurs earlier.
10380 This is not recommended and wastes bitrate as scenecuts encoded as P-frames
10381 are just as big as I-frames, but do not reset the "keyint counter".
10384 .B (no)intra_refresh
10385 Periodic intra block refresh instead of keyframes (default: disabled).
10386 This option disables IDR-frames, and, instead, uses a moving vertical bar
10387 of intra-coded blocks. This reduces compression efficiency but benefits
10388 low-latency streaming and resilience to packet loss.
10391 .B frameref=<1\-16>
10392 Number of previous frames used as predictors in B- and P-frames (default: 3).
10393 This is effective in anime, but in live-action material the improvements
10394 usually drop off very rapidly above 6 or so reference frames.
10395 This has no effect on decoding speed, but does increase the memory needed for
10397 Some decoders can only handle a maximum of 15 reference frames.
10401 maximum number of consecutive B-frames between I- and P-frames (default: 3)
10405 Automatically decides when to use B-frames and how many, up to the maximum
10406 specified above (default: on).
10407 If this option is disabled, then the maximum number of B-frames is used.
10410 .B b_bias=<\-100\-100>
10411 Controls the decision performed by b_adapt.
10412 A higher b_bias produces more B-frames (default: 0).
10416 Allows B-frames to be used as references for predicting other frames.
10417 For example, consider 3 consecutive B-frames: I0 B1 B2 B3 P4.
10418 Without this option, B-frames follow the same pattern as MPEG-[124].
10419 So they are coded in the order I0 P4 B1 B2 B3, and all the B-frames
10420 are predicted from I0 and P4.
10421 With this option, they are coded as I0 P4 B2 B1 B3.
10422 B2 is the same as above, but B1 is predicted from I0 and B2, and
10423 B3 is predicted from B2 and P4.
10424 This usually results in slightly improved compression, at almost no
10426 However, this is an experimental option: it is not fully tuned and
10427 may not always help.
10428 Requires bframes >= 2.
10429 Disadvantage: increases decoding delay to 2 frames.
10433 Use deblocking filter (default: on).
10434 As it takes very little time compared to its quality gain, it is not
10435 recommended to disable it.
10438 .B deblock=<\-6\-6>,<\-6\-6>
10439 The first parameter is AlphaC0 (default: 0).
10440 This adjusts thresholds for the H.264 in-loop deblocking filter.
10441 First, this parameter adjusts the maximum amount of change that the filter is
10442 allowed to cause on any one pixel.
10443 Secondly, this parameter affects the threshold for difference across the
10444 edge being filtered.
10445 A positive value reduces blocking artifacts more, but will also smear details.
10447 The second parameter is Beta (default: 0).
10448 This affects the detail threshold.
10449 Very detailed blocks are not filtered, since the smoothing caused by the
10450 filter would be more noticeable than the original blocking.
10452 The default behavior of the filter almost always achieves optimal quality,
10453 so it is best to either leave it alone, or make only small adjustments.
10454 However, if your source material already has some blocking or noise which
10455 you would like to remove, it may be a good idea to turn it up a little bit.
10459 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on).
10460 Slightly slows down encoding and decoding, but should save 10\-15% bitrate.
10461 Unless you are looking for decoding speed, you should not disable it.
10464 .B qp_min=<1\-51> (ABR or two pass)
10465 Minimum quantizer, 10\-30 seems to be a useful range (default: 10).
10468 .B qp_max=<1\-51> (ABR or two pass)
10469 maximum quantizer (default: 51)
10472 .B qp_step=<1\-50> (ABR or two pass)
10473 maximum value by which the quantizer may be incremented/decremented between
10474 frames (default: 4)
10478 Enable macroblock tree ratecontrol (default: enabled).
10479 Use a large lookahead to track temporal propagation of data and weight quality
10481 In multi-pass mode, this writes to a separate stats file named
10482 <passlogfile>.mbtree.
10485 .B rc_lookahead=<0\-250>
10486 Adjust the mbtree lookahead distance (default: 40).
10487 Larger values will be slower and cause x264 to consume more memory, but can
10488 yield higher quality.
10491 .B ratetol=<0.1\-100.0> (ABR or two pass)
10492 allowed variance in average bitrate (no particular units) (default: 1.0)
10495 .B vbv_maxrate=<value> (ABR or two pass)
10496 maximum local bitrate, in kbits/\:second (default: disabled)
10499 .B vbv_bufsize=<value> (ABR or two pass)
10500 averaging period for vbv_maxrate, in kbits
10501 (default: none, must be specified if vbv_maxrate is enabled)
10504 .B vbv_init=<0.0\-1.0> (ABR or two pass)
10505 initial buffer occupancy, as a fraction of vbv_bufsize (default: 0.9)
10508 .B ip_factor=<value>
10509 quantizer factor between I- and P-frames (default: 1.4)
10512 .B pb_factor=<value>
10513 quantizer factor between P- and B-frames (default: 1.3)
10516 .B qcomp=<0\-1> (ABR or two pass)
10517 quantizer compression (default: 0.6).
10518 A lower value makes the bitrate more constant,
10519 while a higher value makes the quantization parameter more constant.
10522 .B cplx_blur=<0\-999> (two pass only)
10523 Temporal blur of the estimated frame complexity, before curve compression
10525 Lower values allow the quantizer value to jump around more,
10526 higher values force it to vary more smoothly.
10527 cplx_blur ensures that each I-frame has quality comparable to the following
10528 P-frames, and ensures that alternating high and low complexity frames
10529 (e.g.\& low fps animation) do not waste bits on fluctuating quantizer.
10532 .B qblur=<0\-99> (two pass only)
10533 Temporal blur of the quantization parameter, after curve compression
10535 Lower values allow the quantizer value to jump around more,
10536 higher values force it to vary more smoothly.
10539 .B zones=<zone0>[/<zone1>[/...]]
10540 User specified quality for specific parts (ending, credits, ...).
10541 Each zone is <start-frame>,<end-frame>,<option> where option may be
10546 .IPs "b=<0.01\-100.0>"
10552 The quantizer option is not strictly enforced.
10553 It affects only the planning stage of ratecontrol, and is still subject
10554 to overflow compensation and qp_min/qp_max.
10558 .B direct_pred=<name>
10559 Determines the type of motion prediction used for direct macroblocks
10564 Direct macroblocks are not used.
10566 Motion vectors are extrapolated from neighboring blocks.
10569 Motion vectors are extrapolated from the following P-frame.
10571 The codec selects between spatial and temporal for each frame.
10575 Spatial and temporal are approximately the same speed and PSNR,
10576 the choice between them depends on the video content.
10577 Auto is slightly better, but slower.
10578 Auto is most effective when combined with multipass.
10579 direct_pred=none is both slower and lower quality.
10584 Weighted P-frame prediction mode (default: 2).
10590 blind mode (slightly better quality)
10598 Use weighted prediction in B-frames.
10599 Without this option, bidirectionally predicted macroblocks give
10600 equal weight to each reference frame.
10601 With this option, the weights are determined by the temporal position
10602 of the B-frame relative to the references.
10603 Requires bframes > 1.
10606 .B partitions=<list>
10607 Enable some optional macroblock types (default: p8x8,b8x8,i8x8,i4x4).
10611 Enable types p16x8, p8x16, p8x8.
10613 Enable types p8x4, p4x8, p4x4.
10614 p4x4 is recommended only with subq >= 5, and only at low resolutions.
10616 Enable types b16x8, b8x16, b8x8.
10619 i8x8 has no effect unless 8x8dct is enabled.
10623 Enable all of the above types.
10625 Disable all of the above types.
10629 Regardless of this option, macroblock types p16x16, b16x16, and i16x16
10630 are always enabled.
10632 The idea is to find the type and size that best describe a certain area
10634 For example, a global pan is better represented by 16x16 blocks, while
10635 small moving objects are better represented by smaller blocks.
10640 Adaptive spatial transform size: allows macroblocks to choose between
10642 Also allows the i8x8 macroblock type.
10643 Without this option, only 4x4 DCT is used.
10647 Select fullpixel motion estimation algorithm.
10651 diamond search, radius 1 (fast)
10653 hexagon search, radius 2 (default)
10655 uneven multi-hexagon search (slow)
10657 exhaustive search (very slow, and no better than umh)
10662 .B me_range=<4\-64>
10663 radius of exhaustive or multi-hexagon motion search (default: 16)
10667 Adjust subpel refinement quality.
10668 This parameter controls quality versus speed tradeoffs involved in the motion
10669 estimation decision process.
10670 subq=5 can compress up to 10% better than subq=1.
10674 Runs fullpixel precision motion estimation on all candidate
10676 Then selects the best type with SAD metric (faster than subq=1, not recommended
10677 unless you're looking for ultra-fast encoding).
10679 Does as 0, then refines the motion of that type to fast quarterpixel precision
10682 Runs halfpixel precision motion estimation on all candidate macroblock types.
10683 Then selects the best type with SATD metric.
10684 Then refines the motion of that type to fast quarterpixel precision.
10686 As 2, but uses a slower quarterpixel refinement.
10688 Runs fast quarterpixel precision motion estimation on all candidate
10690 Then selects the best type with SATD metric.
10691 Then finishes the quarterpixel refinement for that type.
10693 Runs best quality quarterpixel precision motion estimation on all
10694 candidate macroblock types, before selecting the best type.
10695 Also refines the two motion vectors used in bidirectional macroblocks with
10696 SATD metric, rather than reusing vectors from the forward and backward
10699 Enables rate-distortion optimization of macroblock types in
10702 Enables rate-distortion optimization of macroblock types in all frames (default).
10704 Enables rate-distortion optimization of motion vectors and intra prediction modes in I- and P-frames.
10706 Enables rate-distortion optimization of motion vectors and intra prediction modes in all frames (best).
10710 In the above, "all candidates" does not exactly mean all enabled types:
10711 4x4, 4x8, 8x4 are tried only if 8x8 is better than 16x16.
10716 Takes into account chroma information during subpixel motion search
10717 (default: enabled).
10722 Allows each 8x8 or 16x8 motion partition to independently select a
10724 Without this option, a whole macroblock must use the same reference.
10725 Requires frameref>1.
10728 .B trellis=<0\-2> (cabac only)
10729 rate-distortion optimal quantization
10735 enabled only for the final encode (default)
10737 enabled during all mode decisions (slow, requires subq>=6)
10742 .B psy-rd=rd[,trell]
10743 Sets the strength of the psychovisual optimization.
10746 .IPs rd=<0.0\-10.0>
10747 psy optimization strength (requires subq>=6) (default: 1.0)
10748 .IPs trell=<0.0\-10.0>
10749 trellis (requires trellis, experimental) (default: 0.0)
10755 Enable psychovisual optimizations that hurt PSNR and SSIM but ought to look
10756 better (default: enabled).
10759 .B deadzone_inter=<0\-32>
10760 Set the size of the inter luma quantization deadzone for non-trellis
10761 quantization (default: 21).
10762 Lower values help to preserve fine details and film grain (typically useful
10763 for high bitrate/quality encode), while higher values help filter out
10764 these details to save bits that can be spent again on other macroblocks
10765 and frames (typically useful for bitrate-starved encodes).
10766 It is recommended that you start by tweaking deadzone_intra before changing
10770 .B deadzone_intra=<0\-32>
10771 Set the size of the intra luma quantization deadzone for non-trellis
10772 quantization (default: 11).
10773 This option has the same effect as deadzone_inter except that it affects
10775 It is recommended that you start by tweaking this parameter before changing
10780 Performs early skip detection in P-frames (default: enabled).
10781 This usually improves speed at no cost, but it can sometimes produce
10782 artifacts in areas with no details, like sky.
10785 .B (no)dct_decimate
10786 Eliminate dct blocks in P-frames containing only a small single coefficient
10787 (default: enabled).
10788 This will remove some details, so it will save bits that can be spent
10789 again on other frames, hopefully raising overall subjective quality.
10790 If you are compressing non-anime content with a high target bitrate, you
10791 may want to disable this to preserve as much detail as possible.
10795 Noise reduction, 0 means disabled.
10796 100\-1000 is a useful range for typical content, but you may want to turn it
10797 up a bit more for very noisy content (default: 0).
10798 Given its small impact on speed, you might want to prefer to use this over
10799 filtering noise away with video filters like denoise3d or hqdn3d.
10802 .B chroma_qp_offset=<\-12\-12>
10803 Use a different quantizer for chroma as compared to luma.
10804 Useful values are in the range <\-2\-2> (default: 0).
10808 Defines how adaptive quantization (AQ) distributes bits:
10814 Avoid moving bits between frames.
10816 Move bits between frames (by default).
10821 .B aq_strength=<positive float value>
10822 Controls how much adaptive quantization (AQ) reduces blocking and blurring
10823 in flat and textured areas (default: 1.0).
10824 A value of 0.5 will lead to weak AQ and less details, when a value of 1.5
10825 will lead to strong AQ and more details.
10828 .B cqm=<flat|jvt|<filename>>
10829 Either uses a predefined custom quantization matrix or loads a JM format
10834 Use the predefined flat 16 matrix (default).
10836 Use the predefined JVT matrix.
10838 Use the provided JM format matrix file.
10843 Windows CMD.EXE users may experience problems with parsing the command line
10844 if they attempt to use all the CQM lists.
10845 This is due to a command line length limitation.
10846 In this case it is recommended the lists be put into a JM format CQM
10847 file and loaded as specified above.
10851 .B cqm4iy=<list> (also see cqm)
10852 Custom 4x4 intra luminance matrix, given as a list of 16 comma separated
10853 values in the 1\-255 range.
10856 .B cqm4ic=<list> (also see cqm)
10857 Custom 4x4 intra chrominance matrix, given as a list of 16 comma
10858 separated values in the 1\-255 range.
10861 .B cqm4py=<list> (also see cqm)
10862 Custom 4x4 inter luminance matrix, given as a list of 16 comma separated
10863 values in the 1\-255 range.
10866 .B cqm4pc=<list> (also see cqm)
10867 Custom 4x4 inter chrominance matrix, given as a list of 16 comma
10868 separated values in the 1\-255 range.
10871 .B cqm8iy=<list> (also see cqm)
10872 Custom 8x8 intra luminance matrix, given as a list of 64 comma separated
10873 values in the 1\-255 range.
10876 .B cqm8py=<list> (also see cqm)
10877 Custom 8x8 inter luminance matrix, given as a list of 64 comma separated
10878 values in the 1\-255 range.
10881 .B level_idc=<10\-51>
10882 Set the bitstream's level as defined by annex A of the H.264 standard
10883 (default: 51 \- level 5.1).
10884 This is used for telling the decoder what capabilities it needs to support.
10885 Use this parameter only if you know what it means,
10886 and you have a need to set it.
10890 Spawn threads to encode in parallel on multiple CPUs (default: 0).
10891 This has a slight penalty to compression quality.
10892 0 or 'auto' tells x264 to detect how many CPUs you have and pick an
10893 appropriate number of threads.
10896 .B (no)sliced_threads
10897 Use slice-based threading (default: disabled).
10898 Unlike normal threading, this option adds no encoding latency, but is slightly
10899 slower and less effective at compression.
10902 .B slice_max_size=<0 or positive integer>
10903 Maximum slice size in bytes (default: 0).
10904 A value of zero disables the maximum.
10907 .B slice_max_mbs=<0 or positive integer>
10908 Maximum slice size in number of macroblocks (default: 0).
10909 A value of zero disables the maximum.
10912 .B slices=<0 or positive integer>
10913 Maximum number of slices per frame (default: 0).
10914 A value of zero disables the maximum.
10917 .B sync_lookahead=<0\-250>
10918 Adjusts the size of the threaded lookahead buffer (default: 0).
10919 0 or 'auto' tells x264 to automatically determine buffer size.
10922 .B (no)deterministic
10923 Use only deterministic optimizations with multithreaded encoding (default:
10927 .B (no)global_header
10928 Causes SPS and PPS to appear only once, at the beginning of the bitstream
10929 (default: disabled).
10930 Some players, such as the Sony PSP, require the use of this option.
10931 The default behavior causes SPS and PPS to repeat prior to each IDR frame.
10935 Treat the video content as interlaced.
10938 .B (no)constrained_intra
10939 Enable constrained intra prediction (default: disabled).
10940 This significantly reduces compression, but is required for the base layer of
10945 Write access unit delimeters to the stream (default: disabled).
10946 Enable this only if your target container format requires access unit
10950 .B overscan=<undef|show|crop>
10951 Include VUI overscan information in the stream (default: disabled).
10952 See doc/vui.txt in the x264 source code for more information.
10955 .B videoformat=<component|pal|ntsc|secam|mac|undef>
10956 Include VUI video format information in the stream (default: disabled).
10957 This is a purely informative setting for describing the original source.
10958 See doc/vui.txt in the x264 source code for more information.
10962 Include VUI full range information in the stream (default: disabled).
10963 Use this option if your source video is not range limited.
10964 See doc/vui.txt in the x264 source code for more information.
10967 .B colorprim=<bt709|bt470m|bt470bg|smpte170m|smpte240m|film|undef>
10968 Include color primaries information (default: disabled).
10969 This can be used for color correction.
10970 See doc/vui.txt in the x264 source code for more information.
10973 .B transfer=<bt709|bt470m|bt470bg|linear|log100|log316|smpte170m|smpte240m>
10974 Include VUI transfer characteristics information in the stream
10975 (default: disabled).
10976 This can be used for color correction.
10977 See doc/vui.txt in the x264 source code for more information.
10980 .B colormatrix=<bt709|fcc|bt470bg|smpte170m|smpte240m|GBR|YCgCo>
10981 Include VUI matrix coefficients in the stream (default: disabled).
10982 This can be used for color correction.
10983 See doc/vui.txt in the x264 source code for more information.
10987 Include VUI chroma sample location information in the stream (default:
10989 Use this option to ensure alignment of the chroma and luma planes after
10990 color space conversions.
10991 See doc/vui.txt in the x264 source code for more information.
10995 Adjust the amount of logging info printed to the screen.
11005 PSNR and other analysis statistics when the encode finishes (default)
11007 PSNR, QP, frametype, size, and other statistics for every frame
11013 Print signal-to-noise ratio statistics.
11016 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not
11017 mathematically sound (they are simply the average of per-frame PSNRs).
11018 They are kept only for comparison to the JM reference codec.
11019 For all other purposes, please use either the 'Global' PSNR, or the per-frame
11020 PSNRs printed by log=3.
11024 Print the Structural Similarity Metric results.
11025 This is an alternative to PSNR, and may be better correlated with the
11026 perceived quality of the compressed video.
11030 Enable x264 visualizations during encoding.
11031 If the x264 on your system supports it, a new window will be opened during
11032 the encoding process, in which x264 will attempt to present an overview of
11033 how each frame gets encoded.
11034 Each block type on the visualized movie will be colored as follows:
11037 .B dump_yuv=<file name>
11038 Dump YUV frames to the specified file.
11053 This feature can be considered experimental and subject to change.
11054 In particular, it depends on x264 being compiled with visualizations enabled.
11055 Note that as of writing this, x264 pauses after encoding and visualizing
11056 each frame, waiting for the user to press a key, at which point the next
11057 frame will be encoded.
11061 .SS xvfw (\-xvfwopts)
11063 Encoding with Video for Windows codecs is mostly obsolete unless you wish
11064 to encode to some obscure fringe codec.
11068 The name of the binary codec file with which to encode.
11072 The name of the codec settings file (like firstpass.mcf) created by vfw2menc.
11075 .SS MPEG muxer (\-mpegopts)
11077 The MPEG muxer can generate 5 types of streams, each of which has reasonable
11078 default parameters that the user can override.
11079 Generally, when generating MPEG files, it is advisable to disable
11080 MEncoder's frame-skip code (see \-noskip, \-mc as well as the
11081 harddup and softskip video filters).
11086 .IPs format=mpeg2:tsaf:vbitrate=8000
11091 .B format=<mpeg1 | mpeg2 | xvcd | xsvcd | dvd | pes1 | pes2>
11092 stream format (default: mpeg2).
11093 pes1 and pes2 are very broken formats (no pack header and no padding),
11094 but VDR uses them; do not choose them unless you know exactly what you
11098 .B size=<up to 65535>
11099 Pack size in bytes, do not change unless you know exactly what
11100 you are doing (default: 2048).
11104 Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s).
11105 Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'.
11109 Sets timestamps on all frames, if possible; recommended when format=dvd.
11110 If dvdauthor complains with a message like "..audio sector out of range...",
11111 you probably did not enable this option.
11115 Uses a better algorithm to interleave audio and video packets, based on the
11116 principle that the muxer will always try to fill the stream with the largest
11117 percentage of free space.
11120 .B vdelay=<1\-32760>
11121 Initial video delay time, in milliseconds (default: 0),
11122 use it if you want to delay video with respect to audio.
11123 It doesn't work with :drop.
11126 .B adelay=<1\-32760>
11127 Initial audio delay time, in milliseconds (default: 0),
11128 use it if you want to delay audio with respect to video.
11132 When used with vdelay the muxer drops the part of audio that was
11136 .B vwidth, vheight=<1\-4095>
11137 Set the video width and height when video is MPEG-1/2.
11140 .B vpswidth, vpsheight=<1\-4095>
11141 Set pan and scan video width and height when video is MPEG-2.
11144 .B vaspect=<1 | 4/3 | 16/9 | 221/100>
11145 Sets the display aspect ratio for MPEG-2 video.
11146 Do not use it on MPEG-1 or the resulting aspect ratio will be completely wrong.
11150 Sets the video bitrate in kbit/s for MPEG-1/2 video.
11153 .B vframerate=<24000/1001 | 24 | 25 | 30000/1001 | 30 | 50 | 60000/1001 | 60 >
11154 Sets the framerate for MPEG-1/2 video.
11155 This option will be ignored if used with the telecine option.
11159 Enables 3:2 pulldown soft telecine mode: The muxer will make the
11160 video stream look like it was encoded at 30000/1001 fps.
11161 It only works with MPEG-2 video when the output framerate is
11162 24000/1001 fps, convert it with \-ofps if necessary.
11163 Any other framerate is incompatible with this option.
11167 Enables FILM to PAL and NTSC to PAL soft telecine mode: The muxer
11168 will make the video stream look like it was encoded at 25 fps.
11169 It only works with MPEG-2 video when the output framerate is
11170 24000/1001 fps, convert it with \-ofps if necessary.
11171 Any other framerate is incompatible with this option.
11174 .B tele_src and tele_dest
11175 Enables arbitrary telecining using Donand Graft's DGPulldown code.
11176 You need to specify the original and the desired framerate; the
11177 muxer will make the video stream look like it was encoded at
11178 the desired framerate.
11179 It only works with MPEG-2 video when the input framerate is smaller
11180 than the output framerate and the framerate increase is <= 1.5.
11187 .IPs tele_src=25,tele_dest=30000/1001
11188 PAL to NTSC telecining
11193 .B vbuf_size=<40\-1194>
11194 Sets the size of the video decoder's buffer, expressed in kilobytes.
11195 Specify it only if the bitrate of the video stream is too high for
11196 the chosen format and if you know perfectly well what you are doing.
11197 A too high value may lead to an unplayable movie, depending on the player's
11199 When muxing HDTV video a value of 400 should suffice.
11202 .B abuf_size=<4\-64>
11203 Sets the size of the audio decoder's buffer, expressed in kilobytes.
11204 The same principle as for vbuf_size applies.
11207 .SS FFmpeg libavformat demuxers (\-lavfdopts)
11210 .B analyzeduration=<value>
11211 Maximum length in seconds to analyze the stream properties.
11215 Force a specific libavformat demuxer.
11218 .B o=<key>=<value>[,<key>=<value>[,...]]
11219 Pass AVOptions to libavformat demuxer.
11220 Note, a patch to make the o= unneeded and pass all unknown options through
11221 the AVOption system is welcome.
11222 A full list of AVOptions can be found in the FFmpeg manual.
11223 Note that some options may conflict with MPlayer/MEncoder options.
11235 .B probesize=<value>
11236 Maximum amount of data to probe during the detection phase.
11237 In the case of MPEG-TS this value identifies the maximum number
11238 of TS packets to scan.
11241 .B cryptokey=<hexstring>
11242 Encryption key the demuxer should use.
11243 This is the raw binary data of the key converted to a hexadecimal string.
11246 .SS FFmpeg libavformat muxers (\-lavfopts) (also see \-of lavf)
11250 Currently only meaningful for MPEG[12]: Maximum allowed distance,
11251 in seconds, between the reference timer of the output stream (SCR)
11252 and the decoding timestamp (DTS) for any stream present
11253 (demux to decode delay).
11254 Default is 0.7 (as mandated by the standards defined by MPEG).
11255 Higher values require larger buffers and must not be used.
11258 .B format=<container_format>
11259 Override which container format to mux into
11260 (default: autodetect from output file extension).
11264 MPEG-1 systems and MPEG-2 PS
11266 Advanced Streaming Format
11268 Audio Video Interleave file
11274 Macromedia Flash video files
11276 RealAudio and RealVideo
11280 NUT open container format (experimental)
11286 MPEG-4 format with extra header flags required by Apple iPod firmware
11288 Sony Digital Video container
11289 .IPs "matroska\ \ \ "
11295 Nominal bitrate of the multiplex, in bits per second;
11296 currently it is meaningful only for MPEG[12].
11297 Sometimes raising it is necessary in order to avoid "buffer underflows".
11300 .B o=<key>=<value>[,<key>=<value>[,...]]
11301 Pass AVOptions to libavformat muxer.
11302 Note, a patch to make the o= unneeded and pass all unknown options through
11303 the AVOption system is welcome.
11304 A full list of AVOptions can be found in the FFmpeg manual.
11305 Note that some options may conflict with MEncoder options.
11312 .IPs o=packetsize=100
11317 .B packetsize=<size>
11318 Size, expressed in bytes, of the unitary packet for the chosen format.
11319 When muxing to MPEG[12] implementations the default values are:
11320 2324 for [S]VCD, 2048 for all others formats.
11323 .B preload=<distance>
11324 Currently only meaningful for MPEG[12]: Initial distance,
11325 in seconds, between the reference timer of the output stream (SCR)
11326 and the decoding timestamp (DTS) for any stream present
11327 (demux to decode delay).
11331 .\" --------------------------------------------------------------------------
11332 .\" environment variables
11333 .\" --------------------------------------------------------------------------
11335 .SH ENVIRONMENT VARIABLES
11337 There are a number of environment variables that can be used to
11338 control the behavior of MPlayer and MEncoder.
11341 .B MPLAYER_CHARSET (also see \-msgcharset)
11342 Convert console messages to the specified charset (default: autodetect).
11343 A value of "noconv" means no conversion.
11347 Directory where MPlayer looks for user settings.
11350 .B MPLAYER_LOCALEDIR
11351 Directory where MPlayer looks for gettext translation files (if enabled).
11354 .B MPLAYER_VERBOSE (also see \-v and \-msglevel)
11355 Set the initial verbosity level across all message modules (default: 0).
11356 The resulting verbosity corresponds to that of \-msglevel 5 plus the
11357 value of MPLAYER_VERBOSE.
11363 If LADSPA_PATH is set, it searches for the specified file.
11364 If it is not set, you must supply a fully specified pathname.
11365 FIXME: This is also mentioned in the ladspa section.
11371 Specify a directory in which to store title key values.
11372 This will speed up descrambling of DVDs which are in the cache.
11373 The DVDCSS_CACHE directory is created if it does not exist,
11374 and a subdirectory is created named after the DVD's title
11375 or manufacturing date.
11376 If DVDCSS_CACHE is not set or is empty, libdvdcss will use
11377 the default value which is "${HOME}/.dvdcss/" under Unix and
11378 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" under Win32.
11379 The special value "off" disables caching.
11383 Sets the authentication and decryption method that
11384 libdvdcss will use to read scrambled discs.
11385 Can be one of title, key or disc.
11389 is the default method.
11390 libdvdcss will use a set of calculated player keys to try and get the disc key.
11391 This can fail if the drive does not recognize any of the player keys.
11393 is a fallback method when key has failed.
11394 Instead of using player keys, libdvdcss will crack the disc key using
11395 a brute force algorithm.
11396 This process is CPU intensive and requires 64 MB of memory to store
11399 is the fallback when all other methods have failed.
11400 It does not rely on a key exchange with the DVD drive, but rather uses
11401 a crypto attack to guess the title key.
11402 On rare cases this may fail because there is not enough encrypted data
11403 on the disc to perform a statistical attack, but in the other hand it
11404 is the only way to decrypt a DVD stored on a hard disc, or a DVD with
11405 the wrong region on an RPC2 drive.
11410 .B DVDCSS_RAW_DEVICE
11411 Specify the raw device to use.
11412 Exact usage will depend on your operating system, the Linux
11413 utility to set up raw devices is raw(8) for instance.
11414 Please note that on most operating systems, using a raw device
11415 requires highly aligned buffers: Linux requires a 2048 bytes
11416 alignment (which is the size of a DVD sector).
11420 Sets the libdvdcss verbosity level.
11424 Outputs no messages at all.
11426 Outputs error messages to stderr.
11428 Outputs error messages and debug messages to stderr.
11434 Skip retrieving all keys on startup.
11435 Currently disabled.
11439 FIXME: Document this.
11444 .B AO_SUN_DISABLE_SAMPLE_TIMING
11445 FIXME: Document this.
11449 FIXME: Document this.
11453 Specifies the Network Audio System server to which the
11454 nas audio output driver should connect and the transport
11455 that should be used.
11456 If unset DISPLAY is used instead.
11457 The transport can be one of tcp and unix.
11458 Syntax is tcp/<somehost>:<someport>, <somehost>:<instancenumber>
11459 or [unix]:<instancenumber>.
11460 The NAS base port is 8000 and <instancenumber> is added to that.
11467 .IPs AUDIOSERVER=somehost:0
11468 Connect to NAS server on somehost using default port and transport.
11469 .IPs AUDIOSERVER=tcp/somehost:8000
11470 Connect to NAS server on somehost listening on TCP port 8000.
11471 .IPs AUDIOSERVER=(unix)?:0
11472 Connect to NAS server instance 0 on localhost using unix domain sockets.
11478 FIXME: Document this.
11484 FIXME: Document this.
11488 Set this to 'disable' in order to stop the VIDIX driver from controlling
11489 alphablending settings.
11490 You can then manipulate it yourself with 'ivtvfbctl'.
11496 FIXME: Document this.
11502 FIXME: Document this.
11506 FIXME: Document this.
11510 FIXME: Document this.
11516 FIXME: Document this.
11520 FIXME: Document this.
11524 FIXME: Document this.
11528 FIXME: Document this.
11532 FIXME: Document this.
11538 FIXME: Document this.
11542 FIXME: Document this.
11546 FIXME: Document this.
11552 FIXME: Document this.
11556 FIXME: Document this.
11560 FIXME: Document this.
11564 FIXME: Document this.
11568 FIXME: Document this.
11572 FIXME: Document this.
11576 .\" --------------------------------------------------------------------------
11578 .\" --------------------------------------------------------------------------
11583 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
11584 MPlayer system-wide settings
11587 /usr/\:local/\:etc/\:mplayer/\:mencoder.conf
11588 MEncoder system-wide settings
11591 ~/.mplayer/\:config
11592 MPlayer user settings
11595 ~/.mplayer/\:mencoder.conf
11596 MEncoder user settings
11599 ~/.mplayer/\:input.conf
11600 input bindings (see '\-input keylist' for the full list)
11604 font directory (There must be a font.desc file and files with .RAW extension.)
11607 ~/.mplayer/\:DVDkeys/
11611 Assuming that /path/\:to/\:movie.avi is played, MPlayer searches for sub files
11614 /path/\:to/\:movie.sub
11616 ~/.mplayer/\:sub/\:movie.sub
11621 .\" --------------------------------------------------------------------------
11623 .\" --------------------------------------------------------------------------
11625 .SH EXAMPLES OF MPLAYER USAGE
11628 .B Quickstart Blu\-ray playing:
11630 mplayer br:////path/to/disc
11631 mplayer br:// \-bluray\-device /path/to/disc
11635 .B Quickstart DVD playing:
11641 .B Play in Japanese with English subtitles:
11643 mplayer dvd://1 \-alang ja \-slang en
11647 .B Play only chapters 5, 6, 7:
11649 mplayer dvd://1 \-chapter 5\-7
11653 .B Play only titles 5, 6, 7:
11659 .B Play a multiangle DVD:
11661 mplayer dvd://1 \-dvdangle 2
11665 .B Play from a different DVD device:
11667 mplayer dvd://1 \-dvd\-device /dev/\:dvd2
11671 .B Play DVD video from a directory with VOB files:
11673 mplayer dvd://1 \-dvd\-device /path/\:to/\:directory/
11677 .B Copy a DVD title to hard disk, saving to file "title1.vob":
11679 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
11683 .B Play a DVD with dvdnav from path /dev/sr1:
11685 mplayer dvdnav:////dev/sr1
11689 .B Stream from HTTP:
11691 mplayer http://mplayer.hq/example.avi
11695 .B Stream using RTSP:
11697 mplayer rtsp://server.example.com/streamName
11701 .B Convert subtitles to MPsub format:
11703 mplayer dummy.avi \-sub source.sub \-dumpmpsub
11707 .B Convert subtitles to MPsub format without watching the movie:
11709 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub
11713 .B input from standard V4L:
11715 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
11719 .B Playback on Zoran cards (old style, deprecated):
11721 mplayer \-vo zr \-vf scale=352:288 file.avi
11725 .B Playback on Zoran cards (new style):
11727 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
11731 .B Play DTS-CD with passthrough:
11733 mplayer \-ac hwdts \-rawaudio format=0x2001 \-cdrom\-device /dev/cdrom cdda://
11736 You can also use \-afm hwac3 instead of \-ac hwdts.
11737 Adjust '/dev/cdrom' to match the CD-ROM device on your system.
11738 If your external receiver supports decoding raw DTS streams,
11739 you can directly play it via cdda:// without setting format, hwac3 or hwdts.
11742 .B Play a 6-channel AAC file with only two speakers:
11744 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
11747 You might want to play a bit with the pan values (e.g multiply with a value) to
11748 increase volume or avoid clipping.
11751 .B checkerboard invert with geq filter:
11753 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'
11757 .SH EXAMPLES OF MENCODER USAGE
11760 .B Encode DVD title #2, only selected chapters:
11762 mencoder dvd://2 \-chapter 10\-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11766 .B Encode DVD title #2, resizing to 640x480:
11768 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11772 .B Encode DVD title #2, resizing to 512xHHH (keep aspect ratio):
11774 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
11778 .B The same, but with bitrate set to 1800kbit and optimized macroblocks:
11780 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
11784 .B The same, but with MJPEG compression:
11786 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800
11790 .B Encode all *.jpg files in the current directory:
11792 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
11796 .B Encode from a tuner (specify a format with \-vf format):
11798 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
11802 .B Encode from a pipe:
11804 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
11808 .\" --------------------------------------------------------------------------
11809 .\" Bugs, authors, standard disclaimer
11810 .\" --------------------------------------------------------------------------
11814 If you find one, report it to us, but please make sure you have read all
11815 of the documentation first.
11816 Also look out for smileys. :)
11817 Many bugs are the result of incorrect setup or parameter usage.
11818 The bug reporting section of the documentation
11819 (http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:bugreports.html)
11820 explains how to create useful bug reports.
11825 MPlayer was initially written by Arpad Gereoffy.
11826 See the AUTHORS file for a list of some of the many other contributors.
11828 MPlayer is (C) 2000\-2009 The MPlayer Team
11830 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
11831 It is maintained by Diego Biurrun.
11832 Please send mails about it to the MPlayer-DOCS mailing list.
11833 Translation specific mails belong on the MPlayer-translations mailing list.