Configuration🔗

Everything lives in ~/.config/triad/config.kdl. The file reloads on save. Split it across multiple files with include if it grows large.


Basics🔗

The config format, hot reload, modular includes, environment variables, startup commands, and the layout block.

Monitors🔗

Output modes, positions, scaling, VRR, reserved areas, and hotplug behavior.

Workspaces🔗

Naming workspaces, setting default layouts, pinning to outputs, dynamic creation, and moving workspaces between monitors.

Layouts🔗

The full layout reference: scroller, BSP, i3, frame-tree, algorithmic layouts, and custom Janet layouts.

Window Rules🔗

Match windows by app-id or title and control placement, floating state, workspace assignment, and sizing.

Key Bindings🔗

Keyboard, pointer, scroll wheel, and gesture bindings. Layout-scoped bindings and repeat behavior.

Input🔗

Keyboard XKB layout and repeat rate, touchpad settings, mouse acceleration, and cursor theme.

Shell Setup🔗

Configure Waybar, Quickshell, Noctalia, and DankMaterialShell. Shell profiles, niri-compat IPC, and watchdog fallback.