diff options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/encoding.rst | 36 | ||||
-rw-r--r-- | DOCS/man/en/af.rst | 42 | ||||
-rw-r--r-- | DOCS/man/en/ao.rst | 4 | ||||
-rw-r--r-- | DOCS/man/en/changes.rst | 19 | ||||
-rw-r--r-- | DOCS/man/en/encode.rst | 46 | ||||
-rw-r--r-- | DOCS/man/en/mplayer-old.1 | 8099 | ||||
-rw-r--r-- | DOCS/man/en/mpv.rst (renamed from DOCS/man/en/mplayer.rst) | 130 | ||||
-rw-r--r-- | DOCS/man/en/options.rst | 174 | ||||
-rw-r--r-- | DOCS/man/en/vf.rst | 652 | ||||
-rw-r--r-- | DOCS/man/en/vo.rst | 458 | ||||
-rw-r--r-- | DOCS/tech-overview.txt | 10 |
11 files changed, 472 insertions, 9198 deletions
diff --git a/DOCS/encoding.rst b/DOCS/encoding.rst index 67ad19bae6..84b1007afd 100644 --- a/DOCS/encoding.rst +++ b/DOCS/encoding.rst @@ -3,15 +3,15 @@ General usage :: - mplayer infile -o outfile [-of outfileformat] [-ofopts formatoptions] \ + mpv infile -o outfile [-of outfileformat] [-ofopts formatoptions] \ [-ofps outfps | -oautofps] [-oharddup] [-ocopyts | -orawts] [-oneverdrop] \ - [(any other mplayer options)] \ + [(any other mpv options)] \ -ovc outvideocodec [-ovcopts outvideocodecoptions] \ -oac outaudiocodec [-oacopts outaudiocodecoptions] Help for these options is provided if giving help as parameter, as in:: - mplayer -ovc help + mpv -ovc help The suboptions of these generally are identical to ffmpeg's (as option parsing is simply delegated to ffmpeg). The option -ocopyts enables copying timestamps @@ -25,7 +25,7 @@ from the input video. Note that not all codecs and not all formats support VFR encoding, and some which do have bugs when a target bitrate is specified - use -ofps or -oautofps to force CFR encoding in these cases. -Of course, the options can be stored in a profile, like this .mplayer/config +Of course, the options can be stored in a profile, like this .mpv/config section:: [myencprofile] @@ -40,7 +40,7 @@ section:: One can then encode using this profile using the command:: - mplayer infile -o outfile.mp4 -profile myencprofile + mpv infile -o outfile.mp4 -profile myencprofile Some example profiles are provided in a file etc/encoding-example-profiles.conf; as for this, see below. @@ -54,7 +54,7 @@ for. Typical MPEG-4 Part 2 ("ASP", "DivX") encoding, AVI container:: - mplayer infile -o outfile.avi \ + mpv infile -o outfile.avi \ -ofps 25 \ -ovc mpeg4 -ovcopts qscale=4 \ -oac libmp3lame -oacopts ab=128k @@ -65,19 +65,19 @@ for NTSC) Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, Matroska (MKV) container:: - mplayer infile -o outfile.mkv \ + mpv infile -o outfile.mkv \ -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \ -oac vorbis -oacopts qscale=3 Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, MPEG-4 (MP4) container:: - mplayer infile -o outfile.mp4 \ + mpv infile -o outfile.mp4 \ -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \ -oac aac -oacopts ab=128k Typical VP8 encoding, WebM (restricted Matroska) container:: - mplayer infile -o outfile.mkv \ + mpv infile -o outfile.mkv \ -of webm \ -ovc libvpx -ovcopts qmin=6,b=1000000k \ -oac libvorbis -oacopts qscale=3 @@ -90,10 +90,10 @@ As the options for various devices can get complex, profiles can be used. An example profile file for encoding is provided in etc/encoding-example-profiles.conf in the source tree. You can include it into -your configuration by doing, from the mplayer2-build directory:: +your configuration by doing, from the mpv-build directory:: - mkdir -p ~/.mplayer - echo "include = $PWD/mplayer/etc/encoding-example-profiles.conf" >> ~/.mplayer/config + mkdir -p ~/.mpv + echo "include = $PWD/mpv/etc/encoding-example-profiles.conf" >> ~/.mpv/config Refer to the top of that file for more comments - in a nutshell, the following options are added by it:: @@ -108,7 +108,7 @@ options are added by it:: You can encode using these with a command line like:: - mplayer infile -o outfile.mp4 -profile enc-to-bb-9000 + mpv infile -o outfile.mp4 -profile enc-to-bb-9000 Of course, you are free to override options set by these profiles by specifying them after the -profile option. @@ -122,15 +122,15 @@ What works * 2-pass encoding (specify flags=+pass1 in the first pass's -ovcopts, specify flags=+pass2 in the second pass) * Hardcoding subtitles using vobsub, ass or srt subtitle rendering (just - configure mplayer for the subtitles as usual) -* Hardcoding any other mplayer OSD (e.g. time codes, using -osdlevel 3 and -vf + configure mpv for the subtitles as usual) +* Hardcoding any other mpv OSD (e.g. time codes, using -osdlevel 3 and -vf expand=::::1) * Encoding directly from a DVD, network stream, webcam, or any other source - mplayer supports + mpv supports * Using x264 presets/tunings/profiles (by using profile=, tune=, preset= in the -ovcopts) -* Deinterlacing/Inverse Telecine with any of mplayer's filters for that -* Audio file converting: mplayer -o outfile.mp3 infile.flac -novideo -oac +* Deinterlacing/Inverse Telecine with any of mpv's filters for that +* Audio file converting: mpv -o outfile.mp3 infile.flac -novideo -oac libmp3lame -oacopts ab=320k * inverse telecine filters (confirmed working: detc, pullup, filmdint) diff --git a/DOCS/man/en/af.rst b/DOCS/man/en/af.rst index dc0450241f..1fe480dcdc 100644 --- a/DOCS/man/en/af.rst +++ b/DOCS/man/en/af.rst @@ -57,7 +57,7 @@ resample[=srate[:sloppy[:type]]] *EXAMPLE*: - ``mplayer --af=resample=44100:0:0`` + ``mpv --af=resample=44100:0:0`` would set the output frequency of the resample filter to 44100Hz using exact output frequency scaling and linear interpolation. @@ -200,7 +200,7 @@ equalizer=[g1:g2:g3:...:g10] *EXAMPLE*: - ``mplayer --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi`` + ``mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi`` Would amplify the sound in the upper and lower frequency region while canceling it almost completely around 1kHz. @@ -223,13 +223,13 @@ channels=nch[:nr:from1:to1:from2:to2:from3:to3:...] *EXAMPLE*: - ``mplayer --af=channels=4:4:0:1:1:0:2:2:3:3 media.avi`` + ``mpv --af=channels=4:4:0:1:1:0:2:2:3:3 media.avi`` Would change the number of channels to 4 and set up 4 routes that swap channel 0 and channel 1 and leave channel 2 and 3 intact. Observe that if media containing two channels was played back, channels 2 and 3 would contain silence but 0 and 1 would still be swapped. - ``mplayer --af=channels=6:4:0:0:0:1:0:2:0:3 media.avi`` + ``mpv --af=channels=6:4:0:0:0:1:0:2:0:3 media.avi`` Would change the number of channels to 6 and set up 4 routes that copy channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence. @@ -242,7 +242,7 @@ format[=format] the sign (either 's' for signed or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32) and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian and 'ne' the - endianness of the computer MPlayer is running on). Valid values + endianness of the computer mpv is running on). Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'. Exceptions to this rule that are also valid format specifiers: u8, s8, floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm. @@ -260,7 +260,7 @@ volume[=v[:sc]] background is gone. This filter has a second feature: It measures the overall maximum sound - level and prints out that level when MPlayer exits. This feature currently + level and prints out that level when mpv exits. This feature currently only works with floating-point data, use e.g. ``--af-adv=force=5``, or use ``--af=stats``. @@ -281,7 +281,7 @@ volume[=v[:sc]] *EXAMPLE*: - ``mplayer --af=volume=10.1:0 media.avi`` + ``mpv --af=volume=10.1:0 media.avi`` Would amplify the sound by 10.1dB and hard-clip if the sound level is too high. @@ -306,10 +306,10 @@ pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...] *EXAMPLE*: - ``mplayer --af=pan=1:0.5:0.5 media.avi`` + ``mpv --af=pan=1:0.5:0.5 media.avi`` Would down-mix from stereo to mono. - ``mplayer --af=pan=3:1:0:0.5:0:1:0.5 media.avi`` + ``mpv --af=pan=3:1:0:0.5:0:1:0.5 media.avi`` Would give 3 channel output leaving channels 0 and 1 intact, and mix channels 0 and 1 into output channel 2 (which could be sent to a subwoofer for example). @@ -338,7 +338,7 @@ sub[=fc:ch] *EXAMPLE*: - ``mplayer --af=sub=100:4 --channels=5 media.avi`` + ``mpv --af=sub=100:4 --channels=5 media.avi`` Would add a sub-woofer channel with a cutoff frequency of 100Hz to output channel 4. @@ -367,7 +367,7 @@ surround[=delay] *EXAMPLE*: - ``mplayer --af=surround=15 --channels=4 media.avi`` + ``mpv --af=surround=15 --channels=4 media.avi`` Would add surround sound decoding with 15ms delay for the sound to the rear speakers. @@ -395,7 +395,7 @@ delay[=ch1:ch2:...] *EXAMPLE*: - ``mplayer --af=delay=10.5:10.5:0:0:7:0 media.avi`` + ``mpv --af=delay=10.5:10.5:0:0:7:0 media.avi`` Would delay front left and right by 10.5ms, the two rear channels and the sub by 0ms and the center channel by 7ms. @@ -410,14 +410,14 @@ export[=mmapped_file[:nsamples]] The rest is payload (non-interleaved) 16 bit data. <mmapped_file> - file to map data to (default: ``~/.mplayer/mplayer-af_export``) + file to map data to (default: ``~/.mpv/mpv-af_export``) <nsamples> number of samples per channel (default: 512) *EXAMPLE*: - ``mplayer --af=export=/tmp/mplayer-af_export:1024 media.avi`` - Would export 1024 samples per channel to ``/tmp/mplayer-af_export``. + ``mpv --af=export=/tmp/mpv-af_export:1024 media.avi`` + Would export 1024 samples per channel to ``/tmp/mpv-af_export``. extrastereo[=mul] (Linearly) increases the difference between left and right channels which @@ -461,7 +461,7 @@ ladspa=file:label[:controls...] <controls> Controls are zero or more floating point values that determine the behavior of the loaded plugin (for example delay, threshold or gain). - In verbose mode (add ``-v`` to the MPlayer command line), all + In verbose mode (add ``-v`` to the mpv command line), all available controls and their valid ranges are printed. This eliminates the use of 'analyseplugin' from the LADSPA SDK. @@ -516,21 +516,21 @@ scaletempo[=option1:option2:...] *EXAMPLE*: - ``mplayer --af=scaletempo --speed=1.2 media.ogg`` + ``mpv --af=scaletempo --speed=1.2 media.ogg`` Would playback media at 1.2x normal speed, with audio at normal pitch. Changing playback speed, would change audio tempo to match. - ``mplayer --af=scaletempo=scale=1.2:speed=none --speed=1.2 media.ogg`` + ``mpv --af=scaletempo=scale=1.2:speed=none --speed=1.2 media.ogg`` Would playback media at 1.2x normal speed, with audio at normal pitch, but changing playback speed has no effect on audio tempo. - ``mplayer --af=scaletempo=stride=30:overlap=.50:search=10 media.ogg`` + ``mpv --af=scaletempo=stride=30:overlap=.50:search=10 media.ogg`` Would tweak the quality and performace parameters. - ``mplayer --af=format=floatne,scaletempo media.ogg`` + ``mpv --af=format=floatne,scaletempo media.ogg`` Would make scaletempo use float code. Maybe faster on some platforms. - ``mplayer --af=scaletempo=scale=1.2:speed=pitch audio.ogg`` + ``mpv --af=scaletempo=scale=1.2:speed=pitch audio.ogg`` Would playback audio file at 1.2x normal speed, with audio at normal pitch. Changing playback speed, would change pitch, leaving audio tempo at 1.2x. diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst index 00dd1e9e6d..412d9ac939 100644 --- a/DOCS/man/en/ao.rst +++ b/DOCS/man/en/ao.rst @@ -9,7 +9,7 @@ syntax is: --ao=<driver1[:suboption1[=value]:...],driver2,...[,]> Specify a priority list of audio output drivers to be used. -If the list has a trailing ',' MPlayer will fall back on drivers not contained +If the list has a trailing ',' mpv will fall back on drivers not contained in the list. Suboptions are optional and can mostly be omitted. *NOTE*: See ``--ao=help`` for a list of compiled-in audio output drivers. @@ -48,7 +48,7 @@ jack port=<name> Connects to the ports with the given name (default: physical ports). name=<client> - Client name that is passed to JACK (default: MPlayer [<PID>]). Useful + Client name that is passed to JACK (default: mpv [<PID>]). Useful if you want to have certain connections established automatically. (no-)estimate Estimate the audio delay, supposed to make the video playback smoother diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst index de56621278..402bdbd336 100644 --- a/DOCS/man/en/changes.rst +++ b/DOCS/man/en/changes.rst @@ -3,10 +3,7 @@ CHANGES FROM OTHER VERSIONS OF MPLAYER ====================================== -xxx: since I don't have a new name yet, I'm referring to this version of mplayer -as **mplayer3**, I don't intend to use that name. - -**mplayer3** is based on mplayer2, which in turn is based on the original +**mpv** is based on mplayer2, which in turn is based on the original MPlayer (also called mplayer, mplayer-svn, mplayer1). Many changes have been made. Some changes are incompatible, or completely change how the player behaves. @@ -37,7 +34,7 @@ General changes for mplayer-svn to mplayer2 * General code cleanups * Many more changes -General changes for mplayer2 to mplayer3 +General changes for mplayer2 to mpv ---------------------------------------- * Removal of lots of unneeded code to encourage developer activity (less @@ -51,9 +48,9 @@ General changes for mplayer2 to mplayer3 languages like Arabic should be better supported. * Cleaned up terminal output (nicer status line, less useless noise) * Support for playing URLs of popular streaming sites directly - (e.g. ``mplayer3 https://www.youtube.com/watch?v=...``) -* Improved OpenGL output (``vo_gl3``) -* Make ``--softvol`` default (**mplayer3** is not a mixer control panel) + (e.g. ``mpv https://www.youtube.com/watch?v=...``) +* Improved OpenGL output (``vo_opengl``) +* Make ``--softvol`` default (**mpv** is not a mixer control panel) * Improved support for .cue files * Screenshot improvements (can save screenshots as JPG, configurable filenames) * Removal of teletext support @@ -146,7 +143,7 @@ input.conf and slave commands Other ~~~~~ -* The playtree has been removed. **mplayer3**'s internal playlist is a simple and +* The playtree has been removed. **mpv**'s internal playlist is a simple and flat list now. This makes the code easier, and makes using it less confusing. * Slave mode is broken. This mode is entirely insane in the ``old`` versions of mplayer. A proper slave mode application needed tons of code and hacks to get @@ -156,7 +153,7 @@ Other slave mode application, and as such it's virtually impossible to improve terminal output intended for users without possibly breaking something. - This is absolutely insane, and **mplayer3** will not try to keep slave mode + This is absolutely insane, and **mpv** will not try to keep slave mode compatible. If you're a developer of a slave mode application, contact us, and a new and better protocol can be developed. @@ -185,6 +182,6 @@ Why this fork? withheld as to not turn this into a rant. * mplayer-svn rarely merged from mplayer2, and mplayer2 practically stopped merging from mplayer-svn (not even code cleanups or new features are merged) -* **mplayer3** intents to continuously merge from mplayer-svn and mplayer2, while +* **mpv** intents to continuously merge from mplayer-svn and mplayer2, while speeding up development. There is willingness for significant changes, even if this means breaking compatibility. diff --git a/DOCS/man/en/encode.rst b/DOCS/man/en/encode.rst index 7ebd8e6c01..93b1b84f28 100644 --- a/DOCS/man/en/encode.rst +++ b/DOCS/man/en/encode.rst @@ -10,8 +10,8 @@ You can encode files from one format/codec to another using this facility. --of=<format> Specifies the output format (overrides autodetection by the extension of - the file specified by -o). - See --of=help for a full list of supported formats. + the file specified by -o). This can be a comma separated list of possible + formats to try. See --of=help for a full list of supported formats. --ofopts=<options> Specifies the output format options for libavformat. @@ -56,8 +56,8 @@ You can encode files from one format/codec to another using this facility. avoid --oautofps. --oac=<codec> - Specifies the output audio codec. - See --oac=help for a full list of supported codecs. + Specifies the output audio codec. This can be a comma separated list of + possible codecs to try. See --oac=help for a full list of supported codecs. --oaoffset=<value> Shifts audio data by the given time (in seconds) by adding/removing @@ -86,27 +86,18 @@ You can encode files from one format/codec to another using this facility. --oacopts-clr Completely empties the options list. +--oafirst + Force the audio stream to become the first stream in the output. By default + the order is unspecified. + --ovc=<codec> - Specifies the output video codec. - See --ovc=help for a full list of supported codecs. + Specifies the output video codec. This can be a comma separated list of + possible codecs to try. See --ovc=help for a full list of supported codecs. --ovoffset=<value> Shifts video data by the given time (in seconds) by shifting the pts values. ---ocopyts - Copies input pts to the output video (not supported by some output - container formats, e.g. avi). Discontinuities are still fixed. - By default, audio pts are set to playback time and video pts are - synchronized to match audio pts, as some output formats do not support - anything else. - ---orawts - Copies input pts to the output video (not supported by some output - container formats, e.g. avi). In this modem discontinuities are not fixed - and all pts are passed through as-is. Never seek backwards or use multiple - input files in this mode! - --ovcopts <options> Specifies the output video codec options for libavcodec. See --ovcopts=help for a full list of supported options. @@ -132,3 +123,20 @@ You can encode files from one format/codec to another using this facility. --ovcopts-clr Completely empties the options list. + +--ovfirst + Force the video stream to become the first stream in the output. By default + the order is unspecified. + +--ocopyts + Copies input pts to the output video (not supported by some output + container formats, e.g. avi). Discontinuities are still fixed. + By default, audio pts are set to playback time and video pts are + synchronized to match audio pts, as some output formats do not support + anything else. + +--orawts + Copies input pts to the output video (not supported by some output + container formats, e.g. avi). In this modem discontinuities are not fixed + and all pts are passed through as-is. Never seek backwards or use multiple + input files in this mode! 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\- |