Skip to main content
There are several gestures in niri for different input devices.
Also see the gestures configuration page for customizing these behaviors.

​
Mouse

​
Interactive Move

Available since version 0.1.10
You can move windows by holding Mod and the left mouse button. You can customize the look of the window insertion preview in the insert-hint layout config.
Since version 25.01: Right click while moving to toggle between floating and tiling layout to put the window into.

​
Interactive Resize

Available since version 0.1.6
You can resize windows by holding Mod and the right mouse button.

​
Reset Window Height

Available since version 0.1.6
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)
  • Niri-initiated Mod + right click resizes

​
Toggle Full Width

Available since version 0.1.6
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)
  • Niri-initiated Mod + right click resizes

​
Horizontal View Movement

Available since version 0.1.6
Move the view horizontally by holding Mod and the middle mouse button (or the wheel) and dragging the mouse horizontally.

​
Workspace Switch

Available since version 0.1.7
Switch workspaces by holding Mod 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

​
Open and Close the Overview

Available since version 25.05
Open and close the overview with a four-finger vertical swipe.

​
All Pointing Devices

Available since version 25.02
Scroll the tiling view when moving the mouse cursor against a monitor edge during drag-and-drop (DnD). Also works on a touchscreen.
Available since version 25.05
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.
Available since version 25.05
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.
Available since version 25.05
Put your mouse at the very top-left corner of a monitor to toggle the overview. Also works during drag-and-dropping something.

Build docs developers (and LLMs) love

Get started for freeTalk to us