Skip to content

Commit

Permalink
DOCS/man: remove "Linux desktop issues" section
Browse files Browse the repository at this point in the history
This section has no reason to exist anymore because:

- No "desktop issues" sections exist for other platforms, and all other
Linux-specific issues are represented as notes for options. This section
only addressed one specific issue.

- This section was shortened significantly with commit
2c46ae8, so there is no need for
this to be a separate section anymore.

- This section was shortened again with commit
d5e681e, when the original rationale
behind this section became outdated because GNOME has implemented the
idle inhibit protocol.

The historical info is moved to the documentation of --stop-screensaver.
  • Loading branch information
na-na-hi authored and Dudemanguy committed Dec 29, 2023
1 parent a16bad4 commit abc2a74
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 24 deletions.
21 changes: 0 additions & 21 deletions DOCS/man/mpv.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1358,27 +1358,6 @@ works like in older mpv releases:
change, and not apply your additional settings, and/or use a different
profile name.

Linux desktop issues
====================

This subsection describes common problems on the Linux desktop. None of these
problems exist on systems like Windows or macOS.

Disabling Screensaver
---------------------

By default, mpv tries to disable the OS screensaver during playback (only if
a VO using the OS GUI API is active). ``--stop-screensaver=no`` disables this.

A common problem is that Linux desktop environments ignore the standard
screensaver APIs on which mpv relies. In particular, mpv uses the Screen Saver
extension (XSS) on X11, and the idle-inhibit protocol on Wayland.

Before mpv 0.33.0, the X11 backend ran ``xdg-screensaver reset`` in 10 second
intervals when not paused in order to support screensaver inhibition in these
environments. This functionality was removed in 0.33.0, but it is possible to
call the ``xdg-screensaver`` command line program from a user script instead.


.. include:: options.rst

Expand Down
8 changes: 5 additions & 3 deletions DOCS/man/options.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3450,10 +3450,12 @@ Window
the screensaver will re-enable when playback is not active. ``always`` will
always disable the screensaver. Note that stopping the screensaver is only
possible if a video output is available (i.e. there is an open mpv window).
This is not supported on all video outputs, platforms, or desktop environments.

This is not supported on all video outputs or platforms. Sometimes it is
implemented, but does not work (especially with Linux "desktops"). Read the
`Disabling Screensaver`_ section very carefully.
Before mpv 0.33.0, the X11 backend ran ``xdg-screensaver reset`` in 10 second
intervals when not paused in order to support screensaver inhibition in some
environments. This functionality was removed in 0.33.0, but it is possible to
call the ``xdg-screensaver`` command line program from a user script instead.

``--wid=<ID>``
This tells mpv to attach to an existing window. If a VO is selected that
Expand Down

0 comments on commit abc2a74

Please sign in to comment.