summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-09-10 15:09:24 +0200
committerwm4 <wm4@nowhere>2013-09-10 15:12:25 +0200
commit12770d540706a864e6d6c47195dd03ed4d51f678 (patch)
treebf8b784c1d0c4fa7fd0680049aa3b910e357d8f8 /DOCS
parent683e58066e65e4bca43ff22cf1ef9f4481810266 (diff)
downloadmpv-12770d540706a864e6d6c47195dd03ed4d51f678.tar.bz2
mpv-12770d540706a864e6d6c47195dd03ed4d51f678.tar.xz
manpage: various improvements
Took a superficial look at the manpage, and fixed whatever I spotted.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/ao.rst2
-rw-r--r--DOCS/man/en/changes.rst6
-rw-r--r--DOCS/man/en/input.rst11
-rw-r--r--DOCS/man/en/mpv.rst34
-rw-r--r--DOCS/man/en/options.rst135
-rw-r--r--DOCS/man/en/vo.rst5
6 files changed, 87 insertions, 106 deletions
diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst
index 2b71437a77..374f23b6e1 100644
--- a/DOCS/man/en/ao.rst
+++ b/DOCS/man/en/ao.rst
@@ -36,7 +36,7 @@ Available audio output drivers are:
Set the name of the mixer element (default: ``Master``). This is for
example ``PCM`` or ``Master``.
``mixer-index=<number>``
- Set the index of the mixer channel (default: 0). Consider the output
+ Set the index of the mixer channel (default: 0). Consider the output of
"``amixer scontrols``", then the index is the number that follows the
name of the element.
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index 386275377d..8996a90336 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -185,8 +185,8 @@ input.conf and Slave Commands
This lists only commands that are not always gracefully handled by the
internal legacy translation layer. If an input.conf contains any legacy
- commands, they will be displayed with ``-v`` when it is loaded, and show
- and the replacement commands.
+ commands, a warning will be printed when starting the player. The warnings
+ also show the replacement commands.
Properties containing ``_`` to separate words use ``-`` instead.
@@ -225,7 +225,7 @@ input.conf and Slave Commands
+--------------------------------+----------------------------------------+
| ``show_chapters`` | ``show_text ${chapter-list}`` |
+--------------------------------+----------------------------------------+
- | ``af_switch``, ``af_add``, ... | ``af [set|add|...]`` |
+ | ``af_switch``, ``af_add``, ... | ``af set|add|...`` |
+--------------------------------+----------------------------------------+
Other
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index c05fb664de..ea2ebd2f0b 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -35,7 +35,7 @@ Newlines always start a new binding. ``#`` starts a comment (outside of quoted
string arguments). To bind commands to the ``#`` key, ``SHARP`` can be used.
``<key>`` is either the literal character the key produces (ASCII or Unicode
-character), or a symbol name.
+character), or a symbolic name (as printed by ``--input-keylist``).
``<section>`` (braced with ``{`` and ``}``) is the input section for this
command.
@@ -326,6 +326,9 @@ should be replaced by properties), ``stop`` (questionable use), ``get_property``
Input Command Prefixes
----------------------
+These prefixes are placed between key name and the actual command. Multiple
+prefixes can be specified. They are separated by whitespace.
+
``osd-auto`` (default)
Use the default behavior for this command.
``no-osd``
@@ -390,7 +393,7 @@ Name W Comment
``speed`` x see ``--speed``
``filename`` currently played file (path stripped)
``path`` currently played file (full path)
-``media-title`` filename or libquvi ``QUVIPROP_PAGETITLE``
+``media-title`` filename, title tag, or libquvi ``QUVIPROP_PAGETITLE``
``demuxer``
``stream-path`` filename (full path) of stream layer filename
``stream-pos`` x byte position in source stream
@@ -463,7 +466,7 @@ Name W Comment
``sub`` x alias for ``sid``
``sub-delay`` x see ``--sub-delay``
``sub-pos`` x see ``--sub-pos``
-``sub-visibility`` x whether current subtitle is rendered
+``sub-visibility`` x see ``--sub-visibility``
``sub-forced-only`` x see ``--sub-forced-only``
``sub-scale`` x subtitle font size multiplicator
``ass-use-margins`` x see ``--ass-use-margins``
@@ -477,7 +480,7 @@ Name W Comment
``playlist-pos`` current position on playlist
``playlist-count`` number of total playlist entries
``playlist`` playlist, current entry marked
-``track-list`` list of audio/video/sub tracks, cur. entr. marked
+``track-list`` list of audio/video/sub tracks, current entry marked
``chapter-list`` list of chapters, current entry marked
``quvi-format`` x see ``--quvi-format``
``af`` x see ``--af``
diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst
index 74cc70f1e5..a73be8bad5 100644
--- a/DOCS/man/en/mpv.rst
+++ b/DOCS/man/en/mpv.rst
@@ -203,8 +203,7 @@ corresponding adjustment, or the software equalizer (``--vf=eq``).)
7 and 8
Adjust saturation.
-(The following keys are valid only when using the corevideo video output
-driver.)
+(The following keys are valid only on OSX.)
command + 0
Resize movie window to half its original size.
@@ -233,7 +232,7 @@ PREVIOUS and NEXT
Seek backward/forward 1 minute.
(The following keys are only valid if you compiled with TV or DVB input
-support and will take precedence over the keys defined above.)
+support.)
h and k
Select previous/next channel.
@@ -253,24 +252,6 @@ button 3 and button 4
button 5 and button 6
Decrease/increase volume.
-Joystick Control
-----------------
-
-left and right
- Seek backward/forward 10 seconds.
-
-up and down
- Seek forward/backward 1 minute.
-
-button 1
- Pause.
-
-button 2
- Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
-
-button 3 and button 4
- Decrease/increase volume.
-
USAGE
=====
@@ -315,6 +296,8 @@ file1.mkv ``--a --b --c``
file2.mkv ``--a --b --c``
=============== ===========================
+(This is different from MPlayer and mplayer2.)
+
Also, if any option is changed at runtime (via input commands), they are not
reset when a new file is played.
@@ -499,7 +482,7 @@ behavior of mpv.
FFmpeg/Libav:
This library accesses various environment variables. However, they are not
- centrally documented, and documenting them is not our job. Therefore, the
+ centrally documented, and documenting them is not our job. Therefore, this
list is incomplete.
Notable environment variables:
@@ -602,13 +585,10 @@ FILES
EXAMPLES OF MPV USAGE
=====================
-Quickstart Blu-ray playing:
+Blu-ray playback:
- ``mpv bd:////path/to/disc``
- ``mpv bd:// --bluray-device=/path/to/disc``
-Quickstart DVD playing:
- ``mpv dvd://1``
-
Play in Japanese with English subtitles:
``mpv dvd://1 --alang=ja --slang=en``
@@ -644,6 +624,6 @@ mpv is a MPlayer fork based on mplayer2, which in turn is a fork of MPlayer.
MPlayer was initially written by Arpad Gereoffy. See the ``AUTHORS`` file for
a list of some of the many other contributors.
-MPlayer is (C) 2000-2012 The MPlayer Team
+MPlayer is (C) 2000-2013 The MPlayer Team
This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 8682c3df9d..28046c6bd8 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -69,8 +69,7 @@
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. mpv prints the
- available languages when run in verbose (``-v``) mode. See also ``--aid``.
+ language codes, while OGM uses a free-form identifier. See also ``--aid``.
.. admonition:: Examples
@@ -183,7 +182,7 @@
offset scale factor, not what the video filter chain or the video output
use.
-``--ass-vsfilter-color-compat=<basic|full|force-601|no``
+``--ass-vsfilter-color-compat=<basic|full|force-601|no>``
Mangle colors like (xy-)vsfilter do (default: basic). Historically, VSFilter
was not colorspace aware. This was no problem as long as the colorspace
used for SD video (BT.601) was used. But when everything switched to HD
@@ -249,8 +248,8 @@
See ``--geometry`` for details how this is handled with multi-monitor
setups.
- Use ``--autofit-larger`` instead if you do not want the window to get
- larger.
+ Use ``--autofit-larger`` instead if you just want to limit the maximum size
+ of the window, rather than always forcing a window size.
Use ``--geometry`` if you want to force both window width and height to a
specific size.
@@ -307,17 +306,6 @@
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.
-``--bandwidth=<bytes>``
- 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.
-
- .. note::
-
- Probably broken/useless.
-
``--untimed``
Do not sleep when outputting video frames. Useful for benchmarks when used
with ``--no-audio.``
@@ -331,6 +319,10 @@
Specify the Blu-ray disc location. Must be a directory with Blu-ray
structure.
+ .. admonition:: Example
+
+ ``mpv bd:// --bluray-device=/path/to/bd/``
+
``--border``, ``--no-border``
Play movie with window border and decorations. Since this is on by
default, use ``--no-border`` to disable the standard window decorations.
@@ -357,7 +349,7 @@
``--cache-default=<kBytes|no>``
Set the size of the cache in kilobytes (default: 320 KB). Using ``no``
- will not automatically enable the cache e.h. when playing from a network
+ will not automatically enable the cache e.g. when playing from a network
stream. Note that using ``--cache`` will always override this option.
``--cache-pause=<no|percentage>``
@@ -433,11 +425,6 @@
libavcodec downmixes the audio into the requested number of channels if
possible.
- .. note::
-
- This option is honored by codecs (AC-3 only), filters (surround) and
- audio output drivers (OSS at least).
-
The ``--channels`` option either takes a channel number or an explicit
channel layout. Channel numbers refer to default layouts, e.g. 2 channels
refer to stereo, 6 refers to 5.1.
@@ -446,6 +433,13 @@
lists speaker names, which can be used to express arbitrary channel
layouts (e.g. ``fl-fr-lfe`` is 2.1).
+ .. note::
+
+ Currently, this option is not very useful. The main effect of this
+ option is that automatic stereo downmixing is disabled. It depends
+ mainly on the selected audio output and the associated audio subsystem
+ how playback of files with surround audio will behave.
+
``--chapter=<start[-end]>``
Specify which chapter to start playing at. Optionally specify which
chapter to end playing at. Also see ``--start``.
@@ -596,7 +590,7 @@
This is default in order to reduce latency when opening HTTP streams.
-``--demuxer-lavf-format=<value>``
+``--demuxer-lavf-format=<name>``
Force a specific libavformat demuxer.
``--demuxer-lavf-genpts-mode=<auto|lavf|builtin|no>``
@@ -686,7 +680,7 @@
``--demuxer-rawvideo-format=<value>``
Colorspace (fourcc) in hex or string for ``--demuxer=rawvideo``
- (default: YV12).
+ (default: ``YV12``).
``--demuxer-rawvideo-mp-format=<value>``
Colorspace by internal video format for ``--demuxer=rawvideo``. Use
@@ -722,6 +716,10 @@
also specify a directory that contains files previously copied directly
from a DVD (with e.g. vobcopy).
+ .. admonition:: Example
+
+ ``mpv dvd:// --dvd-device=/path/to/dvd/``
+
``--dvd-speed=<speed>``
Try to limit DVD speed (default: 0, no change). DVD base speed is 1385
kB/s, so an 8x drive can read at speeds up to 11080 kB/s. Slower speeds
@@ -764,7 +762,7 @@
``--no-fixed-vo``, ``--fixed-vo``
``--no-fixed-vo`` enforces closing and reopening the video window for
- multiple files (one (un)initialization for all files).
+ multiple files (one (un)initialization for each file).
``--flip``
Flip image upside-down.
@@ -973,11 +971,7 @@
See also ``--autofit`` and ``--autofit-larger`` for fitting the window into
a given size without changing aspect ratio.
-``--grabpointer``, ``--no-grabpointer``
- ``--no-grabpointer`` tells the player to not grab the mouse pointer after a
- video mode change (``--vm``). Useful for multihead setups.
-
-``--heartbeat-cmd``
+``--heartbeat-cmd=<command>``
Command that is executed every 30 seconds during playback via *system()* -
i.e. using the shell. The time between the commands can be customized with
the ``--heartbeat-interval`` option.
@@ -1070,8 +1064,8 @@
:no: always use software decoding (default)
:auto: see below
- :vdpau: requires ``--vo=vdpau``
- :vaapi: requires ``--vo=vaapi``
+ :vdpau: requires ``--vo=vdpau`` (Linux only)
+ :vaapi: requires ``--vo=vaapi`` (Linux with Intel GPUs only)
:vda: requires ``--vo=corevideo`` (OSX only)
:crystalhd: Broadcom Crystal HD
@@ -1345,8 +1339,9 @@
``--no-sub``
Do not select any subtitle when the file is loaded.
-``--no-sub-visibility``
- Disable display of subtitles, but still select and decode them.
+``--sub-visibility``, ``--no-sub-visibility``
+ Can be used to disable display of subtitles, but still select and decode
+ them.
``--no-video``
Do not play video. With some demuxers this may not work. In those cases
@@ -1372,13 +1367,15 @@
``--osd-bar-align-x=<-1-1>``
Position of the OSD bar. -1 is far left, 0 is centered, 1 is far right.
+ Fractional values (like 0.5) are allowed.
``--osd-bar-align-y=<-1-1>``
Position of the OSD bar. -1 is top, 0 is centered, 1 is bottom.
+ Fractional values (like 0.5) are allowed.
``--osd-bar-w=<1-100>``
Width of the OSD bar, in percentage of the screen width (default: 75).
- A value of 0.5 means the bar is half the screen wide.
+ A value of 50 means the bar is half the screen wide.
``--osd-bar-h=<0.1-50>``
Height of the OSD bar, in percentage of the screen height (default: 3.125).
@@ -1412,8 +1409,8 @@
For example, ``#FF0000`` is red. This is similar to web colors.
You can specify transparency by specifying an alpha value in the form
- ``#AARRGGBB``. 0 is fully transparent, while ``FF`` is opaque (opaque is
- default with the shorter color specification).
+ ``#AARRGGBB``. ``00`` is fully transparent, while ``FF`` is opaque (opaque
+ is default with the shorter color specification).
.. admonition:: Examples
@@ -1510,7 +1507,7 @@
``--playing-msg=<string>``
Print out a string after starting playback. The string is expanded for
- properties, e.g. ``--playing-msg=file: ${filename}`` will print the string
+ properties, e.g. ``--playing-msg='file: ${filename}'`` will print the string
``file:`` followed by a space and the currently played filename.
See `Property Expansion`_.
@@ -1641,6 +1638,8 @@
Particularly useful on slow terminals or broken ones which do not properly
handle carriage return (i.e. ``\r``).
+ Also see ``--really-quiet`` and ``--msglevel``.
+
``--quvi-format=<best|default|...>``
Video format/quality that is directly passed to libquvi (default: ``best``).
This is used when opening links to streaming sites like YouTube. The
@@ -1755,10 +1754,6 @@
- ``--reset-on-next-file=""``
Do not reset pause mode.
-``--reuse-socket``
- (udp:// only)
- Allows a socket to be reused by other processes as soon as it is closed.
-
``--saturation=<-100-100>``
Adjust the saturation of the video signal (default: 0). You can get
grayscale output with this option. Not supported by all video output
@@ -1784,12 +1779,12 @@
multiple displays), this option tells mpv which screen to display the
movie on.
- This option does not always work. In these cases, try to use ``--geometry``
- to position the window explicitly.
-
.. admonition:: Note (X11)
- This option does not work properly with all window managers.
+ This option does not work properly with all window managers. In these
+ cases, you can try to use ``--geometry`` to position the window
+ explicitly. It's also possible that the window manager provides native
+ features to control which screens application windows should use.
See also ``--fs-screen``.
@@ -1904,8 +1899,7 @@
Specify a priority list of subtitle languages to use. Different container
formats employ different language codes. DVDs use ISO 639-1 two letter
language codes, Matroska uses ISO 639-2 three letter language codes while
- OGM uses a free-form identifier. mpv prints the available languages
- when run in verbose (``-v``) mode. See also ``--sid``.
+ OGM uses a free-form identifier. See also ``--sid``.
.. admonition:: Examples
@@ -1959,11 +1953,13 @@
current level. With values below 100 the initial volume (which is 100%)
will be above the maximum, which e.g. the OSD cannot display correctly.
- Note: the maximum value of ``--volume`` as well as the ``volume`` property
- is always 100. Likewise, the volume OSD bar always goes from 0 to 100.
- This means that with ``--softvol-max=200``, ``--volume=100`` means
- maximum amplification, i.e. amplify by 200%. The default volume will be
- ``50`` in this case (meaning no amplification).
+ .. admonition:: Note
+
+ The maximum value of ``--volume`` as well as the ``volume`` property
+ is always 100. Likewise, the volume OSD bar always goes from 0 to 100.
+ This means that with ``--softvol-max=200``, ``--volume=100`` sets
+ maximum amplification, i.e. amplify by 200%. The default volume (no
+ change in volume) will be ``50`` in this case.
``--speed=<0.01-100>``
Slow down or speed up playback by the factor given as parameter.
@@ -2023,7 +2019,8 @@
``--stop-screensaver``, ``--no-stop-screensaver``
Turns off the screensaver (or screen blanker and similar mechanisms) at
- startup and turns it on again on exit (default: yes).
+ startup and turns it on again on exit (default: yes). The screensaver is
+ always reenabled when the player is paused.
This is not supported on all video outputs or platforms. Sometimes it is
implemented, but does not work (happens often on GNOME). You might be able
@@ -2068,10 +2065,12 @@
which means it will try to use UTF-8, otherwise the ``UTF-8-BROKEN``
pseudo codepage (see below).
- Warning: if you force the charset, even subtitles that are known to be
- UTF-8 will be recoded, which is perhaps not what you expect. Prefix
- codepages with ``utf8:`` if you want the codepage to be used only if the
- input is not valid UTF-8.
+ .. admonition:: Warning
+
+ If you force the charset, even subtitles that are known to be
+ UTF-8 will be recoded, which is perhaps not what you expect. Prefix
+ codepages with ``utf8:`` if you want the codepage to be used only if the
+ input is not valid UTF-8.
.. admonition:: Examples
@@ -2081,11 +2080,11 @@
The pseudo codepage ``UTF-8-BROKEN`` is used internally. If this is used
as codepage, the subtitle will be interpreted as UTF-8, but with "Latin 1"
- as fallback for bytes which are not valid UTF-8 sequences. This codepage
- name is never passed to iconv.
+ as fallback for bytes which are not valid UTF-8 sequences. iconv is never
+ involved in this mode.
- If the player was compiled with ENCA support, you can use special syntax
- to use that::
+ If the player was compiled with ENCA support, you can control it with the
+ following syntax::
``--subcp=enca:<language>:<fallback codepage>``
@@ -2165,10 +2164,10 @@
to fix the playback speed for frame-based subtitle formats. Works for
external text subtitles only.
- .. admonition:: Examples
+ .. admonition:: Example
- - ``--sub-speed=25/23.976`` plays frame based subtitles which have been
- loaded assuming a framerate of 23.976 at 25 FPS.
+ `--sub-speed=25/23.976`` plays frame based subtitles which have been
+ loaded assuming a framerate of 23.976 at 25 FPS.
``--sws=<n>``
Specify the software scaler algorithm to be used with ``--vf=scale``. This
@@ -2210,7 +2209,9 @@
.. warning::
There is a danger of this causing significant CPU usage, depending on
- the properties used and the window manager.
+ the properties used and the window manager. Changing the window title
+ is often a slow operation, and if the title changes every frame,
+ playback can be ruined.
``--tv=<option1:option2:...>``
This option tunes various properties of the TV capture module. For
@@ -2513,7 +2514,7 @@
This option is disabled if the ``--no-keepaspect`` option is used.
-``--video-unscaled=<value>``
+``--video-unscaled``
Disable scaling of the video. If the window is larger than the video,
black bars are added. Otherwise, the video is cropped. The video still
can be influenced by the other ``--video-...`` options. (If the
diff --git a/DOCS/man/en/vo.rst b/DOCS/man/en/vo.rst
index 0edf00fe5c..6b6d503219 100644
--- a/DOCS/man/en/vo.rst
+++ b/DOCS/man/en/vo.rst
@@ -22,12 +22,9 @@ in the list. Suboptions are optional and can mostly be omitted.
Available video output drivers are:
``xv`` (X11 only)
- Uses the XVideo extension to enable hardware-accelerated playback. This is
+ Uses the XVideo extension to enable hardware-accelerated display. This is
the most compatible VO on X, but may be low-quality, and has issues with
OSD and subtitle display.
- For information about what colorkey is used and how it is drawn, run
- mpv with the ``-v`` option and look out for the lines tagged with ``[xv
- common]`` at the beginning.
``adaptor=<number>``
Select a specific XVideo adaptor (check xvinfo results).