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 .\" --------------------------------------------------------------------------
41 .\" --------------------------------------------------------------------------
47 [options] [file|URL|playlist|\-]
52 [specific options] [file2] [specific options]
57 {group of files and options}
58 [group-specific options]
62 [br]://[title][/device]
67 [dvd|dvdnav]://[title|[start_title]\-end_title][/device]
76 tv://[channel][/input_id]
81 radio://[channel|frequency][/capture]
91 dvb://[card_number@]channel
96 mf://[filemask|@listfile]
97 [\-mf options] [options]
101 [cdda|cddb]://track[\-endtrack][:speed][/device]
111 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
112 [user:pass@]URL[:port] [options]
121 mpst://host[:port]/URL
126 tivo://host/[list|llist|fsid]
131 .\" --------------------------------------------------------------------------
133 .\" --------------------------------------------------------------------------
137 is a movie player for Linux (runs on many other platforms and CPU
138 architectures, see the documentation).
139 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
140 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
141 native and binary codecs.
142 You can watch VCD, SVCD, DVD, Blu\-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies,
145 MPlayer supports a wide range of video and audio output drivers.
146 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
147 Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
148 VESA (on every VESA-compatible card, even without X11), some low-level
149 card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
150 boards, such as the Siemens DVB, Hauppauge PVR (IVTV) and DXR3/\:Hollywood+.
151 Most of them support software or hardware scaling, so you can enjoy movies in
154 MPlayer has an onscreen display (OSD) for status information, nice big
155 antialiased shaded subtitles and visual feedback for keyboard controls.
156 European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
157 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
158 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
159 DVD subtitles (SPU streams, VOBsub and Closed Captions).
161 Usage examples to get you started quickly can be found at the end
164 .B Also see the HTML documentation!
167 .\" --------------------------------------------------------------------------
168 .\" interactive control
169 .\" --------------------------------------------------------------------------
171 .SH "INTERACTIVE CONTROL"
172 MPlayer has a fully configurable, command-driven control layer
173 which allows you to control MPlayer using keyboard, mouse, joystick
174 or remote control (with LIRC).
175 See the \-input option for ways to customize it.
181 .IPs "LEFT and RIGHT"
182 Seek backward/\:forward 10 seconds.
183 Shift+arrow does a 1 second exact seek (see \-hr\-seek; currently modifier
184 keys like shift only work if used in an X output window).
186 Seek forward/\:backward 1 minute.
187 Shift+arrow does a 5 second exact seek (see \-hr\-seek; currently modifier
188 keys like shift only work if used in an X output window).
189 .IPs "PGUP and PGDWN"
190 Seek forward/\:backward 10 minutes.
192 Decrease/increase current playback speed by 10%.
194 Halve/double current playback speed.
196 Reset playback speed to normal.
198 Go backward/\:forward in the playlist.
200 Go forward in the playlist, even over the end.
202 next/\:previous playtree entry in the parent list
203 .IPs "INS and DEL (ASX playlist only)"
204 next/\:previous alternative source.
206 Pause (pressing again unpauses).
209 Pressing once will pause movie, every consecutive press will play one frame
210 and then go into pause mode again.
212 Stop playing and quit.
214 Stop playing (and quit if \-idle is not used).
216 Adjust audio delay by +/\- 0.1 seconds.
218 Decrease/\:increase volume.
220 Decrease/\:increase volume.
222 Adjust audio balance in favor of left/\:right channel.
225 .IPs "_ (MPEG-TS, AVI and libavformat only)"
226 Cycle through the available video tracks.
227 .IPs "# (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only)"
228 Cycle through the available audio tracks.
229 .IPs "TAB (MPEG-TS and libavformat only)"
230 Cycle through the available programs.
232 Toggle fullscreen (also see \-fs).
234 Toggle stay-on-top (also see \-ontop).
236 Decrease/\:increase pan-and-scan range.
238 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
240 Toggle frame dropping states: none / skip display / skip decoding
241 (see \-framedrop and \-hardframedrop).
243 Toggle subtitle visibility.
245 Cycle through the available subtitles.
247 Step forward/backward in the subtitle list.
249 Toggle displaying "forced subtitles".
251 Toggle subtitle alignment: top / middle / bottom.
253 Adjust subtitle delay by +/\- 0.1 seconds.
255 Toggle subtitle VSFilter aspect compatibility mode.
256 See -ass\-vsfilter\-aspect\-compat for more info.
257 .IPs "C (\-capture only)"
258 Start/stop capturing the primary stream.
260 Move subtitles up/down.
261 .IPs "i (\-edlout mode only)"
262 Set start or end of an EDL skip and write it out to the given file.
263 .IPs "s (\-vf screenshot only)"
265 .IPs "S (\-vf screenshot only)"
266 Start/stop taking screenshots.
268 Show filename on the OSD.
270 Show progression bar, elapsed time and total duration on the OSD.
272 Seek to the beginning of the previous/next chapter.
273 .IPs "D (\-vo vdpau, \-vf yadif, \-vf kerndeint only)"
274 Activate/deactivate deinterlacer.
276 Cycle through the available DVD angles.
277 .IPs "c (currently -vo vdpau and -vo xv only)"
278 Change YUV colorspace.
283 (The following keys are valid only when using a video output that supports
284 the corresponding adjustment, the software equalizer
285 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
302 (The following keys are valid only when using the quartz or corevideo
303 video output driver.)
309 Resize movie window to half its original size.
311 Resize movie window to its original size.
313 Resize movie window to double its original size.
315 Toggle fullscreen (also see \-fs).
316 .IPs "command + [ and command + ]"
317 Set movie window alpha.
322 (The following keys are valid only when using the sdl
323 video output driver.)
329 Cycle through available fullscreen modes.
331 Restore original mode.
336 (The following keys are valid if you have a keyboard
337 with multimedia keys.)
345 Stop playing and quit.
346 .IPs "PREVIOUS and NEXT"
347 Seek backward/\:forward 1 minute.
352 (The following keys are only valid if you compiled with TV or DVB input
353 support and will take precedence over the keys defined above.)
359 Select previous/\:next channel.
368 (The following keys are only valid if you compiled with dvdnav
369 support: They are used to navigate the menus.)
385 Return to nearest menu (the order of preference is: chapter->title->root).
393 (The following keys are used for controlling TV teletext. The data may
394 come from either an analog TV source or an MPEG transport stream.)
400 Switch teletext on/\:off.
402 Go to next/\:prev teletext page.
410 .IPs "button 3 and button 4"
411 Seek backward/\:forward 1 minute.
412 .IPs "button 5 and button 6"
413 Decrease/\:increase volume.
421 .IPs "left and right"
422 Seek backward/\:forward 10 seconds.
424 Seek forward/\:backward 1 minute.
428 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
429 .IPs "button 3 and button 4"
430 Decrease/\:increase volume.
435 .\" --------------------------------------------------------------------------
437 .\" --------------------------------------------------------------------------
440 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
441 \-fs option is \-nofs.
443 If an option is marked as (XXX only), it will only work in combination with
444 the XXX option or if XXX is compiled in.
447 The suboption parser (used for example for \-ao pcm suboptions) supports
448 a special kind of string-escaping intended for use with external GUIs.
450 It has the following format:
452 %n%string_of_length_n
456 mplayer \-ao pcm:file=%10%C:test.wav test.avi
460 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
463 .\" --------------------------------------------------------------------------
464 .\" Configuration files
465 .\" --------------------------------------------------------------------------
467 .SH "CONFIGURATION FILES"
468 You can put all of the options in configuration files which will be read
469 every time MPlayer is run.
470 The system-wide configuration file 'mplayer.conf' is in your configuration
471 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
472 specific one is '~/\:.mplayer/\:config'.
473 User specific options override system-wide options and options given on the
474 command line override either.
475 The syntax of the configuration files is 'option=<value>', everything after
476 a '#' is considered a comment.
477 Options that work without values can be enabled by setting them to 'yes'
478 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
479 Even suboptions can be specified in this way.
481 You can also write file-specific configuration files.
482 If you wish to have a configuration file for a file called 'movie.avi', create a file
483 named 'movie.avi.conf' with the file-specific options in it and put it in
485 You can also put the configuration file in the same directory as the file to
486 be played, as long as you give the \-use\-filedir\-conf option (either on the
487 command line or in your global config file).
488 If a file-specific configuration file is found in the same directory, no
489 file-specific configuration is loaded from ~/.mplayer.
490 In addition, the \-use\-filedir\-conf option enables directory-specific
492 For this, MPlayer first tries to load a mplayer.conf from the same directory as
493 the file played and then tries to load any file-specific configuration.
495 .I EXAMPLE MPLAYER CONFIGURATION FILE:
498 # Use Matrox driver by default.
500 # I love practicing handstands while watching videos.
502 # Decode multiple files from PNG,
503 # start with mf://filemask
505 # Eerie negative images are cool.
509 .\" --------------------------------------------------------------------------
511 .\" --------------------------------------------------------------------------
514 To ease working with different configurations profiles can be defined in the
516 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
517 All following options will be part of the profile.
518 A description (shown by \-profile help) can be defined with the profile-desc
520 To end the profile, start another one or use the profile name 'default'
521 to continue with normal options.
524 .I "EXAMPLE MPLAYER PROFILE:"
529 profile-desc="profile for dvd:// streams"
534 profile-desc="profile for dvdnav:// streams"
540 profile-desc="profile for .flv files"
550 .\" --------------------------------------------------------------------------
552 .\" --------------------------------------------------------------------------
554 .SH "GENERAL OPTIONS"
558 Specify a directory for binary codecs.
561 .B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
562 Override the standard search path and use the specified file
563 instead of the builtin codecs.conf.
566 .B \-include <configuration file>
567 Specify configuration file to be parsed after the default ones.
571 Prints all available options.
574 .B \-msgcharset <charset>
575 Convert console messages to the specified character set (default: autodetect).
576 Text will be in the encoding specified with the \-\-charset configure option.
577 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
580 The option takes effect after command line parsing has finished.
581 The MPLAYER_CHARSET environment variable can help you get rid of
582 the first lines of garbled output.
586 Enable colorful console output on terminals that support ANSI color.
589 .B \-msglevel <all=<level>:<module>=<level>:...>
590 Control verbosity directly for each module.
591 The 'all' module changes the verbosity of all the modules not
592 explicitly specified on the command line.
593 See '\-msglevel help' for a list of all modules.
596 Some messages are printed before the command line is parsed and are
597 therefore not affected by \-msglevel.
598 To control these messages you have to use the MPLAYER_VERBOSE environment
599 variable, see its description below for details.
615 informational messages
617 status messages (default)
631 Prepend module name in front of each console message.
634 .B \-noconfig <options>
635 Do not parse selected configuration files.
638 If \-include or \-use\-filedir\-conf options are
639 specified at the command line, they will be honoured.
641 Available options are:
645 all configuration files
647 system configuration file
649 user configuration file
655 Make console output less verbose; in particular, prevents the status line
656 (i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed.
657 Particularly useful on slow terminals or broken ones which do not properly
658 handle carriage return (i.e.\& \\r).
661 .B \-priority <prio> (Windows and OS/2 only)
662 Set process priority for MPlayer according to the predefined
663 priorities available under Windows and OS/2.
664 Possible values of <prio>:
666 idle|belownormal|normal|abovenormal|high|realtime
671 Using realtime priority can cause system lockup.
675 .B \-profile <profile1,profile2,...>
676 Use the given profile(s), \-profile help displays a list of the defined profiles.
679 .B \-really\-quiet (also see \-quiet)
680 Display even less output and status messages than with \-quiet.
683 .B \-show\-profile <profile>
684 Show the description and content of a profile.
687 .B \-use\-filedir\-conf
688 Look for a file-specific configuration file in the same directory as
689 the file that is being played.
692 May be dangerous if playing from untrusted media.
696 Increment verbosity level, one level for each \-v
697 found on the command line.
704 .B \-autoq <quality> (use with \-vf [s]pp)
705 Dynamically changes the level of postprocessing depending on the available spare
707 The number you specify will be the maximum level used.
708 Usually you can use some big number.
709 You have to use \-vf [s]pp without parameters in order for this to work.
712 .B \-autosync <factor>
713 Gradually adjusts the A/V sync based on audio delay measurements.
714 Specifying \-autosync 0, the default, will cause frame timing to be based
715 entirely on audio delay measurements.
716 Specifying \-autosync 1 will do the same, but will subtly change the A/V
717 correction algorithm.
718 An uneven video framerate in a movie which plays fine with \-nosound can
719 often be helped by setting this to an integer value greater than 1.
720 The higher the value, the closer the timing will be to \-nosound.
721 Try \-autosync 30 to smooth out problems with sound drivers which do
722 not implement a perfect audio delay measurement.
723 With this value, if large A/V sync offsets occur, they will only take about
724 1 or 2 seconds to settle out.
725 This delay in reaction time to sudden A/V offsets should be the only
726 side-effect of turning this option on, for all sound drivers.
730 Prints some statistics on CPU usage and dropped frames at the end of playback.
731 Use in combination with \-nosound and \-vo null for benchmarking only the
735 With this option MPlayer will also ignore frame duration when playing
736 only video (you can think of that as infinite fps).
739 .B \-chapter\-merge\-threshold <number>
740 Threshold for merging almost consecutive ordered chapter parts
741 in milliseconds (default: 100).
742 Some Matroska files with ordered chapters have inaccurate chapter
743 end timestamps, causing a small gap between the end of one chapter and
744 the start of the next one when they should match.
745 If the end of one playback part is less than the given threshold away
746 from the start of the next one then keep playing video normally over the
747 chapter change instead of doing a seek.
750 .B \-colorkey <number>
751 Changes the colorkey to an RGB value of your choice.
752 0x000000 is black and 0xffffff is white.
753 Only supported by the fbdev, svga, vesa, xmga,
754 xover, xv (see \-vo xv:ck) and directx video output drivers.
758 Disables colorkeying.
759 Only supported by the fbdev, svga, vesa, xmga,
760 xover, xv (see \-vo xv:ck) and directx video output drivers.
763 .B \-correct\-pts, \-nocorrect\-pts
764 Switches MPlayer to a mode where timestamps for video frames
765 are calculated differently and video filters which add new frames or
766 modify timestamps of existing ones are supported.
767 Now enabled automatically for most common file formats.
768 The more accurate timestamps can be visible for example when playing
769 subtitles timed to scene changes with the \-ass option.
770 Without \-correct\-pts the subtitle timing will typically be off by some frames.
771 This option does not work correctly with some demuxers and codecs.
774 .B \-crash\-debug (DEBUG CODE)
775 Automatically attaches gdb upon crash or SIGTRAP.
776 Support must be compiled in by configuring with \-\-enable\-crash\-debug.
779 .B \-doubleclick\-time
780 Time in milliseconds to recognize two consecutive button presses as
781 a double-click (default: 300).
782 Set to 0 to let your windowing system decide what a double-click is
786 .B \-edlout <filename>
787 Creates a new file and writes edit decision list (EDL) records to it.
788 During playback, the user hits 'i' to mark the start or end of a skip block.
789 This provides a starting point from which the user can fine-tune EDL entries
791 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
794 .B \-fixed\-vo, \-nofixed\-vo
795 \-fixed\-vo enforces a fixed video system for multiple files (one
796 (un)initialization for all files).
797 Therefore only one window will be opened for all files.
798 Now enabled by default, use \-nofixed\-vo to disable and create a new window
799 whenever the video stream changes.
800 Some of the older drivers may not be fixed-vo compliant.
803 .B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
804 Skip displaying some frames to maintain A/V sync on slow systems.
805 Video filters are not applied to such frames.
806 For B-frames even decoding is skipped completely.
809 .B \-h, \-help, \-\-help
810 Show short summary of options.
813 .B \-hardframedrop (experimental without \-nocorrect\-pts)
814 More intense frame dropping (breaks decoding).
815 Leads to image distortion!
816 Note that especially the libmpeg2 decoder may crash with this,
817 so consider using "\-vc ffmpeg12,".
821 Command that is executed every 30 seconds during playback via system() -
822 i.e.\& using the shell.
825 MPlayer uses this command without any checking, it is your responsibility
826 to ensure it does not cause security problems (e.g.\& make sure to use full
827 paths if "." is in your path like on Windows).
828 It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
830 This can be "misused" to disable screensavers that do not support the proper
831 X API (also see \-stop\-xscreensaver).
832 If you think this is too complicated, ask the author of the screensaver
833 program to support the proper X APIs.
835 .I EXAMPLE for xscreensaver:
836 mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
838 .I EXAMPLE for GNOME screensaver:
839 mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
844 .B \-hr\-seek off|absolute|always
845 Select when to use precise seeks that are not limited to keyframes.
846 Such seeks require decoding video from the previous keyframe up to the target
847 position and so can take some time depending on decoding performance.
848 For some video formats precise seeks are disabled. This option selects the
849 default choice to use for seeks; it's possible to explicitly override that
850 default in the definition of key bindings and in slave mode commands.
854 Never use precise seeks.
856 Use precise seeks if the seek is to an absolute position in the file,
857 such as a chapter seek, but not for relative seeks like the default
858 behavior of arrow keys (default).
860 Use precise seeks whenever possible.
866 Shorthand for \-msglevel identify=4.
867 Show file parameters in an easily parseable format.
868 Also prints more detailed information about subtitle and audio
869 track languages and IDs.
870 In some cases you can get more information by using \-msglevel identify=6.
871 For example, for a DVD or Blu\-ray it will list the chapters and time length
872 of each title, as well as a disk ID.
873 Combine this with \-frames 0 to suppress all video output.
874 The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
875 (hopefully) shellescapes the filenames.
878 .B \-idle (also see \-slave)
879 Makes MPlayer wait idly instead of quitting when there is no file to play.
880 Mostly useful in slave mode where MPlayer can be controlled
881 through input commands.
884 .B \-input <commands>
885 This option can be used to configure certain parts of the input system.
886 Paths are relative to ~/.mplayer/.
889 Autorepeat is currently only supported by joysticks.
891 Available commands are:
896 Specify input configuration file other than the default
897 ~/\:.mplayer/\:input.conf.
898 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
900 Device to be used for Apple IR Remote (default is autodetected, Linux only).
902 Delay in milliseconds before we start to autorepeat a key (0 to disable).
904 Number of key presses to generate per second on autorepeat.
905 .IPs (no)default-bindings
906 Use the key bindings that MPlayer ships with by default.
908 Prints all keys that can be bound to commands.
910 Prints all commands that can be bound to keys.
912 Specifies the joystick device to use (default: /dev/\:input/\:js0).
914 Read commands from the given file.
915 Mostly useful with a FIFO.
918 When the given file is a FIFO MPlayer opens both ends so you can do
919 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
924 .B \-key\-fifo\-size <2\-65000>
925 Specify the size of the FIFO that buffers key events (default: 7).
926 If it is too small some events may be lost.
927 The main disadvantage of setting it to a very large value is that if you
928 hold down a key triggering some particularly slow command then the player
929 may be unresponsive while it processes all the queued commands.
932 .B \-lircconf <filename> (LIRC only)
933 Specifies a configuration file for LIRC (default: ~/.lircrc).
936 .B \-list\-properties
937 Print a list of the available properties.
941 Loops movie playback <number> times.
945 .B \-menu (OSD menu only)
946 Turn on OSD menu support.
949 .B \-menu\-cfg <filename> (OSD menu only)
950 Use an alternative menu.conf.
953 .B \-menu\-chroot <path> (OSD menu only)
954 Chroot the file selection menu to a specific location.
959 .IPs "\-menu\-chroot /home"
960 Will restrict the file selection menu to /\:home and downward (i.e.\& no
961 access to / will be possible, but /home/user_name will).
966 .B \-menu\-keepdir (OSD menu only)
967 File browser starts from the last known location instead of current directory.
970 .B \-menu\-root <value> (OSD menu only)
971 Specify the main menu.
974 .B \-menu\-startup (OSD menu only)
975 Display the main menu at MPlayer startup.
978 .B \-mouse\-movements
979 Permit MPlayer to receive pointer events reported by the video
981 Necessary to select the buttons in DVD menus.
982 Supported for X11-based VOs (x11, xv, etc) and the gl, gl2, direct3d and
987 Turns off AppleIR remote support.
990 .B \-noconsolecontrols
991 Prevent MPlayer from reading key events from standard input.
992 Useful when reading data from standard input.
993 This is automatically enabled when \- is found on the command line.
994 There are situations where you have to set it manually, e.g.\&
995 if you open /dev/\:stdin (or the equivalent on your system), use stdin
996 in a playlist or intend to read from stdin later on via the loadfile or
997 loadlist slave commands.
1000 .B \-noinitial-audio-sync
1001 When starting a video file or after events such as seeking MPlayer will by
1002 default modify the audio stream to make it start from the same timestamp as
1003 video, by either inserting silence at the start or cutting away the first
1005 This option disables that functionality and makes the player behave like
1006 older MPlayer versions did: video and audio are both started immediately
1007 even if their start timestamps differ, and then video timing is gradually
1008 adjusted if necessary to reach correct synchronization later.
1012 Turns off joystick support.
1016 Turns off LIRC support.
1020 Disable mouse button press/\:release input (mozplayerxp's context menu relies
1023 .B \-noordered\-chapters
1024 Disable support for Matroska ordered chapters.
1025 MPlayer will not load or search for video segments from other files,
1026 and will also ignore any chapter order specified for the main file.
1029 .B \-pts\-association\-mode auto|decode|sort
1030 Select the method used to determine which container packet timestamp
1031 corresponds to a particular output frame from the video decoder.
1032 Normally you shouldn't need to change this option.
1036 Try to pick a working mode from the ones below automatically (default)
1038 Use decoder reordering functionality.
1040 Maintain a buffer of unused pts values and use the lowest value for the frame.
1046 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
1048 This wakes up the process every 1/1024 seconds to check the current time.
1049 Useless with modern Linux kernels configured for desktop use as they already
1050 wake up the process with similar accuracy when using normal timed sleep.
1053 .B \-playing\-msg <string>
1054 Print out a string before starting playback.
1055 The following expansions are supported:
1058 Expand to the value of the property NAME.
1060 Expand TEXT only if the property NAME is available.
1062 Expand TEXT only if the property NAME is not available.
1066 .B \-playlist <filename>
1067 Play files according to a playlist file (ASX, Winamp, SMIL, or
1068 one-file-per-line format).
1071 The way MPlayer parses and uses playlist files is not safe against
1072 maliciously constructed files.
1073 Such files may trigger harmful actions.
1074 This has been the case for all MPlayer versions, but unfortunately this
1075 fact was not well documented earlier, and some people have even misguidedly
1076 recommended use of -playlist with untrusted sources.
1077 Do NOT use -playlist with random internet sources or files you don't trust!
1080 This option is considered an entry so options found after it will apply
1081 only to the elements of this playlist.
1083 FIXME: This needs to be clarified and documented thoroughly.
1086 .B \-rtc\-device <device>
1087 Use the specified device for RTC timing.
1091 Play files in random order.
1094 .B \-slave (also see \-input)
1095 Switches on slave mode, in which MPlayer works as a backend for other programs.
1096 Instead of intercepting keyboard events, MPlayer will read commands separated
1097 by a newline (\\n) from stdin.
1100 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
1101 for their description.
1102 Also, this is not intended to disable other inputs, e.g.\& via the video window,
1103 use some other method like \-input nodefault\-bindings:conf=/dev/null for that.
1107 Time frames by repeatedly checking the current time instead of asking the
1108 kernel to wake up MPlayer at the correct time.
1109 Useful if your kernel timing is imprecise and you cannot use the RTC either.
1110 Comes at the price of higher CPU consumption.
1114 Skip <sec> seconds after every frame.
1115 The normal framerate of the movie is kept, so playback is accelerated.
1116 Since MPlayer can only seek to the next keyframe this may be inexact.
1120 .SH "DEMUXER/STREAM OPTIONS"
1124 Select the Dynamic Range Compression level for AC-3 audio streams.
1125 <level> is a float value ranging from 0 to 1, where 0 means no compression
1126 and 1 (which is the default) means full compression (make loud passages more
1127 silent and vice versa).
1128 Values up to 2 are also accepted, but are purely experimental.
1129 This option only shows an effect if the AC-3 stream contains the required range
1130 compression information.
1133 .B \-aid <ID> (also see \-alang)
1134 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1135 VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1136 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1137 When playing an MPEG-TS stream, MPlayer will use the first program (if present)
1138 with the chosen audio stream.
1141 .B \-ausid <ID> (also see \-alang)
1142 Select audio substream channel.
1143 Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled
1144 by the native demuxer (not by libavformat).
1145 The format type may not be correctly identified because of how this information
1146 (or lack thereof) is embedded in the stream, but it will demux correctly the
1147 audio streams when multiple substreams are present.
1148 MPlayer prints the available substream IDs when run with \-identify.
1151 .B \-alang <language code[,language code,...]> (also see \-aid)
1152 Specify a priority list of audio languages to use.
1153 Different container formats employ different language codes.
1154 DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
1155 use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
1156 MPlayer prints the available languages when run in verbose (\-v) mode.
1161 .IPs "mplayer dvd://1 \-alang hu,en"
1162 Chooses the Hungarian language track on a DVD and falls back on English if
1163 Hungarian is not available.
1164 .IPs "mplayer \-alang jpn example.mkv"
1165 Plays a Matroska file in Japanese.
1170 .B \-audio\-demuxer <[+]name> (\-audiofile only)
1171 Force audio demuxer type for \-audiofile.
1172 Use a '+' before the name to force it, this will skip some checks!
1173 Give the demuxer name as printed by \-audio\-demuxer help.
1174 \-audio\-demuxer audio forces MP3.
1177 .B \-audiofile <filename>
1178 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1182 .B \-audiofile\-cache <kBytes>
1183 Enables caching for the stream used by \-audiofile, using the specified
1187 .B \-reuse\-socket (udp:// only)
1188 Allows a socket to be reused by other processes as soon as it is closed.
1191 .B \-bandwidth <Bytes> (network only)
1192 Specify the maximum bandwidth for network streaming (for servers that are
1193 able to send content in different bitrates).
1194 Useful if you want to watch live streamed media behind a slow connection.
1195 With Real RTSP streaming, it is also used to set the maximum delivery
1196 bandwidth allowing faster cache filling and stream dumping.
1199 .B \-bluray\-angle <angle ID> (Blu\-ray only)
1200 Some Blu\-ray discs contain scenes that can be viewed from multiple angles.
1201 Here you can tell MPlayer which angles to use (default: 1).
1204 .B \-bluray\-chapter <chapter ID> (Blu\-ray only)
1205 Tells MPlayer which Blu\-ray chapter to start the current title from (default: 1).
1208 .B \-bluray\-device <path to disc> (Blu\-ray only)
1209 Specify the Blu\-ray disc location. Must be a directory with Blu\-ray structure.
1213 This option specifies how much memory (in kBytes) to use when precaching a
1215 Especially useful on slow media.
1222 .B \-cache\-min <percentage>
1223 Playback will start when the cache has been filled up to <percentage>
1227 .B \-cache\-seek\-min <percentage>
1228 If a seek is to be made to a position within <percentage> of the cache size
1229 from the current position, MPlayer will wait for the cache to be filled to
1230 this position rather than performing a stream seek (default: 50).
1234 Allows capturing the primary stream (not additional audio tracks or other
1235 kind of streams) into the file specified by \-dumpfile or \"stream.dump\"
1237 If this option is given, capturing can be started and stopped by pressing
1238 the key bound to this function (see section INTERACTIVE CONTROL).
1239 Same as for \-dumpstream, this will likely not produce usable results for
1240 anything else than MPEG streams.
1241 Note that, due to cache latencies, captured data may begin and end
1242 somewhat delayed compared to what you see displayed.
1245 .B \-cdda <option1:option2> (CDDA only)
1246 This option can be used to tune the CD Audio reading feature of MPlayer.
1248 Available options are:
1252 .IPs paranoia=<0\-2>
1254 Values other than 0 seem to break playback of anything but the first track.
1256 0: disable checking (default)
1258 1: overlap checking only
1260 2: full data correction and verification
1262 .IPs generic-dev=<value>
1263 Use specified generic SCSI device.
1264 .IPs sector-size=<value>
1265 Set atomic read size.
1266 .IPs overlap=<value>
1267 Force minimum overlap search during verification to <value> sectors.
1269 Assume that the beginning offset of track 1 as reported in the TOC will be
1271 Some Toshiba drives need this for getting track boundaries correct.
1272 .IPs toc-offset=<value>
1273 Add <value> sectors to the values reported when addressing tracks.
1276 (Never) accept imperfect data reconstruction.
1280 .B \-cdrom\-device <path to device>
1281 Specify the CD-ROM device (default: /dev/\:cdrom).
1284 .B \-channels <number> (also see \-af channels)
1285 Request the number of playback channels (default: 2).
1286 MPlayer asks the decoder to decode the audio into as many channels as
1288 Then it is up to the decoder to fulfill the requirement.
1289 This is usually only important when playing videos with AC-3 audio (like DVDs).
1290 In that case liba52 does the decoding by default and correctly downmixes the
1291 audio into the requested number of channels.
1292 To directly control the number of output channels independently of how many
1293 channels are decoded, use the channels filter.
1296 This option is honored by codecs (AC-3 only), filters (surround) and audio
1297 output drivers (OSS at least).
1299 Available options are:
1315 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1316 Specify which chapter to start playing at.
1317 Optionally specify which chapter to end playing at (default: 1).
1320 .B \-edition <edition ID> (Matroska only)
1321 Specify the edition (set of chapters) to use, where 0 is the first. If set to
1322 -1 (the default), MPlayer will choose the first edition declared as a default,
1323 or if there is no default, the first edition defined.
1326 .B \-cookies (network only)
1327 Send cookies when making HTTP requests.
1330 .B \-cookies\-file <filename> (network only)
1331 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1332 and skip reading from default locations.
1333 The file is assumed to be in Netscape format.
1337 audio delay in seconds (positive or negative float value)
1339 Negative values delay the audio, and positive values delay the video.
1343 Ignore the specified starting time for streams in AVI files.
1344 This nullifies stream delays.
1347 .B \-demuxer <[+]name>
1349 Use a '+' before the name to force it, this will skip some checks!
1350 Give the demuxer name as printed by \-demuxer help.
1354 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
1355 in most other cases the resulting file will not be playable).
1356 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1357 on the command line only the last one will work.
1360 .B \-dumpfile <filename>
1361 Specify which file MPlayer should dump to.
1362 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream /
1367 Dumps the raw stream to ./stream.dump.
1368 Useful when ripping from DVD or network.
1369 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1370 on the command line only the last one will work.
1374 Dump raw compressed video stream to ./stream.dump (not very usable).
1375 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1376 on the command line only the last one will work.
1379 .B \-dvbin <options> (DVB only)
1380 Pass the following parameters to the DVB input module, in order to override
1386 Specifies using card number 1\-4 (default: 1).
1387 .IPs file=<filename>
1388 Instructs MPlayer to read the channels list from <filename>.
1389 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1390 or ~/.mplayer/\:channels.conf as a last resort.
1391 .IPs timeout=<1\-30>
1392 Maximum number of seconds to wait when trying to tune a
1393 frequency before giving up (default: 30).
1398 .B \-dvd\-device <path to device> (DVD only)
1399 Specify the DVD device or .iso filename (default: /dev/\:dvd).
1400 You can also specify a directory that contains files previously copied directly
1401 from a DVD (with e.g.\& vobcopy).
1404 .B \-dvd\-speed <factor or speed in KB/s> (DVD only)
1405 Try to limit DVD speed (default: 0, no change).
1406 DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
1408 Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
1409 quiet and fast enough.
1410 MPlayer resets the speed to the drive default value on close.
1411 Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
1415 You need write access to the DVD device to change the speed.
1418 .B \-dvdangle <angle ID> (DVD only)
1419 Some DVD discs contain scenes that can be viewed from multiple angles.
1420 Here you can tell MPlayer which angles to use (default: 1).
1424 Enables edit decision list (EDL) actions during playback.
1425 Video will be skipped over and audio will be muted and unmuted according to
1426 the entries in the given file.
1427 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1431 .B \-endpos <[[hh:]mm:]ss[.ms]> (also see \-ss and \-sb)
1435 When used in conjunction with \-ss option, \-endpos time will shift forward by
1436 seconds specified with \-ss.
1443 .IPs "\-endpos 01:10:00"
1444 Stop at 1 hour 10 minutes.
1445 .IPs "\-ss 10 \-endpos 56"
1446 Stop at 1 minute 6 seconds.
1452 Force index rebuilding.
1453 Useful for files with broken index (A/V desync, etc).
1454 This will enable seeking in files where seeking was not possible.
1457 This option only works if the underlying media supports seeking
1458 (i.e.\& not with stdin, pipe, etc).
1461 .B \-fps <float value>
1462 Override video framerate.
1463 Useful if the original value is wrong or missing.
1466 .B \-frames <number>
1467 Play/\:convert only first <number> frames, then quit.
1470 .B \-hr\-mp3\-seek (MP3 only)
1472 Enabled when playing from an external MP3 file, as we need to seek
1473 to the very exact position to keep A/V sync.
1474 Can be slow especially when seeking backwards since it has to rewind
1475 to the beginning to find an exact frame position.
1478 .B \-http-header-fields <field1,field2>
1479 Set custom HTTP fields when accessing HTTP stream.
1485 mplayer \-http\-header\-fields 'Field1: value1','Field2: value2' http://localhost:1234
1487 Will generate HTTP request:
1492 Host: localhost:1234
1507 .B \-idx (also see \-forceidx)
1508 Rebuilds index of files if no index was found, allowing seeking.
1509 Useful with broken/\:incomplete downloads, or badly created files.
1512 This option only works if the underlying media supports seeking
1513 (i.e.\& not with stdin, pipe, etc).
1517 Skip rebuilding index file.
1520 .B \-ipv4\-only\-proxy (network only)
1521 Skip the proxy for IPv6 addresses.
1522 It will still be used for IPv4 connections.
1525 .B \-lavfdopts <option1:option2:...>
1526 Specify parameters for libavformat demuxers (\-demuxer lavf).
1527 Separate multiple options with a colon.
1530 Available suboptions are:
1533 .IPs analyzeduration=<value>
1534 Maximum length in seconds to analyze the stream properties.
1536 Force a specific libavformat demuxer.
1537 .IPs o=<key>=<value>[,<key>=<value>[,...]]
1538 Pass AVOptions to libavformat demuxer.
1539 Note, a patch to make the o= unneeded and pass all unknown options through
1540 the AVOption system is welcome.
1541 A full list of AVOptions can be found in the FFmpeg manual.
1542 Note that some options may conflict with MPlayer options.
1549 .IPs o=fflags=+ignidx
1552 .IPs probesize=<value>
1553 Maximum amount of data to probe during the detection phase.
1554 In the case of MPEG-TS this value identifies the maximum number
1555 of TS packets to scan.
1556 .IPs cryptokey=<hexstring>
1557 Encryption key the demuxer should use.
1558 This is the raw binary data of the key converted to a hexadecimal string.
1562 .B \-loadidx <index file>
1563 The file from which to read the video index data saved by \-saveidx.
1564 This index will be used for seeking, overriding any index data
1565 contained in the AVI itself.
1566 MPlayer will not prevent you from loading an index file generated
1567 from a different AVI, but this is sure to cause unfavorable results.
1570 This option is obsolete now that MPlayer has OpenDML support.
1573 .B \-mc <seconds/frame>
1574 maximum A-V sync correction per frame (in seconds)
1577 .B \-mf <option1:option2:...>
1578 Used when decoding from multiple PNG or JPEG files.
1580 Available options are:
1585 input file width (default: autodetect)
1587 input file height (default: autodetect)
1589 output fps (default: 25)
1591 input file type (available: jpeg, png, tga, sgi)
1597 Force usage of non-interleaved AVI parser (fixes playback
1598 of some bad AVI files).
1601 .B \-nobps (AVI only)
1602 Do not use average byte/\:second value for A-V sync.
1603 Helps with some AVI files with broken header.
1607 Disables extension-based demuxer selection.
1608 By default, when the file type (demuxer) cannot be detected reliably
1609 (the file has no header or it is not reliable enough), the filename
1610 extension is used to select the demuxer.
1611 Always falls back on content-based demuxer selection.
1614 .B \-passwd <password> (also see \-user) (network only)
1615 Specify password for HTTP authentication.
1618 .B \-prefer\-ipv4 (network only)
1619 Use IPv4 on network connections.
1620 Falls back on IPv6 automatically.
1623 .B \-prefer\-ipv6 (IPv6 network only)
1624 Use IPv6 on network connections.
1625 Falls back on IPv4 automatically.
1628 .B \-psprobe <byte position>
1629 When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
1630 how many bytes in the stream you want MPlayer to scan in order to identify
1631 the video codec used.
1632 This option is needed to play EVO or VDR files containing H.264 streams.
1635 .B \-pvr <option1:option2:...> (PVR only)
1636 This option tunes various encoding properties of the PVR capture module.
1637 It has to be used with any hardware MPEG encoder based card supported by the
1639 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1640 cards are known as PVR capture cards.
1641 Be aware that only Linux 2.6.18 kernel
1642 and above is able to handle MPEG stream through V4L2 layer.
1643 For hardware capture of an MPEG stream and watching it with
1644 MPlayer, use 'pvr://' as a movie URL.
1646 Available options are:
1649 Specify input aspect ratio:
1659 .IPs arate=<32000\-48000>
1660 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1663 Specify MPEG audio layer encoding (default: 2).
1664 .IPs abitrate=<32\-448>
1665 Specify audio encoding bitrate in kbps (default: 384).
1667 Specify audio encoding mode.
1668 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1669 .IPs vbitrate=<value>
1670 Specify average video bitrate encoding in Mbps (default: 6).
1672 Specify video encoding mode:
1674 vbr: Variable BitRate (default)
1676 cbr: Constant BitRate
1679 Specify peak video bitrate encoding in Mbps
1680 (only useful for VBR encoding, default: 9.6).
1682 Choose an MPEG format for encoding:
1684 ps: MPEG-2 Program Stream (default)
1686 ts: MPEG-2 Transport Stream
1688 mpeg1: MPEG-1 System Stream
1690 vcd: Video CD compatible stream
1692 svcd: Super Video CD compatible stream
1694 dvd: DVD compatible stream
1700 .B \-radio <option1:option2:...> (radio only)
1701 These options set various parameters of the radio capture module.
1702 For listening to radio with MPlayer use 'radio://<frequency>'
1703 (if channels option is not given) or 'radio://<channel_number>'
1704 (if channels option is given) as a movie URL.
1705 You can see allowed frequency range by running MPlayer with '\-v'.
1706 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1707 If the capture keyword is not given you can listen to radio
1708 using the line-in cable only.
1709 Using capture to listen is not recommended due to synchronization
1710 problems, which makes this process uncomfortable.
1712 Available options are:
1715 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1717 Radio driver to use (default: v4l2 if available, otherwise v4l).
1718 Currently, v4l and v4l2 drivers are supported.
1719 .IPs volume=<0..100>
1720 sound volume for radio device (default 100)
1721 .IPs "freq_min=<value> (*BSD BT848 only)"
1722 minimum allowed frequency (default: 87.50)
1723 .IPs "freq_max=<value> (*BSD BT848 only)"
1724 maximum allowed frequency (default: 108.00)
1725 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1727 Use _ for spaces in names (or play with quoting ;-).
1728 The channel names will then be written using OSD and the slave commands
1729 radio_step_channel and radio_set_channel will be usable for
1730 a remote control (see LIRC).
1731 If given, number in movie URL will be treated as channel position in
1735 radio://1, radio://104.4, radio_set_channel 1
1736 .IPs "adevice=<value> (radio capture only)"
1737 Name of device to capture sound from.
1738 Without such a name capture will be disabled,
1739 even if the capture keyword appears in the URL.
1740 For ALSA devices use it in the form hw=<card>.<device>.
1741 If the device name contains a '=', the module will use
1742 ALSA to capture, otherwise OSS.
1743 .IPs "arate=<value> (radio capture only)"
1744 Rate in samples per second (default: 44100).
1747 When using audio capture set also \-rawaudio rate=<value> option
1748 with the same value as arate.
1749 If you have problems with sound speed (runs too quickly), try to play
1750 with different rate values (e.g.\& 48000,44100,32000,...).
1751 .IPs "achannels=<value> (radio capture only)"
1752 Number of audio channels to capture.
1756 .B \-rawaudio <option1:option2:...>
1757 This option lets you play raw audio files.
1758 You have to use \-demuxer rawaudio as well.
1759 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1760 For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1762 Available options are:
1766 .IPs channels=<value>
1769 rate in samples per second
1770 .IPs samplesize=<value>
1771 sample size in bytes
1772 .IPs bitrate=<value>
1773 bitrate for rawaudio files
1780 .B \-rawvideo <option1:option2:...>
1781 This option lets you play raw video files.
1782 You have to use \-demuxer rawvideo as well.
1784 Available options are:
1789 rate in frames per second (default: 25.0)
1790 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1791 set standard image size
1793 image width in pixels
1795 image height in pixels
1796 .IPs i420|yv12|yuy2|y8
1799 colorspace (fourcc) in hex or string constant.
1800 Use \-rawvideo format=help for a list of possible strings.
1810 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1811 Play the famous "foreman" sample video.
1812 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1813 Play a raw YUV sample.
1818 .B \-referrer <string> (network only)
1819 Specify a referrer path or URL for HTTP requests.
1823 Used with 'rtsp://' URLs to force the client's port number.
1824 This option may be useful if you are behind a router and want to forward
1825 the RTSP stream from the server to a specific client.
1828 .B \-rtsp\-destination
1829 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1830 This option may be useful with some RTSP server which do not
1831 send RTP packets to the right interface.
1832 If the connection to the RTSP server fails, use \-v to see
1833 which IP address MPlayer tries to bind to and try to force
1834 it to one assigned to your computer instead.
1837 .B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
1838 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1839 packets be streamed over TCP (using the same TCP connection as RTSP).
1840 This option may be useful if you have a broken internet connection that does
1841 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1844 .B \-rtsp\-stream\-over\-http (LIVE555 only)
1845 Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP
1846 packets be streamed over HTTP.
1849 .B \-saveidx <filename>
1850 Force index rebuilding and dump the index to <filename>.
1851 Currently this only works with AVI files.
1854 This option is obsolete now that MPlayer has OpenDML support.
1857 .B \-sb <byte position> (also see \-ss)
1858 Seek to byte position.
1859 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1862 .B \-speed <0.01\-100>
1863 Slow down or speed up playback by the factor given as parameter.
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 input audio sample rate.
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 A value of 1 (default) means to do video capture only and let the
2029 audio go through a loopback cable from the TV card to the sound card.
2031 Use hardware MJPEG compression (if the card supports it).
2032 When using this option, you do not need to specify the width and height
2033 of the output window, because MPlayer will determine it automatically
2034 from the decimation value (see below).
2035 .IPs decimation=<1|2|4>
2036 choose the size of the picture that will be compressed by hardware
2051 .IPs quality=<0\-100>
2052 Choose the quality of the JPEG compression
2053 (< 60 recommended for full size).
2054 .IPs tdevice=<value>
2055 Specify TV teletext device (example: /dev/\:vbi0) (default: none).
2056 .IPs tformat=<format>
2057 Specify TV teletext display format (default: 0):
2063 2: opaque with inverted colors
2065 3: transparent with inverted colors
2067 .IPs tpage=<100\-899>
2068 Specify initial TV teletext page number (default: 100).
2069 .IPs tlang=<\-1\-127>
2070 Specify default teletext language code (default: 0), which will be used
2071 as primary language until a type 28 packet is received.
2072 Useful when the teletext system uses a non-latin character set, but language
2073 codes are not transmitted via teletext type 28 packets for some reason.
2074 To see a list of supported language codes set this option to \-1.
2075 .IPs "hidden_video_renderer (dshow only)"
2076 Terminate stream with video renderer instead of Null renderer (default: off).
2077 Will help if video freezes but audio does not.
2079 May not work with \-vo directx and \-vf crop combination.
2080 .IPs "hidden_vp_renderer (dshow only)"
2081 Terminate VideoPort pin stream with video renderer
2082 instead of removing it from the graph (default: off).
2083 Useful if your card has a VideoPort pin and video is choppy.
2085 May not work with \-vo directx and \-vf crop combination.
2086 .IPs "system_clock (dshow only)"
2087 Use the system clock as sync source instead of the default graph clock
2088 (usually the clock from one of the live sources in graph).
2089 .IPs "normalize_audio_chunks (dshow only)"
2090 Create audio chunks with a time length equal to
2091 video frame time length (default: off).
2092 Some audio cards create audio chunks about 0.5s in size, resulting in
2093 choppy video when using immediatemode=0.
2097 .B \-tvscan <option1:option2:...> (TV only)
2098 Tune the TV channel scanner.
2099 MPlayer will also print value for "-tv channels=" option,
2100 including existing and just found channels.
2102 Available suboptions are:
2105 Begin channel scanning immediately after startup (default: disabled).
2106 .IPs period=<0.1\-2.0>
2107 Specify delay in seconds before switching to next channel (default: 0.5).
2108 Lower values will cause faster scanning, but can detect
2109 inactive TV channels as active.
2110 .IPs threshold=<1\-100>
2111 Threshold value for the signal strength (in percent), as reported
2112 by the device (default: 50).
2113 A signal strength higher than this value will indicate that the
2114 currently scanning channel is active.
2118 .B \-user <username> (also see \-passwd) (network only)
2119 Specify username for HTTP authentication.
2122 .B \-user\-agent <string>
2123 Use <string> as user agent for HTTP streaming.
2127 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
2128 When playing an MPEG-TS stream, MPlayer will use the first program (if present)
2129 with the chosen video stream.
2132 .B \-vivo <suboption> (DEBUG CODE)
2133 Force audio parameters for the VIVO demuxer (for debugging purposes).
2134 FIXME: Document this.
2138 .SH "OSD/SUBTITLE OPTIONS"
2140 Also see \-vf expand.
2143 .B \-ass, \-noass (FreeType only)
2144 Use libass to render all text subtitles.
2145 This enables support for the native styling of SSA/ASS subtitles,
2146 and also support for some styling features in other subtitle formats by
2147 conversion to ASS markup.
2148 Enabled by default if the player was compiled with libass support.
2151 Some of the other subtitle options were written for the old non-libass
2152 subtitle rendering system and may not work the same way or at all with
2153 libass rendering enabled.
2156 .B \-ass\-border\-color <value>
2157 Sets the border (outline) color for text subtitles.
2158 The color format is RRGGBBAA.
2161 .B \-ass\-bottom\-margin <value>
2162 Adds a black band at the bottom of the frame.
2163 The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
2166 .B \-ass\-color <value>
2167 Sets the color for text subtitles.
2168 The color format is RRGGBBAA.
2171 .B \-ass\-font\-scale <value>
2172 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
2175 .B \-ass\-force\-style <[Style.]Param=Value[,...]>
2176 Override some style or script info parameters.
2181 \-ass\-force\-style FontName=Arial,Default.Bold=1
2183 \-ass\-force\-style PlayResY=768
2188 .B \-ass\-hinting <type>
2196 FreeType autohinter, light mode
2198 FreeType autohinter, normal mode
2202 The same, but hinting will only be performed if the OSD is rendered at
2203 screen resolution and will therefore not be scaled.
2206 The default value is 5 (use light hinter for unscaled OSD and no hinting otherwise).
2211 .B \-ass\-line\-spacing <value>
2212 Set line spacing value for SSA/ASS renderer.
2215 .B \-ass\-styles <filename>
2216 Load all SSA/ASS styles found in the specified file and use them for
2217 rendering text subtitles.
2218 The syntax of the file is exactly like the
2219 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
2222 .B \-ass\-top\-margin <value>
2223 Adds a black band at the top of the frame.
2224 The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
2227 .B \-ass\-use\-margins
2228 Enables placing toptitles and subtitles in black borders when they
2232 .B \-ass\-vsfilter\-aspect\-compat
2233 Stretch SSA/ASS subtitles when playing anamorphic videos for compatibility
2234 with traditional VSFilter behavior.
2235 This switch has no effect when the video is stored with square pixels.
2237 The renderer historically most commonly used for the SSA/ASS subtitle formats,
2238 VSFilter, had questionable behavior that resulted in subtitles being
2239 stretched too if the video was stored in anamorphic format that required
2240 scaling for display.
2241 This behavior is usually undesirable and newer VSFilter versions may
2243 However, many existing scripts compensate for the stretching by modifying
2244 things in the opposite direction.
2245 Thus if such scripts are displayed "correctly" they will not appear as intended.
2246 This switch enables emulation of the old VSFilter behavior (undesirable but
2247 expected by many existing scripts).
2252 Convert the given subtitle (specified with the \-sub option) to the time-based
2253 JACOsub subtitle format.
2254 Creates a dumpsub.js file in the current directory.
2257 .B \-dumpmicrodvdsub
2258 Convert the given subtitle (specified with the \-sub option) to the
2259 MicroDVD subtitle format.
2260 Creates a dumpsub.sub file in the current directory.
2264 Convert the given subtitle (specified with the \-sub option) to MPlayer's
2265 subtitle format, MPsub.
2266 Creates a dump.mpsub file in the current directory.
2270 Convert the given subtitle (specified with the \-sub option) to the time-based
2271 SAMI subtitle format.
2272 Creates a dumpsub.smi file in the current directory.
2276 Convert the given subtitle (specified with the \-sub option) to the time-based
2277 SubViewer (SRT) subtitle format.
2278 Creates a dumpsub.srt file in the current directory.
2281 Some broken hardware players choke on SRT subtitle files with Unix
2283 If you are unlucky enough to have such a box, pass your subtitle
2284 files through unix2dos or a similar program to replace Unix line
2285 endings with DOS/Windows line endings.
2288 .B \-dumpsub (BETA CODE)
2289 Dumps the subtitle substream from VOB streams.
2290 Also see the \-dump*sub options.
2293 .B \-noembeddedfonts
2294 Disables use of fonts embedded in Matroska containers and ASS scripts (default: enabled).
2295 These fonts can be used for SSA/ASS subtitle
2296 rendering (\-ass option).
2299 .B \-ffactor <number>
2300 Resample the font alphamap.
2307 very narrow black outline (default)
2309 narrow black outline
2316 .B \-flip\-hebrew (FriBiDi only)
2317 Turns on flipping subtitles using FriBiDi.
2320 .B \-noflip\-hebrew\-commas
2321 Change FriBiDi's assumptions about the placements of commas in subtitles.
2322 Use this if commas in subtitles are shown at the start of a sentence
2323 instead of at the end.
2326 .B \-font <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
2327 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
2328 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
2329 ~/.mplayer/\:subfont.ttf).
2332 With FreeType, this option determines the path to the text font file.
2333 With Fontconfig, this option determines the Fontconfig font pattern.
2338 \-font ~/\:.mplayer/\:arial-14/\:font.desc
2340 \-font ~/\:.mplayer/\:arialuni.ttf
2342 \-font 'Bitstream Vera Sans'
2344 \-font 'Bitstream Vera Sans:style=Bold'
2349 .B \-fontconfig, \-nofontconfig (fontconfig only)
2350 Enables the use of fontconfig managed fonts. Enabled by default.
2354 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
2358 .B \-fribidi\-charset <charset name> (FriBiDi only)
2359 Specifies the character set that will be passed to FriBiDi when
2360 decoding non-UTF-8 subtitles (default: ISO8859-8).
2363 .B \-ifo <VOBsub IFO file>
2364 Indicate the file that will be used to load palette and frame size for VOBsub
2369 Turns off automatic subtitle file loading.
2372 .B \-osd\-duration <time>
2373 Set the duration of the OSD messages in ms (default: 1000).
2376 .B \-osd\-fractions <0\-2>
2377 Set how fractions of seconds of the current timestamp are printed on the OSD:
2381 Do not display fractions (default).
2383 Show the first two decimals.
2385 Show approximate frame count within current second.
2386 This frame count is not accurate but only an approximation.
2387 For variable fps, the approximation is known to be far off the correct frame
2393 .B \-osdlevel <0\-3>
2394 Specifies which mode the OSD should start in.
2400 volume + seek (default)
2402 volume + seek + timer + percentage
2404 volume + seek + timer + percentage + total time
2410 Allows the next subtitle to be displayed while the current one is
2411 still visible (default is to enable the support only for specific
2415 .B \-sid <ID> (also see \-slang, \-vobsubid)
2416 Display the subtitle stream specified by <ID> (0\-31).
2417 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2418 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2422 Disables any otherwise auto-selected internal subtitles (as e.g.\& the Matroska/mkv
2424 Use \-noautosub to disable the loading of external subtitle files.
2427 .B \-slang <language code[,language code,...]> (also see \-sid)
2428 Specify a priority list of subtitle languages to use.
2429 Different container formats employ different language codes.
2430 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2431 three letter language codes while OGM uses a free-form identifier.
2432 MPlayer prints the available languages when run in verbose (\-v) mode.
2437 .IPs "mplayer dvd://1 \-slang hu,en"
2438 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2439 Hungarian is not available.
2440 .IPs "mplayer \-slang jpn example.mkv"
2441 Plays a Matroska file with Japanese subtitles.
2447 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2448 A value of 16 may be added to <mode> in order to force scaling even
2449 when original and scaled frame size already match.
2450 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2451 Available modes are:
2455 none (fastest, very ugly)
2457 approximate (broken?)
2461 bilinear (default, fast and not too bad)
2463 uses swscaler gaussian blur (looks very good)
2468 .B \-spualign <\-1\-2>
2469 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2475 Align at top (original behavior, default).
2484 .B \-spugauss <0.0\-3.0>
2485 Variance parameter of gaussian used by \-spuaa 4.
2486 Higher means more blur (default: 1.0).
2489 .B \-sub <subtitlefile1,subtitlefile2,...>
2490 Use/\:display these subtitle files.
2491 Only one file can be displayed at the same time.
2494 .B \-sub\-bg\-alpha <0\-255>
2495 Specify the alpha channel value for subtitles and OSD backgrounds.
2496 Big values mean more transparency.
2497 0 means completely transparent.
2500 .B \-sub\-bg\-color <0\-255>
2501 Specify the color value for subtitles and OSD backgrounds.
2502 Currently subtitles are grayscale so this value is equivalent to the
2503 intensity of the color.
2504 255 means white and 0 black.
2507 .B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
2508 Force subtitle demuxer type for \-subfile.
2509 Use a '+' before the name to force it, this will skip some checks!
2510 Give the demuxer name as printed by \-sub\-demuxer help.
2513 .B \-sub\-fuzziness <mode>
2514 Adjust matching fuzziness when searching for subtitles:
2520 Load all subs containing movie name.
2522 Load all subs in the current and \-sub\-paths directories.
2527 .B \-sub\-no\-text\-pp
2528 Disables any kind of text post processing done after loading the subtitles.
2529 Used for debug purposes.
2532 .B \-subalign <0\-2>
2533 Specify which edge of the subtitles should be aligned at the height
2538 Align subtitle top edge (original behavior).
2540 Align subtitle center.
2542 Align subtitle bottom edge (default).
2547 .B "\-subcc <1\-4>\ "
2548 Display DVD Closed Caption (CC) subtitles from the specified channel.
2551 the VOB subtitles, these are special ASCII subtitles for the
2552 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2553 CC subtitles have not been spotted on DVDs from other regions so far.
2556 .B \-subcp <codepage> (iconv only)
2557 If your system supports iconv(3), you can use this option to
2558 specify the subtitle codepage.
2570 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2571 You can specify your language using a two letter language code to
2572 make ENCA detect the codepage automatically.
2573 If unsure, enter anything and watch mplayer \-v output for available
2575 Fallback codepage specifies the codepage to use, when autodetection fails.
2580 .IPs "\-subcp enca:cs:latin2"
2581 Guess the encoding, assuming the subtitles are Czech, fall back on
2582 latin 2, if the detection fails.
2583 .IPs "\-subcp enca:pl:cp1250"
2584 Guess the encoding for Polish, fall back on cp1250.
2589 .B \-sub\-paths <path1:path2:...>
2590 Specify extra directories where to search for subtitles matching the video.
2591 Multiple directories can be separated by ":" (";" on Windows).
2592 Paths can be relative or absolute.
2593 Relative paths are interpreted relative to video file directory.
2597 Assuming that /path/\:to/\:movie/\:movie.avi is played and \-sub\-paths
2598 sub:subtitles:/tmp/subs is specified, MPlayer searches for subtitle files in
2603 /path/\:to/\:movie/\:sub/
2605 /path/\:to/\:movie/\:subtitles/
2615 Delays subtitles by <sec> seconds.
2619 .B \-subfile <filename> (BETA CODE)
2621 Same as \-audiofile, but for subtitle streams (OggDS?).
2624 .B \-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
2625 Sets the subtitle font (see \-font).
2626 If no \-subfont is given, \-font is used.
2629 .B \-subfont\-autoscale <0\-3> (FreeType only)
2630 Sets the autoscale mode.
2633 0 means that text scale and OSD scale are font heights in points.
2642 proportional to movie height
2644 proportional to movie width
2646 proportional to movie diagonal (default)
2651 .B \-subfont\-blur <0\-8> (FreeType only)
2652 Sets the font blur radius (default: 2).
2655 .B \-subfont\-encoding <value> (FreeType only)
2656 Sets the font encoding.
2657 When set to 'unicode', all the glyphs from the font file will be rendered and
2658 unicode will be used (default: unicode).
2661 .B \-subfont\-osd\-scale <0\-100> (FreeType only)
2662 Sets the autoscale coefficient of the OSD elements (default: 6).
2665 .B \-subfont\-outline <0\-8> (FreeType only)
2666 Sets the font outline thickness (default: 2).
2669 .B \-subfont\-text\-scale <0\-100> (FreeType only)
2670 Sets the subtitle text autoscale coefficient as percentage of the
2671 screen size (default: 5).
2675 Specify the framerate of the subtitle file (default: movie fps).
2678 <rate> > movie fps speeds the subtitles up for frame-based subtitle files and
2679 slows them down for time-based ones.
2682 .B \-subpos <0\-100> (useful with \-vf expand)
2683 Specify the position of subtitles on the screen.
2684 The value is the vertical position of the subtitle in % of the screen height.
2687 .B \-subwidth <10\-100>
2688 Specify the maximum width of subtitles on the screen.
2690 The value is the width of the subtitle in % of the screen width.
2694 Disable the display of OSD messages on the console when no video output is
2698 .B \-term\-osd\-esc <escape sequence>
2699 Specify the escape sequence to use before writing an OSD message on the
2701 The escape sequence should move the pointer to the beginning of the line
2702 used for the OSD and clear it (default: ^[[A\\r^[[K).
2706 Tells MPlayer to handle the subtitle file as unicode.
2709 .B \-unrarexec <path to unrar executable> (not supported on MingW)
2710 Specify the path to the unrar executable so MPlayer can use it to access
2711 rar-compressed VOBsub files (default: not set, so the feature is off).
2712 The path must include the executable's filename, i.e.\& /usr/local/bin/unrar.
2716 Tells MPlayer to handle the subtitle file as UTF-8.
2719 .B \-vobsub <VOBsub file without extension>
2720 Specify a VOBsub file to use for subtitles.
2721 Has to be the full pathname without extension, i.e.\& without
2722 the '.idx', '.ifo' or '.sub'.
2725 .B \-vobsubid <0\-31>
2726 Specify the VOBsub subtitle ID.
2730 .SH "AUDIO OUTPUT OPTIONS"
2733 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2734 Override audio driver/\:card buffer size detection.
2737 .B \-format <format> (also see the format audio filter)
2738 Select the sample format used for output from the audio filter
2739 layer to the sound card.
2740 The values that <format> can adopt are listed below in the
2741 description of the format audio filter.
2745 Try to play consecutive audio files with no silence or disruption
2746 at the point of file change.
2747 This feature is implemented in a simple manner and relies on audio output
2748 device buffering to continue playback while moving from one file to another.
2749 If playback of the new file starts slowly, for example because it's played from
2750 a remote network location or because you have specified cache settings that
2751 require time for the initial cache fill, then the buffered audio may run out
2752 before playback of the new file can start.
2756 Use a mixer device different from the default /dev/\:mixer.
2757 For ALSA this is the mixer name.
2760 .B \-mixer\-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2761 This option will tell MPlayer to use a different channel for controlling
2762 volume than the default PCM.
2763 Options for OSS include
2765 For a complete list of options look for SOUND_DEVICE_NAMES in
2766 /usr/\:include/\:linux/\:soundcard.h.
2767 For ALSA you can use the names e.g.\& alsamixer displays, like
2768 .B Master, Line, PCM.
2771 ALSA mixer channel names followed by a number must be specified in the
2772 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2778 Force the use of the software mixer, instead of using the sound card
2782 .B \-softvol\-max <10.0\-10000.0>
2783 Set the maximum amplification level in percent (default: 110).
2784 A value of 200 will allow you to adjust the volume up to a maximum of
2785 double the current level.
2786 With values below 100 the initial volume (which is 100%) will be above
2787 the maximum, which e.g.\& the OSD cannot display correctly.
2790 .B \-volstep <0\-100>
2791 Set the step size of mixer volume changes in percent of the whole range
2795 .B \-volume <-1\-100> (also see \-af volume)
2796 Set the startup volume in the mixer, either hardware or software (if
2797 used with \-softvol).
2798 A value of -1 (the default) will not change the volume.
2802 .SH "AUDIO OUTPUT DRIVERS"
2803 Audio output drivers are interfaces to different audio output facilities.
2807 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2808 Specify a priority list of audio output drivers to be used.
2810 If the list has a trailing ',' MPlayer will fall back on drivers not
2811 contained in the list.
2812 Suboptions are optional and can mostly be omitted.
2815 See \-ao help for a list of compiled-in audio output drivers.
2820 .IPs "\-ao alsa,oss,"
2821 Try the ALSA driver, then the OSS driver, then others.
2822 .IPs "\-ao alsa:noblock:device=hw=0.3"
2823 Sets noblock-mode and the device-name as first card, fourth device.
2827 Available audio output drivers are:
2831 ALSA 0.9/1.x audio output driver
2836 .IPs device=<device>
2837 Sets the device name.
2838 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2839 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2840 you really know how to set it correctly.
2846 ALSA 0.5 audio output driver
2850 OSS audio output driver
2854 Sets the audio output device (default: /dev/\:dsp).
2856 Sets the audio mixer device (default: /dev/\:mixer).
2857 .IPs <mixer-channel>
2858 Sets the audio mixer channel (default: pcm).
2864 highly platform independent SDL (Simple Directmedia Layer) library
2869 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2875 audio output through the aRts daemon
2879 audio output through the ESD daemon
2883 Explicitly choose the ESD server to use (default: localhost).
2889 audio output through JACK (Jack Audio Connection Kit)
2893 Connects to the ports with the given name (default: physical ports).
2894 .IPs name=<client name>
2895 Client name that is passed to JACK (default: MPlayer [<PID>]).
2896 Useful if you want to have certain connections established automatically.
2898 Estimate the audio delay, supposed to make the video playback smoother
2901 Automatically start jackd if necessary (default: disabled).
2902 Note that this seems unreliable and will spam stdout with server messages.
2908 audio output through NAS
2911 .B coreaudio (Mac OS X only)
2912 native Mac OS X audio output driver
2916 ID of output device to use (0 = default device)
2918 List all available output devices with their IDs.
2924 Experimental OpenAL audio output driver
2928 PulseAudio audio output driver
2931 .IPs "[<host>][:<output sink>]"
2932 Specify the host and optionally output sink to use.
2933 An empty <host> string uses a local connection, "localhost"
2934 uses network transfer (most likely not what you want).
2940 native SGI audio output driver
2943 .IPs "<output device name>"
2944 Explicitly choose the output device/\:interface to use
2945 (default: system-wide default).
2946 For example, 'Analog Out' or 'Digital Out'.
2952 native Sun audio output driver
2956 Explicitly choose the audio device to use (default: /dev/\:audio).
2961 .B win32 (Windows only)
2962 native Windows waveout audio output driver
2965 .B dsound (Windows only)
2966 DirectX DirectSound audio output driver
2969 .IPs device=<devicenum>
2970 Sets the device number to use.
2971 Playing a file with \-v will show a list of available devices.
2977 OS/2 KAI audio output driver
2985 Open audio in shareable or exclusive mode.
2987 Set buffer size to <size> in samples (default: 2048).
2993 OS/2 DART audio output driver
2997 Open DART in shareable or exclusive mode.
2999 Set buffer size to <size> in samples (default: 2048).
3005 IVTV specific MPEG audio output driver.
3006 Works with \-ac hwmpa only.
3009 .B v4l2 (requires Linux 2.6.22+ kernel)
3010 Audio output driver for V4L2 cards with hardware MPEG decoder.
3013 .B mpegpes (DVB only)
3014 Audio output driver for DVB cards that writes the output to an MPEG-PES
3015 file if no DVB card is installed.
3019 DVB card to use if more than one card is present.
3020 If not specified MPlayer will search the first usable card.
3021 .IPs file=<filename>
3028 Produces no audio output but maintains video playback speed.
3029 Use \-nosound for benchmarking.
3033 raw PCM/wave file writer audio output
3037 Include or do not include the wave header (default: included).
3038 When not included, raw PCM will be generated.
3039 .IPs file=<filename>
3040 Write the sound to <filename> instead of the default
3042 If nowaveheader is specified, the default is audiodump.pcm.
3048 audio output to an RSound daemon
3051 .IPs host=<name/path>
3052 Set the address of the server (default: localhost).
3053 Can be either a network hostname for TCP connections or a Unix domain
3054 socket path starting with '/'.
3056 Set the TCP port used for connecting to the server (default: 12345).
3057 Not used if connecting to a Unix domain socket.
3063 plugin audio output driver
3067 .SH "VIDEO OUTPUT OPTIONS"
3070 .B \-adapter <value>
3071 Set the graphics card that will receive the image.
3072 You can get a list of available cards when you run this option with \-v.
3073 Currently only works with the directx video output driver.
3077 Override the autodetected color depth.
3078 Only supported by the fbdev, dga, svga, vesa video output drivers.
3082 Play movie with window border and decorations.
3083 Since this is on by default, use \-noborder to disable the standard window
3087 .B \-brightness <\-100\-100>
3088 Adjust the brightness of the video signal (default: 0).
3089 Not supported by all video output drivers.
3092 .B \-contrast <\-100\-100>
3093 Adjust the contrast of the video signal (default: 0).
3094 Not supported by all video output drivers.
3097 .B \-display <name> (X11 only)
3098 Specify the hostname and display number of the X server you want to display
3104 \-display xtest.localdomain:0
3110 Turns on direct rendering (not supported by all codecs and video outputs)
3113 May cause OSD/SUB corruption!
3116 .B \-fbmode <modename> (\-vo fbdev only)
3117 Change video mode to the one that is labeled as <modename> in
3121 VESA framebuffer does not support mode changing.
3124 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3125 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
3128 .B \-force\-window\-position
3129 Forcefully move MPlayer's video output window to default location whenever
3130 there is a change in video parameters, video stream or file.
3131 This used to be the default behavior.
3132 Currently only affects X11 VOs.
3135 .B \-fs (also see \-zoom)
3136 Fullscreen playback (centers movie, and paints black bands around it).
3137 Not supported by all video output drivers.
3140 .B \-fsmode\-dontuse <0\-31> (OBSOLETE, use the \-fs option)
3141 Try this option if you still experience fullscreen problems.
3144 .B \-fstype <type1,type2,...> (X11 only)
3145 Specify a priority list of fullscreen modes to be used.
3146 You can negate the modes by prefixing them with '\-'.
3147 If you experience problems like the fullscreen window being covered
3148 by other windows try using a different order.
3151 See \-fstype help for a full list of available modes.
3153 The available types are:
3158 Use the _NETWM_STATE_ABOVE hint if available.
3160 Use the _NETWM_STATE_BELOW hint if available.
3162 Use the _NETWM_STATE_FULLSCREEN hint if available.
3164 Use the _WIN_LAYER hint with the default layer.
3166 Use the _WIN_LAYER hint with the given layer number.
3170 Clear the list of modes; you can add modes to enable afterward.
3172 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
3180 .IPs layer,stays_on_top,above,fullscreen
3181 Default order, will be used as a fallback if incorrect or
3182 unsupported modes are specified.
3184 Fixes fullscreen switching on OpenBox 1.x.
3189 .B \-gamma <\-100\-100>
3190 Adjust the gamma of the video signal (default: 0).
3191 Not supported by all video output drivers.
3194 .B \-geometry x[%][:y[%]] or [WxH][+-x+-y]
3195 Adjust where the output is on the screen initially.
3196 The x and y specifications are in pixels measured from the top-left of the
3197 screen to the top-left of the image being displayed, however if a percentage
3198 sign is given after the argument it turns the value into a percentage of the
3199 screen size in that direction.
3200 It also supports the standard X11 \-geometry option format, in which e.g.
3201 +10-50 means "place 10 pixels from the left border and 50 pixels from the lower
3202 border" and "--20+-10" means "place 20 pixels beyond the right and 10 pixels
3203 beyond the top border".
3204 If an external window is specified using the \-wid option, then the x and
3205 y coordinates are relative to the top-left corner of the window rather
3207 The coordinates are relative to the screen given with \-xineramascreen for
3208 the video output drivers that fully support \-xineramascreen (direct3d, gl, gl2,
3209 vdpau, x11, xv, corevideo).
3212 May not be supported by some of the older VO drivers.
3218 Places the window at x=50, y=40.
3220 Places the window in the middle of the screen.
3222 Places the window at the middle of the right edge of the screen.
3224 Places the window at the bottom right corner of the screen.
3229 .B \-hue <\-100\-100>
3230 Adjust the hue of the video signal (default: 0).
3231 You can get a colored negative of the image with this option.
3232 Not supported by all video output drivers.
3235 .B \-monitor\-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
3236 Specify the dotclock or pixelclock range of the monitor.
3239 .B \-monitor\-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
3240 Specify the horizontal frequency range of the monitor.
3243 .B \-monitor\-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
3244 Specify the vertical frequency range of the monitor.
3247 .B \-monitoraspect <ratio> (also see \-aspect)
3248 Set the aspect ratio of your monitor or TV screen.
3249 A value of 0 disables a previous setting (e.g.\& in the config file).
3250 Overrides the \-monitorpixelaspect setting if enabled.
3255 \-monitoraspect 4:3 or 1.3333
3257 \-monitoraspect 16:9 or 1.7777
3262 .B \-monitorpixelaspect <ratio> (also see \-aspect)
3263 Set the aspect of a single pixel of your monitor or TV screen (default: 1).
3264 A value of 1 means square pixels
3265 (correct for (almost?) all LCDs).
3268 .B \-name (X11 only)
3269 Set the window class name.
3273 Disables double buffering, mostly for debugging purposes.
3274 Double buffering fixes flicker by storing two frames in memory, and
3275 displaying one while decoding another.
3276 It can affect OSD negatively, but often removes OSD flickering.
3280 Do not grab the mouse pointer after a video mode change (\-vm).
3281 Useful for multihead setups.
3285 Do not keep window aspect ratio when resizing windows.
3286 By default MPlayer tries to keep the correct video aspect ratio by
3287 instructing the window manager to maintain window aspect when resizing,
3288 and by adding black bars if the window manager nevertheless allows
3289 window shape to change.
3290 This option disables window manager aspect hints and scales the video
3291 to completely fill the window without regard for aspect ratio.
3295 Makes the player window stay on top of other windows.
3296 Supported by video output drivers which use X11, except SDL,
3297 as well as directx, corevideo, quartz, ggi and gl2.
3300 .B \-panscan <0.0\-1.0>
3301 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
3302 movie to make it fit a 4:3 display without black bands).
3303 The range controls how much of the image is cropped.
3304 May not work with all video output drivers.
3307 Values between \-1 and 0 are allowed as well, but highly experimental
3308 and may crash or worse.
3309 Use at your own risk!
3312 .B \-panscanrange <\-19.0\-99.0> (experimental)
3313 Change the range of the pan-and-scan functionality (default: 1).
3314 Positive values mean multiples of the default range.
3315 Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
3316 E.g.\& \-panscanrange \-3 allows a zoom factor of up to 4.
3317 This feature is experimental.
3318 Do not report bugs unless you are using \-vo gl.
3321 .B \-refreshrate <Hz>
3322 Set the monitor refreshrate in Hz.
3323 Currently only supported by \-vo directx combined with the \-vm option.
3327 Play movie in the root window (desktop background).
3328 Desktop background images may cover the movie window, though.
3329 May not work with all video output drivers.
3332 .B \-saturation <\-100\-100>
3333 Adjust the saturation of the video signal (default: 0).
3334 You can get grayscale output with this option.
3335 Not supported by all video output drivers.
3338 .B \-screenh <pixels>
3339 Specify the screen height for video output drivers which
3340 do not know the screen resolution like fbdev, x11 and TV-out.
3343 .B \-screenw <pixels>
3344 Specify the screen width for video output drivers which
3345 do not know the screen resolution like fbdev, x11 and TV-out.
3348 .B \-stop\-xscreensaver (X11 only)
3349 Turns off xscreensaver at startup and turns it on again on exit.
3350 If your screensaver supports neither the XSS nor XResetScreenSaver
3351 API please use \-heartbeat\-cmd instead.
3354 .B \-title (also see \-use\-filename\-title)
3355 Set the window title.
3356 Supported by X11-based video output drivers.
3359 .B \-use\-filename\-title (also see \-title)
3360 Set the window title using the media filename, when not set with \-title.
3361 Supported by X11-based video output drivers.
3365 Try to change to a different video mode.
3366 Supported by the dga, x11, xv, sdl and directx video output drivers.
3367 If used with the directx video output driver the \-screenw,
3368 \-screenh, \-bpp and \-refreshrate options can be used to set
3369 the new display mode.
3373 Enables VBI for the vesa, dfbmga and svga video output drivers.
3376 .B \-wid <window ID> (X11, OpenGL and DirectX only)
3377 This tells MPlayer to attach to an existing window.
3378 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
3379 This option fills the given window completely, thus aspect scaling,
3380 panscan, etc are no longer handled by MPlayer but must be managed by the
3381 application that created the window.
3384 .B \-xineramascreen <\-2\-...>
3385 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
3386 displays) this option tells MPlayer which screen to display the movie on.
3387 A value of \-2 means fullscreen across the whole virtual display (in this case
3388 Xinerama information is completely ignored), \-1 means
3389 fullscreen on the display the window currently is on.
3390 The initial position set via the \-geometry option is relative to the
3392 Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
3393 This option is not suitable to only set the startup screen (because
3394 it will always display on the given screen in fullscreen mode),
3395 \-geometry is the best that is available for that purpose
3397 Supported by at least the direct3d, gl, gl2, x11, xv and corevideo video output
3402 .SH "VIDEO OUTPUT DRIVERS"
3403 Video output drivers are interfaces to different video output facilities.
3407 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
3408 Specify a priority list of video output drivers to be used.
3410 If the list has a trailing ',' MPlayer will fall back on drivers not
3411 contained in the list.
3412 Suboptions are optional and can mostly be omitted.
3415 See \-vo help for a list of compiled-in video output drivers.
3420 .IPs "\-vo xmga,xv,"
3421 Try the Matrox X11 driver, then the Xv driver, then others.
3422 .IPs "\-vo directx:noaccel"
3423 Uses the DirectX driver with acceleration features turned off.
3427 Available video output drivers are:
3431 Uses the XVideo extension of XFree86 4.x to enable hardware
3432 accelerated playback.
3433 If you cannot use a hardware specific driver, this is probably
3435 For information about what colorkey is used and how it is drawn run MPlayer
3436 with \-v option and look out for the lines tagged with [xv common] at the
3440 .IPs adaptor=<number>
3441 Select a specific XVideo adaptor (check xvinfo results).
3443 Select a specific XVideo port.
3444 .IPs ck=<cur|use|set>
3445 Select the source from which the colorkey is taken (default: cur).
3448 The default takes the colorkey currently set in Xv.
3450 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
3453 Same as use but also sets the supplied colorkey.
3455 .IPs ck-method=<man|bg|auto>
3456 Sets the colorkey drawing method (default: man).
3459 Draw the colorkey manually (reduces flicker in some cases).
3461 Set the colorkey as window background.
3463 Let Xv draw the colorkey.
3470 Shared memory video output driver without hardware acceleration that
3471 works whenever X11 is present.
3475 Adds X11 support to all overlay based video output drivers.
3476 Currently only supported by tdfx_vid.
3480 Select the driver to use as source to overlay on top of X11.
3486 Uses the VDPAU interface to display and optionally also decode video.
3487 Hardware decoding is used with \-vc ffmpeg12vdpau, ffwmv3vdpau, ffvc1vdpau, ffh264vdpau or ffodivxvdpau.
3490 .IPs sharpen=<\-1\-1>
3491 For positive values, apply a sharpening algorithm to the video,
3492 for negative values a blurring algorithm (default: 0).
3494 Apply a noise reduction algorithm to the video (default: 0, no noise reduction).
3496 Select deinterlacing mode (default: -3).
3497 Positive values choose mode and enable deinterlacing.
3498 Corresponding negative values select the same deinterlacing mode,
3499 but do not enable deinterlacing on startup (useful in configuration files
3500 to specify what mode will be enabled by the "D" key).
3501 All modes respect \-field\-dominance.
3506 Show only first field, similar to \-vf field.
3508 Bob deinterlacing, similar to \-vf tfields=1.
3510 motion adaptive temporal deinterlacing.
3511 May lead to A/V desync with slow video hardware and/or high resolution.
3513 motion adaptive temporal deinterlacing with edge-guided spatial interpolation.
3514 Needs fast video hardware.
3517 Makes temporal deinterlacers operate both on luma and chroma (default).
3518 Use nochroma\-deint to solely use luma and speed up advanced deinterlacing.
3519 Useful with slow video memory.
3521 Try to apply inverse telecine, needs motion adaptive temporal deinterlacing.
3522 .IPs colorspace=<0-3>
3523 Select the color space for YUV to RGB conversion.
3524 In general BT.601 should be used for standard definition (SD) content and
3525 BT.709 for high definition (HD) content.
3526 Using incorrect color space results in slightly under or over saturated and
3530 Guess the color space based on video resolution.
3531 Video with width >= 1280 or height > 576 is assumed to be HD and BT.709 color
3534 Use ITU-R BT.601 color space (default).
3536 Use ITU-R BT.709 color space.
3538 Use SMPTE-240M color space.
3540 .IPs hqscaling=<0-9>
3543 Use default VDPAU scaling (default).
3545 Apply high quality VDPAU scaling (needs capable hardware).
3548 Output video in studio level RGB (16-235).
3549 This is what TVs and video monitors generally expect.
3550 By default PC level RGB (0-255) suitable for PC monitors is used.
3551 Providing studio level output to a device expecting PC level input results in
3552 grey blacks and dim whites, the reverse in crushed blacks and whites.
3554 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).
3555 Default 0 means use autodetected value.
3556 A positive value is interpreted as a refresh rate in Hz and overrides the autodetected value.
3557 A negative value disables all timing adjustment and framedrop logic.
3558 .IPs queuetime_windowed=<number>
3559 .IPs queuetime_fs=<number>
3560 Use VDPAU's presentation queue functionality to queue future video frame
3561 changes at most this many milliseconds in advance (default: 50).
3562 See below for additional information.
3563 .IPs output_surfaces=<2-15>
3564 Allocate this many output surfaces to display video frames (default: 3).
3565 See below for additional information.
3569 Using the VDPAU frame queueing functionality controlled by the queuetime
3570 options makes MPlayer's frame flip timing less sensitive to system CPU load
3571 and allows MPlayer to start decoding the next frame(s) slightly earlier
3572 which can reduce jitter caused by individual slow-to-decode frames.
3573 However the NVIDIA graphics drivers can make other window behavior such as
3574 window moves choppy if VDPAU is using the blit queue (mainly happens
3575 if you have the composite extension enabled) and this feature is active.
3576 If this happens on your system and it bothers you then you can set the
3577 queuetime value to 0 to disable this feature.
3578 The settings to use in windowed and fullscreen mode are separate because there
3579 should be less reason to disable this for fullscreen mode (as the driver issue
3580 shouldn't affect the video itself).
3582 You can queue more frames ahead by increasing the queuetime values and the
3583 output_surfaces count (to ensure enough surfaces to buffer video for a
3584 certain time ahead you need at least as many surfaces as the video has
3585 frames during that time, plus two).
3586 This could help make video smoother in some cases.
3587 The main downsides are increased video RAM requirements for the surfaces
3588 and laggier display response to user commands (display changes only become
3589 visible some time after they're queued). The graphics driver implementation may
3590 also have limits on the length of maximum queuing time or number of queued
3591 surfaces that work well or at all.
3597 Play video through the XFree86 Direct Graphics Access extension.
3598 Considered obsolete.
3601 .B sdl (SDL only, buggy/outdated)
3602 Highly platform independent SDL (Simple Directmedia Layer) library
3603 video output driver.
3604 Since SDL uses its own X11 layer, MPlayer X11 options do not have
3606 Note that it has several minor bugs (\-vm/\-novm is mostly ignored,
3607 \-fs behaves like \-novm should, window is in top-left corner when
3608 returning from fullscreen, panscan is not supported, ...).
3611 .IPs driver=<driver>
3612 Explicitly choose the SDL driver to use.
3614 Use XVideo through the sdl video output driver (default: forcexv).
3616 Use hardware accelerated scaler (default: hwaccel).
3621 .B direct3d (Windows only) (BETA CODE!)
3622 Video output driver that uses the Direct3D interface (useful for Vista).
3625 .B directx (Windows only)
3626 Video output driver that uses the DirectX interface.
3630 Turns off hardware acceleration.
3631 Try this option if you have display problems.
3637 Video output driver that uses the libkva interface.
3643 Force WarpOverlay! mode.
3647 Enable or disable workaround for T23 laptop (default: disabled).
3648 Try to enable this option if your video card supports upscaling only.
3653 .B quartz (Mac OS X only)
3654 Mac OS X Quartz video output driver.
3655 Under some circumstances, it might be more efficient to force a
3656 packed YUV output format, with e.g.\& \-vf format=yuy2.
3659 .IPs device_id=<number>
3660 Choose the display device to use in fullscreen.
3661 .IPs fs_res=<width>:<height>
3662 Specify the fullscreen resolution (useful on slow systems).
3667 .B corevideo (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
3668 Mac OS X CoreVideo video output driver
3671 .IPs device_id=<number>
3672 Choose the display device to use for fullscreen or set it to \-1 to
3673 always use the same screen the video window is on (default: \-1 \- auto).
3675 Write output to a shared memory buffer instead of displaying it and
3676 try to open an existing NSConnection for communication with a GUI.
3677 .IPs buffer_name=<name>
3678 Name of the shared buffer created with shm_open as well as the name of
3679 the NSConnection MPlayer will try to open (default: "mplayerosx").
3680 Setting buffer_name implicitly enables shared_buffer.
3685 .B fbdev (Linux only)
3686 Uses the kernel framebuffer to play video.
3690 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0).
3695 .B fbdev2 (Linux only)
3696 Uses the kernel framebuffer to play video,
3697 alternative implementation.
3701 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3707 Very general video output driver that should work on any VESA VBE 2.0
3712 Turns DGA mode on or off (default: on).
3714 Activate the NeoMagic TV out and set it to PAL norm.
3716 Activate the NeoMagic TV out and set it to NTSC norm.
3718 Activate the Linux Video Overlay on top of VESA mode.
3724 Play video using the SVGA library.
3728 Specify video mode to use.
3729 The mode can be given in a <width>x<height>x<colors> format,
3730 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
3732 Draw OSD into black bands below the movie (slower).
3734 Use only native drawing functions.
3735 This avoids direct rendering, OSD and hardware acceleration.
3737 Force frame switch on vertical retrace.
3738 Usable only with \-double.
3739 It has the same effect as the \-vsync option.
3741 Try to select a video mode with square pixels.
3747 OpenGL video output driver, simple version.
3748 Video size must be smaller than
3749 the maximum texture size of your OpenGL implementation.
3750 Intended to work even with the most basic OpenGL implementations,
3751 but also makes use of newer extensions, which allow support for more
3752 colorspaces and direct rendering.
3753 For optimal speed try adding the options
3757 The code performs very few checks, so if a feature does not work, this
3758 might be because it is not supported by your card/OpenGL implementation
3759 even if you do not get any error message.
3760 Use glxinfo or a similar tool to display the supported OpenGL extensions.
3764 ATI drivers may give a corrupted image when PBOs are used (when using \-dr
3766 This option fixes this, at the expense of using a bit more memory.
3768 Always uses PBOs to transfer textures even if this involves an extra copy.
3769 Currently this gives a little extra speed with NVidia drivers and a lot more
3770 speed with ATI drivers.
3771 May need \-noslices and the ati\-hack suboption to work correctly.
3773 Changes the way the OSD behaves when the size of the
3774 window changes (default: disabled).
3775 When enabled behaves more like the other video output drivers,
3776 which is better for fixed-size fonts.
3777 Disabled looks much better with FreeType fonts and uses the
3778 borders in fullscreen mode.
3779 Does not work correctly with ass subtitles (see \-ass), you can instead
3780 render them without OpenGL support via \-vf ass.
3781 .IPs osdcolor=<0xAARRGGBB>
3782 Color for OSD (default: 0x00ffffff, corresponds to non-transparent white).
3783 .IPs rectangle=<0,1,2>
3784 Select usage of rectangular textures which saves video RAM, but often is
3785 slower (default: 0).
3787 0: Use power-of-two textures (default).
3789 1: Use the GL_ARB_texture_rectangle extension.
3791 2: Use the GL_ARB_texture_non_power_of_two extension.
3792 In some cases only supported in software and thus very slow.
3794 .IPs swapinterval=<n>
3795 Minimum interval between two buffer swaps, counted in
3796 displayed frames (default: 1).
3797 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
3798 Values below 0 will leave it at the system default.
3799 This limits the framerate to (horizontal refresh rate / n).
3800 Requires GLX_SGI_swap_control support to work.
3801 With some (most/all?) implementations this only works in fullscreen mode.
3803 Use the GL_MESA_ycbcr_texture extension to convert YUV to RGB.
3804 In most cases this is probably slower than doing software conversion to RGB.
3806 Select the type of YUV to RGB conversion.
3807 The default is auto-detection deciding between values 0 and 2.
3809 0: Use software conversion.
3810 Compatible with all OpenGL versions.
3811 Provides brightness, contrast and saturation control.
3813 1: Use register combiners.
3814 This uses an nVidia-specific extension (GL_NV_register_combiners).
3815 At least three texture units are needed.
3816 Provides saturation and hue control.
3817 This method is fast but inexact.
3819 2: Use a fragment program.
3820 Needs the GL_ARB_fragment_program extension and at least three texture units.
3821 Provides brightness, contrast, saturation and hue control.
3823 3: Use a fragment program using the POW instruction.
3824 Needs the GL_ARB_fragment_program extension and at least three texture units.
3825 Provides brightness, contrast, saturation, hue and gamma control.
3826 Gamma can also be set independently for red, green and blue.
3827 Method 4 is usually faster.
3829 4: Use a fragment program with additional lookup.
3830 Needs the GL_ARB_fragment_program extension and at least four texture units.
3831 Provides brightness, contrast, saturation, hue and gamma control.
3832 Gamma can also be set independently for red, green and blue.
3834 5: Use ATI-specific method (for older cards).
3835 This uses an ATI-specific extension (GL_ATI_fragment_shader \- not
3836 GL_ARB_fragment_shader!).
3837 At least three texture units are needed.
3838 Provides saturation and hue control.
3839 This method is fast but inexact.
3841 6: Use a 3D texture to do conversion via lookup.
3842 Needs the GL_ARB_fragment_program extension and at least four texture units.
3843 Extremely slow (software emulation) on some (all?) ATI cards since it uses
3844 a texture with border pixels.
3845 Provides brightness, contrast, saturation, hue and gamma control.
3846 Gamma can also be set independently for red, green and blue.
3847 Speed depends more on GPU memory bandwidth than other methods.
3850 Select the color space for YUV to RGB conversion.
3853 Use the formula used normally by MPlayer (default).
3855 Use ITU-R BT.601 color space.
3857 Use ITU-R BT.709 color space.
3859 Use SMPTE-240M color space.
3862 Select the brightness level conversion to use for the YUV to RGB conversion
3865 Convert TV to PC levels (default).
3867 Convert PC to TV levels.
3869 Do not do any conversion.
3872 Select the scaling function to use for luminance scaling.
3873 Only valid for yuv modes 2, 3, 4 and 6.
3876 Use simple linear filtering (default).
3878 Use bicubic B-spline filtering (better quality).
3879 Needs one additional texture unit.
3880 Older cards will not be able to handle this for chroma at least in fullscreen mode.
3882 Use cubic filtering in horizontal, linear filtering in vertical direction.
3883 Works on a few more cards than method 1.
3885 Same as 1 but does not use a lookup texture.
3886 Might be faster on some cards.
3888 Use experimental unsharp masking with 3x3 support and a default strength of 0.5 (see filter-strength).
3890 Use experimental unsharp masking with 5x5 support and a default strength of 0.5 (see filter-strength).
3893 Select the scaling function to use for chrominance scaling.
3894 For details see lscale.
3895 .IPs filter-strength=<value>
3896 Set the effect strength for the lscale/cscale filters that support it.
3898 Select a method for stereo display.
3899 You may have to use \-aspect to fix the aspect value.
3900 Experimental, do not expect too much from it.
3905 Convert side by side input to full-color red-cyan stereo.
3907 Convert side by side input to full-color green-magenta stereo.
3909 Convert side by side input to quadbuffered stereo.
3910 Only supported by very few OpenGL cards.
3915 The following options are only useful if writing your own fragment programs.
3919 .IPs customprog=<filename>
3920 Load a custom fragment program from <filename>.
3921 See TOOLS/edgedect.fp for an example.
3922 .IPs customtex=<filename>
3923 Load a custom "gamma ramp" texture from <filename>.
3924 This can be used in combination with yuv=4 or with the customprog option.
3926 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
3927 for customtex texture.
3928 .IPs (no)customtrect
3929 If enabled, use texture_rectangle for customtex texture.
3930 Default is disabled.
3932 If enabled, mipmaps for the video are automatically generated.
3933 This should be useful together with the customprog and the TXB
3934 instruction to implement blur filters with a large radius.
3935 For most OpenGL implementations this is very slow for any non-RGB
3937 Default is disabled.
3941 Normally there is no reason to use the following options, they mostly
3942 exist for testing purposes.
3947 Call glFinish() before swapping buffers.
3948 Slower but in some cases more correct output (default: disabled).
3950 Enables support for more (RGB and BGR) color formats (default: enabled).
3951 Needs OpenGL version >= 1.2.
3952 .IPs slice-height=<0\-...>
3953 Number of lines copied to texture in one piece (default: 0).
3957 If YUV colorspace is used (see yuv suboption), special rules apply:
3959 If the decoder uses slice rendering (see \-noslices), this setting
3960 has no effect, the size of the slices as provided by the decoder is used.
3962 If the decoder does not use slice rendering, the default is 16.
3965 Enable or disable support for OSD rendering via OpenGL (default: enabled).
3966 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
3968 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
3969 Disabling might increase speed.
3976 Variant of the OpenGL video output driver.
3977 Supports videos larger than the maximum texture size but lacks many of the
3978 advanced features and optimizations of the gl driver and is unlikely to be
3983 same as gl (default: enabled)
3985 Select the type of YUV to RGB conversion.
3986 If set to anything except 0 OSD will be disabled and brightness, contrast and
3987 gamma setting is only available via the global X server settings.
3988 Apart from this the values have the same meaning as for \-vo gl.
3993 OpenGL-based renderer creating a Matrix-like running-text effect.
3997 Number of text columns to display.
3998 Very low values (< 16) will probably fail due to scaler limitations.
3999 Values not divisible by 16 may cause issues as well.
4001 Number of text rows to display.
4002 Very low values (< 16) will probably fail due to scaler limitations.
4003 Values not divisible by 16 may cause issues as well.
4008 Produces no video output.
4009 Useful for benchmarking.
4013 ASCII art video output driver that works on a text console.
4014 You can get a list and an explanation of available suboptions
4015 by executing 'mplayer \-vo aa:help'.
4018 The driver does not handle \-aspect correctly.
4021 You probably have to specify \-monitorpixelaspect.
4022 Try 'mplayer \-vo aa \-monitorpixelaspect 0.5'.
4026 Color ASCII art video output driver that works on a text console.
4030 Video playback using the Blinkenlights UDP protocol.
4031 This driver is highly hardware specific.
4035 Explicitly choose the Blinkenlights subdevice driver to use.
4036 It is something like arcade:host=localhost:2323 or
4037 hdl:file=name1,file=name2.
4038 You must specify a subdevice.
4044 GGI graphics system video output driver
4048 Explicitly choose the GGI driver to use.
4049 Replace any ',' that would appear in the driver string by a '.'.
4055 Play video using the DirectFB library.
4059 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
4060 .IPs buffermode=single|double|triple
4061 Double and triple buffering give best results if you want to avoid tearing issues.
4062 Triple buffering is more efficient than double buffering as it does
4063 not block MPlayer while waiting for the vertical retrace.
4064 Single buffering should be avoided (default: single).
4065 .IPs fieldparity=top|bottom
4066 Control the output order for interlaced frames (default: disabled).
4067 Valid values are top = top fields first, bottom = bottom fields first.
4068 This option does not have any effect on progressive film material
4069 like most MPEG movies are.
4070 You need to enable this option if you have tearing issues or unsmooth
4071 motions watching interlaced film material.
4073 Will force layer with ID N for playback (default: \-1 \- auto).
4075 Specify a parameter list for DirectFB.
4081 Matrox G400/\:G450/\:G550 specific video output driver that uses the
4082 DirectFB library to make use of special hardware features.
4083 Enables CRTC2 (second head), displaying video independently of the first head.
4087 same as directfb (default: disabled)
4088 .IPs buffermode=single|double|triple
4089 same as directfb (default: triple)
4090 .IPs fieldparity=top|bottom
4093 Enable the use of the Matrox BES (backend scaler) (default: disabled).
4094 Gives very good results concerning speed and output quality as interpolated
4095 picture processing is done in hardware.
4096 Works only on the primary head.
4098 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
4100 Turn on TV-out on the second head (default: enabled).
4101 The output quality is amazing as it is a full interlaced picture
4102 with proper sync to every odd/\:even field.
4103 .IPs tvnorm=pal|ntsc|auto
4104 Will set the TV norm of the Matrox card without the need
4105 for modifying /etc/\:directfbrc (default: disabled).
4106 Valid norms are pal = PAL, ntsc = NTSC.
4107 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
4108 which norm to use by looking at the framerate of the movie.
4114 Matrox specific video output driver that makes use of the YUV back
4115 end scaler on Gxxx cards through a kernel module.
4116 If you have a Matrox card, this is the fastest option.
4120 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4125 .B xmga (Linux, X11 only)
4126 The mga video output driver, running in an X11 window.
4130 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
4135 .B s3fb (Linux only) (also see \-dr)
4136 S3 Virge specific video output driver.
4137 This driver supports the card's YUV conversion and scaling, double
4138 buffering and direct rendering features.
4139 Use \-vf format=yuy2 to get hardware-accelerated YUY2 rendering, which is
4140 much faster than YV12 on this card.
4144 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4150 Nintendo Wii/GameCube specific video output driver.
4153 .B 3dfx (Linux only)
4154 3dfx-specific video output driver that directly uses
4155 the hardware on top of X11.
4156 Only 16 bpp are supported.
4159 .B tdfxfb (Linux only)
4160 This driver employs the tdfxfb framebuffer driver to play movies with
4161 YUV acceleration on 3dfx cards.
4165 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
4170 .B tdfx_vid (Linux only)
4171 3dfx-specific video output driver that works in combination with
4172 the tdfx_vid kernel module.
4176 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
4182 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
4183 Hollywood Plus) specific video output driver.
4184 Also see the lavc video filter.
4188 Activates the overlay instead of TV-out.
4190 Turns on prebuffering.
4192 Will turn on the new sync-engine.
4194 Specifies the TV norm.
4196 0: Does not change current norm (default).
4198 1: Auto-adjust using PAL/\:NTSC.
4200 2: Auto-adjust using PAL/\:PAL-60.
4209 Specifies the device number to use if you have more than one em8300 card.
4215 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
4216 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
4217 specific video output driver for TV-out.
4218 Also see the lavc video filter.
4222 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4224 Explicitly choose the TV-out output to be used for the video signal.
4229 .B v4l2 (requires Linux 2.6.22+ kernel)
4230 Video output driver for V4L2 compliant cards with built-in hardware MPEG decoder.
4231 Also see the lavc video filter.
4235 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
4237 Explicitly choose the TV-out output to be used for the video signal.
4242 .B mpegpes (DVB only)
4243 Video output driver for DVB cards that writes the output to an MPEG-PES file
4244 if no DVB card is installed.
4248 Specifies the device number to use if you have more than one DVB output card
4249 (V3 API only, such as 1.x.y series drivers).
4250 If not specified MPlayer will search the first usable card.
4252 output filename (default: ./grab.mpg)
4258 Calculate MD5 sums of each frame and write them to a file.
4259 Supports RGB24 and YV12 colorspaces.
4260 Useful for debugging.
4263 .IPs outfile=<value>
4264 Specify the output filename (default: ./md5sums).
4270 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
4271 images and stores it in a file (default: ./stream.yuv).
4272 The format is the same as the one employed by mjpegtools, so this is
4273 useful if you want to process the video with the mjpegtools suite.
4274 It supports the YV12 format.
4275 If your source file has a different format and is interlaced, make sure
4276 to use -vf scale=::1 to ensure the conversion uses interlaced mode.
4277 You can combine it with the \-fixed\-vo option to concatenate files
4278 with the same dimensions and fps value.
4282 Write the output as interlaced frames, top field first.
4284 Write the output as interlaced frames, bottom field first.
4285 .IPs file=<filename>
4286 Write the output to <filename> instead of the default stream.yuv.
4292 If you do not specify any option the output is progressive
4293 (i.e.\& not interlaced).
4298 Output each frame into a single animated GIF file in the current directory.
4299 It supports only RGB format with 24 bpp and the output is converted to 256
4304 Float value to specify framerate (default: 5.0).
4306 Specify the output filename (default: ./out.gif).
4312 You must specify the framerate before the filename or the framerate will
4313 be part of the filename.
4319 mplayer video.nut \-vo gif89a:fps=15:output=test.gif
4325 Output each frame into a JPEG file in the current directory.
4326 Each file takes the frame number padded with leading zeros as name.
4329 .IPs [no]progressive
4330 Specify standard or progressive JPEG (default: noprogressive).
4332 Specify use of baseline or not (default: baseline).
4333 .IPs optimize=<0\-100>
4334 optimization factor (default: 100)
4335 .IPs smooth=<0\-100>
4336 smooth factor (default: 0)
4337 .IPs quality=<0\-100>
4338 quality factor (default: 75)
4339 .IPs outdir=<dirname>
4340 Specify the directory to save the JPEG files to (default: ./).
4341 .IPs subdirs=<prefix>
4342 Create numbered subdirectories with the specified prefix to
4343 save the files in instead of the current directory.
4344 .IPs "maxfiles=<value> (subdirs only)"
4345 Maximum number of files to be saved per subdirectory.
4346 Must be equal to or larger than 1 (default: 1000).
4352 Output each frame into a PNM file in the current directory.
4353 Each file takes the frame number padded with leading zeros as name.
4354 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
4355 Also see pnm(5), ppm(5) and pgm(5).
4359 Write PPM files (default).
4364 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
4365 bottom of the picture.
4367 Write PNM files in raw mode (default).
4369 Write PNM files in ASCII mode.
4370 .IPs outdir=<dirname>
4371 Specify the directory to save the PNM files to (default: ./).
4372 .IPs subdirs=<prefix>
4373 Create numbered subdirectories with the specified prefix to
4374 save the files in instead of the current directory.
4375 .IPs "maxfiles=<value> (subdirs only)"
4376 Maximum number of files to be saved per subdirectory.
4377 Must be equal to or larger than 1 (default: 1000).
4383 Output each frame into a PNG file in the current directory.
4384 Each file takes the frame number padded with leading zeros as name.
4385 24bpp RGB and BGR formats are supported.
4389 Specifies the compression level.
4390 0 is no compression, 9 is maximum compression.
4391 .IPs alpha (default: noalpha)
4392 Create PNG files with an alpha channel.
4393 Note that MPlayer in general does not support alpha, so this will only
4394 be useful in some rare cases.
4400 Output each frame into a Targa file in the current directory.
4401 Each file takes the frame number padded with leading zeros as name.
4402 The purpose of this video output driver is to have a simple lossless
4403 image writer to use without any external library.
4404 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
4405 You can force a particular format with the format video filter.
4411 mplayer video.nut \-vf format=bgr15 \-vo tga
4417 .SH "DECODING/FILTERING OPTIONS"
4420 .B \-ac <[\-|+]codec1,[\-|+]codec2,...[,]>
4421 Specify a priority list of audio codecs to be used, according to their codec
4422 name in codecs.conf.
4423 Use a '\-' before the codec name to omit it.
4424 Use a '+' before the codec name to force it, this will likely crash!
4425 If the list has a trailing ',' MPlayer will fall back on codecs not
4426 contained in the list.
4429 See \-ac help for a full list of available codecs.
4435 Force the l3codeca.acm MP3 codec.
4437 Try libmad first, then fall back on others.
4438 .IPs "\-ac hwac3,a52,"
4439 Try hardware AC-3 passthrough, software AC-3, then others.
4441 Try hardware DTS passthrough, then fall back on others.
4442 .IPs "\-ac \-ffmp3,"
4443 Skip FFmpeg's MP3 decoder.
4448 .B \-af\-adv <force=(0\-7):list=(filters)> (also see \-af)
4449 Specify advanced audio filter options:
4452 Forces the insertion of audio filters to one of the following:
4454 0: Use completely automatic filter insertion (currently identical to 1).
4456 1: Optimize for accuracy (default).
4458 2: Optimize for speed.
4460 Some features in the audio filters may silently fail,
4461 and the sound quality may drop.
4463 3: Use no automatic insertion of filters and no optimization.
4465 It may be possible to crash MPlayer using this setting.
4467 4: Use automatic insertion of filters according to 0 above,
4468 but use floating point processing when possible.
4470 5: Use automatic insertion of filters according to 1 above,
4471 but use floating point processing when possible.
4473 6: Use automatic insertion of filters according to 2 above,
4474 but use floating point processing when possible.
4476 7: Use no automatic insertion of filters according to 3 above,
4477 and use floating point processing when possible.
4484 .B \-afm <driver1,driver2,...>
4485 Specify a priority list of audio codec families to be used, according
4486 to their codec name in codecs.conf.
4487 Falls back on the default codecs if none of the given codec families work.
4490 See \-afm help for a full list of available codec families.
4496 Try FFmpeg's libavcodec codecs first.
4497 .IPs "\-afm acm,dshow"
4498 Try Win32 codecs first.
4503 .B \-aspect <ratio> (also see \-zoom)
4504 Override movie aspect ratio, in case aspect information is
4505 incorrect or missing in the file being played.
4510 \-aspect 4:3 or \-aspect 1.3333
4512 \-aspect 16:9 or \-aspect 1.7777
4518 Disable automatic movie aspect ratio compensation.
4521 .B "\-field\-dominance <\-1\-1>"
4522 Set first field for interlaced content.
4523 Useful for deinterlacers that double the framerate: \-vf tfields=1,
4524 \-vf yadif=1 and \-vo vdpau:deint.
4528 auto (default): If the decoder does not export the appropriate information,
4529 it falls back to 0 (top field first).
4539 Flip image upside-down.
4542 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
4543 Specify libavcodec decoding parameters.
4544 Separate multiple options with a colon.
4549 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
4554 Available options are:
4558 Only use bit-exact algorithms in all decoding steps (for codec testing).
4560 Manually work around encoder bugs.
4564 1: autodetect bugs (default)
4566 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
4568 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
4570 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
4572 16 (mpeg4): padding bug (autodetected)
4574 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
4576 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
4578 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
4580 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
4582 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
4584 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
4587 Display debugging information.
4598 8: macroblock (MB) type
4600 16: per-block quantization parameter (QP)
4604 0x0040: motion vector visualization (use \-noslices)
4606 0x0080: macroblock (MB) skip
4612 0x0400: error resilience
4614 0x0800: memory management control operations (H.264)
4618 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
4620 0x4000: Visualize block types.
4623 Set error concealment strategy.
4625 1: Use strong deblock filter for damaged MBs.
4627 2: iterative motion vector (MV) search (slow)
4632 Set error resilience strategy.
4637 1: careful (Should work with broken encoders.)
4639 2: normal (default) (Works with compliant encoders.)
4641 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4645 .IPs "fast (MPEG-2, MPEG-4, and H.264 only)"
4646 Enable optimizations which do not comply to the specification and might
4647 potentially cause problems, like simpler dequantization, simpler motion
4648 compensation, assuming use of the default quantization matrix, assuming
4649 YUV 4:2:0 and skipping a few checks to detect damaged bitstreams.
4651 grayscale only decoding (a bit faster than with color)
4652 .IPs "idct=<0\-99> (see \-lavcopts)"
4653 For best decoding quality use the same IDCT algorithm for decoding and encoding.
4654 This may come at a price in accuracy, though.
4655 .IPs lowres=<number>[,<w>]
4656 Decode at lower resolutions.
4657 Low resolution decoding is not supported by all codecs, and it will
4658 often result in ugly artifacts.
4659 This is not a bug, but a side effect of not decoding at full resolution.
4671 If <w> is specified lowres decoding will be used only if the width of the
4672 video is major than or equal to <w>.
4674 .B o=<key>=<value>[,<key>=<value>[,...]]
4675 Pass AVOptions to libavcodec decoder.
4676 Note, a patch to make the o= unneeded and pass all unknown options through
4677 the AVOption system is welcome.
4678 A full list of AVOptions can be found in the FFmpeg manual.
4688 .IPs "sb=<number> (MPEG-2 only)"
4689 Skip the given number of macroblock rows at the bottom.
4690 .IPs "st=<number> (MPEG-2 only)"
4691 Skip the given number of macroblock rows at the top.
4692 .IPs "skiploopfilter=<skipvalue> (H.264 only)"
4693 Skips the loop filter (AKA deblocking) during H.264 decoding.
4694 Since the filtered frame is supposed to be used as reference
4695 for decoding dependent frames this has a worse effect on quality
4696 than not doing deblocking on e.g.\& MPEG-2 video.
4697 But at least for high bitrate HDTV this provides a big speedup with
4698 no visible quality loss.
4700 <skipvalue> can be either one of the following:
4705 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
4707 nonref: Skip frames that are not referenced (i.e.\& not used for
4708 decoding other frames, the error cannot "build up").
4710 bidir: Skip B-Frames.
4712 nonkey: Skip all frames except keyframes.
4714 all: Skip all frames.
4716 .IPs "skipidct=<skipvalue> (MPEG-1/2 only)"
4717 Skips the IDCT step.
4718 This degrades quality a lot of in almost all cases
4719 (see skiploopfilter for available skip values).
4720 .IPs skipframe=<skipvalue>
4721 Skips decoding of frames completely.
4722 Big speedup, but jerky motion and sometimes bad artifacts
4723 (see skiploopfilter for available skip values).
4724 .IPs "threads=<0\-16>"
4725 Number of threads to use for decoding.
4726 Whether threading is actually supported depends on codec.
4727 0 means autodetect number of cores on the machine and use that, up to the
4731 Visualize motion vectors.
4736 1: Visualize forward predicted MVs of P-frames.
4738 2: Visualize forward predicted MVs of B-frames.
4740 4: Visualize backward predicted MVs of B-frames.
4743 Prints some statistics and stores them in ./vstats_*.log.
4748 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4749 whole frame in a single run.
4750 May be faster or slower, depending on video card and available cache.
4751 It has effect only with libmpeg2 and libavcodec codecs.
4756 Useful for benchmarking.
4761 With some demuxers this may not work. In those cases you can try \-vc null \-vo null instead; but "\-vc null" is always unreliable.
4764 .B \-pp <quality> (also see \-vf pp)
4765 Set the DLL postprocess level.
4766 This option is no longer usable with \-vf pp.
4767 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4768 The valid range of \-pp values varies by codec, it is mostly
4769 0\-6, where 0=disable, 6=slowest/\:best.
4772 .B \-pphelp (also see \-vf pp)
4773 Show a summary about the available postprocess filters and their usage.
4777 Specifies software scaler parameters.
4782 \-vf scale \-ssf lgb=3.0
4788 gaussian blur filter (luma)
4790 gaussian blur filter (chroma)
4791 .IPs ls=<\-100\-100>
4792 sharpen filter (luma)
4793 .IPs cs=<\-100\-100>
4794 sharpen filter (chroma)
4796 chroma horizontal shifting
4798 chroma vertical shifting
4804 Select type of MP2/\:MP3 stereo output.
4817 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
4818 Specify the software scaler algorithm to be used with the \-zoom option.
4819 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4821 Available types are:
4830 bicubic (good quality) (default)
4834 nearest neighbor (bad quality)
4838 luma bicubic / chroma bilinear
4846 natural bicubic spline
4852 Some \-sws options are tunable.
4853 The description of the scale video filter has further information.
4857 .B \-vc <[\-|+]codec1,[\-|+]codec2,...[,]>
4858 Specify a priority list of video codecs to be used, according to their codec
4859 name in codecs.conf.
4860 Use a '\-' before the codec name to omit it.
4861 Use a '+' before the codec name to force it, this will likely crash!
4862 If the list has a trailing ',' MPlayer will fall back on codecs not
4863 contained in the list.
4866 See \-vc help for a full list of available codecs.
4872 Force Win32/\:VfW DivX codec, no fallback.
4873 .IPs "\-vc \-divxds,\-divx,"
4874 Skip Win32 DivX codecs.
4875 .IPs "\-vc ffmpeg12,mpeg12,"
4876 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
4881 .B \-vfm <driver1,driver2,...>
4882 Specify a priority list of video codec families to be used, according
4883 to their names in codecs.conf.
4884 Falls back on the default codecs if none of the given codec families work.
4887 See \-vfm help for a full list of available codec families.
4892 .IPs "\-vfm ffmpeg,dshow,vfw"
4893 Try the libavcodec, then Directshow, then VfW codecs and fall back
4894 on others, if they do not work.
4896 Try XAnim codecs first.
4901 .B \-x <x> (also see \-zoom)
4902 Scale image to width <x> (if software/\:hardware scaling is available).
4903 Disables aspect calculations.
4906 .B \-xvidopts <option1:option2:...>
4907 Specify additional parameters when decoding with Xvid.
4910 Since libavcodec is faster than Xvid you might want to use the libavcodec
4911 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
4913 Xvid's internal postprocessing filters:
4916 .IPs "deblock-chroma (also see \-vf pp)"
4917 chroma deblock filter
4918 .IPs "deblock-luma (also see \-vf pp)"
4920 .IPs "dering-luma (also see \-vf pp)"
4921 luma deringing filter
4922 .IPs "dering-chroma (also see \-vf pp)"
4923 chroma deringing filter
4924 .IPs "filmeffect (also see \-vf noise)"
4925 Adds artificial film grain to the video.
4926 May increase perceived quality, while lowering true quality.
4935 Activate direct rendering method 2.
4937 Deactivate direct rendering method 2.
4942 .B \-xy <value> (also see \-zoom)
4946 Scale image by factor <value>.
4948 Set width to value and calculate height to keep correct aspect ratio.
4953 .B \-y <y> (also see \-zoom)
4954 Scale image to height <y> (if software/\:hardware scaling is available).
4955 Disables aspect calculations.
4959 Allow software scaling, where available.
4960 This will allow scaling with output drivers (like x11, fbdev) that
4961 do not support hardware scaling where MPlayer disables scaling by
4962 default for performance reasons.
4967 Audio filters allow you to modify the audio stream and its properties.
4971 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
4972 Setup a chain of audio filters.
4975 To get a full list of available audio filters, see \-af help.
4977 Audio filters are managed in lists.
4978 There are a few commands to manage the filter list.
4981 .B \-af\-add <filter1[,filter2,...]>
4982 Appends the filters given as arguments to the filter list.
4985 .B \-af\-pre <filter1[,filter2,...]>
4986 Prepends the filters given as arguments to the filter list.
4989 .B \-af\-del <index1[,index2,...]>
4990 Deletes the filters at the given indexes.
4991 Index numbers start at 0, negative numbers address the end of the
4992 list (\-1 is the last).
4996 Completely empties the filter list.
4998 Available filters are:
5001 .B resample[=srate[:sloppy[:type]]]
5002 Changes the sample rate of the audio stream.
5003 Can be used if you have a fixed frequency sound card or if you are
5004 stuck with an old sound card that is only capable of max 44.1kHz.
5005 This filter is automatically enabled if necessary.
5006 It only supports 16-bit integer and float in native-endian format as input.
5010 output sample frequency in Hz.
5011 The valid range for this parameter is 8000 to 192000.
5012 If the input and output sample frequency are the same or if this
5013 parameter is omitted the filter is automatically unloaded.
5014 A high sample frequency normally improves the audio quality,
5015 especially when used in combination with other filters.
5017 Allow (1) or disallow (0) the output frequency to differ slightly
5018 from the frequency given by <srate> (default: 1).
5019 Can be used if the startup of the playback is extremely slow.
5021 Select which resampling method to use.
5023 0: linear interpolation (fast, poor quality especially when upsampling)
5025 1: polyphase filterbank and integer processing
5027 2: polyphase filterbank and floating point processing (slow, best quality)
5037 .IPs "mplayer \-af resample=44100:0:0"
5038 would set the output frequency of the resample filter to 44100Hz using
5039 exact output frequency scaling and linear interpolation.
5044 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
5045 Changes the sample rate of the audio stream to an integer <srate> in Hz.
5046 It only supports the 16-bit native-endian format.
5050 the output sample rate
5052 length of the filter with respect to the lower sampling rate (default: 16)
5054 if 1 then filters will be linearly interpolated between polyphase entries
5056 log2 of the number of polyphase entries
5057 (..., 10->1024, 11->2048, 12->4096, ...)
5060 cutoff frequency (0.0\-1.0), default set depending upon filter length
5065 .B lavcac3enc[=tospdif[:bitrate[:minchn]]]
5066 Encode multi-channel audio to AC-3 at runtime using libavcodec.
5067 Supports 16-bit native-endian input format, maximum 6 channels.
5068 The output is big-endian when outputting a raw AC-3 stream,
5069 native-endian when outputting to S/PDIF.
5070 The output sample rate of this filter is same with the input sample rate.
5071 When input sample rate is 48kHz, 44.1kHz, or 32kHz, this filter directly use it.
5072 Otherwise a resampling filter is auto-inserted before this filter to make
5073 the input and output sample rate be 48kHz.
5074 You need to specify '\-channels N' to make the decoder decode audio into
5075 N-channel, then the filter can encode the N-channel input to AC-3.
5080 Output raw AC-3 stream if zero or not set,
5081 output to S/PDIF for passthrough when <tospdif> is set non-zero.
5083 The bitrate to encode the AC-3 stream.
5084 Set it to either 384 or 384000 to get 384kbits.
5085 Valid values: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
5086 320, 384, 448, 512, 576, 640
5087 Default bitrate is based on the input channel number:
5088 1ch: 96, 2ch: 192, 3ch: 224, 4ch: 384, 5ch: 448, 6ch: 448
5090 If the input channel number is less than <minchn>, the filter will
5091 detach itself (default: 5).
5097 Produces a sine sweep.
5101 Sine function delta, use very low values to hear the sweep.
5106 .B sinesuppress[=freq:decay]
5107 Remove a sine at the specified frequency.
5108 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
5109 It probably only works on mono input.
5113 The frequency of the sine which should be removed (in Hz) (default: 50)
5115 Controls the adaptivity (a larger value will make the filter adapt to
5116 amplitude and phase changes quicker, a smaller value will make the
5117 adaptation slower) (default: 0.0001).
5118 Reasonable values are around 0.001.
5123 .B bs2b[=option1:option2:...]
5124 Bauer stereophonic to binaural transformation using libbs2b.
5125 Improves the headphone listening experience by making the sound
5126 similar to that from loudspeakers, allowing each ear to hear both
5127 channels and taking into account the distance difference and the
5128 head shadowing effect.
5129 It is applicable only to 2 channel audio.
5132 .IPs fcut=<300\-1000>
5133 Set cut frequency in Hz.
5135 Set feed level for low frequencies in 0.1*dB.
5136 .IPs profile=<value>
5137 Several profiles are available for convenience:
5141 will be used if nothing else was specified (fcut=700, feed=45)
5143 Chu Moy circuit implementation (fcut=700, feed=60)
5145 Jan Meier circuit implementation (fcut=650, feed=95)
5150 If fcut or feed options are specified together with a profile, they
5151 will be applied on top of the selected profile.
5157 Head-related transfer function: Converts multichannel audio to
5158 2 channel output for headphones, preserving the spatiality of the sound.
5163 .IPs "m matrix decoding of the rear channel"
5164 .IPs "s 2-channel matrix decoding"
5165 .IPs "0 no matrix decoding (default)"
5170 .B equalizer=[g1:g2:g3:...:g10]
5171 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
5172 This means that it works regardless of what type of audio is being played back.
5173 The center frequencies for the 10 bands are:
5177 .IPs "No. frequency"
5192 If the sample rate of the sound being played is lower than the center
5193 frequency for a frequency band, then that band will be disabled.
5194 A known bug with this filter is that the characteristics for the
5195 uppermost band are not completely symmetric if the sample
5196 rate is close to the center frequency of that band.
5197 This problem can be worked around by upsampling the sound
5198 using the resample filter before it reaches this filter.
5202 .IPs <g1>:<g2>:<g3>:...:<g10>
5203 floating point numbers representing the gain in dB
5204 for each frequency band (\-12\-12)
5211 .IPs "mplayer \-af equalizer=11:11:10:5:0:\-12:0:5:12:12 media.avi"
5212 Would amplify the sound in the upper and lower frequency region
5213 while canceling it almost completely around 1kHz.
5218 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
5219 Can be used for adding, removing, routing and copying audio channels.
5220 If only <nch> is given the default routing is used, it works as
5221 follows: If the number of output channels is bigger than the number of
5222 input channels empty channels are inserted (except mixing from mono to
5223 stereo, then the mono channel is repeated in both of the output
5225 If the number of output channels is smaller than the number
5226 of input channels the exceeding channels are truncated.
5230 number of output channels (1\-8)
5232 number of routes (1\-8)
5233 .IPs <from1:to1:from2:to2:from3:to3:...>
5234 Pairs of numbers between 0 and 7 that define where to route each channel.
5241 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
5242 Would change the number of channels to 4 and set up 4 routes that
5243 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
5244 Observe that if media containing two channels was played back, channels
5245 2 and 3 would contain silence but 0 and 1 would still be swapped.
5246 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
5247 Would change the number of channels to 6 and set up 4 routes
5248 that copy channel 0 to channels 0 to 3.
5249 Channel 4 and 5 will contain silence.
5254 .B format[=format] (also see \-format)
5255 Convert between different sample formats.
5256 Automatically enabled when needed by the sound card or another filter.
5260 Sets the desired format.
5261 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
5262 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
5263 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
5264 and 'ne' the endianness of the computer MPlayer is running on).
5265 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
5266 Exceptions to this rule that are also valid format specifiers: u8, s8,
5267 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
5273 Implements software volume control.
5274 Use this filter with caution since it can reduce the signal
5275 to noise ratio of the sound.
5276 In most cases it is best to set the level for the PCM sound to max,
5277 leave this filter out and control the output level to your
5278 speakers with the master volume control of the mixer.
5279 In case your sound card has a digital PCM mixer instead of an analog
5280 one, and you hear distortion, use the MASTER mixer instead.
5281 If there is an external amplifier connected to the computer (this
5282 is almost always the case), the noise level can be minimized by
5283 adjusting the master level and the volume knob on the amplifier
5284 until the hissing noise in the background is gone.
5286 This filter has a second feature: It measures the overall maximum
5287 sound level and prints out that level when MPlayer exits.
5288 This feature currently only works with floating-point data,
5289 use e.g. \-af\-adv force=5, or use \-af stats.
5292 This filter is not reentrant and can therefore only be enabled
5293 once for every audio stream.
5297 Sets the desired gain in dB for all channels in the stream
5298 from \-200dB to +60dB, where \-200dB mutes the sound
5299 completely and +60dB equals a gain of 1000 (default: 0).
5301 Turns soft clipping on (1) or off (0).
5302 Soft-clipping can make the sound more smooth if very
5303 high volume levels are used.
5304 Enable this option if the dynamic range of the
5305 loudspeakers is very low.
5308 This feature creates distortion and should be considered a last resort.
5315 .IPs "mplayer \-af volume=10.1:0 media.avi"
5316 Would amplify the sound by 10.1dB and hard-clip if the
5317 sound level is too high.
5322 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
5323 Mixes channels arbitrarily.
5324 Basically a combination of the volume and the channels filter
5325 that can be used to down-mix many channels to only a few,
5326 e.g.\& stereo to mono or vary the "width" of the center
5327 speaker in a surround sound system.
5328 This filter is hard to use, and will require some tinkering
5329 before the desired result is obtained.
5330 The number of options for this filter depends on
5331 the number of output channels.
5332 An example how to downmix a six-channel file to two channels with
5333 this filter can be found in the examples section near the end.
5337 number of output channels (1\-8)
5339 How much of input channel i is mixed into output channel j (0\-1).
5340 So in principle you first have n numbers saying what to do with the
5341 first input channel, then n numbers that act on the second input channel
5343 If you do not specify any numbers for some input channels, 0 is assumed.
5350 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
5351 Would down-mix from stereo to mono.
5352 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
5353 Would give 3 channel output leaving channels 0 and 1 intact,
5354 and mix channels 0 and 1 into output channel 2 (which could
5355 be sent to a subwoofer for example).
5361 Adds a subwoofer channel to the audio stream.
5362 The audio data used for creating the subwoofer channel is
5363 an average of the sound in channel 0 and channel 1.
5364 The resulting sound is then low-pass filtered by a 4th order
5365 Butterworth filter with a default cutoff frequency of 60Hz
5366 and added to a separate channel in the audio stream.
5369 Disable this filter when you are playing DVDs with Dolby
5370 Digital 5.1 sound, otherwise this filter will disrupt
5371 the sound to the subwoofer.
5375 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
5376 For the best result try setting the cutoff frequency as low as possible.
5377 This will improve the stereo or surround sound experience.
5379 Determines the channel number in which to insert the sub-channel audio.
5380 Channel number can be between 0 and 7 (default: 5).
5381 Observe that the number of channels will automatically
5382 be increased to <ch> if necessary.
5389 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
5390 Would add a sub-woofer channel with a cutoff frequency of
5391 100Hz to output channel 4.
5397 Creates a center channel from the front channels.
5398 May currently be low quality as it does not implement a
5399 high-pass filter for proper extraction yet, but averages and
5400 halves the channels instead.
5404 Determines the channel number in which to insert the center channel.
5405 Channel number can be between 0 and 7 (default: 5).
5406 Observe that the number of channels will automatically
5407 be increased to <ch> if necessary.
5413 Decoder for matrix encoded surround sound like Dolby Surround.
5414 Many files with 2 channel audio actually contain matrixed surround sound.
5415 Requires a sound card supporting at least 4 channels.
5419 delay time in ms for the rear speakers (0 to 1000) (default: 20)
5420 This delay should be set as follows: If d1 is the distance
5421 from the listening position to the front speakers and d2 is the distance
5422 from the listening position to the rear speakers, then the delay should
5423 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
5430 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
5431 Would add surround sound decoding with 15ms delay for the sound to the
5437 .B delay[=ch1:ch2:...]
5438 Delays the sound to the loudspeakers such that the sound from the
5439 different channels arrives at the listening position simultaneously.
5440 It is only useful if you have more than 2 loudspeakers.
5444 The delay in ms that should be imposed on each channel
5445 (floating point number between 0 and 1000).
5450 To calculate the required delay for the different channels do as follows:
5452 Measure the distance to the loudspeakers in meters in relation
5453 to your listening position, giving you the distances s1 to s5
5455 There is no point in compensating for the subwoofer (you will not hear the
5458 Subtract the distances s1 to s5 from the maximum distance,
5459 i.e.\& s[i] = max(s) \- s[i]; i = 1...5.
5461 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
5469 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
5470 Would delay front left and right by 10.5ms, the two rear channels
5471 and the sub by 0ms and the center channel by 7ms.
5476 .B export[=mmapped_file[:nsamples]]
5477 Exports the incoming signal to other processes using memory mapping (mmap()).
5478 Memory mapped areas contain a header:
5481 int nch /*number of channels*/
5482 int size /*buffer size*/
5483 unsigned long long counter /*Used to keep sync, updated every
5484 time new data is exported.*/
5487 The rest is payload (non-interleaved) 16 bit data.
5491 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
5493 number of samples per channel (default: 512)
5500 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
5501 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
5506 .B extrastereo[=mul]
5507 (Linearly) increases the difference between left and right channels
5508 which adds some sort of "live" effect to playback.
5512 Sets the difference coefficient (default: 2.5).
5513 0.0 means mono sound (average of both channels), with 1.0 sound will be
5514 unchanged, with \-1.0 left and right channels will be swapped.
5519 .B volnorm[=method:target]
5520 Maximizes the volume without distorting the sound.
5524 Sets the used method.
5526 1: Use a single sample to smooth the variations via the standard
5527 weighted mean over past samples (default).
5529 2: Use several samples to smooth the variations via the standard
5530 weighted mean over past samples.
5533 Sets the target amplitude as a fraction of the maximum for the
5534 sample type (default: 0.25).
5539 .B ladspa=file:label[:controls...]
5540 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
5541 This filter is reentrant, so multiple LADSPA plugins can be used at once.
5545 Specifies the LADSPA plugin library file.
5546 If LADSPA_PATH is set, it searches for the specified file.
5547 If it is not set, you must supply a fully specified pathname.
5549 Specifies the filter within the library.
5550 Some libraries contain only one filter, but others contain many of them.
5551 Entering 'help' here, will list all available filters within the specified
5552 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
5554 Controls are zero or more floating point values that determine the
5555 behavior of the loaded plugin (for example delay, threshold or gain).
5556 In verbose mode (add \-v to the MPlayer command line), all available controls
5557 and their valid ranges are printed.
5558 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
5564 Compressor/expander filter usable for microphone input.
5565 Prevents artifacts on very loud sound and raises the volume on
5567 This filter is untested, maybe even unusable.
5571 Noise gate filter similar to the comp audio filter.
5572 This filter is untested, maybe even unusable.
5576 Simple voice removal filter exploiting the fact that voice is
5577 usually recorded with mono gear and later 'center' mixed onto
5578 the final audio stream.
5579 Beware that this filter will turn your signal into mono.
5580 Works well for 2 channel tracks; do not bother trying it
5581 on anything but 2 channel stereo.
5584 .B scaletempo[=option1:option2:...]
5585 Scales audio tempo without altering pitch, optionally synced to playback
5588 This works by playing \'stride\' ms of audio at normal speed then
5589 consuming \'stride*scale\' ms of input audio.
5590 It pieces the strides together by blending \'overlap\'% of stride with
5591 audio following the previous stride.
5592 It optionally performs a short statistical analysis on the next \'search\'
5593 ms of audio to determine the best overlap position.
5597 Nominal amount to scale tempo.
5598 Scales this amount in addition to speed.
5600 .IPs stride=<amount>
5601 Length in milliseconds to output each stride.
5602 Too high of value will cause noticable skips at high scale amounts and
5603 an echo at low scale amounts.
5604 Very low values will alter pitch.
5605 Increasing improves performance.
5607 .IPs overlap=<percent>
5608 Percentage of stride to overlap.
5609 Decreasing improves performance.
5611 .IPs search=<amount>
5612 Length in milliseconds to search for best overlap position.
5613 Decreasing improves performance greatly.
5614 On slow systems, you will probably want to set this very low.
5616 .IPs speed=<tempo|pitch|both|none>
5617 Set response to speed change.
5620 Scale tempo in sync with speed (default).
5622 Reverses effect of filter.
5623 Scales pitch without altering tempo.
5624 Add \'[ speed_mult 0.9438743126816935\' and \'] speed_mult 1.059463094352953\'
5625 to your input.conf to step by musical semi-tones.
5627 Loses sync with video.
5629 Scale both tempo and pitch.
5631 Ignore speed changes.
5639 .IPs "mplayer \-af scaletempo \-speed 1.2 media.ogg"
5640 Would playback media at 1.2x normal speed, with audio at normal pitch.
5641 Changing playback speed, would change audio tempo to match.
5642 .IPs "mplayer \-af scaletempo=scale=1.2:speed=none \-speed 1.2 media.ogg"
5643 Would playback media at 1.2x normal speed, with audio at normal pitch,
5644 but changing playback speed has no effect on audio tempo.
5645 .IPs "mplayer \-af scaletempo=stride=30:overlap=.50:search=10 media.ogg"
5646 Would tweak the quality and performace parameters.
5647 .IPs "mplayer \-af format=floatne,scaletempo media.ogg"
5648 Would make scaletempo use float code.
5649 Maybe faster on some platforms.
5650 .IPs "mplayer \-af scaletempo=scale=1.2:speed=pitch audio.ogg"
5651 Would playback audio file at 1.2x normal speed, with audio at normal pitch.
5652 Changing playback speed, would change pitch, leaving audio tempo at 1.2x.
5658 Collects and prints statistics about the audio stream, especially the volume.
5659 These statistics are especially intended to help adjusting the volume while
5661 The volumes are printed in dB and compatible with the volume audio filter.
5666 Video filters allow you to modify the video stream and its properties.
5670 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
5671 Setup a chain of video filters.
5673 Many parameters are optional and set to default values if omitted.
5674 To explicitly use a default value set a parameter to '\-1'.
5675 Parameters w:h means width x height in pixels, x:y means x;y position counted
5676 from the upper left corner of the bigger image.
5679 To get a full list of available video filters, see \-vf help.
5681 Video filters are managed in lists.
5682 There are a few commands to manage the filter list.
5685 .B \-vf\-add <filter1[,filter2,...]>
5686 Appends the filters given as arguments to the filter list.
5689 .B \-vf\-pre <filter1[,filter2,...]>
5690 Prepends the filters given as arguments to the filter list.
5693 .B \-vf\-del <index1[,index2,...]>
5694 Deletes the filters at the given indexes.
5695 Index numbers start at 0, negative numbers address the end of the
5696 list (\-1 is the last).
5700 Completely empties the filter list.
5702 With filters that support it, you can access parameters by their name.
5705 .B \-vf <filter>=help
5706 Prints the parameter names and parameter value ranges for a particular
5710 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
5711 Sets a named parameter to the given value.
5712 Use on and off or yes and no to set flag parameters.
5714 Available filters are:
5718 Crops the given part of the image and discards the rest.
5719 Useful to remove black bands from widescreen movies.
5723 Cropped width and height, defaults to original width and height.
5725 Position of the cropped picture, defaults to center.
5730 .B cropdetect[=limit:round[:reset]]
5731 Calculates necessary cropping parameters and prints the recommended parameters
5736 Threshold, which can be optionally specified from nothing (0) to
5737 everything (255) (default: 24).
5740 Value which the width/\:height should be divisible by (default: 16).
5741 The offset is automatically adjusted to center the video.
5742 Use 2 to get only even dimensions (needed for 4:2:2 video).
5743 16 is best when encoding to most video codecs.
5746 Counter that determines after how many frames cropdetect will reset the
5747 previously detected largest video area and start over to detect the current
5748 optimal crop area (default: 0).
5749 This can be useful when channel logos distort the video area.
5750 0 indicates never reset and return the largest area encountered during playback.
5755 .B rectangle[=w:h:x:y]
5756 Draws a rectangle of the requested width and height at the specified
5757 coordinates over the image and prints current rectangle parameters
5759 This can be used to find optimal cropping parameters.
5760 If you bind the input.conf directive 'change_rectangle' to keystrokes,
5761 you can move and resize the rectangle on the fly.
5765 width and height (default: \-1, maximum possible width where boundaries
5768 top left corner position (default: \-1, uppermost leftmost)
5773 .B expand[=w:h:x:y:o:a:r]
5774 Expands (not scales) movie resolution to the given value and places the
5775 unscaled original at coordinates x, y.
5776 Can be used for placing subtitles/\:OSD in the resulting black bands.
5779 Expanded width,height (default: original width,height).
5780 Negative values for w and h are treated as offsets to the original size.
5785 .IP expand=0:\-50:0:0
5786 Adds a 50 pixel border to the bottom of the picture.
5790 position of original image on the expanded image (default: center)
5792 OSD/\:subtitle rendering
5794 0: disable (default)
5799 Expands to fit an aspect instead of a resolution (default: 0).
5804 .IP expand=800:::::4/3
5805 Expands to 800x600, unless the source is higher resolution, in which
5806 case it expands to fill a 4/3 aspect.
5810 Rounds up to make both width and height divisible by <r> (default: 1).
5814 .B flip (also see \-flip)
5815 Flips the image upside down.
5819 Mirrors the image on the Y axis.
5823 Rotates the image by 90 degrees and optionally flips it.
5824 For values between 4\-7 rotation is only done if the movie geometry is
5825 portrait and not landscape.
5828 Rotate by 90 degrees clockwise and flip (default).
5830 Rotate by 90 degrees clockwise.
5832 Rotate by 90 degrees counterclockwise.
5834 Rotate by 90 degrees counterclockwise and flip.
5838 .B scale[=w:h[:interlaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]]
5839 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
5840 colorspace conversion (also see \-sws).
5843 scaled width/\:height (default: original width/\:height)
5846 If \-zoom is used, and underlying filters (including libvo) are
5847 incapable of scaling, it defaults to d_width/\:d_height!
5849 0: scaled d_width/\:d_height
5851 \-1: original width/\:height
5853 \-2: Calculate w/h using the other dimension and the prescaled aspect ratio.
5855 \-3: Calculate w/h using the other dimension and the original aspect ratio.
5857 \-(n+8): Like \-n above, but rounding the dimension to the closest multiple of 16.
5860 Toggle interlaced scaling.
5869 0: Use all available input lines for chroma.
5871 1: Use only every 2. input line for chroma.
5873 2: Use only every 4. input line for chroma.
5875 3: Use only every 8. input line for chroma.
5877 .IPs "<par>[:<par2>] (also see \-sws)"
5878 Set some scaling parameters depending on the type of scaler selected
5881 \-sws 2 (bicubic): B (blurring) and C (ringing)
5885 0.00:0.75 VirtualDub's "precise bicubic"
5887 0.00:0.50 Catmull-Rom spline
5889 0.33:0.33 Mitchell-Netravali spline
5891 1.00:0.00 cubic B-spline
5893 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
5895 \-sws 9 (lanczos): filter length (1\-10)
5898 Scale to preset sizes.
5900 qntsc: 352x240 (NTSC quarter screen)
5902 qpal: 352x288 (PAL quarter screen)
5904 ntsc: 720x480 (standard NTSC)
5906 pal: 720x576 (standard PAL)
5908 sntsc: 640x480 (square pixel NTSC)
5910 spal: 768x576 (square pixel PAL)
5913 Disallow upscaling past the original dimensions.
5915 0: Allow upscaling (default).
5917 1: Disallow upscaling if one dimension exceeds its original value.
5919 2: Disallow upscaling if both dimensions exceed their original values.
5922 Accurate rounding for the vertical scaler, which may be faster
5923 or slower than the default rounding.
5925 0: Disable accurate rounding (default).
5927 1: Enable accurate rounding.
5932 .B dsize[=aspect|w:h:aspect-method:r]
5933 Changes the intended display size/\:aspect at an arbitrary point in the
5935 Aspect can be given as a fraction (4/3) or floating point number
5937 Alternatively, you may specify the exact display width and height
5939 Note that this filter does
5941 do any scaling itself; it just affects
5942 what later scalers (software or hardware) will do when auto-scaling to
5946 New display width and height.
5947 Can also be these special values:
5949 0: original display width and height
5951 \-1: original video width and height (default)
5953 \-2: Calculate w/h using the other dimension and the original display
5956 \-3: Calculate w/h using the other dimension and the original video
5964 Specifies a display resolution of 800x600 for a 4/3 aspect video, or
5965 800x450 for a 16/9 aspect video.
5967 .IPs <aspect-method>
5968 Modifies width and height according to original aspect ratios.
5970 \-1: Ignore original aspect ratio (default).
5972 0: Keep display aspect ratio by using <w> and <h> as maximum
5975 1: Keep display aspect ratio by using <w> and <h> as minimum
5978 2: Keep video aspect ratio by using <w> and <h> as maximum
5981 3: Keep video aspect ratio by using <w> and <h> as minimum
5989 Specifies a display resolution of at most 800x600, or smaller, in order
5994 Rounds up to make both width and height divisible by <r> (default: 1).
5999 Forces software YVU9 to YV12 colorspace conversion.
6000 Deprecated in favor of the software scaler.
6004 Clamps YUV color values to the CCIR 601 range without doing real conversion.
6008 RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette.
6011 .B format[=fourcc[:outfourcc]]
6012 Restricts the colorspace for the next filter without doing any conversion.
6013 Use together with the scale filter for a real conversion.
6016 For a list of available formats see format=fmt=help.
6020 format name like rgb15, bgr24, yv12, etc (default: yuy2)
6022 Format name that should be substituted for the output.
6023 If this is not 100% compatible with the <fourcc> value it will crash.
6027 format=rgb24:bgr24 format=yuyv:yuy2
6029 Invalid examples (will crash):
6036 .B noformat[=fourcc]
6037 Restricts the colorspace for the next filter without doing any conversion.
6038 Unlike the format filter, this will allow any colorspace
6040 the one you specify.
6043 For a list of available formats see noformat=fmt=help.
6047 format name like rgb15, bgr24, yv12, etc (default: yv12)
6052 .B pp[=filter1[:option1[:option2...]]/[\-]filter2...] (also see \-pphelp)
6053 Enables the specified chain of postprocessing subfilters.
6054 Subfilters must be separated by '/' and can be disabled by
6056 Each subfilter and some options have a short and a long name that can be
6057 used interchangeably, i.e.\& dr/dering are the same.
6058 All subfilters share common options to determine their scope:
6062 Automatically switch the subfilter off if the CPU is too slow.
6064 Do chrominance filtering, too (default).
6066 Do luminance filtering only (no chrominance).
6068 Do chrominance filtering only (no luminance).
6075 \-pphelp shows a list of available subfilters.
6077 Available subfilters are
6080 .IPs hb/hdeblock[:difference[:flatness]]
6081 horizontal deblocking filter
6083 <difference>: Difference factor where higher values mean
6084 more deblocking (default: 32).
6086 <flatness>: Flatness threshold where lower values mean
6087 more deblocking (default: 39).
6089 .IPs vb/vdeblock[:difference[:flatness]]
6090 vertical deblocking filter
6092 <difference>: Difference factor where higher values mean
6093 more deblocking (default: 32).
6095 <flatness>: Flatness threshold where lower values mean
6096 more deblocking (default: 39).
6098 .IPs ha/hadeblock[:difference[:flatness]]
6099 accurate horizontal deblocking filter
6101 <difference>: Difference factor where higher values mean
6102 more deblocking (default: 32).
6104 <flatness>: Flatness threshold where lower values mean
6105 more deblocking (default: 39).
6107 .IPs va/vadeblock[:difference[:flatness]]
6108 accurate vertical deblocking filter
6110 <difference>: Difference factor where higher values mean
6111 more deblocking (default: 32).
6113 <flatness>: Flatness threshold where lower values mean
6114 more deblocking (default: 39).
6117 The horizontal and vertical deblocking filters share the
6118 difference and flatness values so you cannot set
6119 different horizontal and vertical thresholds.
6122 experimental horizontal deblocking filter
6124 experimental vertical deblocking filter
6127 .IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]]
6128 temporal noise reducer
6130 <threshold1>: larger -> stronger filtering
6132 <threshold2>: larger -> stronger filtering
6134 <threshold3>: larger -> stronger filtering
6136 .IPs al/autolevels[:f/fullyrange]
6137 automatic brightness / contrast correction
6139 f/fullyrange: Stretch luminance to (0\-255).
6141 .IPs lb/linblenddeint
6142 Linear blend deinterlacing filter that deinterlaces the given block
6143 by filtering all lines with a (1 2 1) filter.
6144 .IPs li/linipoldeint
6145 Linear interpolating deinterlacing filter that deinterlaces the given block
6146 by linearly interpolating every second line.
6147 .IPs ci/cubicipoldeint
6148 Cubic interpolating deinterlacing filter deinterlaces the given block
6149 by cubically interpolating every second line.
6151 Median deinterlacing filter that deinterlaces the given block
6152 by applying a median filter to every second line.
6154 FFmpeg deinterlacing filter that deinterlaces the given block
6155 by filtering every second line with a (\-1 4 2 4 \-1) filter.
6157 Vertically applied FIR lowpass deinterlacing filter that deinterlaces
6158 the given block by filtering all lines with a (\-1 2 6 2 \-1) filter.
6159 .IPs fq/forceQuant[:quantizer]
6160 Overrides the quantizer table from the input with the constant
6161 quantizer you specify.
6163 <quantizer>: quantizer to use
6166 default pp filter combination (hb:a,vb:a,dr:a)
6168 fast pp filter combination (h1:a,v1:a,dr:a)
6170 high quality pp filter combination (ha:a:128:7,va:a,dr:a)
6178 .IPs "\-vf pp=hb/vb/dr/al"
6179 horizontal and vertical deblocking, deringing and automatic
6180 brightness/\:contrast
6181 .IPs "\-vf pp=de/\-al"
6182 default filters without brightness/\:contrast correction
6183 .IPs "\-vf pp=default/tmpnoise:1:2:3"
6184 Enable default filters & temporal denoiser.
6185 .IPs "\-vf pp=hb:y/vb:a"
6186 Horizontal deblocking on luminance only, and switch vertical deblocking
6187 on or off automatically depending on available CPU time.
6192 .B spp[=quality[:qp[:mode]]]
6193 Simple postprocessing filter that compresses and decompresses the
6194 image at several (or \- in the case of quality level 6 \- all)
6195 shifts and averages the results.
6200 Force quantization parameter (default: 0, use QP from video).
6202 0: hard thresholding (default)
6204 1: soft thresholding (better deringing, but blurrier)
6206 4: like 0, but also use B-frames' QP (may cause flicker)
6208 5: like 1, but also use B-frames' QP (may cause flicker)
6212 .B uspp[=quality[:qp]]
6213 Ultra simple & slow postprocessing filter that compresses and
6214 decompresses the image at several (or \- in the case of quality
6215 level 8 \- all) shifts and averages the results.
6216 The way this differs from the behavior of spp is that uspp actually
6217 encodes & decodes each case with libavcodec Snow, whereas spp uses
6218 a simplified intra only 8x8 DCT similar to MJPEG.
6223 Force quantization parameter (default: 0, use QP from video).
6227 .B fspp[=quality[:qp[:strength[:bframes]]]]
6228 faster version of the simple postprocessing filter
6231 4\-5 (equivalent to spp; default: 4)
6233 Force quantization parameter (default: 0, use QP from video).
6235 Filter strength, lower values mean more details but also more artifacts,
6236 while higher values make the image smoother but also blurrier (default:
6239 0: do not use QP from B-frames (default)
6241 1: use QP from B-frames too (may cause flicker)
6246 Variant of the spp filter, similar to spp=6 with 7 point DCT where
6247 only the center sample is used after IDCT.
6250 Force quantization parameter (default: 0, use QP from video).
6252 0: hard thresholding
6254 1: soft thresholding (better deringing, but blurrier)
6256 2: medium thresholding (default, good results)
6261 quantization parameter (QP) change filter
6264 some equation like "2+2*sin(PI*qp)"
6269 generic equation change filter
6272 Some equation, e.g.\& 'p(W-X\\,Y)' to flip the image horizontally.
6273 You can use whitespace to make the equation more readable.
6274 There are a couple of constants that can be used in the equation:
6280 X / Y: the coordinates of the current sample
6282 W / H: width and height of the image
6284 SW / SH: width/height scale depending on the currently filtered plane, e.g.\&
6285 1,1 and 0.5,0.5 for YUV 4:2:0.
6287 p(x,y): returns the value of the pixel at location x/y of the current plane.
6293 Generate various test patterns.
6296 .B rgbtest[=width:height]
6297 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
6298 You should see a red, green and blue stripe from top to bottom.
6301 Desired width of generated image (default: 0).
6302 0 means width of input image.
6305 Desired height of generated image (default: 0).
6306 0 means height of input image.
6310 .B lavc[=quality:fps]
6311 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV/\:V4L2.
6316 32\-: fixed bitrate in kbits
6318 force output fps (float value) (default: 0, autodetect based on height)
6322 .B dvbscale[=aspect]
6323 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
6324 calculating the y axis scaling in software to keep aspect.
6325 Only useful together with expand and scale.
6328 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
6329 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
6337 .IPs "\-vf dvbscale,scale=\-1:0,expand=\-1:576:\-1:\-1:1,lavc"
6338 FIXME: Explain what this does.
6343 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
6352 uniform noise (gaussian otherwise)
6354 temporal noise (noise pattern changes between frames)
6356 averaged temporal noise (smoother, but a lot slower)
6358 high quality (slightly better looking, slightly slower)
6360 mix random noise with a (semi)regular pattern
6365 .B denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6366 This filter aims to reduce image noise producing smooth images and making still
6367 images really still (This should enhance compressibility.).
6371 spatial luma strength (default: 4)
6372 .IPs <chroma_spatial>
6373 spatial chroma strength (default: 3)
6375 luma temporal strength (default: 6)
6377 chroma temporal strength (default: luma_tmp*chroma_spatial/luma_spatial)
6382 .B hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
6383 High precision/\:quality version of the denoise3d filter.
6384 Parameters and usage are the same.
6387 .B ow[=depth[:luma_strength[:chroma_strength]]]
6388 Overcomplete Wavelet denoiser.
6392 Larger depth values will denoise lower frequency components more, but
6393 slow down filtering (default: 8).
6394 .IPs <luma_strength>
6395 luma strength (default: 1.0)
6396 .IPs <chroma_strength>
6397 chroma strength (default: 1.0)
6402 .B eq[=brightness:contrast] (OBSOLETE)
6403 Software equalizer with interactive controls just like the hardware
6404 equalizer, for cards/\:drivers that do not support brightness and
6405 contrast controls in hardware.
6416 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
6417 Alternative software equalizer that uses lookup tables (very slow),
6418 allowing gamma correction in addition to simple brightness
6419 and contrast adjustment.
6420 Note that it uses the same MMX optimized code as \-vf eq if all
6421 gamma values are 1.0.
6422 The parameters are given as floating point values.
6426 initial gamma value (default: 1.0)
6428 initial contrast, where negative values result in a
6429 negative image (default: 1.0)
6431 initial brightness (default: 0.0)
6433 initial saturation (default: 1.0)
6435 gamma value for the red component (default: 1.0)
6437 gamma value for the green component (default: 1.0)
6439 gamma value for the blue component (default: 1.0)
6441 The weight parameter can be used to reduce the effect of a high gamma value on
6442 bright image areas, e.g.\& keep them from getting overamplified and just plain
6444 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
6445 at its full strength (default: 1.0).
6450 .B hue[=hue:saturation]
6451 Software equalizer with interactive controls just like the hardware
6452 equalizer, for cards/\:drivers that do not support hue and
6453 saturation controls in hardware.
6457 initial hue (default: 0.0)
6459 initial saturation, where negative values result
6460 in a negative chroma (default: 1.0)
6466 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
6467 keeping all chroma samples.
6468 Useful for output to low-resolution display devices when hardware downscaling
6469 is poor quality or is not available.
6470 Can also be used as a primitive luma-only deinterlacer with very low CPU
6475 By default, halfpack averages pairs of lines when downsampling.
6476 Any value different from 0 or 1 gives the default (averaging) behavior.
6478 0: Only use even lines when downsampling.
6480 1: Only use odd lines when downsampling.
6487 When interlaced video is stored in YUV 4:2:0 formats, chroma
6488 interlacing does not line up properly due to vertical downsampling of
6489 the chroma channels.
6490 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
6491 the chroma lines in their proper locations, so that in any given
6492 scanline, the luma and chroma data both come from the same field.
6496 Select the sampling mode.
6498 0: nearest-neighbor sampling, fast but incorrect
6500 1: linear interpolation (default)
6506 .B decimate[=max:hi:lo:frac]
6507 Drops frames that do not differ greatly from the previous frame in
6508 order to reduce framerate.
6509 The main use of this filter is for very-low-bitrate encoding (e.g.\&
6510 streaming over dialup modem), but it could in theory be used for
6511 fixing movies that were inverse-telecined incorrectly.
6515 Sets the maximum number of consecutive frames which can be
6516 dropped (if positive), or the minimum interval between
6517 dropped frames (if negative).
6518 .IPs <hi>,<lo>,<frac>
6519 A frame is a candidate for dropping if no 8x8 region differs by more
6520 than a threshold of <hi>, and if not more than <frac> portion (1
6521 meaning the whole image) differs by more than a threshold of <lo>.
6522 Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
6523 pixel value differences, so a threshold of 64 corresponds to 1 unit of
6524 difference for each pixel, or the same spread out differently over the
6530 .B dint[=sense:level]
6531 The drop-deinterlace (dint) filter detects and drops the first from a set
6532 of interlaced video frames.
6536 relative difference between neighboring pixels (default: 0.1)
6538 What part of the image has to be detected as interlaced to
6539 drop the frame (default: 0.15).
6544 .B lavcdeint (OBSOLETE)
6545 FFmpeg deinterlacing filter, same as \-vf pp=fd
6548 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
6549 Donald Graft's adaptive kernel deinterlacer.
6550 Deinterlaces parts of a video if a configurable threshold is exceeded.
6554 threshold (default: 10)
6557 0: Ignore pixels exceeding the threshold (default).
6559 1: Paint pixels exceeding the threshold white.
6563 0: Leave fields alone (default).
6569 0: Disable additional sharpening (default).
6571 1: Enable additional sharpening.
6575 0: Disable twoway sharpening (default).
6577 1: Enable twoway sharpening.
6583 .B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
6584 unsharp mask / gaussian blur
6587 Apply effect on luma component.
6589 Apply effect on chroma components.
6590 .IPs <width>x<height>
6591 width and height of the matrix, odd sized in both directions
6592 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
6594 Relative amount of sharpness/\:blur to add to the image
6595 (a sane range should be \-1.5\-1.5).
6608 .B il[=d|i][s][:[d|i][s]]
6609 (De)interleaves lines.
6610 The goal of this filter is to add the ability to process interlaced images
6611 pre-field without deinterlacing them.
6612 You can filter your interlaced DVD and play it on a TV without breaking the
6614 While deinterlacing (with the postprocessing filter) removes interlacing
6615 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
6616 2 fields (so called half pictures), so you can process (filter) them
6617 independently and then re-interleave them.
6621 deinterleave (placing one above the other)
6625 swap fields (exchange even & odd lines)
6631 (De)interleaves lines.
6632 This filter is very similar to the il filter but much faster, the main
6633 disadvantage is that it does not always work.
6634 Especially if combined with other filters it may produce randomly messed
6635 up images, so be happy if it works but do not complain if it does not for
6636 your combination of filters.
6640 Deinterleave fields, placing them side by side.
6642 Interleave fields again (reversing the effect of fil=d).
6648 Extracts a single field from an interlaced image using stride arithmetic
6649 to avoid wasting CPU time.
6650 The optional argument n specifies whether to extract the even or the odd
6651 field (depending on whether n is even or odd).
6654 .B detc[=var1=value1:var2=value2:...]
6655 Attempts to reverse the 'telecine' process to recover a clean,
6656 non-interlaced stream at film framerate.
6657 This was the first and most primitive inverse telecine filter to be
6659 It works by latching onto the telecine 3:2 pattern and following it as
6661 This makes it suitable for perfectly-telecined material, even in the
6662 presence of a fair degree of noise, but it will fail in the presence
6663 of complex post-telecine edits.
6664 Development on this filter is no longer taking place, as ivtc, pullup,
6665 and filmdint are better for most applications.
6666 The following arguments (see syntax above) may be used to control
6670 Set the frame dropping mode.
6672 0: Do not drop frames to maintain fixed output framerate (default).
6674 1: Always drop a frame when there have been no drops or telecine
6675 merges in the past 5 frames.
6677 2: Always maintain exact 5:4 input to output frame ratio.
6682 0: Fixed pattern with initial frame number specified by <fr>.
6684 1: aggressive search for telecine pattern (default)
6687 Set initial frame number in sequence.
6688 0\-2 are the three clean progressive frames; 3 and 4 are the two
6690 The default, \-1, means 'not in telecine sequence'.
6691 The number specified here is the type for the imaginary previous
6692 frame before the movie starts.
6693 .IPs "<t0>, <t1>, <t2>, <t3>"
6694 Threshold values to be used in certain modes.
6699 Experimental 'stateless' inverse telecine filter.
6700 Rather than trying to lock on to a pattern like the detc filter does,
6701 ivtc makes its decisions independently for each frame.
6702 This will give much better results for material that has undergone
6703 heavy editing after telecine was applied, but as a result it is not as
6704 forgiving of noisy input, for example TV capture.
6705 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
6706 detc filter, and should not be used with MPlayer.
6707 Further development on ivtc has stopped, as the pullup and filmdint
6708 filters appear to be much more accurate.
6711 .B pullup[=jl:jr:jt:jb:sb:mp]
6712 Third-generation pulldown reversal (inverse telecine) filter,
6713 capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
6714 fps progressive content.
6715 The pullup filter is designed to be much more robust than detc or
6716 ivtc, by taking advantage of future context in making its decisions.
6717 Like ivtc, pullup is stateless in the sense that it does not lock onto
6718 a pattern to follow, but it instead looks forward to the following
6719 fields in order to identify matches and rebuild progressive frames.
6720 It is still under development, but believed to be quite accurate.
6722 .IPs "jl, jr, jt, and jb"
6723 These options set the amount of "junk" to ignore at
6724 the left, right, top, and bottom of the image, respectively.
6725 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
6727 The default is 8 pixels on each side.
6729 .IPs "sb (strict breaks)"
6730 Setting this option to 1 will reduce the chances of
6731 pullup generating an occasional mismatched frame, but it may also
6732 cause an excessive number of frames to be dropped during high motion
6734 Conversely, setting it to \-1 will make pullup match fields more
6736 This may help processing of video where there is slight blurring
6737 between the fields, but may also cause there to be interlaced frames
6740 .IPs "mp (metric plane)"
6741 This option may be set to 1 or 2 to use a chroma
6742 plane instead of the luma plane for doing pullup's computations.
6743 This may improve accuracy on very clean source material, but more
6744 likely will decrease accuracy, especially if there is chroma noise
6745 (rainbow effect) or any grayscale video.
6746 The main purpose of setting mp to a chroma plane is to reduce CPU load
6747 and make pullup usable in realtime on slow machines.
6751 .B filmdint[=options]
6752 Inverse telecine filter, similar to the pullup filter above.
6753 It is designed to handle any pulldown pattern, including mixed soft and
6754 hard telecine and limited support for movies that are slowed down or sped
6755 up from their original framerate for TV.
6756 Only the luma plane is used to find the frame breaks.
6757 If a field has no match, it is deinterlaced with simple linear
6759 If the source is MPEG-2, this must be the first filter to allow
6760 access to the field-flags set by the MPEG-2 decoder.
6761 Depending on the source MPEG, you may be fine ignoring this advice, as
6762 long as you do not see lots of "Bottom-first field" warnings.
6763 With no options it does normal inverse telecine.
6764 When this filter is used with MPlayer, it will result in an uneven
6765 framerate during playback, but it is still generally better than using
6766 pp=lb or no deinterlacing at all.
6767 Multiple options can be specified separated by /.
6769 .IPs crop=<w>:<h>:<x>:<y>
6770 Just like the crop filter, but faster, and works on mixed hard and soft
6771 telecined content as well as when y is not a multiple of 4.
6772 If x or y would require cropping fractional pixels from the chroma
6773 planes, the crop area is extended.
6774 This usually means that x and y must be even.
6775 .IPs io=<ifps>:<ofps>
6776 For each ifps input frames the filter will output ofps frames.
6777 This could be used to filter movies that are broadcast on TV at a frame
6778 rate different from their original framerate.
6780 If n is nonzero, the chroma plane is copied unchanged.
6781 This is useful for YV12 sampled TV, which discards one of the chroma
6784 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
6785 optimized functions, otherwise, use plain C.
6786 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
6787 this option to override auto-detection.
6789 The larger n will speed up the filter at the expense of accuracy.
6790 The default value is n=3.
6791 If n is odd, a frame immediately following a frame marked with the
6792 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
6793 will not spend any time on soft-telecined MPEG-2 content.
6794 This is the only effect of this flag if MMX2 or 3DNow! is available.
6795 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
6797 If n=2 or 3, the number of luma levels used to find the frame breaks is
6798 reduced from 256 to 128, which results in a faster filter without losing
6800 If n=4 or 5, a faster, but much less accurate metric will be used to
6801 find the frame breaks, which is more likely to misdetect high vertical
6802 detail as interlaced content.
6804 If n is nonzero, print the detailed metrics for each frame.
6805 Useful for debugging.
6807 Deinterlace threshold.
6808 Used during de-interlacing of unmatched frames.
6809 Larger value means less deinterlacing, use n=256 to completely turn off
6813 Threshold for comparing a top and bottom fields.
6816 Threshold to detect temporal change of a field.
6819 Sum of Absolute Difference threshold, default is 64.
6824 Inverse telecine for deinterlaced video.
6825 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
6826 using a method that keeps one field and interpolates the other, the result is
6827 a juddering video that has every fourth frame duplicated.
6828 This filter is intended to find and drop those duplicates and restore the
6829 original film framerate.
6830 Two different modes are available:
6831 One pass mode is the default and is straightforward to use,
6832 but has the disadvantage that any changes in the telecine
6833 phase (lost frames or bad edits) cause momentary judder
6834 until the filter can resync again.
6835 Two pass mode avoids this by analyzing the whole video
6836 beforehand so it will have forward knowledge about the
6837 phase changes and can resync at the exact spot.
6840 correspond to pass one and two of the encoding process.
6841 You must run an extra pass using divtc pass one before the
6842 actual encoding throwing the resulting video away.
6843 Use \-nosound \-ovc raw \-o /dev/null to avoid
6844 wasting CPU power for this pass.
6845 You may add something like crop=2:2:0:0 after divtc
6846 to speed things up even more.
6847 Then use divtc pass two for the actual encoding.
6848 If you use multiple encoder passes, use divtc
6849 pass two for all of them.
6854 .IPs file=<filename>
6855 Set the two pass log filename (default: "framediff.log").
6856 .IPs threshold=<value>
6857 Set the minimum strength the telecine pattern must have for the filter to
6858 believe in it (default: 0.5).
6859 This is used to avoid recognizing false pattern from the parts of the video
6860 that are very dark or very still.
6861 .IPs window=<numframes>
6862 Set the number of past frames to look at when searching for pattern
6864 Longer window improves the reliability of the pattern search, but shorter
6865 window improves the reaction time to the changes in the telecine phase.
6866 This only affects the one pass mode.
6867 The two pass mode currently uses fixed window that extends to both future
6869 .IPs phase=0|1|2|3|4
6870 Sets the initial telecine phase for one pass mode (default: 0).
6871 The two pass mode can see the future, so it is able to use the correct
6872 phase from the beginning, but one pass mode can only guess.
6873 It catches the correct phase when it finds it, but this option can be used
6874 to fix the possible juddering at the beginning.
6875 The first pass of the two pass mode also uses this, so if you save the output
6876 from the first pass, you get constant phase result.
6877 .IPs deghost=<value>
6878 Set the deghosting threshold (0\-255 for one pass mode, \-255\-255 for two pass
6880 If nonzero, deghosting mode is used.
6881 This is for video that has been deinterlaced by blending the fields
6882 together instead of dropping one of the fields.
6883 Deghosting amplifies any compression artifacts in the blended frames, so the
6884 parameter value is used as a threshold to exclude those pixels from
6885 deghosting that differ from the previous frame less than specified value.
6886 If two pass mode is used, then negative value can be used to make the
6887 filter analyze the whole video in the beginning of pass-2 to determine
6888 whether it needs deghosting or not and then select either zero or the
6889 absolute value of the parameter.
6890 Specify this option for pass-2, it makes no difference on pass-1.
6894 .B phase[=t|b|p|a|u|T|B|A|U][:v]
6895 Delay interlaced video by one field time so that the field order
6897 The intended use is to fix PAL movies that have been captured with the
6898 opposite field order to the film-to-video transfer.
6902 Capture field order top-first, transfer bottom-first.
6903 Filter will delay the bottom field.
6905 Capture bottom-first, transfer top-first.
6906 Filter will delay the top field.
6908 Capture and transfer with the same field order.
6909 This mode only exists for the documentation of the other options to refer to,
6910 but if you actually select it, the filter will faithfully do nothing ;-)
6912 Capture field order determined automatically by field flags, transfer opposite.
6913 Filter selects among t and b modes on a frame by frame basis using field flags.
6914 If no field information is available, then this works just like u.
6916 Capture unknown or varying, transfer opposite.
6917 Filter selects among t and b on a frame by frame basis by analyzing the
6918 images and selecting the alternative that produces best match between the
6921 Capture top-first, transfer unknown or varying.
6922 Filter selects among t and p using image analysis.
6924 Capture bottom-first, transfer unknown or varying.
6925 Filter selects among b and p using image analysis.
6927 Capture determined by field flags, transfer unknown or varying.
6928 Filter selects among t, b and p using field flags and image analysis.
6929 If no field information is available, then this works just like U.
6930 This is the default mode.
6932 Both capture and transfer unknown or varying.
6933 Filter selects among t, b and p using image analysis only.
6936 Prints the selected mode for each frame and the average squared difference
6937 between fields for t, b, and p alternatives.
6942 Apply 3:2 'telecine' process to increase framerate by 20%.
6943 This most likely will not work correctly with MPlayer.
6944 The optional start parameter tells the filter where in the telecine
6945 pattern to start (0\-3).
6948 .B tinterlace[=mode]
6949 Temporal field interlacing \- merge pairs of frames into an interlaced
6950 frame, halving the framerate.
6951 Even frames are moved into the upper field, odd frames to the lower field.
6952 This can be used to fully reverse the effect of the tfields filter (in mode 0).
6953 Available modes are:
6957 Move odd frames into the upper field, even into the lower field, generating
6958 a full-height frame at half framerate.
6960 Only output odd frames, even frames are dropped; height unchanged.
6962 Only output even frames, odd frames are dropped; height unchanged.
6964 Expand each frame to full height, but pad alternate lines with black;
6965 framerate unchanged.
6967 Interleave even lines from even frames with odd lines from odd frames.
6968 Height unchanged at half framerate.
6973 .B tfields[=mode[:field_dominance]]
6974 Temporal field separation \- split fields into frames, doubling the
6979 0: Leave fields unchanged (will jump/\:flicker).
6981 1: Interpolate missing lines. (The algorithm used might not be so good.)
6983 2: Translate fields by 1/4 pixel with linear interpolation (no jump).
6985 4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default).
6986 .IPs <field_dominance>\ (DEPRECATED)
6988 Only works if the decoder exports the appropriate information and
6989 no other filters which discard that information come before tfields
6990 in the filter chain, otherwise it falls back to 0 (top field first).
6994 1: bottom field first
6997 This option will possibly be removed in a future version.
6998 Use \-field\-dominance instead.
7003 .B yadif=[mode[:field_dominance]]
7004 Yet another deinterlacing filter
7008 0: Output 1 frame for each frame.
7010 1: Output 1 frame for each field.
7012 2: Like 0 but skips spatial interlacing check.
7014 3: Like 1 but skips spatial interlacing check.
7015 .IPs <field_dominance>\ (DEPRECATED)
7016 Operates like tfields.
7019 This option will possibly be removed in a future version.
7020 Use \-field\-dominance instead.
7025 .B mcdeint=[mode[:parity[:qp]]]
7026 Motion compensating deinterlacer.
7027 It needs one field per frame as input and must thus be used together
7028 with tfields=1 or yadif=1/3 or equivalent.
7036 2: slow, iterative motion estimation
7038 3: extra slow, like 2 plus multiple reference frames
7040 0 or 1 selects which field to use (note: no autodetection yet!).
7042 Higher values should result in a smoother motion vector
7043 field but less optimal individual vectors.
7048 .B boxblur=radius:power[:radius:power]
7053 blur filter strength
7055 number of filter applications
7060 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
7065 blur filter strength (~0.1\-4.0) (slower if larger)
7067 prefilter strength (~0.1\-2.0)
7069 maximum difference between pixels to still be considered (~0.1\-100.0)
7074 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
7079 blur filter strength (~0.1\-5.0) (slower if larger)
7081 blur (0.0\-1.0) or sharpen (\-1.0\-0.0)
7083 filter all (0), filter flat areas (0\-30) or filter edges (\-30\-0)
7088 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
7089 Correct the perspective of movies not filmed perpendicular to the screen.
7093 coordinates of the top left, top right, bottom left, bottom right corners
7095 linear (0) or cubic resampling (1)
7101 Scale and smooth the image with the 2x scale and interpolate algorithm.
7105 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
7108 .B down3dright[=lines]
7109 Reposition and resize stereoscopic images.
7110 Extracts both stereo fields and places them side by side, resizing
7111 them to maintain the original movie aspect.
7115 number of lines to select from the middle of the image (default: 12)
7120 .B bmovl=hidden:opaque:fifo
7121 The bitmap overlay filter reads bitmaps from a FIFO and displays them
7122 on top of the movie, allowing some transformations on the image.
7123 Also see TOOLS/bmovl-test.c for a small bmovl test program.
7127 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
7129 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
7131 path/\:filename for the FIFO (named pipe connecting 'mplayer \-vf bmovl' to the
7132 controlling application)
7141 .IPs "RGBA32 width height xpos ypos alpha clear"
7142 followed by width*height*4 Bytes of raw RGBA32 data.
7143 .IPs "ABGR32 width height xpos ypos alpha clear"
7144 followed by width*height*4 Bytes of raw ABGR32 data.
7145 .IPs "RGB24 width height xpos ypos alpha clear"
7146 followed by width*height*3 Bytes of raw RGB24 data.
7147 .IPs "BGR24 width height xpos ypos alpha clear"
7148 followed by width*height*3 Bytes of raw BGR24 data.
7149 .IPs "ALPHA width height xpos ypos alpha"
7150 Change alpha transparency of the specified area.
7151 .IPs "CLEAR width height xpos ypos"
7154 Disable all alpha transparency.
7155 Send "ALPHA 0 0 0 0 0" to enable it again.
7168 .IPs "<width>, <height>"
7170 .IPs "<xpos>, <ypos>"
7171 Start blitting at position x/y.
7173 Set alpha difference.
7174 If you set this to \-255 you can then send a sequence of ALPHA-commands to set
7175 the area to \-225, \-200, \-175 etc for a nice fade-in-effect! ;)
7179 255: Make everything opaque.
7181 \-255: Make everything transparent.
7184 Clear the framebuffer before blitting.
7186 0: The image will just be blitted on top of the old one, so you do not need to
7187 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
7195 .B framestep=I|[i]step
7196 Renders only every nth frame or every intra frame (keyframe).
7198 If you call the filter with I (uppercase) as the parameter, then
7200 keyframes are rendered.
7201 For DVDs it generally means one in every 15/12 frames (IBBPBBPBBPBBPBB),
7202 for AVI it means every scene change or every keyint value.
7204 When a keyframe is found, an 'I!' string followed by a newline character is
7205 printed, leaving the current line of MPlayer output on the screen, because it
7206 contains the time (in seconds) and frame number of the keyframe (You can use
7207 this information to split the AVI.).
7209 If you call the filter with a numeric parameter 'step' then only one in
7210 every 'step' frames is rendered.
7212 If you put an 'i' (lowercase) before the number then an 'I!' is printed
7213 (like the I parameter).
7215 If you give only the i then nothing is done to the frames, only I! is
7219 .B tile=xtiles:ytiles:output:start:delta
7220 Tile a series of images into a single, bigger image.
7221 If you omit a parameter or use a value less than 0, then the default
7223 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
7224 It is probably a good idea to put the scale filter before the tile :-)
7231 number of tiles on the x axis (default: 5)
7233 number of tiles on the y axis (default: 5)
7235 Render the tile when 'output' number of frames are reached, where 'output'
7236 should be a number less than xtile * ytile.
7237 Missing tiles are left blank.
7238 You could, for example, write an 8 * 7 tile every 50 frames to have one
7239 image every 2 seconds @ 25 fps.
7241 outer border thickness in pixels (default: 2)
7243 inner border thickness in pixels (default: 4)
7248 .B delogo[=x:y:w:h:t]
7249 Suppresses a TV station logo by a simple interpolation of the
7251 Just set a rectangle covering the logo and watch it disappear (and
7252 sometimes something even uglier appear \- your mileage may vary).
7256 top left corner of the logo
7258 width and height of the cleared rectangle
7260 Thickness of the fuzzy edge of the rectangle (added to w and h).
7261 When set to \-1, a green rectangle is drawn on the screen to
7262 simplify finding the right x,y,w,h parameters.
7264 You can specify a text file to load the coordinates from.
7265 Each line must have a timestamp (in seconds, and in ascending order) and the
7266 "x:y:w:h:t" coordinates (t can be omitted).
7271 .B remove\-logo=/path/to/logo_bitmap_file_name.pgm
7272 Suppresses a TV station logo, using a PGM or PPM image
7273 file to determine which pixels comprise the logo.
7274 The width and height of the image file must match
7275 those of the video stream being processed.
7276 Uses the filter image and a circular blur
7277 algorithm to remove the logo.
7279 .IPs /path/to/logo_bitmap_file_name.pgm
7280 [path] + filename of the filter image.
7285 Allows acquiring screenshots of the movie using slave mode
7286 commands that can be bound to keypresses.
7287 See the slave mode documentation and the INTERACTIVE CONTROL
7288 section for details.
7289 Files named 'shotNNNN.png' will be saved in the working directory,
7290 using the first available number \- no files will be overwritten.
7291 The filter has no overhead when not used and accepts an arbitrary
7292 colorspace, so it is safe to add it to the configuration file.
7293 Make sure that the screenshot filter is added after all other filters
7294 whose effect you want to record on the saved image.
7295 E.g.\& it should be the last filter if you want to have an exact
7296 screenshot of what you see on the monitor.
7301 Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
7302 Only useful with the \-ass option.
7307 .IPs "\-vf ass,screenshot"
7308 Moves SSA/ASS rendering before the screenshot filter.
7309 Screenshots taken this way will contain subtitles.
7314 .B blackframe[=amount:threshold]
7315 Detect frames that are (almost) completely black.
7316 Can be useful to detect chapter transitions or commercials.
7317 Output lines consist of the frame number of the detected frame, the
7318 percentage of blackness, the frame type and the frame number of the last
7319 encountered keyframe.
7322 Percentage of the pixels that have to be below the threshold (default: 98).
7324 Threshold below which a pixel value is considered black (default: 32).
7329 .B stereo3d[=in:out]
7330 Stereo3d converts between different stereoscopic image formats.
7333 Stereoscopic image format of input. Possible values:
7335 .B sbsl or side_by_side_left_first
7337 side by side parallel (left eye left, right eye right)
7339 .B sbsr or side_by_side_right_first
7341 side by side crosseye (right eye left, left eye right)
7343 .B abl or above_below_left_first
7345 above-below (left eye above, right eye below)
7347 .B abl or above_below_right_first
7349 above-below (right eye above, left eye below)
7351 .B ab2l or above_below_half_height_left_first
7353 above-below with half height resolution (left eye above, right eye below)
7355 .B ab2r or above_below_half_height_right_first
7357 above-below with half height resolution (right eye above, left eye below)
7361 Stereoscopic image format of output. Possible values are all the input formats
7364 .B arcg or anaglyph_red_cyan_gray
7366 anaglyph red/cyan gray (red filter on left eye, cyan filter on right eye)
7368 .B arch or anaglyph_red_cyan_half_color
7370 anaglyph red/cyan half colored (red filter on left eye, cyan filter on right
7373 .B arcc or anaglyph_red_cyan_color
7375 anaglyph red/cyan color (red filter on left eye, cyan filter on right eye)
7377 .B arcd or anaglyph_red_cyan_dubois
7379 anaglyph red/cyan color optimized with the least squares projection of dubois
7380 (red filter on left eye, cyan filter on right eye)
7382 .B agmg or anaglyph_green_magenta_gray
7384 anaglyph green/magenta gray (green filter on left eye, magenta filter on right
7387 .B agmh or anaglyph_green_magenta_half_color
7389 anaglyph green/magenta half colored (green filter on left eye, magenta filter on
7392 .B agmc or anaglyph_green_magenta_color
7394 anaglyph green/magenta colored (green filter on left eye, magenta filter on
7397 .B aybg or anaglyph_yellow_blue_gray
7399 anaglyph yellow/blue gray (yellow filter on left eye, blue filter on right eye)
7401 .B aybh or anaglyph_yellow_blue_half_color
7403 anaglyph yellow/blue half colored (yellow filter on left eye, blue filter on
7406 .B aybc or anaglyph_yellow_blue_color
7408 anaglyph yellow/blue colored (yellow filter on left eye, blue filter on right
7411 .B irl or interleave_rows_left_first
7413 Interleaved rows (left eye has top row, right eye starts on next row)
7415 .B irr or interleave_rows_right_first
7417 Interleaved rows (right eye has top row, left eye starts on next row)
7421 mono output (left eye only)
7425 mono output (right eye only)
7429 To use either of the interleaved-rows output formats to display
7430 full-screen on a row-interleaved 3D display, you will need to scale the
7431 video to the correct height first using the "scale" filter, if it is not
7432 already the right height. Typically, that is 1080 rows (so use e.g.
7433 "-vf scale=1440:1080,stereo3d=sbsl:irl" for a 720p side-by-side encoded
7439 .B gradfun[=strength[:radius]]
7440 Fix the banding artifacts that are sometimes introduced into nearly flat
7441 regions by truncation to 8bit colordepth.
7442 Interpolates the gradients that should go where the bands are, and
7445 This filter is designed for playback only.
7446 Do not use it prior to lossy compression, because compression tends
7447 to lose the dither and bring back the bands.
7450 Maximum amount by which the filter will change any one pixel.
7451 Also the threshold for detecting nearly flat regions (default: 1.2).
7453 Neighborhood to fit the gradient to.
7454 Larger radius makes for smoother gradients, but also prevents the filter
7455 from modifying pixels near detailed regions (default: 16).
7460 Fixes the presentation timestamps (PTS) of the frames.
7461 By default, the PTS passed to the next filter is dropped, but the following
7462 options can change that:
7465 Print the incoming PTS.
7467 Specify a frame per second value.
7469 Specify an initial value for the PTS.
7473 incoming PTS as the initial PTS.
7474 All previous PTS are kept, so setting a huge value or \-1 keeps the PTS
7479 incoming PTS after the end of autostart to determine the framerate.
7487 .IPs "\-vf fixpts=fps=24000/1001,ass,fixpts"
7488 Generates a new sequence of PTS, uses it for ASS subtitles, then drops it.
7489 Generating a new sequence is useful when the timestamps are reset during the
7490 program; this is frequent on DVDs.
7491 Dropping it may be necessary to avoid confusing encoders.
7497 Using this filter together with any sort of seeking (including -ss and EDLs)
7498 may make demons fly out of your nose.
7502 .\" --------------------------------------------------------------------------
7503 .\" environment variables
7504 .\" --------------------------------------------------------------------------
7506 .SH ENVIRONMENT VARIABLES
7508 There are a number of environment variables that can be used to
7509 control the behavior of MPlayer.
7512 .B MPLAYER_CHARSET (also see \-msgcharset)
7513 Convert console messages to the specified charset (default: autodetect).
7514 A value of "noconv" means no conversion.
7518 Directory where MPlayer looks for user settings.
7521 .B MPLAYER_LOCALEDIR
7522 Directory where MPlayer looks for gettext translation files (if enabled).
7525 .B MPLAYER_VERBOSE (also see \-v and \-msglevel)
7526 Set the initial verbosity level across all message modules (default: 0).
7527 The resulting verbosity corresponds to that of \-msglevel 5 plus the
7528 value of MPLAYER_VERBOSE.
7534 If LADSPA_PATH is set, it searches for the specified file.
7535 If it is not set, you must supply a fully specified pathname.
7536 FIXME: This is also mentioned in the ladspa section.
7542 Specify a directory in which to store title key values.
7543 This will speed up descrambling of DVDs which are in the cache.
7544 The DVDCSS_CACHE directory is created if it does not exist,
7545 and a subdirectory is created named after the DVD's title
7546 or manufacturing date.
7547 If DVDCSS_CACHE is not set or is empty, libdvdcss will use
7548 the default value which is "${HOME}/.dvdcss/" under Unix and
7549 "C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" under Win32.
7550 The special value "off" disables caching.
7554 Sets the authentication and decryption method that
7555 libdvdcss will use to read scrambled discs.
7556 Can be one of title, key or disc.
7560 is the default method.
7561 libdvdcss will use a set of calculated player keys to try and get the disc key.
7562 This can fail if the drive does not recognize any of the player keys.
7564 is a fallback method when key has failed.
7565 Instead of using player keys, libdvdcss will crack the disc key using
7566 a brute force algorithm.
7567 This process is CPU intensive and requires 64 MB of memory to store
7570 is the fallback when all other methods have failed.
7571 It does not rely on a key exchange with the DVD drive, but rather uses
7572 a crypto attack to guess the title key.
7573 On rare cases this may fail because there is not enough encrypted data
7574 on the disc to perform a statistical attack, but in the other hand it
7575 is the only way to decrypt a DVD stored on a hard disc, or a DVD with
7576 the wrong region on an RPC2 drive.
7581 .B DVDCSS_RAW_DEVICE
7582 Specify the raw device to use.
7583 Exact usage will depend on your operating system, the Linux
7584 utility to set up raw devices is raw(8) for instance.
7585 Please note that on most operating systems, using a raw device
7586 requires highly aligned buffers: Linux requires a 2048 bytes
7587 alignment (which is the size of a DVD sector).
7591 Sets the libdvdcss verbosity level.
7595 Outputs no messages at all.
7597 Outputs error messages to stderr.
7599 Outputs error messages and debug messages to stderr.
7605 Skip retrieving all keys on startup.
7610 FIXME: Document this.
7615 .B AO_SUN_DISABLE_SAMPLE_TIMING
7616 FIXME: Document this.
7620 FIXME: Document this.
7624 Specifies the Network Audio System server to which the
7625 nas audio output driver should connect and the transport
7626 that should be used.
7627 If unset DISPLAY is used instead.
7628 The transport can be one of tcp and unix.
7629 Syntax is tcp/<somehost>:<someport>, <somehost>:<instancenumber>
7630 or [unix]:<instancenumber>.
7631 The NAS base port is 8000 and <instancenumber> is added to that.
7638 .IPs AUDIOSERVER=somehost:0
7639 Connect to NAS server on somehost using default port and transport.
7640 .IPs AUDIOSERVER=tcp/somehost:8000
7641 Connect to NAS server on somehost listening on TCP port 8000.
7642 .IPs AUDIOSERVER=(unix)?:0
7643 Connect to NAS server instance 0 on localhost using unix domain sockets.
7649 FIXME: Document this.
7655 FIXME: Document this.
7661 FIXME: Document this.
7665 FIXME: Document this.
7669 FIXME: Document this.
7675 FIXME: Document this.
7679 FIXME: Document this.
7683 FIXME: Document this.
7687 FIXME: Document this.
7691 FIXME: Document this.
7697 FIXME: Document this.
7701 FIXME: Document this.
7705 FIXME: Document this.
7711 FIXME: Document this.
7715 FIXME: Document this.
7719 FIXME: Document this.
7723 FIXME: Document this.
7727 FIXME: Document this.
7731 FIXME: Document this.
7735 .\" --------------------------------------------------------------------------
7737 .\" --------------------------------------------------------------------------
7742 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
7743 MPlayer system-wide settings
7747 MPlayer user settings
7750 ~/.mplayer/\:input.conf
7751 input bindings (see '\-input keylist' for the full list)
7755 font directory (There must be a font.desc file and files with .RAW extension.)
7758 ~/.mplayer/\:DVDkeys/
7764 .\" --------------------------------------------------------------------------
7766 .\" --------------------------------------------------------------------------
7768 .SH EXAMPLES OF MPLAYER USAGE
7771 .B Quickstart Blu\-ray playing:
7773 mplayer br:////path/to/disc
7774 mplayer br:// \-bluray\-device /path/to/disc
7778 .B Quickstart DVD playing:
7784 .B Play in Japanese with English subtitles:
7786 mplayer dvd://1 \-alang ja \-slang en
7790 .B Play only chapters 5, 6, 7:
7792 mplayer dvd://1 \-chapter 5\-7
7796 .B Play only titles 5, 6, 7:
7802 .B Play a multiangle DVD:
7804 mplayer dvd://1 \-dvdangle 2
7808 .B Play from a different DVD device:
7810 mplayer dvd://1 \-dvd\-device /dev/\:dvd2
7814 .B Play DVD video from a directory with VOB files:
7816 mplayer dvd://1 \-dvd\-device /path/\:to/\:directory/
7820 .B Copy a DVD title to hard disk, saving to file "title1.vob":
7822 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
7826 .B Play a DVD with dvdnav from path /dev/sr1:
7828 mplayer dvdnav:////dev/sr1
7832 .B Stream from HTTP:
7834 mplayer http://mplayer.hq/example.avi
7838 .B Stream using RTSP:
7840 mplayer rtsp://server.example.com/streamName
7844 .B Convert subtitles to MPsub format:
7846 mplayer dummy.avi \-sub source.sub \-dumpmpsub
7850 .B Convert subtitles to MPsub format without watching the movie:
7852 mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub
7856 .B input from standard V4L:
7858 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
7862 .B Play DTS-CD with passthrough:
7864 mplayer \-ac hwdts \-rawaudio format=0x2001 \-cdrom\-device /dev/cdrom cdda://
7867 You can also use \-afm hwac3 instead of \-ac hwdts.
7868 Adjust '/dev/cdrom' to match the CD-ROM device on your system.
7869 If your external receiver supports decoding raw DTS streams,
7870 you can directly play it via cdda:// without setting format, hwac3 or hwdts.
7873 .B Play a 6-channel AAC file with only two speakers:
7875 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
7878 You might want to play a bit with the pan values (e.g multiply with a value) to
7879 increase volume or avoid clipping.
7882 .B checkerboard invert with geq filter:
7884 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'
7888 .\" --------------------------------------------------------------------------
7889 .\" Bugs, authors, standard disclaimer
7890 .\" --------------------------------------------------------------------------
7893 MPlayer was initially written by Arpad Gereoffy.
7894 See the AUTHORS file for a list of some of the many other contributors.
7896 MPlayer is (C) 2000\-2011 The MPlayer Team
7898 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.