diff options
Diffstat (limited to 'DOCS/man/en/mplayer.1')
| -rw-r--r-- | DOCS/man/en/mplayer.1 | 4503 |
1 files changed, 4503 insertions, 0 deletions
diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1 new file mode 100644 index 0000000000..52d2fe7d60 --- /dev/null +++ b/DOCS/man/en/mplayer.1 @@ -0,0 +1,4503 @@ +.\" $Revision$ +.\" MPlayer (C) 2000-2003 Arpad Gereoffy +.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann +.\" +.\" Run this to get a HTML version of the man page: +.\" groff -man -Thtml mplayer.1 > manpage.html +.\" Run this to get a text version of the man page: +.\" groff -m man -Tascii mplayer.1 | col -bx > manpage.txt +.\" +. +.\" -------------------------------------------------------------------------- +.\" Macro definitions +.\" -------------------------------------------------------------------------- +. +.\" default indentation is 7, don't change! +.nr IN 7 +.\" 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 \n(IN+3 +.. +.\" 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 "2003-07-05" +. +.SH NAME +mplayer \- Movie Player for Linux +.br +mencoder \- Movie Encoder for Linux + +.\" -------------------------------------------------------------------------- +.\" Synopsis +.\" -------------------------------------------------------------------------- +. +.SH SYNOPSIS +.na +.nh +.B mplayer +.RI [options]\ [ \ file\ | \ URL\ | \ playlist\ | \ \-\ ] +.br +.B mplayer +'in +\n[.k]u +[global options] +.I file1 +[specific options] [file2] [specific options] +.br +.in +.B mplayer +'in +\n[.k]u +[global options] +.RI { "group of files and options" } +[group specific options] +.br +.in +.B mplayer +'in +\n[.k]u +.RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] :// +[user:passwd@]\fIURL\fP[:port] [options] +.br +.in +.B mplayer +'in +\n[.k]u +.I dvd://title +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I vcd://track[/device] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I tv://[channel] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I mf://filemask +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I [cdda|cddb]://track[:speed][/device] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I cue://file[:track] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I sdp://file +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I mpst://host[:port]/URL +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I dvb://channel +[options] +.br +.in +.B mencoder +[options] +.RI [ \ file\ | \ URL\ | \ \-\ ] +[\-o\ file] +.br +.B gmplayer +[options] +[\-skin\ skin] +.ad +.hy + +.\" -------------------------------------------------------------------------- +.\" Description +.\" -------------------------------------------------------------------------- +. +.SH DESCRIPTION +.B mplayer +is a movie player for LINUX (runs on many other Unices and non\-x86 CPUs, see +the documentation). +It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM, +VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many +native, XAnim, and Win32 DLL codecs. +You can watch VideoCD, SVCD, DVD, 3ivx, DivX\ 3/\:4/\:5 and even WMV movies, +too (without using the avifile library). +.PP +Another great feature of MPlayer is the wide range of supported output +drivers. +It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you +can also use GGI, SDL (and this way 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, DXR2 and DXR3/\:Hollywood+. +Most of them support software or hardware scaling, so you can enjoy movies in +fullscreen. +.PP +MPlayer has an onscreen display (OSD) for status information, nice big +antialiased shaded subtitles and visual feedback for keyboard controls. +European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean +fonts are supported along with 10 subtitle formats (MicroDVD, SubRip, +SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub and our own: MPsub) and +DVD subtitles (SPU streams, VobSub and Closed Captions). +.PP +.B mencoder +(MPlayer's Movie Encoder) is a simple movie encoder, designed to encode +MPlayer-playable movies (see above) to other MPlayer-playable formats (see +below). +It encodes to DivX4, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3 +audio in 1, 2 or 3\ passes. +Furthermore it has stream copying abilities, a powerful plugin system (crop, +expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and +more. +.PP +.B gmplayer +is MPlayer with a graphical user interface. +It has the same options as MPlayer. + + +.\" -------------------------------------------------------------------------- +.\" Options +.\" -------------------------------------------------------------------------- +. +.SH "GENERAL NOTES" +.B Also see the HTML documentation! +.PP +Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the +\-fs option is \-nofs. +.PP +You can put all of the options in a configuration file 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' and disabled by setting them to 'no' or '0'. +Even suboptions can be specified in this way. + +.I EXAMPLE: +.br +# Use Matrox driver by default. +.br +vo=xmga +.br +# I love practicing handstands while watching videos. +.br +flip=yes +.br +# Decode/\:encode multiple files from png, +.br +# start with mf://filemask +.br +mf=type=png:fps=25 + +You can also write file-specific configuration files. +If you wish to have a config 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 or in the same directory as the file. + + +.\" -------------------------------------------------------------------------- +.\" Keyboard control +.\" -------------------------------------------------------------------------- +. +.SH "KEYBOARD CONTROL" +.I NOTE: +.br +MPlayer has a fully configurable, command driven, control layer +which allow you to control MPlayer using keyboard, mouse, joystick +or remote control (using lirc). +.br +The default configuration file for the input system is +~/.mplayer/\:input.conf but it can be overriden +using the \-input conf option. +.br +These keys may/\:may not work, depending on your video output driver. +.TP +.B general control +.PD 0 +.RSs +.IPs "<\- and \->" +seek backward/\:forward 10 seconds +.IPs "up and down" +seek backward/\:forward 1 minute +.IPs "pgup and pgdown" +seek backward/\:forward 10 minutes +.IPs "< and >" +backward/\:forward in playlist +.IPs "HOME and END" +go to next/\:previous playtree entry in the parent list +.IPs "INS and DEL" +go to next/\:previous alternative source (asx playlist only) +.IPs "p / SPACE" +pause movie (any key unpauses) +.IPs "q / ESC" +stop playing and quit +.IPs "+ and -" +adjust audio delay by +/\:- 0.1 second +.IPs "/ and *" +decrease/\:increase volume +.IPs "9 and 0" +decrease/\:increase volume +.IPs m\ \ \ \ +mute sound +.IPs f\ \ \ \ +toggle fullscreen +.IPs "w and e" +decrease/\:increase panscan range +.IPs o\ \ \ \ +toggle between OSD states: none / seek / seek+timer +.IPs d\ \ \ \ +toggle frame dropping +.IPs v\ \ \ \ +toggle subtitle visibility +.IPs j\ \ \ \ +switch subtitle language +.IP F\ \ \ \ +toggle display of "forced subtitles" +.IPs a\ \ \ \ +toggle subtitle aligment: top/middle/bottom +.IPs "z and x" +adjust subtitle delay by +/\:- 0.1 second +.IPs "r and t" +adjust subtitle position +.IPs i\ \ \ \ +set EDL mark + +.PP +(The following keys are valid only when using a hardware accelerated video +output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter +(\-vf eq or \-vf eq2). + +.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 +. +.TP +.B GUI keyboard control +.PD 0 +.RSs +.IPs ENTER +start playing +.IPs s\ \ \ \ +stop playing +.IPs l\ \ \ \ +load file +.IPs c\ \ \ \ +skin browser +.IPs p\ \ \ \ +toggle playlist +.RE +.PD 1 +. +.TP +.B TV input control +.PD 0 +.RSs +.IPs "h and k" +select previous/\:next channel +.IPs n\ \ \ \ +change norm +.IPs u\ \ \ \ +change channel list +.RE +.PD 1 + + +.SH "PLAYER OPTIONS (MPLAYER ONLY)" +.TP +.B \-autoq <quality> (use with \-vf pp) +Dynamically changes the level of postprocessing depending on 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 pp without parameters in order to use this. +.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 used. +An uneven video frame rate 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. +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 \-colorkey <number> +Changes the colorkey to an RGB value of your choice. +0x000000 is black and 0xffffff is white. +Only supported by the xmga, xvidix and xover video out drivers. +.TP +.B \-edl <filename> +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 DOCS/documentation.html#edl for details on how to use this. +.TP +.B \-edlout <filename> +Creates a new file and writes edit decision list (EDL) records to that file. +During playback, when the user hits 'i', an entry to skip over the last two +seconds of playback will be written to the file. +This provides a starting point from which the user can fine-tune EDL entries +later. +See DOCS/documentation.html#edl for details. +.TP +.B \-enqueue (GUI only) +Enqueue files given on the command line in the playlist instead of playing them +immediately. +.TP +.B \-fixed-vo (BETA CODE!) +Enforces a fixed video system for multiple files (one (un)initialisation for +all files). +Therefore only one window will be opened for all files. +Currently the following drivers are fixed-vo compliant: gl2, mga, svga, x11, +xmga, xv and xvidix. +.TP +.B \-framedrop (also see \-hardframedrop) +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 +More intense frame dropping (breaks decoding). +Leads to image distortion! +.TP +.B \-identify +Show file parameters in easy parsable format. +The wrapper script TOOLS/midentify suppresses the other MPlayer output and +(hopefully) shellescapes the filenames. +.TP +.B \-input <commands> +This option can be used to configure certain parts of the input system. +Paths are relative to ~/\:.mplayer/. + +.I NOTE: +.br +Autorepeat is currently only supported by joysticks. +.br +Available commands are: + +.PD 0 +.RSs +.IPs conf=<file> +Read alternative input.conf. +If given without pathname, ~/\:.mplayer is assumed. +.IPs ar-delay +Delay in msec before we start to autorepeat a key (0 to disable). +.IPs ar-rate +How many key presses per second when we autorepeat. +.IPs keylist +Prints all keys that can be bound. +.IPs cmdlist +Prints all commands that can be bound. +.IPs js-dev +Specifies the joystick device to use (default is /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 \-lircconf <file> +Specifies a configuration file for LIRC (Linux Infrared Remote Control, see +http://www.lirc.org) if you don't like the default ~/\:.lircrc. +.TP +.B \-list-options +Prints out all the available options. +.TP +.B \-loop <number> +Loops movie playback <number> times. +0 means forever. +.TP +.B \-menu (BETA CODE) +Turn on OSD menu support. +.TP +.B \-menu-cfg <file> (BETA CODE) +Use an alternative menu.conf. +.TP +.B \-menu-root <value> (BETA CODE) +Specify the main menu. +.TP +.B \-nojoystick +Turns off joystick support. +Default is on, if compiled in. +.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 \-nortc \ \ +Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing +mechanism. +.TP +.B \-playlist <file> +Play files according to a playlist (1 file per row or Winamp or ASX format). +.br +.I NOTE: +This option is considered an entry so options found after it will apply +only to the elements of this playlist. +.TP +.B \-quiet \ \ +Don't display the status messages. With this option the status line +(i.e. A: 0.7 V: 0.6 A-V: 0.068 ...) will not be displayed. It's +particulary useful when your terminal does not understand carriage +return (i.e. \\r) like the XEmacs one. +.TP +.B \-really-quiet \ \ +Display even less output and status messages. +.TP +.B \-shuffle \ \ +Play files in random order. +.TP +.B \-skin <skin\ directory> (GUI only) (BETA CODE) +Load skin from the given directory (WITHOUT path name). + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-skin fittyfene" +tries Skin/fittyfene. +It first checks +/usr/local/share/mplayer/ +and afterwards ~/.mplayer/. +.RE +.PD 1 +. +.TP +.B \-slave \ \ +This option switches on slave mode. +This is intended for use of MPlayer as a backend to other programs. +Instead of intercepting keyboard events, MPlayer will read simplistic command +lines from its stdin. +.TP +.B \-softsleep +Uses high quality software timers. +As precise as the RTC without requiring special privileges. +Comes at the price of higher CPU consumption. +.TP +.B \-speed <0.01\-100> +Set playback speed rate. +.TP +.B \-sstep <sec> +Specifies seconds between displayed frames. +Useful for slideshows. +.TP +.B \-use-stdin +The standard input (aka. stdin) will be used to read data instead of key +events. 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 openfile or +openlist commands you +.B need +this option. + + +.SH "DEMUXER/STREAM OPTIONS" +.TP +.B \-aid <id> (also see \-alang option) +Select audio channel [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127 +VOB(AC3): 128\-159 VOB(LPCM): 160\-191 MPEG-TS 17\-8190]. +MPlayer prints the available IDs when running in verbose (\-v) mode. +When playing an MPEG-TS stream, MPlayer/Mencoder will use the first program +(if present) with the chosen audio stream. +.TP +.B \-alang <two letter\ country\ code> (also see \-aid option) +Works only for DVD playback. +It selects the DVD audio language and always tries to play audio streams whose +language matches the given code. +For the list of available languages, use with the \-v option and look at the +output. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-alang hu,en" +Plays Hungarian and falls back to English if Hungarian is not available. +.RE +.PD 1 +. +.TP +.B \-audio-demuxer <number> (\-audiofile only) +Force audio demuxer type for \-audiofile. +Give the demuxer ID as defined in demuxers.h. +Use \-audio-demuxer 17 to force .mp3 detection. +.TP +.B \-audiofile <filename> +Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a +movie. +.TP +.B \-audiofile-cache <kBytes> +Enables caching for the stream used by \-audiofile, using the specified +amount of memory. +.TP +.B \-bandwidth <value> +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. +.TP +.B \-cdrom-device <path\ to\ device> +Override default CDROM drive name /dev/\:cdrom. +.TP +.B \-cache <kBytes> +This option specifies how much memory (in kBytes) to use when precaching a +file/\:URL. +Especially useful on slow media (default is \-nocache). +.TP +.B \-cdda <option1:option2> +This option can be used to tune the CD Audio reading feature of MPlayer. +.br +Available options are: +. +.RSs +.IPs speed=<value> +set CD spin speed +.IPs paranoia=<0\-2> +set paranoia level +.RSss +0: disable checking +.br +1: overlap checking only (default) +.br +2: full data correction and verification +.REss +.IPs generic-dev=<value> +use specified generic SCSI device +.IPs sector-size=<value> +atomic read size +.IPs overlap=<value> +force minimum overlap search during verification to <value> 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=<value> +Add <value> sectors to the values reported when addressing tracks. +May be negative. +.IPs (no)skip +(never) accept imperfect data reconstruction. +.RE +. +.TP +.B \-channels <number> +Change the number of playback channels, defaults to '2' if not specified. +If the number of output channels is bigger than the number of input channels +empty channels are inserted (unless mixing from mono to stereo, then the mono +channel is repeated in both output channels). +If the number of output channels is smaller than the number of input channels, +results depend on the audio decoder (\-afm). +MPlayer asks the decoder to decode the audio into as many channels as +specified. +Now it's up to the decoder to fulfill the requirement. +If the decoder outputs more channels than requested, the exceeding channels +are truncated. +This is usually only important when playing videos with AC3 audio (like DVDs). +In that case liba52 does the decoding by default and correctly downmixes the +audio into the requested number of channels. + +.I NOTE: +.br +This option is honored by codecs (AC3 only) filters (surround) and ao drivers +(OSS at least). +.br +Available options are: + +.PD 0 +.RSs +.IPs 2 +Stereo +.IPs 4 +Surround +.IPs 6 +Full 5.1 +.RE +.PD 1 +. +.TP +.B \-chapter <chapter\ id>[\-<end\ chapter\ id>] +Specify which chapter to start playing at. +Optionally specify which chapter to end playing at (default: 1). +Examples can be found below. +.TP +.B \-csslib <filename> +(old-style DVD option) This option is used to override the default location of +libcss.so. +.TP +.B \-demuxer <number> +Force demuxer type. +Give the demuxer ID as defined in demuxers.h. +Use \-demuxer 17 to force .mp3 detection. +.TP +.B \-dumpaudio (MPLAYER only) +Dumps raw compressed audio stream to ./\:stream.dump (useful with mpeg/\:ac3). +.TP +.B \-dumpfile <filename> (MPLAYER only) +Specify which file MPlayer should dump to. +Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream. +.TP +.B \-dumpstream (MPLAYER only) +Dumps the raw stream to ./\:stream.dump. +Useful when ripping from DVD or network. +.TP +.B \-dumpvideo (MPLAYER only) +Dump raw compressed video stream to ./\:stream.dump (not very usable). +.TP +.B \-dvbin <options> +Pass the following parameters to the DVB input module, in order to override +the default ones: + +.PD 0 +.RSs +.IPs card=<1\-4> +Specifies using card number 1\-4 (default: 1). +.IPs file=<file> +Instructs MPlayer to read the channels list from <file>. +.IPs type=<SAT|TER|CBL> +Specifies that the card type is SATellite, TERrestrial or CaBLe. If not specified +the type will be autodetected. +.RE +.PD 1 +. +.TP +.B \-dvd-device <path\ to\ device> +Override default DVD device name /dev/\:dvd. +.TP +.B \-dvdangle <angle\ id> +Some DVD discs contain scenes that can be viewed from multiple angles. +Here you can tell MPlayer which angles to use (default: 1). +Examples can be found below. +.TP +.B \-dvdauth <DVD\ device> +(old-style DVD option) Turns on DVD authentication using the given device. +.TP +.B \-dvdkey <CSS\ key> +(old-style DVD option) When decoding a VOB file copied undecrypted from DVD, +this option gives the CSS key needed to decrypt the VOB (the key is printed +when authenticating with the DVD drive using \-dvdauth). +.TP +.B \-forceidx +Force rebuilding of INDEX. +Useful for files with broken index (desyncs, etc). +Seeking will be possible. +You can fix the index permanently with MEncoder (see the documentation). +.br +.I NOTES: +You can only use this option if the underlying media supports seeking +(i.e. not with stdin, pipe, etc). +.TP +.B \-fps <value> +Override video framerate (if value is wrong/\:missing in the header) (float +number). +.TP +.B \-frames <number> +Play/\:convert only first <number> frames, then quit. +.TP +.B \-hr-mp3-seek (MP3 only) +Hi-res mp3 seeking. +Default is: enabled when playing from external MP3 file, as we need to seek +to the very exact position to keep A/\:V sync. +It can be slow especially when seeking backwards \- it has to rewind to the +beginning to find the exact frame. +.TP +.B \-idx (also see \-forceidx) +Rebuilds INDEX of the AVI if no INDEX was found, +thus allowing seeking. +Useful with broken/\:incomplete downloads, or badly created AVIs. +.br +.I NOTES: +You can only use this option if the underlying media supports seeking +(i.e. not with stdin, pipe, etc). +.TP +.B \-ipv4-only-proxy +Skip the proxy for IPv6 addresses. +It will still be used for IPv4 connections. +.TP +.B \-mc <seconds/frame> +Maximum A-V sync correction per frame (in seconds). +.TP +.B \-mf <option1:option2:...> +Used when decoding from multiple PNG or JPEG files. +.br +Available options are: + +.PD 0 +.RSs +.IPs w=<value> +width of the output (autodetect) +.IPs h=<value> +height of the output (autodetect) +.IPs fps=<value> +fps of the output (default: 25) +.IPs type=<value> +type of input files (available types: jpeg, png, tga, sgi) +.RE +.PD 1 +. +.TP +.B \-ni (AVI only) +Force usage of non-interleaved AVI parser (fixes playing +of some bad AVI files). +.TP +.B \-nobps (AVI only) +Do not use average byte/\:sec value for A-V sync (AVI). +Helps with some AVI files with broken header. +.TP +.B \-noextbased +Disables filename-extension based demuxer selection. +By default, when 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 demuxer. It always falls back to content-based +demuxer selection. +.TP +.B \-passwd <password> (see \-user option too) +Specify password for http authentication. +.TP +.B \-prefer-ipv4 +Use IPv4 on network connections. +Falls back to IPv6 automatically. +.TP +.B \-prefer-ipv6 +Use IPv6 on network connections. +Falls back to IPv4 automatically. +.TP +.B \-rawaudio <option1:option2:...> +This option lets you play raw audio files. +It may also be used to play audio CDs which are not 44KHz 16Bit stereo. +.br +Available options are: + +.PD 0 +.RSs +.IPs on\ \ \ +use raw audio demuxer +.IPs channels=<value> +number of channels +.IPs rate=<value> +rate in samples per second +.IPs samplesize=<value> +sample size in byte +.IPs format=<value> +fourcc in hex +.RE +.PD 1 +. +.TP +.B \-rawvideo <option1:option2:...> +This option lets you play raw video files. +.br +Available options are: + +.PD 0 +.RSs +.IPs on\ \ \ +use raw video demuxer +.IPs fps=<value> +rate in frames per second, default 25.0 +.IPs sqcif|qcif|cif|4cif|pal|ntsc +set standard image size +.IPs w=<value> +image width in pixels +.IPs h=<value> +image height in pixels +.IPs y420|yv12|yuy2|y8 +set colorspace +.IPs format=<value> +colorspace (fourcc) in hex +.IPs size=<value> +frame size in Bytes +.RE +.PD 1 +. +.TP +.B \-rtsp-stream-over-tcp +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.live.com/mplayer/). +.TP +.B \-sb <byte\ position> (see \-ss option too) +Seek to byte position. +Useful for playback from CDROM images / .VOB files with junk at the beginning. +.TP +.B \-srate <Hz> +Forces the given audio playback rate, changing video speed to keep A-V sync. +MEncoder passes this value to lame for resampling. +.TP +.B \-ss <time> (see \-sb option too) +Seek to given time position. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-ss 56" +seeks to 56 seconds +.IPs "\-ss 01:10:00" +seeks to 1\ hour 10\ min +.RE +.PD 1 +. +.TP +.B \-tsprog <1\-65534> +When playing an MPEG-TS stream, you can specify with this option which +program (if present) you want to play. Can be used with \-vid and \-aid. +. +.TP +.B \-tv <option1:option2:...> +This option tunes various properties of the TV capture module. +For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>' +or even 'tv://<channel_name> (see option channels for channel_name below) +as a movie URL. + +.I NOTE: +.br +MPlayer doesn't accept colons so type dots instead in the device ID +(e.g.\& hw.0,0 instead of hw:0,0). +.br +Be advised that although you can select any samplerate when using ALSA, +the LAME audio codec is able to encode only the 'standard' samplerates. +You'll get an .avi file with no sound when you choose an odd +samplerate and use this codec. +.br +Available options are: +. +.RSs +.IPs noaudio +no sound +.IPs driver=<value> +available: dummy, v4l, v4l2, bsdbt848 +.IPs device=<value> +Specify other device than the default /dev/\:video0. +.IPs input=<value> +Specify other input than the default 0 (Television) (see output for a list) +.IPs freq=<value> +Specify the frequency to set the tuner to (e.g.\& 511.250). +Not compatible with channels parameter. +.IPs outfmt=<value> +output format of the tuner (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, +i420) +.IPs width=<value> +width of the output window +.IPs height=<value> +height of the output window +.IPs fps=<value> +framerate at which to capture video (frames per second) +.IPs buffersize=<value> +maximum size of the capture buffer in megabytes (default: dynamical) +.IPs norm=<value> +available: PAL, SECAM, NTSC. For v4l2 use the normid option below. +.IPs normid=<value> +v4l2 only. See MPlayer output for a list of available TV norms. +.IPs channel=<value> +Set tuner to <value> channel. +.IPs chanlist=<value> +available: europe-east, europe-west, us-bcast, us-cable, etc +.IPs channels=<channel>\-<name>,<channel>\-<name>,... +Set names for channels. +Use _ for spaces in names (or play with quoting ;-). +The channel names will then be written using OSD, and the commands tv_step_channel, +tv_set_channel and tv_last_channel will then be usable using a remote (see lirc). +Not compatible with frequency parameter. +Warning: The channel number will then be the position in the 'channels' list, +beginning with 1. +Example: use tv://1, tv://2, tv://TV1, tv_set_channel 1, tv_set_channel 2, tv_set_channel TV1, etc. +.IPs [brightness|contrast|hue|saturation]=<-100\-100> +set the color equalizer on the video card. +.IPs audiorate=<value> +set audio capture bitrate +.IPs forceaudio +capture audio even if there are no audio sources reported by v4l +.IPs alsa\ +capture from ALSA +.IPs amode=<0\-3> +choose an audio mode: +.RSss +0: mono +.br +1: stereo +.br +2: language 1 +.br +3: language 2 +.REss +.IPs forcechan=<1\-2> +By default, the count of recorded audio channels is determined automatically +by querying the audio mode from the tv card. +This option allows to force stereo/\:mono recording regardless of the amode +option and the values returned by v4l. +This can be used for troubleshooting when the tv card is unable to report the +current audio mode. +.IPs adevice=<value> +set an audio device +.RSss +/dev/\:...\& for OSS +.br +hardware ID for ALSA +.REss +.IPs audioid=<value> +choose an audio output of the capture card, if it has more of them +.IPs [volume|bass|treble|balance]=<0\-65535> +.IPs [volume|bass|treble|balance]=<0\-100> +These options set parameters of the mixer on the video capture card. +They will have no effect, if your card doesn't have one. +For v4l1, 0-65535 is a valid range. +For v4l2, the valid range is 0 to 100, and 50 maps to the default value of the +control, as reported by the driver. +.IPs immediatemode=<bool> +A value of 0 means capture and buffer audio and video together +(default for MEncoder). +A value of 1 (default for MPlayer) means to do video capture only and let the +audio go through a loopback cable from the TV card to the soundcard. +.IPs mjpeg +Use hardware mjpeg compression (if the card supports it). +When using this option, you do not need to specify the width and height +of the output window, because MPlayer will determine it automatically +from the decimation value (see below). +.IPs decimation=<1,2,4> +choose the size of the picture that will be compressed by hardware +mjpeg compression: +.RSss +1: full size + 704x576 PAL + 704x480 NTSC +.br +2: medium size + 352x288 PAL + 352x240 NTSC +.br +4: small size + 176x144 PAL + 176x120 NTSC +.REss +.IPs quality=<0\-100> +choose the quality of the jpeg compression +.br +(quality < 60 recommended for full size) +.RE +. +.TP +.B \-user <user name> (see \-passwd option too) +Specify user name for http authentication. +.TP +.B \-vid <id> +Select video channel [MPG: 0\-15 ASF: 0\-255 MPEG-TS: 17\-8190]. +When playing an MPEG-TS stream, MPlayer/Mencoder will use the first program +(if present) with the chosen video stream. +.TP +.B \-vivo <sub-options> (DEBUG CODE) +Force audio parameters for the .vivo demuxer (for debugging purposes). + + +.SH "OSD/SUB OPTIONS" +.I NOTE: +.br +See \-vf expand too. +.TP +.B \-dumpjacosub (MPLAYER only) +Convert the given subtitle (specified with the \-sub option) to the time-based +JACOsub subtitle format. +Creates a dumpsub.js file in the current directory. +.TP +.B \-dumpmicrodvdsub (MPLAYER only) +Convert the given subtitle (specified with the \-sub option) to the +MicroDVD subtitle format. +Creates a dumpsub.sub file in the current directory. +.TP +.B \-dumpmpsub (MPLAYER only) +Convert the given subtitle (specified with the \-sub option) to MPlayer's +subtitle format, MPsub. +Creates a dump.mpsub file in the current directory. +.TP +.B \-dumpsami (MPLAYER only) +Convert the given subtitle (specified with the \-sub option) to the time-based +SAMI subtitle format. +Creates a dumpsub.smi file in the current directory. +.TP +.B \-dumpsrtsub (MPLAYER only) +Convert the given subtitle (specified with the \-sub option) to the time-based +SubViewer (SRT) subtitle format. +Creates a dumpsub.srt file in the current directory. +.TP +.B \-dumpsub (MPLAYER only) (BETA CODE) +Dumps the subtitle substream from VOB streams. +See \-dump*sub and \-vobsubout* options too. +.TP +.B \-ffactor <number> +Resample alphamap of the font. +Can be: + +.PD 0 +.RSs +.IPs 0 +plain white fonts +.IPs 0.75 +very narrow black outline (default) +.IPs 1 +narrow black outline +.IPs 10 +bold black outline +.RE +.PD 1 +. +.TP +.B \-flip_hebrew +Turns on flipping subtitles using FriBiDi. +.TP +.B \-font <path\ to\ font.desc\ file> +Search for the OSD/\:SUB fonts in an alternative directory (default for normal +fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts: +~/.mplayer/\:subfont.ttf). + +.I NOTE: +.br +With FreeType, this option determines path to the t |