diff options
Diffstat (limited to 'DOCS/man/en/mplayer-old.1')
-rw-r--r-- | DOCS/man/en/mplayer-old.1 | 7902 |
1 files changed, 7902 insertions, 0 deletions
diff --git a/DOCS/man/en/mplayer-old.1 b/DOCS/man/en/mplayer-old.1 new file mode 100644 index 0000000000..0e1ff45516 --- /dev/null +++ b/DOCS/man/en/mplayer-old.1 @@ -0,0 +1,7902 @@ +.\" $Revision$ +.\" MPlayer (C) 2000-2010 MPlayer Team +.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann +. +.\" -------------------------------------------------------------------------- +.\" Macro definitions +.\" -------------------------------------------------------------------------- +. +.\" define indentation for suboptions +.nr SS 5 +.\" add new suboption +.de IPs +.IP "\\$1" \n(SS +.. +.\" begin of first level suboptions, end with .RE +.de RSs +.RS 10 +.. +.\" begin of 2nd level suboptions +.de RSss +.PD 0 +.RS \n(SS+3 +.. +.\" end of 2nd level suboptions +.de REss +.RE +.PD 1 +.. +. +.\" -------------------------------------------------------------------------- +.\" Title +.\" -------------------------------------------------------------------------- +. +.TH MPlayer 1 "2009-03-25" "The MPlayer Project" "The Movie Player" +. +.SH NAME +mplayer \- movie player +. +.\" -------------------------------------------------------------------------- +.\" Synopsis +.\" -------------------------------------------------------------------------- +. +.SH SYNOPSIS +.na +.nh +.B mplayer +[options] [file|URL|playlist|\-] +. +.br +.B mplayer +[options] file1 +[specific options] [file2] [specific options] +. +.br +.B mplayer +[options] +{group of files and options} +[group-specific options] +. +.br +.B mplayer +[br]://[title][/device] +[options] +. +.br +.B mplayer +[dvd|dvdnav]://[title|[start_title]\-end_title][/device] +[options] +. +.br +.B mplayer +vcd://track[/device] +. +.br +.B mplayer +tv://[channel][/input_id] +[options] +. +.br +.B mplayer +radio://[channel|frequency][/capture] +[options] +. +.br +.B mplayer +pvr:// +[options] +. +.br +.B mplayer +dvb://[card_number@]channel +[options] +. +.br +.B mplayer +mf://[filemask|@listfile] +[\-mf options] [options] +. +.br +.B mplayer +[cdda|cddb]://track[\-endtrack][:speed][/device] +[options] +. +.br +.B mplayer +cue://file[:track] +[options] +. +.br +.B mplayer +[file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]:// +[user:pass@]URL[:port] [options] +. +.br +.B mplayer +sdp://file +[options] +. +.br +.B mplayer +mpst://host[:port]/URL +[options] +. +.br +.B mplayer +tivo://host/[list|llist|fsid] +[options] +.ad +.hy +. +.\" -------------------------------------------------------------------------- +.\" Description +.\" -------------------------------------------------------------------------- +. +.SH DESCRIPTION +.B mplayer +is a movie player for Linux (runs on many other platforms and CPU +architectures, see the documentation). +It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM, +MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many +native and binary codecs. +You can watch VCD, SVCD, DVD, Blu\-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies, +too. +.PP +MPlayer supports a wide range of video and audio output drivers. +It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB, +Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers), +VESA (on every VESA-compatible card, even without X11), some low-level +card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder +boards, such as the Siemens DVB, Hauppauge PVR (IVTV) and DXR3/\:Hollywood+. +Most of them support software or hardware scaling, so you can enjoy movies in +fullscreen mode. +.PP +MPlayer has an onscreen display (OSD) for status information, nice big +antialiased shaded subtitles and visual feedback for keyboard controls. +European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean +fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM, +SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and +DVD subtitles (SPU streams, VOBsub and Closed Captions). +.PP +Usage examples to get you started quickly can be found at the end +of this man page. +.PP +.B Also see the HTML documentation! +. +. +.\" -------------------------------------------------------------------------- +.\" interactive control +.\" -------------------------------------------------------------------------- +. +.SH "INTERACTIVE CONTROL" +MPlayer has a fully configurable, command-driven control layer +which allows you to control MPlayer using keyboard, mouse, joystick +or remote control (with LIRC). +See the \-input option for ways to customize it. +. +.TP +.B keyboard control +.PD 0 +.RS +.IPs "LEFT and RIGHT" +Seek backward/\:forward 10 seconds. +Shift+arrow does a 1 second exact seek (see \-hr\-seek; currently modifier +keys like shift only work if used in an X output window). +.IPs "UP and DOWN" +Seek forward/\:backward 1 minute. +Shift+arrow does a 5 second exact seek (see \-hr\-seek; currently modifier +keys like shift only work if used in an X output window). +.IPs "PGUP and PGDWN" +Seek forward/\:backward 10 minutes. +.IPs "[ and ]" +Decrease/increase current playback speed by 10%. +.IPs "{ and }" +Halve/double current playback speed. +.IPs "BACKSPACE" +Reset playback speed to normal. +.IPs "< and >" +Go backward/\:forward in the playlist. +.IPs "ENTER" +Go forward in the playlist, even over the end. +.IPs "HOME and END" +next/\:previous playtree entry in the parent list +.IPs "INS and DEL (ASX playlist only)" +next/\:previous alternative source. +.IPs "p / SPACE" +Pause (pressing again unpauses). +.IPs ".\ \ \ \ " +Step forward. +Pressing once will pause movie, every consecutive press will play one frame +and then go into pause mode again. +.IPs "q / ESC" +Stop playing and quit. +.IPs "U\ \ \ \ " +Stop playing (and quit if \-idle is not used). +.IPs "+ and \-" +Adjust audio delay by +/\- 0.1 seconds. +.IPs "/ and *" +Decrease/\:increase volume. +.IPs "9 and 0" +Decrease/\:increase volume. +.IPs "( and )" +Adjust audio balance in favor of left/\:right channel. +.IPs "m\ \ \ \ " +Mute sound. +.IPs "_ (MPEG-TS, AVI and libavformat only)" +Cycle through the available video tracks. +.IPs "# (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only)" +Cycle through the available audio tracks. +.IPs "TAB (MPEG-TS and libavformat only)" +Cycle through the available programs. +.IPs "f\ \ \ \ " +Toggle fullscreen (also see \-fs). +.IPs "T\ \ \ \ " +Toggle stay-on-top (also see \-ontop). +.IPs "w and e" +Decrease/\:increase pan-and-scan range. +.IPs "o\ \ \ \ " +Toggle OSD states: none / seek / seek + timer / seek + timer + total time. +.IPs "d\ \ \ \ " +Toggle frame dropping states: none / skip display / skip decoding +(see \-framedrop and \-hardframedrop). +.IPs "v\ \ \ \ " +Toggle subtitle visibility. +.IPs "j and J" +Cycle through the available subtitles. +.IPs "y and g" +Step forward/backward in the subtitle list. +.IPs "F\ \ \ \ " +Toggle displaying "forced subtitles". +.IPs "a\ \ \ \ " +Toggle subtitle alignment: top / middle / bottom. +.IPs "x and z" +Adjust subtitle delay by +/\- 0.1 seconds. +.IPs "V\ \ \ \ " +Toggle subtitle VSFilter aspect compatibility mode. +See -ass\-vsfilter\-aspect\-compat for more info. +.IPs "C (\-capture only)" +Start/stop capturing the primary stream. +.IPs "r and t" +Move subtitles up/down. +.IPs "i (\-edlout mode only)" +Set start or end of an EDL skip and write it out to the given file. +.IPs "s (\-vf screenshot only)" +Take a screenshot. +.IPs "S (\-vf screenshot only)" +Start/stop taking screenshots. +.IPs "I\ \ \ \ " +Show filename on the OSD. +.IPs "P\ \ \ \ " +Show progression bar, elapsed time and total duration on the OSD. +.IPs "! and @" +Seek to the beginning of the previous/next chapter. +.IPs "D (\-vo vdpau, \-vf yadif, \-vf kerndeint only)" +Activate/deactivate deinterlacer. +.IPs "A\ \ \ \ " +Cycle through the available DVD angles. +.IPs "c (currently -vo vdpau and -vo xv only)" +Change YUV colorspace. +.RE +.PD 1 +.PP +.RS +(The following keys are valid only when using a video output that supports +the corresponding adjustment, the software equalizer +(\-vf eq or \-vf eq2) or hue filter (\-vf hue).) +.RE +.PP +.PD 0 +.RS +.IPs "1 and 2" +Adjust contrast. +.IPs "3 and 4" +Adjust brightness. +.IPs "5 and 6" +Adjust hue. +.IPs "7 and 8" +Adjust saturation. +.RE +.PD 1 +.PP +.RS +(The following keys are valid only when using the quartz or corevideo +video output driver.) +.RE +.PP +.PD 0 +.RS +.IPs "command + 0" +Resize movie window to half its original size. +.IPs "command + 1" +Resize movie window to its original size. +.IPs "command + 2" +Resize movie window to double its original size. +.IPs "command + f" +Toggle fullscreen (also see \-fs). +.IPs "command + [ and command + ]" +Set movie window alpha. +.RE +.PD 1 +.PP +.RS +(The following keys are valid only when using the sdl +video output driver.) +.RE +.PP +.PD 0 +.RS +.IPs "c\ \ \ \ " +Cycle through available fullscreen modes. +.IPs "n\ \ \ \ " +Restore original mode. +.RE +.PD 1 +.PP +.RS +(The following keys are valid if you have a keyboard +with multimedia keys.) +.RE +.PP +.PD 0 +.RS +.IPs PAUSE +Pause. +.IPs "STOP\ " +Stop playing and quit. +.IPs "PREVIOUS and NEXT" +Seek backward/\:forward 1 minute. +.RE +.PD 1 +.PP +.RS +(The following keys are only valid if you compiled with TV or DVB input +support and will take precedence over the keys defined above.) +.RE +.PP +.PD 0 +.RS +.IPs "h and k" +Select previous/\:next channel. +.IPs "n\ \ \ \ " +Change norm. +.IPs "u\ \ \ \ " +Change channel list. +.RE +.PD 1 +.PP +.RS +(The following keys are only valid if you compiled with dvdnav +support: They are used to navigate the menus.) +.RE +.PP +.PD 0 +.RS +.IPs "keypad 8" +Select button up. +.IPs "keypad 2" +Select button down. +.IPs "keypad 4" +Select button left. +.IPs "keypad 6" +Select button right. +.IPs "keypad 5" +Return to main menu. +.IPs "keypad 7" +Return to nearest menu (the order of preference is: chapter->title->root). +.IPs "keypad ENTER" +Confirm choice. +.RE +.PD 1 +.PP +.RS +. +(The following keys are used for controlling TV teletext. The data may +come from either an analog TV source or an MPEG transport stream.) +.RE +.PP +.PD 0 +.RS +.IPs "X\ \ \ \ " +Switch teletext on/\:off. +.IPs "Q and W" +Go to next/\:prev teletext page. +.RE +.PD 1 +. +.TP +.B mouse control +.PD 0 +.RS +.IPs "button 3 and button 4" +Seek backward/\:forward 1 minute. +.IPs "button 5 and button 6" +Decrease/\:increase volume. +.RE +.PD 1 +. +.TP +.B joystick control +.PD 0 +.RS +.IPs "left and right" +Seek backward/\:forward 10 seconds. +.IPs "up and down" +Seek forward/\:backward 1 minute. +.IPs "button 1" +Pause. +.IPs "button 2" +Toggle OSD states: none / seek / seek + timer / seek + timer + total time. +.IPs "button 3 and button 4" +Decrease/\:increase volume. +.RE +.PD 1 +. +. +.\" -------------------------------------------------------------------------- +.\" Usage +.\" -------------------------------------------------------------------------- +. +.SH "USAGE" +Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the +\-fs option is \-nofs. +.PP +If an option is marked as (XXX only), it will only work in combination with +the XXX option or if XXX is compiled in. +.PP +.I NOTE: +The suboption parser (used for example for \-ao pcm suboptions) supports +a special kind of string-escaping intended for use with external GUIs. +.br +It has the following format: +.br +%n%string_of_length_n +.br +.I EXAMPLES: +.br +mplayer \-ao pcm:file=%10%C:test.wav test.avi +.br +Or in a script: +.br +mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi +.PP +. +.\" -------------------------------------------------------------------------- +.\" Configuration files +.\" -------------------------------------------------------------------------- +. +.SH "CONFIGURATION FILES" +You can put all of the options in configuration files which will be read +every time MPlayer is run. +The system-wide configuration file 'mplayer.conf' is in your configuration +directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user +specific one is '~/\:.mplayer/\:config'. +User specific options override system-wide options and options given on the +command line override either. +The syntax of the configuration files is 'option=<value>', everything after +a '#' is considered a comment. +Options that work without values can be enabled by setting them to 'yes' +or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'. +Even suboptions can be specified in this way. +.PP +You can also write file-specific configuration files. +If you wish to have a configuration file for a file called 'movie.avi', create a file +named 'movie.avi.conf' with the file-specific options in it and put it in +~/.mplayer/. +You can also put the configuration file in the same directory as the file to +be played, as long as you give the \-use\-filedir\-conf option (either on the +command line or in your global config file). +If a file-specific configuration file is found in the same directory, no +file-specific configuration is loaded from ~/.mplayer. +In addition, the \-use\-filedir\-conf option enables directory-specific +configuration files. +For this, MPlayer first tries to load a mplayer.conf from the same directory as +the file played and then tries to load any file-specific configuration. +.PP +.I EXAMPLE MPLAYER CONFIGURATION FILE: +.sp 1 +.nf +# Use Matrox driver by default. +vo=xmga +# I love practicing handstands while watching videos. +flip=yes +# Decode multiple files from PNG, +# start with mf://filemask +mf=type=png:fps=25 +# Eerie negative images are cool. +vf=eq2=1.0:\-0.8 +.fi +. +.\" -------------------------------------------------------------------------- +.\" Profiles +.\" -------------------------------------------------------------------------- +. +.SH "PROFILES" +To ease working with different configurations profiles can be defined in the +configuration files. +A profile starts with its name between square brackets, e.g.\& '[my-profile]'. +All following options will be part of the profile. +A description (shown by \-profile help) can be defined with the profile-desc +option. +To end the profile, start another one or use the profile name 'default' +to continue with normal options. +.fi +.PP +.I "EXAMPLE MPLAYER PROFILE:" +.sp 1 +.nf + +[protocol.dvd] +profile-desc="profile for dvd:// streams" +vf=pp=hb/vb/dr/al/fd +alang=en + +[protocol.dvdnav] +profile-desc="profile for dvdnav:// streams" +profile=protocol.dvd +mouse-movements=yes +nocache=yes + +[extension.flv] +profile-desc="profile for .flv files" +flip=yes + +[vo.pnm] +outdir=/tmp + +[ao.alsa] +device=spdif +.fi +. +.\" -------------------------------------------------------------------------- +.\" Options +.\" -------------------------------------------------------------------------- +. +.SH "GENERAL OPTIONS" +. +.TP +.B \-codecpath <dir> +Specify a directory for binary codecs. +. +.TP +.B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc) +Override the standard search path and use the specified file +instead of the builtin codecs.conf. +. +.TP +.B \-include <configuration file> +Specify configuration file to be parsed after the default ones. +. +.TP +.B \-list\-options +Prints all available options. +. +.TP +.B \-msgcharset <charset> +Convert console messages to the specified character set (default: autodetect). +Text will be in the encoding specified with the \-\-charset configure option. +Set this to "noconv" to disable conversion (for e.g.\& iconv problems). +.br +.I NOTE: +The option takes effect after command line parsing has finished. +The MPLAYER_CHARSET environment variable can help you get rid of +the first lines of garbled output. +. +.TP +.B \-msgcolor +Enable colorful console output on terminals that support ANSI color. +. +.TP +.B \-msglevel <all=<level>:<module>=<level>:...> +Control verbosity directly for each module. +The 'all' module changes the verbosity of all the modules not +explicitly specified on the command line. +See '\-msglevel help' for a list of all modules. +.br +.I NOTE: +Some messages are printed before the command line is parsed and are +therefore not affected by \-msglevel. +To control these messages you have to use the MPLAYER_VERBOSE environment +variable, see its description below for details. +.br +Available levels: +.PD 0 +.RSs +.IPs "\-1" +complete silence +.IPs " 0" +fatal messages only +.IPs " 1" +error messages +.IPs " 2" +warning messages +.IPs " 3" +short hints +.IPs " 4" +informational messages +.IPs " 5" +status messages (default) +.IPs " 6" +verbose messages +.IPs " 7" +debug level 2 +.IPs " 8" +debug level 3 +.IPs " 9" +debug level 4 +.RE +.PD 1 +. +.TP +.B \-msgmodule +Prepend module name in front of each console message. +. +.TP +.B \-noconfig <options> +Do not parse selected configuration files. +.br +.I NOTE: +If \-include or \-use\-filedir\-conf options are +specified at the command line, they will be honoured. +.sp 1 +Available options are: +.PD 0 +.RSs +.IPs "all\ \ " +all configuration files +.IPs system +system configuration file +.IPs "user\ " +user configuration file +.RE +.PD 1 +. +.TP +.B "\-quiet\ " +Make console output less verbose; in particular, prevents the status line +(i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed. +Particularly useful on slow terminals or broken ones which do not properly +handle carriage return (i.e.\& \\r). +. +.TP +.B \-priority <prio> (Windows and OS/2 only) +Set process priority for MPlayer according to the predefined +priorities available under Windows and OS/2. +Possible values of <prio>: +.RSs +idle|belownormal|normal|abovenormal|high|realtime +.RE +.sp 1 +.RS +.I WARNING: +Using realtime priority can cause system lockup. +.RE +. +.TP +.B \-profile <profile1,profile2,...> +Use the given profile(s), \-profile help displays a list of the defined profiles. +. +.TP +.B \-really\-quiet (also see \-quiet) +Display even less output and status messages than with \-quiet. +. +.TP +.B \-show\-profile <profile> +Show the description and content of a profile. +. +.TP +.B \-use\-filedir\-conf +Look for a file-specific configuration file in the same directory as +the file that is being played. +.br +.I WARNING: +May be dangerous if playing from untrusted media. +. +.TP +.B "\-v\ \ \ \ \ " +Increment verbosity level, one level for each \-v +found on the command line. +. +. +. +.SH "PLAYER OPTIONS" +. +.TP +.B \-autoq <quality> (use with \-vf [s]pp) +Dynamically changes the level of postprocessing depending on the available spare +CPU time. +The number you specify will be the maximum level used. +Usually you can use some big number. +You have to use \-vf [s]pp without parameters in order for this to work. +. +.TP +.B \-autosync <factor> +Gradually adjusts the A/V sync based on audio delay measurements. +Specifying \-autosync 0, the default, will cause frame timing to be based +entirely on audio delay measurements. +Specifying \-autosync 1 will do the same, but will subtly change the A/V +correction algorithm. +An uneven video framerate in a movie which plays fine with \-nosound can +often be helped by setting this to an integer value greater than 1. +The higher the value, the closer the timing will be to \-nosound. +Try \-autosync 30 to smooth out problems with sound drivers which do +not implement a perfect audio delay measurement. +With this value, if large A/V sync offsets occur, they will only take about +1 or 2 seconds to settle out. +This delay in reaction time to sudden A/V offsets should be the only +side-effect of turning this option on, for all sound drivers. +. +.TP +.B \-benchmark +Prints some statistics on CPU usage and dropped frames at the end of playback. +Use in combination with \-nosound and \-vo null for benchmarking only the +video codec. +.br +.I NOTE: +With this option MPlayer will also ignore frame duration when playing +only video (you can think of that as infinite fps). +. +.TP +.B \-chapter\-merge\-threshold <number> +Threshold for merging almost consecutive ordered chapter parts +in milliseconds (default: 100). +Some Matroska files with ordered chapters have inaccurate chapter +end timestamps, causing a small gap between the end of one chapter and +the start of the next one when they should match. +If the end of one playback part is less than the given threshold away +from the start of the next one then keep playing video normally over the +chapter change instead of doing a seek. +. +.TP +.B \-colorkey <number> +Changes the colorkey to an RGB value of your choice. +0x000000 is black and 0xffffff is white. +Only supported by the fbdev, svga, vesa, xmga, +xover, xv (see \-vo xv:ck) and directx video output drivers. +. +.TP +.B \-nocolorkey +Disables colorkeying. +Only supported by the fbdev, svga, vesa, xmga, +xover, xv (see \-vo xv:ck) and directx video output drivers. +. +.TP +.B \-correct\-pts, \-nocorrect\-pts +Switches MPlayer to a mode where timestamps for video frames +are calculated differently and video filters which add new frames or +modify timestamps of existing ones are supported. +Now enabled automatically for most common file formats. +The more accurate timestamps can be visible for example when playing +subtitles timed to scene changes with the \-ass option. +Without \-correct\-pts the subtitle timing will typically be off by some frames. +This option does not work correctly with some demuxers and codecs. +. +.TP +.B \-crash\-debug (DEBUG CODE) +Automatically attaches gdb upon crash or SIGTRAP. +Support must be compiled in by configuring with \-\-enable\-crash\-debug. +. +.TP +.B \-doubleclick\-time +Time in milliseconds to recognize two consecutive button presses as +a double-click (default: 300). +Set to 0 to let your windowing system decide what a double-click is +(\-vo directx only). +. +.TP +.B \-edlout <filename> +Creates a new file and writes edit decision list (EDL) records to it. +During playback, the user hits 'i' to mark the start or end of a skip block. +This provides a starting point from which the user can fine-tune EDL entries +later. +See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details. +. +.TP +.B \-fixed\-vo, \-nofixed\-vo +\-fixed\-vo enforces a fixed video system for multiple files (one +(un)initialization for all files). +Therefore only one window will be opened for all files. +Now enabled by default, use \-nofixed\-vo to disable and create a new window +whenever the video stream changes. +Some of the older drivers may not be fixed-vo compliant. +. +.TP +.B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts) +Skip displaying some frames to maintain A/V sync on slow systems. +Video filters are not applied to such frames. +For B-frames even decoding is skipped completely. +. +.TP +.B \-h, \-help, \-\-help +Show short summary of options. +. +.TP +.B \-hardframedrop (experimental without \-nocorrect\-pts) +More intense frame dropping (breaks decoding). +Leads to image distortion! +Note that especially the libmpeg2 decoder may crash with this, +so consider using "\-vc ffmpeg12,". +. +.TP +.B \-heartbeat\-cmd +Command that is executed every 30 seconds during playback via system() - +i.e.\& using the shell. +.sp 1 +.I NOTE: +MPlayer uses this command without any checking, it is your responsibility +to ensure it does not cause security problems (e.g.\& make sure to use full +paths if "." is in your path like on Windows). +It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null). +.sp 1 +This can be "misused" to disable screensavers that do not support the proper +X API (also see \-stop\-xscreensaver). +If you think this is too complicated, ask the author of the screensaver +program to support the proper X APIs. +.sp 1 +.I EXAMPLE for xscreensaver: +mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file +.sp 1 +.I EXAMPLE for GNOME screensaver: +mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file +.RE +.PD 1 +. +.TP +.B \-hr\-seek off|absolute|always +Select when to use precise seeks that are not limited to keyframes. +Such seeks require decoding video from the previous keyframe up to the target +position and so can take some time depending on decoding performance. +For some video formats precise seeks are disabled. This option selects the +default choice to use for seeks; it's possible to explicitly override that +default in the definition of key bindings and in slave mode commands. +.PD 0 +.RSs +.IPs off +Never use precise seeks. +.IPs absolute +Use precise seeks if the seek is to an absolute position in the file, +such as a chapter seek, but not for relative seeks like the default +behavior of arrow keys (default). +.IPs always +Use precise seeks whenever possible. +.RE +.PD 1 +. +.TP +.B \-identify +Shorthand for \-msglevel identify=4. +Show file parameters in an easily parseable format. +Also prints more detailed information about subtitle and audio +track languages and IDs. +In some cases you can get more information by using \-msglevel identify=6. +For example, for a DVD or Blu\-ray it will list the chapters and time length +of each title, as well as a disk ID. +Combine this with \-frames 0 to suppress all video output. +The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and +(hopefully) shellescapes the filenames. +. +.TP +.B \-idle (also see \-slave) +Makes MPlayer wait idly instead of quitting when there is no file to play. +Mostly useful in slave mode where MPlayer can be controlled +through input commands. +. +.TP +.B \-input <commands> +This option can be used to configure certain parts of the input system. +Paths are relative to ~/.mplayer/. +.br +.I NOTE: +Autorepeat is currently only supported by joysticks. +.sp 1 +Available commands are: +.sp 1 +.PD 0 +.RSs +.IPs conf=<filename> +Specify input configuration file other than the default +~/\:.mplayer/\:input.conf. +~/\:.mplayer/\:<filename> is assumed if no full path is given. +.IPs ar-dev=<device> +Device to be used for Apple IR Remote (default is autodetected, Linux only). +.IPs ar-delay +Delay in milliseconds before we start to autorepeat a key (0 to disable). +.IPs ar-rate +Number of key presses to generate per second on autorepeat. +.IPs (no)default-bindings +Use the key bindings that MPlayer ships with by default. +.IPs keylist +Prints all keys that can be bound to commands. +.IPs cmdlist +Prints all commands that can be bound to keys. +.IPs js-dev +Specifies the joystick device to use (default: /dev/\:input/\:js0). +.IPs file=<filename> +Read commands from the given file. +Mostly useful with a FIFO. +.br +.I NOTE: +When the given file is a FIFO MPlayer opens both ends so you can do +several 'echo "seek 10" > mp_pipe' and the pipe will stay valid. +.RE +.PD 1 +. +.TP +.B \-key\-fifo\-size <2\-65000> +Specify the size of the FIFO that buffers key events (default: 7). +If it is too small some events may be lost. +The main disadvantage of setting it to a very large value is that if you +hold down a key triggering some particularly slow command then the player +may be unresponsive while it processes all the queued commands. +. +.TP +.B \-lircconf <filename> (LIRC only) +Specifies a configuration file for LIRC (default: ~/.lircrc). +. +.TP +.B \-list\-properties +Print a list of the available properties. +. +.TP +.B \-loop <number> +Loops movie playback <number> times. +0 means forever. +. +.TP +.B \-menu (OSD menu only) +Turn on OSD menu support. +. +.TP +.B \-menu\-cfg <filename> (OSD menu only) +Use an alternative menu.conf. +. +.TP +.B \-menu\-chroot <path> (OSD menu only) +Chroot the file selection menu to a specific location. +.sp 1 +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-menu\-chroot /home" +Will restrict the file selection menu to /\:home and downward (i.e.\& no +access to / will be possible, but /home/user_name will). +.RE +.PD 1 +. +.TP +.B \-menu\-keepdir (OSD menu only) +File browser starts from the last known location instead of current directory. +. +.TP +.B \-menu\-root <value> (OSD menu only) +Specify the main menu. +. +.TP +.B \-menu\-startup (OSD menu only) +Display the main menu at MPlayer startup. +. +.TP +.B \-mouse\-movements +Permit MPlayer to receive pointer events reported by the video +output driver. +Necessary to select the buttons in DVD menus. +Supported for X11-based VOs (x11, xv, etc) and the gl, gl2, direct3d and +corevideo VOs. +. +.TP +.B \-noar +Turns off AppleIR remote support. +. +.TP +.B \-noconsolecontrols +Prevent MPlayer from reading key events from standard input. +Useful when reading data from standard input. +This is automatically enabled when \- is found on the command line. +There are situations where you have to set it manually, e.g.\& +if you open /dev/\:stdin (or the equivalent on your system), use stdin +in a playlist or intend to read from stdin later on via the loadfile or +loadlist slave commands. +. +.TP +.B \-noinitial-audio-sync +When starting a video file or after events such as seeking MPlayer will by +default modify the audio stream to make it start from the same timestamp as +video, by either inserting silence at the start or cutting away the first +samples. +This option disables that functionality and makes the player behave like +older MPlayer versions did: video and audio are both started immediately +even if their start timestamps differ, and then video timing is gradually +adjusted if necessary to reach correct synchronization later. +. +.TP +.B \-nojoystick +Turns off joystick support. +. +.TP +.B \-nolirc +Turns off LIRC support. +. +.TP +.B \-nomouseinput +Disable mouse button press/\:release input (mozplayerxp's context menu relies +on this option). +.TP +.B \-noordered\-chapters +Disable support for Matroska ordered chapters. +MPlayer will not load or search for video segments from other files, +and will also ignore any chapter order specified for the main file. +. +.TP +.B \-pts\-association\-mode auto|decode|sort +Select the method used to determine which container packet timestamp +corresponds to a particular output frame from the video decoder. +Normally you shouldn't need to change this option. +.PD 0 +.RSs +.IPs auto +Try to pick a working mode from the ones below automatically (default) +.IPs decoder +Use decoder reordering functionality. +.IPs sort +Maintain a buffer of unused pts values and use the lowest value for the frame. +.RE +.PD 1 +. +.TP +.B \-rtc (RTC only) +Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing +mechanism. +This wakes up the process every 1/1024 seconds to check the current time. +Useless with modern Linux kernels configured for desktop use as they already +wake up the process with similar accuracy when using normal timed sleep. +. +.TP +.B \-playing\-msg <string> +Print out a string before starting playback. +The following expansions are supported: +.RSs +.IPs ${NAME} +Expand to the value of the property NAME. +.IPs ?(NAME:TEXT) +Expand TEXT only if the property NAME is available. +.IPs ?(!NAME:TEXT) +Expand TEXT only if the property NAME is not available. +.RE +. +.TP +.B \-playlist <filename> +Play files according to a playlist file (ASX, Winamp, SMIL, or +one-file-per-line format). +.br +.I WARNING: +The way MPlayer parses and uses playlist files is not safe against +maliciously constructed files. +Such files may trigger harmful actions. +This has been the case for all MPlayer versions, but unfortunately this +fact was not well documented earlier, and some people have even misguidedly +recommended use of -playlist with untrusted sources. +Do NOT use -playlist with random internet sources or files you don't trust! +.br +.I NOTE: +This option is considered an entry so options found after it will apply +only to the elements of this playlist. +.br +FIXME: This needs to be clarified and documented thoroughly. +. +.TP +.B \-rtc\-device <device> +Use the specified device for RTC timing. +. +.TP +.B \-shuffle +Play files in random order. +. +.TP +.B \-slave (also see \-input) +Switches on slave mode, in which MPlayer works as a backend for other programs. +Instead of intercepting keyboard events, MPlayer will read commands separated +by a newline (\\n) from stdin. +.br +.I NOTE: +See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt +for their description. +Also, this is not intended to disable other inputs, e.g.\& via the video window, +use some other method like \-input nodefault\-bindings:conf=/dev/null for that. +. +.TP +.B \-softsleep +Time frames by repeatedly checking the current time instead of asking the +kernel to wake up MPlayer at the correct time. +Useful if your kernel timing is imprecise and you cannot use the RTC either. +Comes at the price of higher CPU consumption. +. +.TP +.B \-sstep <sec> +Skip <sec> seconds after every frame. +The normal framerate of the movie is kept, so playback is accelerated. +Since MPlayer can only seek to the next keyframe this may be inexact. +. +. +. +.SH "DEMUXER/STREAM OPTIONS" +. +.TP +.B \-a52drc <leve |