How bra0/niri-mods works
niri-mods is a Linux daemon for niri that combines keyboard chord modes with Waybar visibility control. The main workflow is: Mod plus a leader enters a configured mode, grabs keyboards, and displays a binding hint; a bound key launches its command, while cancellation, timeout, or reload exits the mode and releases keyboards. The daemon also handles toggle requests and hot-reloads KDL configuration. Relationships below follow the excerpts and README; unsampled details of the shipped configuration and external programs are not expanded.
Main entry points: main.rs Event loop · keys.rs Keyboard reader · waybar.rs Waybar process · state.rs Event types
Components 12
Daemon runtime
- CLI
src/main.rs - Event loop
src/main.rs - Event types
src/state.rs - Socket control
src/ipc.rs - Config watcher
src/watch.rs
Keyboard input
- Keyboard reader
src/keys.rs
Modes and configuration
- KDL config
src/config.rs
Desktop integrations
- niri compositor
- Waybar process
src/waybar.rs - foot hint window
src/hint.rs
Other components
- User
- Linux keyboards
Connections 19
- User → CLI: runs command
README.md - CLI → Socket control: sends toggle
src/main.rs - CLI → Event loop: starts daemon
src/main.rs - Event loop → Socket control: starts listener
src/main.rs - Event loop → Keyboard reader: starts readers
src/main.rs - Event loop → Config watcher: starts polling
src/main.rs - Event loop → KDL config: loads and reloads
src/main.rs - Keyboard reader → Linux keyboards: reads events
src/keys.rs - Keyboard reader → Event types: sends key events
src/keys.rs - Socket control → Event types: sends toggle
src/ipc.rs - Config watcher → Event types: sends reload
src/watch.rs - Event loop → Event types: handles events
src/main.rs - Event loop → Keyboard reader: grabs and releases
src/main.rs - Event loop → KDL config: looks up modes
src/main.rs - Event loop → foot hint window: shows hint
src/main.rs - Event loop → niri compositor: spawns commands
src/main.rs - Event loop → Waybar process: controls visibility
src/main.rs - Waybar process → niri compositor: reloads config
src/waybar.rs - Waybar process → Waybar process: signals process
src/waybar.rs