From abf100f81df02a8b72a750bd3b30a8885d4c1263 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 10 Apr 2015 21:24:12 +0200 Subject: manpage: document pseudo-gui stuff --- DOCS/man/mpv.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index 0a993d412e..caf8592b7f 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -610,6 +610,34 @@ PROTOCOLS ``memory://data`` Use the ``data`` part as source data. +PSEUDO GUI MODE +=============== + +mpv has no official GUI, other than the OSC (`ON SCREEN CONTROLLER`_), which +is not a full GUI and is not meant to be. However, to compensate for the lack +of expected GUI behavior, mpv will in some cases start with some settings +changed to behave slightly more like a GUI mode. + +Currently this happens only if started using the ``mpv.desktop`` file in Linux +(like started from menus or file associations provided by desktop environments). + +This mode implicitly adds ``--profile=pseudo-gui`` to the command line, with +the ``pseudo-gui`` profile being predefined with the following contents: + +:: + + [pseudo-gui] + terminal=no + force-window=yes + idle=once + +This follows the mpv config file format. To customize pseudo-GUI mode, you can +put your own ``pseudo-gui`` profile into your ``mpv.conf``. This profile will +enhance the default profile, rather than overwrite it. + +The profile always overrides other settings in ``mpv.conf``. + + .. include:: options.rst .. include:: ao.rst -- cgit v1.2.3