Files
nixos-setup/configs/ABOUTME.md
T
2026-09-08 16:26:22 -04:00

38 lines
2.2 KiB
Markdown

# configs/
Application configuration files that are symlinked into `~/.config/` via
`system.userActivationScripts` (using `skygUtils.makeHyperlinkScriptToConfigs`
from `modules/skyg-utils.nix`).
Most entries link `~/.config/<name>` -> `configs/<name>`. Some are host-scoped
and live under `configs/<hostName>/` — e.g. the Hyprland module links
`~/.config/hypr` -> `configs/<hostName>/hypr` (defaulting to the machine's
hostName). `makeHyperlinkScriptToConfigs` takes an optional `targetPath` for
these cases where the source subdir and `~/.config` target differ.
## Contents
| Path | Description |
|---|---|
| `niri/` | Niri Wayland compositor config |
| `fwbook/hypr/` | Hyprland config for `fwbook` (scrolling layout + noctalia); linked to `~/.config/hypr` |
| `hl-fwdesk/hypr/` | Hyprland config for `hl-fwdesk` (Steam console); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/hypr/` | Hyprland config for `hl-pi1` (clock box); linked to `~/.config/hypr` |
| `hl-fws1/hypr/` | Hyprland config for `hl-fws1` (remote slim desktop); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/quickshell/` | Quickshell configs for `hl-pi1` (full-screen clock + calendar); linked to `~/.config/quickshell` |
| `fwbook/quickshell/` | Quickshell configs for `fwbook` (scrolling overview); linked to `~/.config/quickshell` |
| `extra.nu` | Extra NuShell config sourced at shell startup |
| `fwbook.knsv` | fwbook-specific Kanshi display profile |
| `libinput-gestures.conf` | Touchpad gesture bindings |
| `hypr-types/hl.lua` | Shared EmmyLua type stubs for the `hl` global; each host's Hyprland `.luarc.json` points here via `workspace.library` |
## Notes
- Changes here take effect on next login or when the activation script runs
- These are **not** NixOS options — they are plain config files managed as repo content
- The symlink mechanism is defined in `modules/skyg-utils.nix`
- Hosts can embed their config in the build by setting
`configLink.mountAsSource = true`; the dir is then read from the flake's
store path (`skyg.rootDir`) instead of the live `~/nixos-setup/configs`
checkout. See `modules/nixos/desktop/tiler/hyprland.nix`.