aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS
diff options
context:
space:
mode:
authorGravatar wm4 <wm4@nowhere>2017-09-18 22:54:03 +0200
committerGravatar wm4 <wm4@nowhere>2017-09-18 22:54:03 +0200
commit80e3173aa101ffd1c94b53299b325a0654562824 (patch)
tree1db6d8d60963d8a34b9dfec51ee5999a7a93129b /DOCS
parent6b013133e5f6dc859d5c915d7487353169e41027 (diff)
options: remove --heartbeat-cmd and --heartbeat--interval
This mechanism uses system() and shouldn't even exist. x11_common.c has its own solution for the original problem (disabling Linux DE screensavers without MPlayer/mpv having to link a dbus lib). If that is not sufficient, you can create a simple Lua script. Incidentally fixes #4888.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst3
-rw-r--r--DOCS/man/options.rst44
2 files changed, 3 insertions, 44 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index d8c4900c21..656a5d204f 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -19,6 +19,9 @@ Interface changes
::
+ --- mpv 0.28.0 ---
+ - drop previously deprecated --heartbeat-cmd and --heartbeat--interval
+ options
--- mpv 0.27.0 ---
- drop previously deprecated --field-dominance option
- drop previously deprecated "osd" command
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index ce14d3e92a..fa2f676190 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2412,50 +2412,6 @@ Window
there is a change in video parameters, video stream or file. This used to
be the default behavior. Currently only affects X11 VOs.
-``--heartbeat-cmd=<command>``
-
- .. warning::
-
- This option is redundant with Lua scripting. Further, it shouldn't be
- needed for disabling screensaver anyway, since mpv will call
- ``xdg-screensaver`` when using X11 backend. As a consequence this
- option has been deprecated with no direct replacement.
-
- 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. The command is not run while playback
- is paused.
-
- .. note::
-
- mpv uses this command without any checking. It is your responsibility to
- ensure it does not cause security problems (e.g. make sure to use full
- paths if "." is in your path like on Windows). It also only works when
- playing video (i.e. not with ``--no-video`` but works with
- ``--vo=null``).
-
- This can be "misused" to disable screensavers that do not support the
- proper X API (see also ``--stop-screensaver``). If you think this is too
- complicated, ask the author of the screensaver program to support the
- proper X APIs. Note that the ``--stop-screensaver`` does not influence the
- heartbeat code at all.
-
- .. admonition:: Example for xscreensaver
-
- ``mpv --heartbeat-cmd="xscreensaver-command -deactivate" file``
-
- .. admonition:: Example for GNOME screensaver
-
- ``mpv --heartbeat-cmd="gnome-screensaver-command --deactivate" file``
-
-
-``--heartbeat-interval=<sec>``
- Time between ``--heartbeat-cmd`` invocations in seconds (default: 30).
-
- .. note::
-
- This does not affect the normal screensaver operation in any way.
-
``--no-keepaspect``, ``--keepaspect``
``--no-keepaspect`` will always stretch the video to window size, and will
disable the window manager hints that force the window aspect ratio.