Gestures

Overview¶

There are several gestures in niri.

Also see the gestures configuration wiki page.

Mouse¶

Interactive Move¶

^{Since: 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: 25.01} Right click while moving to toggle between floating and tiling layout to put the window into.

Interactive Resize¶

^{Since: 0.1.6}

You can resize windows by holding Mod and the right mouse button.

Reset Window Height¶

^{Since: 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), and niri-initiated Mod + right click resizes.

Toggle Full Width¶

^{Since: 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), and niri-initiated Mod + right click resizes.

Horizontal View Movement¶

^{Since: 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¶

^{Since: 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.

All Pointing Devices¶

Drag-and-Drop Edge View Scroll¶

^{Since: 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.

Drag-and-Drop Edge Workspace Switch¶

^{Since: 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.

Drag-and-Drop Hold to Activate¶

^{Since: 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.

Hot Corner to Toggle the Overview¶

^{Since: 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.