From 3d712eb56da9b9dccdef28fa1a3694c4d8fccd65 Mon Sep 17 00:00:00 2001 From: wm4 Date: Thu, 11 Oct 2012 02:04:01 +0200 Subject: manpage: remove old manpage --- DOCS/man/en/mplayer-old.1 | 8099 --------------------------------------------- 1 file changed, 8099 deletions(-) delete mode 100644 DOCS/man/en/mplayer-old.1 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=', 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 -Specify a directory for binary codecs. -. -.TP -.B \-codecs\-file (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 -Specify configuration file to be parsed after the default ones. -. -.TP -.B \-list\-options -Prints all available options. -. -.TP -.B \-msgcharset -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 :=:...> -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 -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 (Windows and OS/2 only) -Set process priority for MPlayer according to the predefined -priorities available under Windows and OS/2. -Possible values of : -.RSs -idle|belownormal|normal|abovenormal|high|realtime -.RE -.sp 1 -.RS -.I WARNING: -Using realtime priority can cause system lockup. -.RE -. -.TP -.B \-profile -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 -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 (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 -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 -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 -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 -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 -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= -Specify input configuration file other than the default -~/\:.mplayer/\:input.conf. -~/\:.mplayer/\: is assumed if no full path is given. -.IPs ar-dev= -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= -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 (LIRC only) -Specifies a configuration file for LIRC (default: ~/.lircrc). -. -.TP -.B \-list\-properties -Print a list of the available properties. -. -.TP -.B \-loop -Loops movie playback times. -0 means forever. -. -.TP -.B \-menu (OSD menu only) -Turn on OSD menu support. -. -.TP -.B \-menu\-cfg (OSD menu only) -Use an alternative menu.conf. -. -.TP -.B \-menu\-chroot (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 (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 -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 -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 -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 -Skip 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 -Select the Dynamic Range Compression level for AC-3 audio streams. - is a float value ranging from 0 to 1, where 0 means no compression -and 1 (which is the default) means full compression (make loud passages more -silent and vice versa). -Values up to 2 are also accepted, but are purely experimental. -This option only shows an effect if the AC-3 stream contains the required range -compression information. -. -.TP -.B \-aid (also see \-alang) -Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127, -VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190). -MPlayer prints the available audio IDs when run in verbose (\-v) mode. -When playing an MPEG-TS stream, MPlayer will use the first program (if present) -with the chosen audio stream. -. -.TP -.B \-ausid (also see \-alang) -Select audio substream channel. -Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled -by the native demuxer (not by libavformat). -The format type may not be correctly identified because of how this information -(or lack thereof) is embedded in the stream, but it will demux correctly the -audio streams when multiple substreams are present. -MPlayer prints the available substream IDs when run with \-identify. -. -.TP -.B \-alang (also see \-aid) -Specify a priority list of audio languages to use. -Different container formats employ different language codes. -DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT -use ISO 639-2 three letter language codes while OGM uses a free-form identifier. -MPlayer prints the available languages when run in verbose (\-v) mode. -.sp 1 -.I EXAMPLE: -.PD 0 -.RSs -.IPs "mplayer dvd://1 \-alang hu,en" -Chooses the Hungarian language track on a DVD and falls back on English if -Hungarian is not available. -.IPs "mplayer \-alang jpn example.mkv" -Plays a Matroska file in Japanese. -.RE -.PD 1 -. -.TP -.B \-audio\-demuxer <[+]name> (\-audiofile only) -Force audio demuxer type for \-audiofile. -Use a '+' before the name to force it, this will skip some checks! -Give the demuxer name as printed by \-audio\-demuxer help. -\-audio\-demuxer audio forces MP3. -. -.TP -.B \-audiofile -Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a -movie. -. -.TP -.B \-audiofile\-cache -Enables caching for the stream used by \-audiofile, using the specified -amount of memory. -. -.TP -.B \-reuse\-socket (udp:// only) -Allows a socket to be reused by other processes as soon as it is closed. -. -.TP -.B \-bandwidth (network only) -Specify the maximum bandwidth for network streaming (for servers that are -able to send content in different bitrates). -Useful if you want to watch live streamed media behind a slow connection. -With Real RTSP streaming, it is also used to set the maximum delivery -bandwidth allowing faster cache filling and stream dumping. -. -.TP -.B \-bluray\-angle (Blu\-ray only) -Some Blu\-ray discs contain scenes that can be viewed from multiple angles. -Here you can tell MPlayer which angles to use (default: 1). -. -.TP -.B \-bluray\-chapter (Blu\-ray only) -Tells MPlayer which Blu\-ray chapter to start the current title from (default: 1). -. -.TP -.B \-bluray\-device (Blu\-ray only) -Specify the Blu\-ray disc location. Must be a directory with Blu\-ray structure. -. -.TP -.B \-cache -This option specifies how much memory (in kBytes) to use when precaching a -file or URL. -Especially useful on slow media. -. -.TP -.B \-nocache -Turns off caching. -. -.TP -.B \-cache\-min -Playback will start when the cache has been filled up to -of the total. -. -.TP -.B \-cache\-seek\-min -If a seek is to be made to a position within of the cache size -from the current position, MPlayer will wait for the cache to be filled to -this position rather than performing a stream seek (default: 50). -. -.TP -.B \-capture -Allows capturing the primary stream (not additional audio tracks or other -kind of streams) into the file specified by \-dumpfile or \"stream.dump\" -by default. -If this option is given, capturing can be started and stopped by pressing -the key bound to this function (see section INTERACTIVE CONTROL). -Same as for \-dumpstream, this will likely not produce usable results for -anything else than MPEG streams. -Note that, due to cache latencies, captured data may begin and end -somewhat delayed compared to what you see displayed. -. -.TP -.B \-cdda (CDDA only) -This option can be used to tune the CD Audio reading feature of MPlayer. -.sp 1 -Available options are: -.RSs -.IPs speed= -Set CD spin speed. -.IPs paranoia=<0\-2> -Set paranoia level. -Values other than 0 seem to break playback of anything but the first track. -.RSss -0: disable checking (default) -.br -1: overlap checking only -.br -2: full data correction and verification -.REss -.IPs generic-dev= -Use specified generic SCSI device. -.IPs sector-size= -Set atomic read size. -.IPs overlap= -Force minimum overlap search during verification to sectors. -.IPs toc-bias -Assume that the beginning offset of track 1 as reported in the TOC will be -addressed as LBA 0. -Some Toshiba drives need this for getting track boundaries correct. -.IPs toc-offset= -Add sectors to the values reported when addressing tracks. -May be negative. -.IPs (no)skip -(Never) accept imperfect data reconstruction. -.RE -. -.TP -.B \-cdrom\-device -Specify the CD-ROM device (default: /dev/\:cdrom). -. -.TP -.B \-channels (also see \-af channels) -Request the number of playback channels (default: 2). -MPlayer asks the decoder to decode the audio into as many channels as -specified. -Then it is up to the decoder to fulfill the requirement. -This is usually only important when playing videos with AC-3 audio (like DVDs). -In that case liba52 does the decoding by default and correctly downmixes the -audio into the requested number of channels. -To directly control the number of output channels independently of how many -channels are decoded, use the channels filter. -.br -.I NOTE: -This option is honored by codecs (AC-3 only), filters (surround) and audio -output drivers (OSS at least). -.sp 1 -Available options are: -.sp 1 -.PD 0 -.RSs -.IPs 2 -stereo -.IPs 4 -surround -.IPs 6 -full 5.1 -.IPs 8 -full 7.1 -.RE -.PD 1 -. -.TP -.B \-chapter [\-] (dvd:// and dvdnav:// only) -Specify which chapter to start playing at. -Optionally specify which chapter to end playing at (default: 1). -. -.TP -.B \-edition (Matroska only) -Specify the edition (set of chapters) to use, where 0 is the first. If set to --1 (the default), MPlayer will choose the first edition declared as a default, -or if there is no default, the first edition defined. -. -.TP -.B \-cookies (network only) -Send cookies when making HTTP requests. -. -.TP -.B \-cookies\-file (network only) -Read HTTP cookies from (default: ~/.mozilla/ and ~/.netscape/) -and skip reading from default locations. -The file is assumed to be in Netscape format. -. -.TP -.B \-delay -audio delay in seconds (positive or negative float value) -.br -Negative values delay the audio, and positive values delay the video. -. -.TP -.B \-ignore\-start -Ignore the specified starting time for streams in AVI files. -This nullifies stream delays. -. -.TP -.B \-demuxer <[+]name> -Force demuxer type. -Use a '+' before the name to force it, this will skip some checks! -Give the demuxer name as printed by \-demuxer help. -. -.TP -.B \-dumpaudio -Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3, -in most other cases the resulting file will not be playable). -If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream -on the command line only the last one will work. -. -.TP -.B \-dumpfile -Specify which file MPlayer should dump to. -Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream / -\-capture. -. -.TP -.B \-dumpstream -Dumps the raw stream to ./stream.dump. -Useful when ripping from DVD or network. -If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream -on the command line only the last one will work. -. -.TP -.B \-dumpvideo -Dump raw compressed video stream to ./stream.dump (not very usable). -If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream -on the command line only the last one will work. -. -.TP -.B \-dvbin (DVB only) -Pass the following parameters to the DVB input module, in order to override -the default ones: -.sp 1 -.PD 0 -.RSs -.IPs card=<1\-4> -Specifies using card number 1\-4 (default: 1). -.IPs file= -Instructs MPlayer to read the channels list from . -Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type) -or ~/.mplayer/\:channels.conf as a last resort. -.IPs timeout=<1\-30> -Maximum number of seconds to wait when trying to tune a -frequency before giving up (default: 30). -.RE -.PD 1 -. -.TP -.B \-dvd\-device (DVD only) -Specify the DVD device or .iso filename (default: /dev/\:dvd). -You can also specify a directory that contains files previously copied directly -from a DVD (with e.g.\& vobcopy). -. -.TP -.B \-dvd\-speed (DVD only) -Try to limit DVD speed (default: 0, no change). -DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to -10800KB/s. -Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be -quiet and fast enough. -MPlayer resets the speed to the drive default value on close. -Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects -10800KB/s. -.br -.I NOTE: -You need write access to the DVD device to change the speed. -. -.TP -.B \-dvdangle (DVD only) -Some DVD discs contain scenes that can be viewed from multiple angles. -Here you can tell MPlayer which angles to use (default: 1). -. -.TP -.B \-edl -Enables edit decision list (EDL) actions during playback. -Video will be skipped over and audio will be muted and unmuted according to -the entries in the given file. -See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details -on how to use this. -. -.TP -.B \-endpos <[[hh:]mm:]ss[.ms]> (also see \-ss and \-sb) -Stop at given time. -.br -.I NOTE: -When used in conjunction with \-ss option, \-endpos time will shift forward by -seconds specified with \-ss. -.sp 1 -.I EXAMPLE: -.PD 0 -.RSs -.IPs "\-endpos 56" -Stop at 56 seconds. -.IPs "\-endpos 01:10:00" -Stop at 1 hour 10 minutes. -.IPs "\-ss 10 \-endpos 56" -Stop at 1 minute 6 seconds. -.RE -.PD 1 -. -.TP -.B \-forceidx -Force index rebuilding. -Useful for files with broken index (A/V desync, etc). -This will enable seeking in files where seeking was not possible. -.br -.I NOTE: -This option only works if the underlying media supports seeking -(i.e.\& not with stdin, pipe, etc). -. -.TP -.B \-fps -Override video framerate. -Useful if the original value is wrong or missing. -. -.TP -.B \-frames -Play/\:convert only first frames, then quit. -. -.TP -.B \-hr\-mp3\-seek (MP3 only) -Hi-res MP3 seeking. -Enabled when playing from an external MP3 file, as we need to seek -to the very exact position to keep A/V sync. -Can be slow especially when seeking backwards since it has to rewind -to the beginning to find an exact frame position. -. -.TP -.B \-http-header-fields -Set custom HTTP fields when accessing HTTP stream. -.sp 1 -.I EXAMPLE: -.PD 0 -.RSs -.IPs -mplayer \-http\-header\-fields 'Field1: value1','Field2: value2' http://localhost:1234 -.br -Will generate HTTP request: -.RSss -.br -GET / HTTP/1.0 -.br -Host: localhost:1234 -.br -User-Agent: MPlayer -.br -Icy-MetaData: 1 -.br -Field1: value1 -.br -Field2: value2 -.br -Connection: close -.REss -.RE -. -.TP -.B \-idx (also see \-forceidx) -Rebuilds index of files if no index was found, allowing seeking. -Useful with broken/\:incomplete downloads, or badly created files. -.br -.I NOTE: -This option only works if the underlying media supports seeking -(i.e.\& not with stdin, pipe, etc). -. -.TP -.B \-noidx -Skip rebuilding index file. -. -.TP -.B \-ipv4\-only\-proxy (network only) -Skip the proxy for IPv6 addresses. -It will still be used for IPv4 connections. -. -.TP -.B \-lavfdopts -Specify parameters for libavformat demuxers (\-demuxer lavf). -Separate multiple options with a colon. -.sp -.RS -Available suboptions are: -.RE -.RSs -.IPs analyzeduration= -Maximum length in seconds to analyze the stream properties. -.IPs format= -Force a specific libavformat demuxer. -.IPs o==[,=[,...]] -Pass AVOptions to libavformat demuxer. -Note, a patch to make the o= unneeded and pass all unknown options through -the AVOption system is welcome. -A full list of AVOptions can be found in the FFmpeg manual. -Note that some options may conflict with MPlayer options. -.sp 1 -.RS -.I EXAMPLE: -.RE -.RSs -.PD 0 -.IPs o=fflags=+ignidx -.PD 1 -.RE -.IPs probesize= -Maximum amount of data to probe during the detection phase. -In the case of MPEG-TS this value identifies the maximum number -of TS packets to scan. -.IPs cryptokey= -Encryption key the demuxer should use. -This is the raw binary data of the key converted to a hexadecimal string. -.RE -. -.TP -.B \-loadidx -The file from which to read the video index data saved by \-saveidx. -This index will be used for seeking, overriding any index data -contained in the AVI itself. -MPlayer will not prevent you from loading an index file generated -from a different AVI, but this is sure to cause unfavorable results. -.br -.I NOTE: -This option is obsolete now that MPlayer has OpenDML support. -. -.TP -.B \-mc -maximum A-V sync correction per frame (in seconds) -. -.TP -.B \-mf -Used when decoding from multiple PNG or JPEG files. -.sp 1 -Available options are: -.sp 1 -.PD 0 -.RSs -.IPs w= -input file width (default: autodetect) -.IPs h= -input file height (default: autodetect) -.IPs fps= -output fps (default: 25) -.IPs type= -input file type (available: jpeg, png, tga, sgi) -.RE -.PD 1 -. -.TP -.B \-ni (AVI only) -Force usage of non-interleaved AVI parser (fixes playback -of some bad AVI files). -. -.TP -.B \-nobps (AVI only) -Do not use average byte/\:second value for A-V sync. -Helps with some AVI files with broken header. -. -.TP -.B \-noextbased -Disables extension-based demuxer selection. -By default, when the file type (demuxer) cannot be detected reliably -(the file has no header or it is not reliable enough), the filename -extension is used to select the demuxer. -Always falls back on content-based demuxer selection. -. -.TP -.B \-passwd (also see \-user) (network only) -Specify password for HTTP authentication. -. -.TP -.B \-prefer\-ipv4 (network only) -Use IPv4 on network connections. -Falls back on IPv6 automatically. -. -.TP -.B \-prefer\-ipv6 (IPv6 network only) -Use IPv6 on network connections. -Falls back on IPv4 automatically. -. -.TP -.B \-psprobe -When playing an MPEG-PS or MPEG-PES streams, this option lets you specify -how many bytes in the stream you want MPlayer to scan in order to identify -the video codec used. -This option is needed to play EVO or VDR files containing H.264 streams. -. -.TP -.B \-pvr (PVR only) -This option tunes various encoding properties of the PVR capture module. -It has to be used with any hardware MPEG encoder based card supported by the -V4L2 driver. -The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based -cards are known as PVR capture cards. -Be aware that only Linux 2.6.18 kernel -and above is able to handle MPEG stream through V4L2 layer. -For hardware capture of an MPEG stream and watching it with -MPlayer, use 'pvr://' as a movie URL. -.sp 1 -Available options are: -.RSs -.IPs aspect=<0\-3> -Specify input aspect ratio: -.RSss -0: 1:1 -.br -1: 4:3 (default) -.br -2: 16:9 -.br -3: 2.21:1 -.REss -.IPs arate=<32000\-48000> -Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100 -and 48000 Hz). -.IPs alayer=<1\-3> -Specify MPEG audio layer encoding (default: 2). -.IPs abitrate=<32\-448> -Specify audio encoding bitrate in kbps (default: 384). -.IPs amode= -Specify audio encoding mode. -Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo). -.IPs vbitrate= -Specify average video bitrate encoding in Mbps (default: 6). -.IPs vmode= -Specify video encoding mode: -.RSss -vbr: Variable BitRate (default) -.br -cbr: Constant BitRate -.REss -.IPs vpeak= -Specify peak video bitrate encoding in Mbps -(only useful for VBR encoding, default: 9.6). -.IPs fmt= -Choose an MPEG format for encoding: -.RSss -ps: MPEG-2 Program Stream (default) -.br -ts: MPEG-2 Transport Stream -.br -mpeg1: MPEG-1 System Stream -.br -vcd: Video CD compatible stream -.br -svcd: Super Video CD compatible stream -.br -dvd: DVD compatible stream -.REss -.RE -.PD 1 -. -.TP -.B \-radio (radio only) -These options set various parameters of the radio capture module. -For listening to radio with MPlayer use 'radio://' -(if channels option is not given) or 'radio://' -(if channels option is given) as a movie URL. -You can see allowed frequency range by running MPlayer with '\-v'. -To start the grabbing subsystem, use 'radio:///capture'. -If the capture keyword is not given you can listen to radio -using the line-in cable only. -Using capture to listen is not recommended due to synchronization -problems, which makes this process uncomfortable. -.sp 1 -Available options are: -.RSs -.IPs device= -Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD). -.IPs driver= -Radio driver to use (default: v4l2 if available, otherwise v4l). -Currently, v4l and v4l2 drivers are supported. -.IPs volume=<0..100> -sound volume for radio device (default 100) -.IPs "freq_min= (*BSD BT848 only)" -minimum allowed frequency (default: 87.50) -.IPs "freq_max= (*BSD BT848 only)" -maximum allowed frequency (default: 108.00) -.IPs channels=\-,\-,... -Set channel list. -Use _ for spaces in names (or play with quoting ;-). -The channel names will then be written using OSD and the slave commands -radio_step_channel and radio_set_channel will be usable for -a remote control (see LIRC). -If given, number in movie URL will be treated as channel position in -channel list. -.br -.I EXAMPLE: -radio://1, radio://104.4, radio_set_channel 1 -.IPs "adevice= (radio capture only)" -Name of device to capture sound from. -Without such a name capture will be disabled, -even if the capture keyword appears in the URL. -For ALSA devices use it in the form hw=.. -If the device name contains a '=', the module will use -ALSA to capture, otherwise OSS. -.IPs "arate= (radio capture only)" -Rate in samples per second (default: 44100). -.br -.I NOTE: -When using audio capture set also \-rawaudio rate= option -with the same value as arate. -If you have problems with sound speed (runs too quickly), try to play -with different rate values (e.g.\& 48000,44100,32000,...). -.IPs "achannels= (radio capture only)" -Number of audio channels to capture. -.RE -. -.TP -.B \-rawaudio -This option lets you play raw audio files. -You have to use \-demuxer rawaudio as well. -It may also be used to play audio CDs which are not 44kHz 16-bit stereo. -For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio. -.sp 1 -Available options are: -.sp 1 -.PD 0 -.RSs -.IPs channels= -number of channels -.IPs rate= -rate in samples per second -.IPs samplesize= -sample size in bytes -.IPs bitrate= -bitrate for rawaudio files -.IPs format= -fourcc in hex -.RE -.PD 1 -. -.TP -.B \-rawvideo -This option lets you play raw video files. -You have to use \-demuxer rawvideo as well. -.sp 1 -Available options are: -.sp 1 -.PD 0 -.RSs -.IPs fps= -rate in frames per second (default: 25.0) -.IPs sqcif|qcif|cif|4cif|pal|ntsc -set standard image size -.IPs w= -image width in pixels -.IPs h= -image height in pixels -.IPs i420|yv12|yuy2|y8 -set colorspace -.IPs format= -colorspace (fourcc) in hex or string constant. -Use \-rawvideo format=help for a list of possible strings. -.IPs size= -frame size in Bytes -.REss -.sp 1 -.RS -.I EXAMPLE: -.RE -.PD 0 -.RSs -.IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif" -Play the famous "foreman" sample video. -.IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576" -Play a raw YUV sample. -.RE -.PD 1 -. -.TP -.B \-referrer (network only) -Specify a referrer path or URL for HTTP requests. -. -.TP -.B \-rtsp\-port -Used with 'rtsp://' URLs to force the client's port number. -This option may be useful if you are behind a router and want to forward -the RTSP stream from the server to a specific client. -. -.TP -.B \-rtsp\-destination -Used with 'rtsp://' URLs to force the destination IP address to be bound. -This option may be useful with some RTSP server which do not -send RTP packets to the right interface. -If the connection to the RTSP server fails, use \-v to see -which IP address MPlayer tries to bind to and try to force -it to one assigned to your computer instead. -. -.TP -.B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only) -Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP -packets be streamed over TCP (using the same TCP connection as RTSP). -This option may be useful if you have a broken internet connection that does -not pass incoming UDP packets (see http://www.live555.com/\:mplayer/). -. -.TP -.B \-rtsp\-stream\-over\-http (LIVE555 only) -Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP -packets be streamed over HTTP. -. -.TP -.B \-saveidx -Force index rebuilding and dump the index to . -Currently this only works with AVI files. -.br -.I NOTE: -This option is obsolete now that MPlayer has OpenDML support. -. -.TP -.B \-sb (also see \-ss) -Seek to byte position. -Useful for playback from CD-ROM images or VOB files with junk at the beginning. -. -.TP -.B \-speed <0.01\-100> -Slow down or speed up playback by the factor given as parameter. -. -.TP -.B \-srate -Select the output sample rate to be used -(of course sound cards have limits on this). -If the sample frequency selected is different from that -of the current media, the resample or lavcresample audio filter will be inserted -into the audio filter layer to compensate for the difference. -The type of resampling can be controlled by the \-af\-adv option. -The default is fast resampling that may cause distortion. -. -.TP -.B \-ss