aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2025-10-15 12:07:50 +0300
committerIvan Molodetskikh <yalterz@gmail.com>2025-10-15 12:08:07 +0300
commitc482b446a9173485702b3336781b11541d7859d4 (patch)
tree2221a96d353468158b8c4459fde2da05ea53d7d2 /docs
parent1dd82a8dcfdbad2c39cc2e2f68cd82e360170028 (diff)
downloadniri-c482b446a9173485702b3336781b11541d7859d4.tar.gz
niri-c482b446a9173485702b3336781b11541d7859d4.tar.bz2
niri-c482b446a9173485702b3336781b11541d7859d4.zip
wiki: Mention windowed fullscreen on fullscreen and maximize page
Diffstat (limited to 'docs')
-rw-r--r--docs/wiki/Fullscreen-and-Maximize.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/wiki/Fullscreen-and-Maximize.md b/docs/wiki/Fullscreen-and-Maximize.md
index 36156448..c106eff5 100644
--- a/docs/wiki/Fullscreen-and-Maximize.md
+++ b/docs/wiki/Fullscreen-and-Maximize.md
@@ -64,6 +64,18 @@ If the window does this, then `open-maximized-to-edges` and `open-fullscreen` wi
However, some clients tend to request to be maximized shortly *after* the initial configure sequence, when the niri already sent them the initial size request (sometimes even after showing on screen, resulting in a quick resize right after opening).
From niri's point of view, the window is already open by this point, so if the window does this, then the `open-maximized-to-edges` and `open-fullscreen` window rules don't do anything.
+## Windowed fullscreen
+
+<sup>Since: 25.05</sup>
+
+Niri can also tell a window that it's in fullscreen without actually making it fullscreen, via the `toggle-windowed-fullscreen` action.
+This is generally useful for screencasting browser-based presentations, when you want to hide the browser UI, but still have the window sized as a normal window.
+
+When in windowed fullscreen, you can use the niri action to maximize or unmaximize the window.
+Window-side titlebar maximize buttons and gestures may not work, since the window will always think that it's in fullscreen.
+
+See also windowed fullscreen on the [screencasting features wiki page](./Screencasting.md#windowed-fakedetached-fullscreen).
+
[struts]: ./Configuration:-Layout.md#struts
[gaps]: ./Configuration:-Layout.md#gaps