aboutsummaryrefslogtreecommitdiff
path: root/docs/wiki/Floating-Windows.md
diff options
context:
space:
mode:
authorKent Daleng <lolexplode@gmail.com>2025-08-17 16:05:41 +0200
committerGitHub <noreply@github.com>2025-08-17 17:05:41 +0300
commitdc93f1c1fd7b67e2da5af2ffada732b9ddeb2d6a (patch)
treea2f2938a7df17c196be7016dc5fe1fc9f75fb484 /docs/wiki/Floating-Windows.md
parenta6febb86aa5af0df7bf2792ca027ef95a503d599 (diff)
downloadniri-dc93f1c1fd7b67e2da5af2ffada732b9ddeb2d6a.tar.gz
niri-dc93f1c1fd7b67e2da5af2ffada732b9ddeb2d6a.tar.bz2
niri-dc93f1c1fd7b67e2da5af2ffada732b9ddeb2d6a.zip
github wiki replacement / mkdocs-docs (#2147)
* Add wiki based on mkdocs * wording fixes * fix github bg color on narrow * Fix left sidebar section headers being bigger than pages * fix hover accent * fix list rendering on fractional layout * fix videos * fix automatic full links * remove redundant commented css * improve dark mode contrast * update pygments for better child node coloring * update logo * remove blank lines * add systemd language hint --------- Co-authored-by: Ivan Molodetskikh <yalterz@gmail.com>
Diffstat (limited to 'docs/wiki/Floating-Windows.md')
-rw-r--r--docs/wiki/Floating-Windows.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/wiki/Floating-Windows.md b/docs/wiki/Floating-Windows.md
new file mode 100644
index 00000000..cfce5a94
--- /dev/null
+++ b/docs/wiki/Floating-Windows.md
@@ -0,0 +1,16 @@
+### Overview
+
+<sup>Since: 25.01</sup>
+
+Floating windows in niri always show on top of the tiled windows.
+The floating layout does not scroll.
+Each workspace/monitor has its own floating layout, just like each workspace/monitor has its own tiling layout.
+
+New windows will automatically float if they have a parent (e.g. dialogs) or if they are fixed size (e.g. splash screens).
+To change a window between floating and tiling, you can use the `toggle-window-floating` bind or right click while dragging/moving the window.
+You can also use the `open-floating true/false` window rule to either force a window to open as floating, or to disable the automatic floating logic.
+
+Use `switch-focus-between-floating-and-tiling` to switch the focus between the two layouts.
+When focused on the floating layout, binds (like `focus-column-right`) will operate on the floating window.
+
+You can precisely position a floating window with a command like `niri msg action move-floating-window -x 100 -y 200`.