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.

View Movement

^{Since: 0.1.6}

Move the view by holding Mod and the middle mouse button (or the wheel) and dragging along the tiling main axis. By default this is horizontal; with layout.main-axis "vertical", this becomes vertical.

Workspace Switch

^{Since: 0.1.7}

Switch workspaces by holding Mod and the middle mouse button (or the wheel) and dragging perpendicular to the tiling main axis. By default this is vertical; with layout.main-axis "vertical", this becomes horizontal.

Touchpad

Workspace Switch

Switch workspaces with three-finger swipes perpendicular to the tiling main axis. By default this is a vertical swipe; with layout.main-axis "vertical", this is horizontal.

View Movement

Move the view with three-finger swipes along the tiling main axis. By default this is horizontal; with layout.main-axis "vertical", this is vertical.

Open and Close the Overview

^{Since: 25.05}

Open and close the overview with a four-finger vertical swipe.

Touchscreen

Interactive Move

^{Since: 0.1.10}

You can move windows by holding Mod and dragging the window with your finger.

Dragging a tiled window horizontally will scroll the view instead.

You can customize the look of the window insertion preview in the insert-hint layout config.

^{Since: 25.11} Tap with a second finger while moving to toggle between floating and tiling layout to put the window into.

Tablet

Interactive Move

^{Since: next release}

You can move windows by holding Mod and dragging the window with a tablet pen.

Dragging a tiled window horizontally will scroll the view instead.

You can customize the look of the window insertion preview in the insert-hint layout config.

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 along the overview strip when moving the mouse cursor against the relevant 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.