summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-09-18 01:19:27 +0200
committerwm4 <wm4@nowhere>2014-09-18 01:23:33 +0200
commitea2b19f64673a975a6bafe3292d26eab51142a5f (patch)
treea93fc536215ba676f3d182f452b1bac0a3c2c20a /DOCS/man
parent6c3d25e6f5f09a110ad0fffaeeea6a65ee5d228b (diff)
downloadmpv-ea2b19f64673a975a6bafe3292d26eab51142a5f.tar.bz2
mpv-ea2b19f64673a975a6bafe3292d26eab51142a5f.tar.xz
player: allow overriding OSD message for all OSD levels
Until now, you could override only level 3 with --osd-status-msg. Extend this, add add --osd-msg1 to --osd-msg3 (one for each OSD level). OSD level 0 always means disable OSD, so that isn't included. --osd-msg3 corresponds to --osd-status-msg, but they're not exactly the same. To allow more customization, --osd-msgN do not include the OSD symbol. The symbol can be manually added with "${osd-sym-cc}". We keep the "old" option for some short-term compatibility. --osd-msg1 should be particularly useful; for example you could do: --osd-msg1='${?pause==yes:${osd-sym-cc}}' to display a "paused" symbol when paused, and nothing during normal playback. (Although admittedly, the syntax is quite a bit of work.)
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/options.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 2a1bf8ded1..a0e5f59a41 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2197,6 +2197,26 @@ OSD
Default: 45.
+``--osd-msg1=<string>``
+ Show this string as message on OSD with OSD level 1 (visible by default).
+ The message will be visible by default, and as long no other message
+ covers it, and the OSD level isn't changed (see ``--osd-level``).
+ Expands properties; see `Property Expansion`_.
+
+``--osd-msg2=<string>``
+ Similar as ``--osd-msg1``, but for OSD level 2. If this is an empty string
+ (default), then the playback time is shown.
+
+``--osd-msg3=<string>``
+ Similar as ``--osd-msg1``, but for OSD level 3. If this is an empty string
+ (default), then the playback time, duration, and some more information is
+ shown.
+
+ This is also used for the ``show_progress`` command (by default mapped to
+ ``P``), or in some non-default cases when seeking.
+
+ ``--osd-status-msg`` is a legacy equivalent (but with a minor difference).
+
``--osd-status-msg=<string>``
Show a custom string during playback instead of the standard status text.
This overrides the status text used for ``--osd-level=3``, when using the
@@ -2204,6 +2224,10 @@ OSD
non-default cases when seeking. Expands properties. See
`Property Expansion`_.
+ This option has been replaced with ``--osd-msg3``. The only difference is
+ that this option implicitly includes ``${osd-sym-cc}``. This option is
+ ignored if ``--osd-msg3`` is not empty.
+
``--osd-playing-msg=<string>``
Show a message on OSD when playback starts. The string is expanded for
properties, e.g. ``--osd-playing-msg='file: ${filename}'`` will show the