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.
Open and Close the Overview
Since: 25.05
Open and close the overview with a four-finger vertical swipe.
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.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Usage
- Getting Started
- Example systemd Setup
- Important Software
- Workspaces
- Floating Windows
- Tabs
- Overview
- Screencasting
- Layer‐Shell Components
- IPC,
niri msg
- Application-Specific Issues
- Nvidia
- Xwayland
- Gestures
- Packaging niri
- Integrating niri
- Accessibility
- Name and Logo
- FAQ
Configuration
- Introduction
- Input
- Outputs
- Key Bindings
- Switch Events
- Layout
- Named Workspaces
- Miscellaneous
- Window Rules
- Layer Rules
- Animations
- Gestures
- Debug Options
- Include