diff options
author | wm4 <wm4@nowhere> | 2012-10-11 02:04:01 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2012-10-12 10:14:23 +0200 |
commit | 3d712eb56da9b9dccdef28fa1a3694c4d8fccd65 (patch) | |
tree | 31aeb9354081386566820c2261c1c5e513613abd | |
parent | 4401862751370a5422de0b465b457d81cdf2dfbb (diff) | |
download | mpv-3d712eb56da9b9dccdef28fa1a3694c4d8fccd65.tar.bz2 mpv-3d712eb56da9b9dccdef28fa1a3694c4d8fccd65.tar.xz |
manpage: remove old manpage
-rw-r--r-- | DOCS/man/en/mplayer-old.1 | 8099 |
1 files changed, 0 insertions, 8099 deletions
diff --git a/DOCS/man/en/mplayer-old.1 b/DOCS/man/en/mplayer-old.1 deleted file mode 100644 index 92592c7f27..0000000000 --- a/DOCS/man/en/mplayer-old.1 +++ /dev/null @@ -1,8099 +0,0 @@ -.\" $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 |