Config

Personal Linux workstation configuration.

Workflow

Bootstrap Home Manager with the repo flake:

make prepare

Check prerequisites for the non-bootstrap targets:

make doctor

Sync repo-managed files into place:

make sync

Apply the Home Manager configuration:

make switch

Do both in one step:

make apply

Day-to-Day

Show repo status:

make status

Reload Waybar after config or style changes:

make reload-waybar

Toggle Waybar visibility:

make toggle-waybar

niri-ctl

The bin/niri-ctl helper supports environment overrides for machine-specific values:

• NIRI_CTL_MONITOR_MAIN
• NIRI_CTL_MONITOR_PORTRAIT
• NIRI_CTL_MONITOR_SECONDARY
• NIRI_CTL_MONITOR_MAIN_MATCH
• NIRI_CTL_MONITOR_PORTRAIT_MATCH
• NIRI_CTL_PROJECTS_DIR
• NIRI_CTL_TERMINAL
• NIRI_CTL_EDITOR
• NIRI_CTL_IDE
• NIRI_CTL_BROWSER

Example:

NIRI_CTL_PROJECTS_DIR="$HOME/src" \
NIRI_CTL_BROWSER=firefox \
NIRI_CTL_MONITOR_SECONDARY=DP-1 \
niri-ctl project

Notes

• make sync installs the wallpaper to ~/.local/share/backgrounds/background.jpg.
• make prepare runs Home Manager directly from this repo using a path: flake reference and uses -b backup to preserve pre-existing conflicting files on first activation.
• make switch runs home-manager --impure switch.