docs(DE): full redesign sweep — desk profiles, keybinds, noctalia v5, handy fleet wiring, incident log

- niri: index/config-tree rework, displays.md desk-profile rewrite,
  tips/action-reference/default-bindings refresh (26.04),
  generated keybindings.md (119 bindings)
- noctalia-shell.md: settings.toml lives in ~/.local/state, taskbar
  widget, v5 keybind table (Mod+D/Mod+V/Alt+Tab)
- handy.md: NEW; live nested store shape, fleet endpoint, known
  thinking-model empty-content breaker + verified cure
- log.md: DE redesign entry + pam_faillock sudo-lockout incident
This commit is contained in:
Frank committed 2026-10-09 14:42:08 -07:00
1 parent 37554b0fb0
commit b441cfda56
10 files changed
+974 -166

No files matched your search

+42 -6
View File
@@ -1,16 +1,18 @@
---
type: reference
title: Niri Action Reference
description: Complete reference of all available niri actions — window operations, focus, movement, spawning, and system actions.
description: Curated reference of niri actions — window operations, focus, movement, spawning, and system actions. For complete command-line options, see `niri msg action <ACTION> --help`.
tags:
- niri
- actions
- reference
verified: 2026-08-28
verified: 2026-10-09
---
# Action Reference
> **Note:** This is a curated subset. For complete options and parameters, run `niri msg action <ACTION> --help` (authoritative, live).
## Window/Column Actions
- `close-window` — Close focused window
@@ -55,15 +57,49 @@ verified: 2026-08-28
- `spawn "program"` — Run program (no shell expansion)
- `spawn-sh "command"` — Run command through shell
- `spawn-at-startup "program"` — Run at startup
- `quit` — Quit compositor (with confirmation)
- `quit` — Quit compositor (with confirmation, `--skip-confirmation` available)
- `show-hotkey-overlay` — Show keybind cheat sheet
- `toggle-overview` — Toggle overview
- `screenshot` — Interactive screenshot
- `screenshot-screen` — Screenshot monitor
- `screenshot-window` — Screenshot window
- `screenshot-screen` — Screenshot monitor (`--write-to-disk`, `--show-pointer` options)
- `screenshot-window` — Screenshot window (`--write-to-disk`, `--show-pointer` options)
- `power-off-monitors` — Turn off displays
- `toggle-keyboard-shortcuts-inhibit` — Toggle inhibitor
- `do-screen-transition` — Smooth screen transition (for theme switching)
- `do-screen-transition` — Smooth screen transition (for theme switching, `--delay-ms` option)
- `stop-cast --session-id <ID>` — Stop a PipeWire screencast
- `toggle-window-rule-opacity` — Toggle opacity of focused window
- `focus-column-or-monitor-left/right` — Focus column or monitor horizontally
- `focus-column-or-monitor-up/down` — Focus column or monitor vertically
- `focus-window-or-monitor-up/down` — Focus window or monitor vertically
- `focus-window-or-monitor-down/up` — Focus window or monitor vertically
- `focus-column-or-monitor-left/right` — Focus column or monitor horizontally
- `focus-window-or-monitor-down/up` — Focus window or monitor vertically
- `focus-window-or-workspace-down/up` — Focus window or workspace vertically
- `focus-window-or-workspace-up/down` — Focus window or workspace vertically
## Bind Properties
Actions and bindings support optional properties:
| Property | Description |
|----------|-------------|
| `repeat=false` | Disable repeat for the binding |
| `cooldown-ms=N` | Rate-limit to N milliseconds (commonly 150 for wheel binds) |
| `allow-when-locked=true` | Execute even when session is locked |
| `allow-inhibiting=false` | Process even when inhibitor is active |
| `hotkey-overlay-title="..."` | Custom title for overlay (supports `=null` to hide or Pango markup) |
### Mod+Mouse* Binds (25.01+)
Since 25.01, `Mod+Mouse*` binds are supported for advanced navigation.
### TouchpadScroll Binds
`Mod+TouchpadScroll*` binds are available for touchpad-based navigation.
### Mouse-Click Binds
Mouse-click actions operate on the **focused window**, not the clicked window.
## Related