Skip to content
Shortcuts
niri

niri shortcuts

Key bindings for the niri scrollable-tiling Wayland compositor.

Generated from niri/dot-config/niri/binds.kdl by tools/gen-docs.py — run just docs-update to refresh. For the mouse-warp binds see also the wl-kbptr guide.

Mod is the Super key. Press Mod+Shift+/ to open these docs as a local web app.

Apps & launchers

KeysAction
Mod+Shift+SlashDotfiles Docs (local)
Mod+F1Keybinding Cheatsheet: Noctalia
Mod+TOpen a Terminal: ghostty
Mod+DRun an Application: Noctalia
Mod+SlashRun an Application: fuzzel
Super+Alt+LLock the Screen
Mod+EscapeMenu Power (press again: Tools)
Mod+Shift+EscapeMenu Just: dotfiles commands
Mod+EFile Manager: superfile
Mod+YFile Manager: yazi
Mod+Shift+CColor Picker: hyprpicker
Mod+Ctrl+NNotifications: toggle Do Not Disturb
Mod+XF86MonBrightnessUpExternal monitor brightness up (works on lock screen)
Mod+XF86MonBrightnessDownExternal monitor brightness down (works on lock screen)
Mod+Shift+Ctrl+SSwap Workspaces Between Monitors
Alt+TabRun noctalia msg window-switcher hold
Mod+PeriodEmoji Finder
Mod+VManage clipboard
Mod+BToggle Bar
PrintScreenshot region
Ctrl+PrintScreenshot monitor
Shift+PrintScreenshot and annotate

Mouse warp (wl-kbptr)

KeysAction
Mod+GMouse Warp: wl-kbptr
Mod+Shift+GMouse Warp + Click
Mod+Alt+GMouse Warp: coarse (tile only)
Mod+Ctrl+GMouse Warp: tile + split
Mod+AMouse Warp: other monitor
Mod+Shift+AMouse Warp + Click: other monitor
Mod+Alt+AMouse Warp: coarse, other monitor
Mod+Ctrl+AMouse Warp: tile + split, other monitor
Mod+NMouse Warp: bisect then tile
Mod+Shift+NMouse Warp + Click: bisect then tile
Mod+MMouse Warp: bisect then tile, other monitor
Mod+Shift+MMouse Warp + Click: bisect then tile, other monitor
Mod+XMouse Warp: detect + click (X-ray)
Mod+Shift+XMouse Warp: detect only

Media, volume & brightness

KeysAction
XF86AudioRaiseVolumeRun noctalia msg volume-up (works on lock screen)
XF86AudioLowerVolumeRun noctalia msg volume-down (works on lock screen)
XF86AudioMuteRun noctalia msg volume-mute (works on lock screen)
XF86AudioMicMuteRun noctalia msg mic-mute (works on lock screen)
XF86MonBrightnessUpRun noctalia msg brightness-up (works on lock screen)
XF86MonBrightnessDownRun noctalia msg brightness-down (works on lock screen)
XF86AudioNextRun playerctl next (works on lock screen)
XF86AudioPauseRun playerctl play-pause (works on lock screen)
XF86AudioPlayRun playerctl play-pause (works on lock screen)
XF86AudioPrevRun playerctl previous (works on lock screen)

Focus

KeysAction
Mod+LeftFocus column left
Mod+DownFocus window down
Mod+UpFocus window up
Mod+RightFocus column right
Mod+HFocus column left
Mod+LFocus column right
Mod+HomeFocus column first
Mod+EndFocus column last
Mod+WheelScrollRightFocus column right
Mod+WheelScrollLeftFocus column left
Mod+Shift+WheelScrollDownFocus column right
Mod+Shift+WheelScrollUpFocus column left

Moving windows & columns

KeysAction
Mod+Ctrl+LeftMove column left
Mod+Ctrl+DownMove window down
Mod+Ctrl+UpMove window up
Mod+Ctrl+RightMove column right
Mod+Ctrl+HMove column left
Mod+Ctrl+LMove column right
Mod+Ctrl+HomeMove column to first
Mod+Ctrl+EndMove column to last
Mod+Ctrl+WheelScrollRightMove column right
Mod+Ctrl+WheelScrollLeftMove column left
Mod+Ctrl+Shift+WheelScrollDownMove column right
Mod+Ctrl+Shift+WheelScrollUpMove column left
Mod+BracketLeftConsume or expel window left
Mod+BracketRightConsume or expel window right
Mod+CommaConsume window into column
Mod+Shift+CommaExpel window from column

