diff options
Diffstat (limited to 'DOCS/man/mpv.rst')
-rw-r--r-- | DOCS/man/mpv.rst | 29 |
1 files changed, 20 insertions, 9 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index 736c9a097d..7a4c0b64d0 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -43,6 +43,9 @@ The following listings are not necessarily complete. See ``etc/input.conf`` for a list of default bindings. User ``input.conf`` files and Lua scripts can define additional key bindings. +See also ``--input-test`` for interactive binding details by key, and the +`stats`_ built-in script for key bindings list (including print to terminal). + Keyboard Control ---------------- @@ -227,7 +230,7 @@ i and I `STATS`_ for more information. del - Cycles visibility between never / auto (mouse-move) / always + Cycle OSC visibility between never / auto (mouse-move) / always \` Show the console. (ESC closes it again. See `CONSOLE`_.) @@ -390,6 +393,9 @@ It is started with ``%`` and has the following format:: ``mpv --vf=foo:option1=%`expr length "$NAME"`%"$NAME" test.avi`` +Note: where applicable with JSON-IPC, ``%n%`` is the length in UTF-8 bytes, +after decoding the JSON data. + Suboptions passed to the client API are also subject to escaping. Using ``mpv_set_option_string()`` is exactly like passing ``--name=data`` to the command line (but without shell processing of the string). Some options @@ -427,23 +433,28 @@ need to escape special characters. To work this around, the path can be additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n`` (see above). -Some mpv options interpret paths starting with ``~``. Currently, the prefix -``~~/`` expands to the mpv configuration directory (usually ``~/.config/mpv/``). +Some mpv options interpret paths starting with ``~``. +Currently, the prefix ``~~home/`` expands to the mpv configuration directory +(usually ``~/.config/mpv/``). ``~/`` expands to the user's home directory. (The trailing ``/`` is always required.) The following paths are currently recognized: ================ =============================================================== Name Meaning ================ =============================================================== -``~~/`` mpv config dir (for example ``~/.config/mpv/``) +``~~/`` If the subpath exists in any of the mpv's config directories + the path of the existing file/dir is returned. Otherwise this + is equivalent to ``~~home/``. + Note that if --no-config is used ``~~/foobar`` will resolve to + ``foobar`` which can be unexpected. ``~/`` user home directory root (similar to shell, ``$HOME``) -``~~home/`` same as ``~~/`` +``~~home/`` mpv config dir (for example ``~/.config/mpv/``) ``~~global/`` the global config path, if available (not on win32) ``~~osxbundle/`` the macOS bundle resource path (macOS only) ``~~desktop/`` the path to the desktop (win32, macOS) -``~~exe_dir`` win32 only: the path to the directory containing the exe (for +``~~exe_dir/`` win32 only: the path to the directory containing the exe (for config file purposes; ``$MPV_HOME`` overrides it) -``~~old_home`` do not use +``~~old_home/`` do not use ================ =============================================================== @@ -511,7 +522,7 @@ They support the following operations: ============= =============================================== Suffix Meaning ============= =============================================== --set Set a list of items (using the list separator, interprets escapes) +-set Set a list of items (using the list separator, escaped with backslash) -append Append single item (does not interpret escapes) -add Append 1 or more items (same syntax as -set) -pre Prepend 1 or more items (same syntax as -set) @@ -1003,7 +1014,7 @@ listed. - ``AV:`` or ``V:`` (video only) or ``A:`` (audio only) - The current time position in ``HH:MM:SS`` format (``playback-time`` property) - The total file duration (absent if unknown) (``duration`` property) -- Playback speed, e.g. `` x2.0``. Only visible if the speed is not normal. This +- Playback speed, e.g. ``x2.0``. Only visible if the speed is not normal. This is the user-requested speed, and not the actual speed (usually they should be the same, unless playback is too slow). (``speed`` property.) - Playback percentage, e.g. ``(13%)``. How much of the file has been played. |