Frank
02883d3ed2
Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
1.6 KiB
1.6 KiB
type, title, description, tags, verified
| type | title | description | tags | verified | ||||
|---|---|---|---|---|---|---|---|---|
| reference | Niri Key Bindings Syntax | Configuration syntax for niri key bindings — KDL format, modifiers, bind options, and finding key names with wev. |
|
2026-08-28 |
Key Bindings Syntax
Key bindings go in the binds {} section of the config file (~/.config/niri/config.kdl):
binds {
Mod+T { spawn "alacritty"; }
Mod+Left { focus-column-left; }
}
Modifiers
CtrlorControlShiftAltSuperorWinISO_Level3_ShiftorMod5(AltGr)ISO_Level5_Shift(for lv5 options likelv5:caps_switch)Mod— Special: equalsSuperon TTY, equalsAltin nested window
Bind Options
binds {
Mod+T repeat=false { spawn "alacritty"; } // Do not repeat on hold
Mod+T cooldown-ms=500 { spawn "alacritty"; } // Rate-limit
Super+Alt+L allow-when-locked=true { spawn "swaylock"; } // Works when locked
Mod+Q hotkey-overlay-title="Close Window" { close-window; } // Custom title in overlay
Mod+Escape allow-inhibiting=false { ... } // Always works (even with inhibitors)
}
Finding Key Names
Use wev to find XKB key names:
wev
# Then press the key you want to bind — look at `sym: XXXX` in output
Shifted keys require Shift + the unshifted key (for example, Mod+Shift+Comma for < on US QWERTY).
Related
- Default Key Bindings — What niri ships with out of the box
- Action Reference — All available actions