From 9b1a4366e9a9fd3a84b7687fd4c41fce031a4e9b Mon Sep 17 00:00:00 2001 From: nanahi <130121847+na-na-hi@users.noreply.github.com> Date: Wed, 30 Jul 2025 20:36:34 -0400 Subject: [PATCH] DOCS/man/options: document special wid value -1 This value can be used to tell mpv to detach from the existing parent into its own window. --- DOCS/man/options.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 009299c6e7..c01ca29543 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -3711,12 +3711,15 @@ Window 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=`` +``--wid=`` This tells mpv to attach to an existing window. If a VO is selected that supports this option, it will use that window for video output. mpv will scale the video to the size of this window, and will add black bars to compensate if the aspect ratio of the video is different. + An ID of value ``-1`` is interpreted specially, and mpv will detach from + the currently attached window to its own window. + On X11, the ID is interpreted as a ``Window`` on X11. Unlike MPlayer/mplayer2, mpv always creates its own window, and sets the wid window as parent. The window will always be resized to cover the parent