aboutsummaryrefslogtreecommitdiff
path: root/docs/wiki/Gestures.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/Gestures.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/Gestures.md')
-rw-r--r--docs/wiki/Gestures.md93
1 files changed, 93 insertions, 0 deletions
diff --git a/docs/wiki/Gestures.md b/docs/wiki/Gestures.md
new file mode 100644
index 00000000..3099edd4
--- /dev/null
+++ b/docs/wiki/Gestures.md
@@ -0,0 +1,93 @@
+### Overview
+
+There are several gestures in niri.
+
+Also see the [gestures configuration](./Configuration:-Gestures.md) wiki page.
+
+### Mouse
+
+#### Interactive Move
+
+<sup>Since: 0.1.10</sup>
+
+You can move windows by holding <kbd>Mod</kbd> and the left mouse button.
+
+You can customize the look of the window insertion preview in the [`insert-hint` layout config](./Configuration:-Layout.md#insert-hint).
+
+<sup>Since: 25.01</sup> Right click while moving to toggle between floating and tiling layout to put the window into.
+
+#### Interactive Resize
+
+<sup>Since: 0.1.6</sup>
+
+You can resize windows by holding <kbd>Mod</kbd> and the right mouse button.
+
+#### Reset Window Height
+
+<sup>Since: 0.1.6</sup>
+
+If you double-click on a top or bottom tiled window resize edge, the window height will reset to automatic.
+
+This works with both window-initiated resizes (when using client-side decorations), and niri-initiated <kbd>Mod</kbd> + right click resizes.
+
+#### Toggle Full Width
+
+<sup>Since: 0.1.6</sup>
+
+If you double-click on a left or right tiled window resize edge, the column will expand to the full workspace width.
+
+This works with both window-initiated resizes (when using client-side decorations), and niri-initiated <kbd>Mod</kbd> + right click resizes.
+
+#### Horizontal View Movement
+
+<sup>Since: 0.1.6</sup>
+
+Move the view horizontally by holding <kbd>Mod</kbd> and the middle mouse button (or the wheel) and dragging the mouse horizontally.
+
+#### Workspace Switch
+
+<sup>Since: 0.1.7</sup>
+
+Switch workspaces by holding <kbd>Mod</kbd> and the middle mouse button (or the wheel) and dragging the mouse vertically.
+
+### Touchpad
+
+#### Workspace Switch
+
+Switch workspaces with three-finger vertical swipes.
+
+#### Horizontal View Movement
+
+Move the view horizontally with three-finger horizontal swipes.
+
+### All Pointing Devices
+
+#### Drag-and-Drop Edge View Scroll
+
+<sup>Since: 25.02</sup>
+
+Scroll the tiling view when moving the mouse cursor against a monitor edge during drag-and-drop (DnD).
+Also works on a touchscreen.
+
+#### Drag-and-Drop Edge Workspace Switch
+
+<sup>Since: 25.05</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.
+
+#### Drag-and-Drop Hold to Activate
+
+<sup>Since: 25.05</sup>
+
+While drag-and-dropping, hold your mouse over a window to activate it.
+This will bring a floating window to the top for example.
+
+In the overview, you can also hold the mouse over a workspace to switch to it.
+
+#### Hot Corner to Toggle the Overview
+
+<sup>Since: 25.05</sup>
+
+Put your mouse at the very top-left corner of a monitor to toggle the overview.
+Also works during drag-and-dropping something.