aboutsummaryrefslogtreecommitdiff
path: root/wiki/Configuration:-Gestures.md
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2025-04-25 10:36:59 +0300
committerIvan Molodetskikh <yalterz@gmail.com>2025-04-25 02:00:18 -0700
commit85cd64e83017459f0a6edfd7b91ba31d70b0ef17 (patch)
tree80f76e354ac3f034959cffb8a28a2fa481ff5c1a /wiki/Configuration:-Gestures.md
parent55c14eebf20d1e4d794e3a95b9d7ae65e305e769 (diff)
downloadniri-85cd64e83017459f0a6edfd7b91ba31d70b0ef17.tar.gz
niri-85cd64e83017459f0a6edfd7b91ba31d70b0ef17.tar.bz2
niri-85cd64e83017459f0a6edfd7b91ba31d70b0ef17.zip
Document the Overview and other new things
Diffstat (limited to 'wiki/Configuration:-Gestures.md')
-rw-r--r--wiki/Configuration:-Gestures.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/wiki/Configuration:-Gestures.md b/wiki/Configuration:-Gestures.md
index cb1446fd..4b9760ce 100644
--- a/wiki/Configuration:-Gestures.md
+++ b/wiki/Configuration:-Gestures.md
@@ -14,6 +14,16 @@ gestures {
delay-ms 100
max-speed 1500
}
+
+ dnd-edge-workspace-switch {
+ trigger-height 50
+ delay-ms 100
+ max-speed 1500
+ }
+
+ hot-corners {
+ // off
+ }
}
```
@@ -41,3 +51,46 @@ gestures {
}
}
```
+
+### `dnd-edge-workspace-switch`
+
+<sup>Since: next release</sup>
+
+Scroll the workspaces up/down when moving the mouse cursor against a monitor edge during drag-and-drop (DnD) while in the overview.
+Also works on a touchscreen.
+
+The options are:
+
+- `trigger-height`: size of the area near the monitor edge that will trigger the scrolling, in logical pixels.
+- `delay-ms`: delay in milliseconds before the scrolling starts.
+Avoids unwanted scrolling when dragging things across monitors.
+- `max-speed`: maximum scrolling speed; 1500 corresponds to one screen height per second.
+The scrolling speed increases linearly as you move your mouse cursor from `trigger-width` to the very edge of the monitor.
+
+```kdl
+gestures {
+ // Increase the trigger area and maximum speed.
+ dnd-edge-workspace-switch {
+ trigger-height 100
+ max-speed 3000
+ }
+}
+```
+
+### `hot-corners`
+
+<sup>Since: next release</sup>
+
+Put your mouse at the very top-left corner of a monitor to toggle the overview.
+Also works during drag-and-dropping something.
+
+`off` disables the hot corners.
+
+```kdl
+// Disable the hot corners.
+gestures {
+ hot-corners {
+ off
+ }
+}
+```