Workspaces

KeysAction
Mod+JFocus window or workspace down
Mod+KFocus window or workspace up
Mod+Ctrl+JMove window down or to workspace down
Mod+Ctrl+KMove window up or to workspace up
Mod+Shift+Ctrl+UMove Workspace to Previous Monitor
Mod+Shift+Ctrl+IMove Workspace to Next Monitor
Mod+Page_DownFocus workspace down
Mod+Page_UpFocus workspace up
Mod+UFocus workspace down
Mod+IFocus workspace up
Mod+Ctrl+Page_DownMove column to workspace down
Mod+Ctrl+Page_UpMove column to workspace up
Mod+Ctrl+UMove column to workspace down
Mod+Ctrl+IMove column to workspace up
Mod+Shift+Page_DownMove workspace down
Mod+Shift+Page_UpMove workspace up
Mod+Shift+UMove workspace down
Mod+Shift+IMove workspace up
Mod+WheelScrollDownFocus workspace down (cooldown 150ms)
Mod+WheelScrollUpFocus workspace up (cooldown 150ms)
Mod+Ctrl+WheelScrollDownMove column to workspace down (cooldown 150ms)
Mod+Ctrl+WheelScrollUpMove column to workspace up (cooldown 150ms)
Mod+1Focus workspace 1
Mod+2Focus workspace 2
Mod+3Focus workspace 3
Mod+4Focus workspace 4
Mod+5Focus workspace 5
Mod+6Focus workspace 6
Mod+7Focus workspace 7
Mod+8Focus workspace 8
Mod+9Focus workspace 9
Mod+Ctrl+1Move column to workspace 1
Mod+Ctrl+2Move column to workspace 2
Mod+Ctrl+3Move column to workspace 3
Mod+Ctrl+4Move column to workspace 4
Mod+Ctrl+5Move column to workspace 5
Mod+Ctrl+6Move column to workspace 6
Mod+Ctrl+7Move column to workspace 7
Mod+Ctrl+8Move column to workspace 8
Mod+Ctrl+9Move column to workspace 9

Monitors

KeysAction
Mod+Shift+LeftFocus monitor left
Mod+Shift+DownFocus monitor down
Mod+Shift+UpFocus monitor up
Mod+Shift+RightFocus monitor right
Mod+Shift+HFocus monitor left
Mod+Shift+JFocus monitor down
Mod+Shift+KFocus monitor up
Mod+Shift+LFocus monitor right
Mod+Shift+Ctrl+LeftMove column to monitor left
Mod+Shift+Ctrl+DownMove column to monitor down
Mod+Shift+Ctrl+UpMove column to monitor up
Mod+Shift+Ctrl+RightMove column to monitor right
Mod+Shift+Ctrl+HMove column to monitor left
Mod+Shift+Ctrl+JMove column to monitor down
Mod+Shift+Ctrl+KMove column to monitor up
Mod+Shift+Ctrl+LMove column to monitor right

Layout & sizing

KeysAction
Mod+RSwitch preset column width
Mod+Shift+RSwitch preset window height
Mod+Ctrl+RReset window height
Mod+ZMaximize column
Mod+Shift+ZFullscreen window
Mod+Ctrl+ZExpand column to available width
Mod+CCenter column
Mod+Ctrl+CCenter visible columns
Mod+MinusSet column width -10%
Mod+EqualSet column width +10%
Mod+Shift+MinusSet window height -10%
Mod+Shift+EqualSet window height +10%
Mod+FToggle window floating
Mod+Shift+FSwitch focus between floating and tiling
Mod+WToggle column tabbed display

Screenshots & screencasting

KeysAction
Alt+PrintScreenshot window
Mod+PSet dynamic cast window
Mod+Ctrl+PSet dynamic cast monitor
Mod+Alt+PClear dynamic cast target

Session & misc

KeysAction
Mod+OToggle overview (no key-repeat)
Mod+QClose window
Mod+Alt+EscapeToggle keyboard shortcuts inhibit (never inhibited)
Mod+Shift+EQuit
Ctrl+Alt+DeleteQuit
Mod+Shift+PPower off monitors
zellijshell (fish)