NixOS Flake Configuration

Modular NixOS flake for a Ryzen 9950X3D desktop + MacBook Pro 9,2 laptop. Built on flake-parts with a myModules.* option namespace — every feature is an independent, toggleable module.

This README is a directory. Detail lives in docs/.

Hosts

• ryzen-9950x3d — Zen 5 workstation, RX 9070 XT, CachyOS-LTO kernel, VFIO-ready.
• macbook-pro-9-2 — Ivy Bridge laptop, xanmod base kernel + CachyOS-LTO specialisation.

Quick commands

nrb               # Build + switch current host
nrb --check       # Evaluate every config without building
nix flake check   # Full check suite including VM tests

Full operator reference + hook list in docs/BUILD.md.

Where things live

• parts/ — NixOS modules. One directory per concern. Layout + scope rules: docs/ARCHITECTURE.md.
• home/ — Home Manager modules. Parallel tree to parts/, auto-discovered.
• docs/ — human-readable documentation (linked below).
• repos/ — independent package repos (gitignored, see docs/REPO-STANDARD.md).

Documentation

Project standards — required reading before touching code:

• docs/STYLE.md — code conventions, option types, # Why: discipline on mkForce, §13a placement rule.
• docs/ARCHITECTURE.md — directory layout, parts-vs-home boundary, scope categories.
• docs/BUILD.md — nrb operator commands, formatters, all 12 pre-commit hooks, VM tests, doc auto-regen.

How-to / reference:

• docs/installation.md — BTRFS + LUKS + disko install, from live USB.
• docs/secure-boot.md — Lanzaboote enrollment + recovery.
• docs/SECRETS.md — sops-nix entry point.
• docs/NETWORKING.md — DNS, Portmaster, Mullvad interactions.
• docs/STORAGE-STRATEGY.md — MBP 9,2 dual-drive decision record.
• docs/TERMINAL-TOOLS.md — shell stack, aliases, key bindings.
• docs/PACKAGES.md — custom drivers, patched packages, scripts.
• docs/REPO-STANDARD.md — Nix Packaging Standard for repos/*-nix satellites.

Auto-generated (regenerated by the update-docs pre-commit hook from scripts/generate-readme-sections.nix + scripts/generate-docs.nix):

• docs/OPTIONS.md — full myModules.* reference (types, defaults, descriptions).
• The three sections below: Module Reference, Directory Layout, Flake Inputs.

Module Reference

NixOS modules (parts/)

Boot modules

Module	Description
boot	systemd-boot loader, Plymouth splash, and initrd configuration.
hibernate	generic suspend-to-disk via LUKS-encrypted swap partition.
impermanence	erase root filesystem on every boot, preserve only declared state.
kernel	custom kernel variant selector (xanmod, cachyos, zen, stock).

Desktop modules

Module	Description
displays	declarative monitor layout, resolution, and scaling configuration.
flatpak	Flatpak application sandbox runtime support.
plasma	KDE Plasma desktop environment with SDDM display manager.

Diagnostics modules

Module	Description
turbostat	Intel/AMD per-core frequency + C-state + thermal monitoring CLI.

Gaming modules

Module	Description
gamemode	Gamemode CPU/GPU optimisation daemon for foreground-game priority boosting.
gamescope	Gamescope micro-compositor for gaming (HDR, VRR, upscaling).
rocksmith	Rocksmith 2014 with WineASIO and RS_ASIO for low-latency guitar input.
steam	Steam with Proton-GE and steam-devices udev rules.

Hardware modules

Module	Description
acpid	ACPI event daemon for power button, lid, and hotkey handling.
bluetooth	BlueZ stack configuration with optional power-on-boot.
coolercontrol	CoolerControl fan and cooling device management daemon.
core	baseline hardware configuration (firmware, microcode updates).
cpu-amd	AMD CPU optimizations (microcode, P-state driver, performance governor).
cpu-intel	Intel CPU optimizations (microcode, intel_pstate, governor).
goxlr	GoXLR Mini audio mixer support (goxlr-utility daemon and udev).
gpu-amd	AMD Graphics (amdgpu) with Mesa/Vulkan and ROCm compute.
gpu-intel	Intel Graphics (i915) with Mesa and VA-API/QSV acceleration.
gpu-nvidia	NVIDIA proprietary driver and CUDA runtime.
graphics	base graphics support (Mesa, 32-bit libs, VA-API/VDPAU).
networking	NetworkManager, firewall, and hostname configuration.
pipewire	audio stack via PipeWire (ALSA, JACK, PulseAudio compatibility).
power	power management configuration (suspend, lid, button events).
udev-access	USB device access rules for development hardware (plugdev group).
upower	UPower battery and power monitoring daemon.
usb-power	disable USB autosuspend to prevent WiFi dropouts on USB wireless adapters.
usbmuxd	USB multiplexing daemon for iOS device support (iPhone/iPad tethering).

Host modules

Module	Description
host	typed per-host CPU capability declaration.

Input modules

Module	Description
ducky-one-x-mini	Ducky One X Mini keyboard HID access (udev rules for VIA/Vial).
libinput	touchpad/trackpad behaviour (natural scrolling, tap-to-click).
ratbagd	Piper mouse configuration tool and ratbagd service for programmable mice.
streamcontroller	StreamController (Elgato Stream Deck) support with udev rules.
yeetmouse	YeetMouse kernel mouse acceleration driver.

Macbook modules

Module	Description
hid-apple	Apple keyboard hid_apple configuration (fnMode, Option/Command swap).
mbpfan	mbpfan daemon for MacBook fan control via applesmc.
patches	out-of-tree kernel modules for MacBook hardware.
wifi	Broadcom BCM4331 WiFi via b43 driver (MacBook Pro 9,2).

Nix modules

Module	Description
nix	Nix daemon configuration, flakes, substituters, and garbage collection.
nix-ld	dynamic linker shim for running unpatched FHS binaries on NixOS.
remote-builder	offload nix builds from laptop → desktop (or similar).

Security modules

Module	Description
agenix	age-encrypted secret deployment via host SSH identities.
hardening	system-wide security hardening (kernel, sysctl, AppArmor).
portmaster	Portmaster privacy firewall with per-app network rules.
portmaster-mullvad-compat	preserves Mullvad's WireGuard fwmark across Portmaster's CONNMARK --restore-mark.
ssh	OpenSSH server with key-only auth and hardened crypto defaults.

Sensors modules

Module	Description
it87	ITE IT87xx Super I/O sensors (out-of-tree, 38+ chip models).
msr	x86 MSR access (APERF/MPERF, RAPL energy counters) via /dev/cpu/*/msr.
nct6775	Nuvoton NCT67xx Super I/O sensors (motherboard Vcore, fans, temps).
ryzen-smu	AMD ryzen_smu kernel module (Curve Optimizer, PBO, boost override).
zenpower	Zenpower5 AMD CPU sensors (replaces k10temp — Zen 1 through Zen 5).

Services modules

Module	Description
avahi	mDNS/zeroconf hostname resolution (.local) + service discovery.
cups	CUPS printing server with vendor drivers.
earlyoom	early OOM killer that prevents system freezes under memory pressure.
geoclue	GeoClue2 location service for automatic timezone and night-light.
mullvad	thin wrapper over Daaboulex/mullvad-vpn-nix nixosModules.default.
sunshine	Sunshine game streaming server (Moonlight-compatible).
syncthing	Syncthing continuous file synchronization across devices.

Storage modules

Module	Description
btrbk	incremental btrfs snapshot replication to secondary drive.
filesystems	universal filesystem support (ext4, btrfs, xfs, exfat, ntfs).
fstrim	periodic SSD TRIM timer for flash longevity.

Tuning modules

Module	Description
cachyos	CachyOS upstream tuning toggles (zram, IO schedulers, audio, THP, systemd).
corecycler	CoreCyclerLx device access (MSR, SMU sysfs, dmesg) for Curve Optimizer stability testing.
performance	general performance tuning (governor, swappiness, scheduler).
sysctls	extra performance sysctls (BBR, CAKE, tcp_fastopen, buffer sizes, max_map_count).

Users modules

Module	Description
users	primary user account, groups, and shell configuration.

Vfio modules

Module	Description
base	VFIO GPU passthrough base (libvirt, qemu, iommu, stealth VM management).
device-binding	VFIO PCI binding strategy (static vfio-pci.ids vs dynamic libvirt hooks).
evdev	evdev input passthrough for keyboard/mouse to VFIO guests.
hugepages	hugepage allocation for VM memory (allocated on VM start, freed on stop).
kvmfr	KVMFR shared memory for Looking Glass frame relay (zero-copy host/guest display).
session-gpu	KWIN_DRM_DEVICES primary-render GPU selection for safe passthrough.
vms	per-VM NixVirt definitions with GPU passthrough and libvirt hook generation.

Home-Manager modules (home/modules/)

Home-Manager modules

Module (option leaf)	Description
myModules.home.android	Android device connectivity (adb, fastboot)
myModules.home.antigravity	Google Antigravity with agy CLI wrapper.
myModules.home.anydesk	AnyDesk remote desktop client
myModules.home.archive	archive tools (zip, unzip, p7zip, unrar)
myModules.home.arkenfox	auto-download Arkenfox user.js for Firefox security hardening.
myModules.home.atuin	cross-machine shell history sync with full-text search.
myModules.home.azahar	Azahar 3DS emulator
myModules.home.bat	syntax-highlighted cat replacement with theme integration and MANPAGER hookup.
myModules.home.bluez-tools	bluez-tools Bluetooth CLI
myModules.home.brightnessctl	brightnessctl display brightness control
myModules.home.btop	resource monitor TUI with AMD GPU support and theme integration.
myModules.home.c-cpp	C/C++ tools (clang-tools)
myModules.home.chafa	chafa terminal image viewer
myModules.home.cifs-utils	CIFS/SMB filesystem utilities
myModules.home.claude-code	Claude Code AI assistant
myModules.home.cmake	CMake build system
myModules.home.codex-cli	Codex CLI AI assistant
myModules.home.comma	comma — run uninstalled programs via nix-index
myModules.home.coolercontrol	declarative fan/cooling configuration with optional GUI autostart.
myModules.home.corecycler	per-core CPU stability tester and PBO Curve Optimizer tuner.
myModules.home.csvlens	terminal CSV viewer with theme-derived color palette.
myModules.home.curl	HTTP client with user .curlrc configuration.
myModules.home.delta	syntax-highlighting git diff pager with theme integration.
myModules.home.devenv	devenv development environments
myModules.home.dig	dig, nslookup, host — classic DNS debug tools (bind.dnsutils)
myModules.home.direnv	per-directory environment loader with nix-direnv integration.
myModules.home.displays	display arrangement, toggle scripts, tiling activation, and systemd services.
myModules.home.dmidecode	dmidecode SMBIOS/DMI decoder
myModules.home.duf	duf modern disk free utility
myModules.home.durdraw	terminal ANSI/ASCII art animation editor with theme-derived palette.
myModules.home.dust	dust intuitive disk usage viewer
myModules.home.easyeffects	PipeWire audio effects processor (EQ, compressor, noise suppression).
myModules.home.eden	Eden Switch emulator with optional NX-Save-Sync integration.
myModules.home.elisa	KDE music player.
myModules.home.ethtool	ethtool Ethernet diagnostics
myModules.home.eza	modern ls replacement with theme-derived color scheme.
myModules.home.fastfetch	fastfetch system info display
myModules.home.ffmpeg	ffmpeg multimedia framework
myModules.home.flatpak	declarative Flatpak management via nix-flatpak with flathub remote.
myModules.home.fzf	fuzzy finder with ripgrep/fd integration and theme-derived colors.
myModules.home.gamescope	Valve's micro-compositor for gaming.
myModules.home.gcc	GCC compiler
myModules.home.gdb	GNU debugger with custom ~/.gdbinit and theme integration.
myModules.home.gemini-cli	Google Gemini terminal AI assistant with pinned-version selection.
myModules.home.git	git version control with GitHub CLI and delta pager integration.
myModules.home.glow	terminal markdown renderer with theme integration.
myModules.home.gnumake	GNU Make
myModules.home.goxlr	declarative GoXLR/GoXLR Mini mixer configuration (EQ, denoise, routing).
myModules.home.goxlr.denoise	pipewire RNNoise filter chain for GoXLR Chat Mic.
myModules.home.goxlr.eq	pipewire parametric EQ filter chains for GoXLR channels.
myModules.home.goxlr.toggle	script for switching between active and sleep GoXLR profiles.
myModules.home.gparted	GParted graphical partition editor
myModules.home.gpg	GnuPG with optional pinentry agent integration.
myModules.home.gtk	GTK theme configuration (Breeze Dark) with theme-module derived colors.
myModules.home.heroic	Heroic Games Launcher
myModules.home.htop	interactive process viewer with theme-aware color defaults.
myModules.home.hwinfo	hwinfo hardware information
myModules.home.hyperfine	hyperfine command-line benchmarking
myModules.home.ifuse	ifuse (FUSE mount for iOS devices)
myModules.home.inxi	inxi system information
myModules.home.iodiag	one-shot I/O pressure diagnostic snapshot.
myModules.home.iommu	helper script that lists IOMMU groups for PCI passthrough planning.
myModules.home.iotop	per-process disk I/O monitor (iotop-c: colorised modern fork).
myModules.home.iw	iw wireless configuration
myModules.home.jaeger	Jaeger all-in-one tracing backend (OTLP gRPC/HTTP + query UI) as user service.
myModules.home.jq	command-line JSON processor with theme-derived JQ_COLORS.
myModules.home.kate	KDE text editor with theme-derived font and settings.
myModules.home.kdotool	kdotool (xdotool for KDE Wayland)
myModules.home.kiro	FHS-wrapped Kiro IDE with optional CLI companion.
myModules.home.konsole	KDE terminal emulator with theme-derived colors and optional GPU acceleration.
myModules.home.lact	LACT AMD GPU overclocking/monitoring GUI
myModules.home.lazygit	terminal Git UI with theme-derived colors.
myModules.home.libimobiledevice	libimobiledevice (iOS device communication)
myModules.home.llmfit	llmfit LLM context window calculator
myModules.home.lm-sensors	lm_sensors hardware monitoring
myModules.home.lmstudio	LM Studio desktop app (stable/beta channel) with optional user daemon.
myModules.home.looking-glass	Looking Glass client for KVMFR frame relay
myModules.home.lsfg-vk	Vulkan frame generation via Lossless Scaling shim.
myModules.home.lshw	lshw hardware lister
myModules.home.lsof	lsof open files lister
myModules.home.macbook	HM ergonomics umbrella for Apple hardware.
myModules.home.macbook.dock	MacBook dock tweaks (remove virtual desktop pager on small screens).
myModules.home.macbook.keyboard	MacBook keyboard remap (Cmd→Ctrl via xkb).
myModules.home.macbook.workspaces	MacBook Mac-like virtual desktops (KWin Spaces emulation).
myModules.home.man-pages	Linux man pages
myModules.home.mangohud	Vulkan/OpenGL performance overlay with theme-derived colors.
myModules.home.mangojuice	MangoJuice GUI for MangoHud configuration
myModules.home.memtest-vulkan	memtest_vulkan GPU memory test
myModules.home.minicom	serial terminal emulator.
myModules.home.models	Models CLI — TUI for AI models, benchmarks, and coding agents
myModules.home.moonlight	Moonlight game streaming client
myModules.home.mullvad	thin wrapper over Daaboulex/mullvad-vpn-nix homeManagerModules.default.
myModules.home.nano	GNU nano text editor with theme-aware defaults.
myModules.home.neovim	Neovim text editor with nixd LSP host and theme integration.
myModules.home.neovim.lsp	Neovim language servers, formatters, snippets, direnv, treesitter.
myModules.home.neovim.ui	Neovim visual IDE polish (sidebar, bufferline, notifications, icons).
myModules.home.nil	nil Nix language server
myModules.home.nix-output-monitor	nix-output-monitor (nom) — pretty nix build output
myModules.home.nix-prefetch-git	nix-prefetch-git
myModules.home.nix-tree	nix-tree — explore Nix store dependency trees
myModules.home.node	Node.js environment
myModules.home.ns-usbloader	Nintendo Switch USB loader and NSP installer
myModules.home.nvd	nvd — Nix version diff between system generations
myModules.home.occt	OCCT stability test/benchmark
myModules.home.okular	KDE PDF viewer.
myModules.home.opencode	OpenCode AI terminal agent
myModules.home.openviking	OpenViking context database with configurable read-only search paths.
myModules.home.pastel	pastel color manipulation CLI
myModules.home.pciutils	pciutils (lspci)
myModules.home.piper	Piper mouse configuration tool
myModules.home.pkg-config	pkg-config build helper
myModules.home.plasma	KDE Plasma core packages, programs.plasma.enable, and app configFile entries.
myModules.home.plasma.appearance	Plasma workspace theme, KDE globals, window decorations, session restore.
myModules.home.plasma.input	Plasma input devices (keyboard, mouse, touchpad) and KRunner settings.
myModules.home.plasma.kwin	Plasma KWin virtual desktops, tiling, night light, effects, and overrides.
myModules.home.plasma.panels	Plasma bottom panel with all widgets (launcher, pager, tasks, tray, clock).
myModules.home.plasma.power	Plasma Powerdevil and KScreenLocker settings.
myModules.home.plasma.shortcuts	Plasma keyboard shortcut bindings.
myModules.home.powershell	PowerShell (pwsh)
myModules.home.powertop	powertop power analysis
myModules.home.prismlauncher	Prism Launcher for Minecraft
myModules.home.protonplus	ProtonPlus for managing Proton versions
myModules.home.pulsemixer	PipeWire/PulseAudio TUI mixer with theme integration.
myModules.home.python	Python environment
myModules.home.qpwgraph	qpwgraph PipeWire patchbay
myModules.home.radeontop	radeontop AMD GPU utilization monitor
myModules.home.radv	RADV Vulkan driver session variables (RADV_PERFTEST, device selection).
myModules.home.ripgrep	fast recursive search with theme-derived colors.
myModules.home.ryubing	Ryubing Switch emulator
myModules.home.saleae	Saleae Logic analyzer
myModules.home.samba	Samba SMB client and server tools
myModules.home.sd	sd intuitive find-and-replace (sed alternative)
myModules.home.sherlock	Sherlock username OSINT tool
myModules.home.smartmontools	smartmontools disk health (smartctl)
myModules.home.starship	cross-shell prompt with theme-aware styling.
myModules.home.streamcontroller	declarative Stream Deck page/key configuration via StreamController.
myModules.home.stress-ng	stress-ng stress testing
myModules.home.syncthing	Syncthing folder sync configuration with declarative folders and peer devices.
myModules.home.sysbench	sysbench system benchmark
myModules.home.sysdiag	system diagnostics helper script with theme-aware output.
myModules.home.sysdiag.sysdiag-script	Comprehensive NixOS system diagnostics script
myModules.home.sysstat	sar/iostat/pidstat performance monitoring toolkit.
myModules.home.tcpdump	tcpdump — network packet analyzer
myModules.home.tealdeer	tldr command cheatsheets with theme-derived colors.
myModules.home.testdisk	TestDisk/PhotoRec data recovery tools
myModules.home.theme	unified palette + font source for downstream modules (Breeze Dark base).
myModules.home.tidalcycles	TidalCycles live-coding environment with optional SuperDirt autostart.
myModules.home.tokei	tokei fast code statistics
myModules.home.tree	recursive directory listing with theme-derived LS_COLORS mapping.
myModules.home.usbutils	usbutils (lsusb)
myModules.home.virt-manager	virt-manager and virt-viewer VM management GUIs
myModules.home.vkbasalt	Vulkan post-processing overlay (CAS/FXAA/SMAA) with configurable shaders.
myModules.home.vkbasalt.shaders	ReShade + vkBasalt shader-collection helper (pure Nix, not a module).
myModules.home.vscode	VSCodium editor with theme-derived settings and font.
myModules.home.vulkan-tools	Vulkan and Mesa graphics diagnostic tools
myModules.home.wget	HTTP download client with user .wgetrc configuration.
myModules.home.wine	Wine installation with variant selection and optional Bottles frontend.
myModules.home.xdg	XDG user directory configuration (Downloads, Documents, etc.).
myModules.home.xh	xh friendly HTTP client (curl alternative)
myModules.home.yazi	terminal file manager with theme-derived colors.
myModules.home.yeetmouse	YeetMouse configuration GUI (requires NixOS yeetmouse driver).
myModules.home.zellij	terminal workspace/multiplexer with theme-derived colors.
myModules.home.zoxide	smart directory jumper (z/zi replacement for cd).
myModules.home.zsh	Zsh shell with custom functions, aliases, and theme-aware colors.

For full option details with types, defaults, and descriptions, see docs/OPTIONS.md (also auto-generated).

Directory Layout

parts/boot/boot.nix                                         # systemd-boot loader, Plymouth splash, and initrd configuration.
parts/boot/hibernate.nix                                    # generic suspend-to-disk via LUKS-encrypted swap partition.
parts/boot/impermanence.nix                                 # erase root filesystem on every boot, preserve only declared state.
parts/boot/kernel.nix                                       # custom kernel variant selector (xanmod, cachyos, zen, stock).
parts/desktop/displays.nix                                  # declarative monitor layout, resolution, and scaling configuration.
parts/desktop/flatpak.nix                                   # Flatpak application sandbox runtime support.
parts/desktop/plasma.nix                                    # KDE Plasma desktop environment with SDDM display manager.
parts/diagnostics/turbostat.nix                             # Intel/AMD per-core frequency + C-state + thermal monitoring CLI.
parts/gaming/gamemode.nix                                   # Gamemode CPU/GPU optimisation daemon for foreground-game priority boosting.
parts/gaming/gamescope.nix                                  # Gamescope micro-compositor for gaming (HDR, VRR, upscaling).
parts/gaming/rocksmith.nix                                  # Rocksmith 2014 with WineASIO and RS_ASIO for low-latency guitar input.
parts/gaming/steam.nix                                      # Steam with Proton-GE and steam-devices udev rules.
parts/hardware/acpid.nix                                    # ACPI event daemon for power button, lid, and hotkey handling.
parts/hardware/bluetooth.nix                                # BlueZ stack configuration with optional power-on-boot.
parts/hardware/coolercontrol.nix                            # CoolerControl fan and cooling device management daemon.
parts/hardware/core.nix                                     # baseline hardware configuration (firmware, microcode updates).
parts/hardware/cpu-amd.nix                                  # AMD CPU optimizations (microcode, P-state driver, performance governor).
parts/hardware/cpu-intel.nix                                # Intel CPU optimizations (microcode, intel_pstate, governor).
parts/hardware/goxlr.nix                                    # GoXLR Mini audio mixer support (goxlr-utility daemon and udev).
parts/hardware/gpu-amd.nix                                  # AMD Graphics (amdgpu) with Mesa/Vulkan and ROCm compute.
parts/hardware/gpu-intel.nix                                # Intel Graphics (i915) with Mesa and VA-API/QSV acceleration.
parts/hardware/gpu-nvidia.nix                               # NVIDIA proprietary driver and CUDA runtime.
parts/hardware/graphics.nix                                 # base graphics support (Mesa, 32-bit libs, VA-API/VDPAU).
parts/hardware/networking.nix                               # NetworkManager, firewall, and hostname configuration.
parts/hardware/pipewire.nix                                 # audio stack via PipeWire (ALSA, JACK, PulseAudio compatibility).
parts/hardware/power.nix                                    # power management configuration (suspend, lid, button events).
parts/hardware/udev-access.nix                              # USB device access rules for development hardware (plugdev group).
parts/hardware/upower.nix                                   # UPower battery and power monitoring daemon.
parts/hardware/usb-power.nix                                # disable USB autosuspend to prevent WiFi dropouts on USB wireless adapters.
parts/hardware/usbmuxd.nix                                  # USB multiplexing daemon for iOS device support (iPhone/iPad tethering).
parts/host.nix                                              # typed per-host CPU capability declaration.
parts/input/ducky-one-x-mini.nix                            # Ducky One X Mini keyboard HID access (udev rules for VIA/Vial).
parts/input/libinput.nix                                    # touchpad/trackpad behaviour (natural scrolling, tap-to-click).
parts/input/ratbagd.nix                                     # Piper mouse configuration tool and ratbagd service for programmable mice.
parts/input/streamcontroller.nix                            # StreamController (Elgato Stream Deck) support with udev rules.
parts/input/yeetmouse.nix                                   # YeetMouse kernel mouse acceleration driver.
parts/macbook/hid-apple.nix                                 # Apple keyboard hid_apple configuration (fnMode, Option/Command swap).
parts/macbook/mbpfan.nix                                    # mbpfan daemon for MacBook fan control via applesmc.
parts/macbook/patches.nix                                   # out-of-tree kernel modules for MacBook hardware.
parts/macbook/wifi.nix                                      # Broadcom BCM4331 WiFi via b43 driver (MacBook Pro 9,2).
parts/nix/nix-ld.nix                                        # dynamic linker shim for running unpatched FHS binaries on NixOS.
parts/nix/nix.nix                                           # Nix daemon configuration, flakes, substituters, and garbage collection.
parts/nix/remote-builder.nix                                # offload nix builds from laptop → desktop (or similar).
parts/security/agenix.nix                                   # age-encrypted secret deployment via host SSH identities.
parts/security/hardening.nix                                # system-wide security hardening (kernel, sysctl, AppArmor).
parts/security/portmaster-mullvad-compat.nix                # preserves Mullvad's WireGuard fwmark across Portmaster's CONNMARK --restore-mark.
parts/security/portmaster.nix                               # Portmaster privacy firewall with per-app network rules.
parts/security/ssh.nix                                      # OpenSSH server with key-only auth and hardened crypto defaults.
parts/sensors/it87.nix                                      # ITE IT87xx Super I/O sensors (out-of-tree, 38+ chip models).
parts/sensors/msr.nix                                       # x86 MSR access (APERF/MPERF, RAPL energy counters) via /dev/cpu/*/msr.
parts/sensors/nct6775.nix                                   # Nuvoton NCT67xx Super I/O sensors (motherboard Vcore, fans, temps).
parts/sensors/ryzen-smu.nix                                 # AMD ryzen_smu kernel module (Curve Optimizer, PBO, boost override).
parts/sensors/zenpower.nix                                  # Zenpower5 AMD CPU sensors (replaces k10temp — Zen 1 through Zen 5).
parts/services/avahi.nix                                    # mDNS/zeroconf hostname resolution (.local) + service discovery.
parts/services/cups.nix                                     # CUPS printing server with vendor drivers.
parts/services/earlyoom.nix                                 # early OOM killer that prevents system freezes under memory pressure.
parts/services/geoclue.nix                                  # GeoClue2 location service for automatic timezone and night-light.
parts/services/mullvad.nix                                  # thin wrapper over Daaboulex/mullvad-vpn-nix nixosModules.default.
parts/services/sunshine.nix                                 # Sunshine game streaming server (Moonlight-compatible).
parts/services/syncthing.nix                                # Syncthing continuous file synchronization across devices.
parts/storage/btrbk.nix                                     # incremental btrfs snapshot replication to secondary drive.
parts/storage/filesystems.nix                               # universal filesystem support (ext4, btrfs, xfs, exfat, ntfs).
parts/storage/fstrim.nix                                    # periodic SSD TRIM timer for flash longevity.
parts/tuning/cachyos.nix                                    # CachyOS upstream tuning toggles (zram, IO schedulers, audio, THP, systemd).
parts/tuning/corecycler.nix                                 # CoreCyclerLx device access (MSR, SMU sysfs, dmesg) for Curve Optimizer stability testing.
parts/tuning/performance.nix                                # general performance tuning (governor, swappiness, scheduler).
parts/tuning/sysctls.nix                                    # extra performance sysctls (BBR, CAKE, tcp_fastopen, buffer sizes, max_map_count).
parts/users.nix                                             # primary user account, groups, and shell configuration.
parts/vfio/base.nix                                         # VFIO GPU passthrough base (libvirt, qemu, iommu, stealth VM management).
parts/vfio/device-binding.nix                               # VFIO PCI binding strategy (static vfio-pci.ids vs dynamic libvirt hooks).
parts/vfio/evdev.nix                                        # evdev input passthrough for keyboard/mouse to VFIO guests.
parts/vfio/hugepages.nix                                    # hugepage allocation for VM memory (allocated on VM start, freed on stop).
parts/vfio/kvmfr.nix                                        # KVMFR shared memory for Looking Glass frame relay (zero-copy host/guest display).
parts/vfio/session-gpu.nix                                  # KWIN_DRM_DEVICES primary-render GPU selection for safe passthrough.
parts/vfio/vms.nix                                          # per-VM NixVirt definitions with GPU passthrough and libvirt hook generation.

home/modules/android/default.nix                            # Android device connectivity (adb, fastboot)
home/modules/antigravity/default.nix                        # Google Antigravity with `agy` CLI wrapper.
home/modules/anydesk/default.nix                            # AnyDesk remote desktop client
home/modules/archive/default.nix                            # archive tools (zip, unzip, p7zip, unrar)
home/modules/arkenfox/default.nix                           # auto-download Arkenfox user.js for Firefox security hardening.
home/modules/atuin/default.nix                              # cross-machine shell history sync with full-text search.
home/modules/azahar/default.nix                             # Azahar 3DS emulator
home/modules/bat/default.nix                                # syntax-highlighted cat replacement with theme integration and MANPAGER hookup.
home/modules/bluez-tools/default.nix                        # bluez-tools Bluetooth CLI
home/modules/brightnessctl/default.nix                      # brightnessctl display brightness control
home/modules/btop/default.nix                               # resource monitor TUI with AMD GPU support and theme integration.
home/modules/c-cpp/default.nix                              # C/C++ tools (clang-tools)
home/modules/chafa/default.nix                              # chafa terminal image viewer
home/modules/cifs-utils/default.nix                         # CIFS/SMB filesystem utilities
home/modules/claude-code/default.nix                        # Claude Code AI assistant
home/modules/cmake/default.nix                              # CMake build system
home/modules/codex-cli/default.nix                          # Codex CLI AI assistant
home/modules/comma/default.nix                              # comma — run uninstalled programs via nix-index
home/modules/coolercontrol/default.nix                      # declarative fan/cooling configuration with optional GUI autostart.
home/modules/corecycler/default.nix                         # per-core CPU stability tester and PBO Curve Optimizer tuner.
home/modules/csvlens/default.nix                            # terminal CSV viewer with theme-derived color palette.
home/modules/curl/default.nix                               # HTTP client with user .curlrc configuration.
home/modules/delta/default.nix                              # syntax-highlighting git diff pager with theme integration.
home/modules/devenv/default.nix                             # devenv development environments
home/modules/dig/default.nix                                # dig, nslookup, host — classic DNS debug tools (bind.dnsutils)
home/modules/direnv/default.nix                             # per-directory environment loader with nix-direnv integration.
home/modules/displays/default.nix                           # display arrangement, toggle scripts, tiling activation, and systemd services.
home/modules/dmidecode/default.nix                          # dmidecode SMBIOS/DMI decoder
home/modules/duf/default.nix                                # duf modern disk free utility
home/modules/durdraw/default.nix                            # terminal ANSI/ASCII art animation editor with theme-derived palette.
home/modules/dust/default.nix                               # dust intuitive disk usage viewer
home/modules/easyeffects/default.nix                        # PipeWire audio effects processor (EQ, compressor, noise suppression).
home/modules/eden/default.nix                               # Eden Switch emulator with optional NX-Save-Sync integration.
home/modules/elisa/default.nix                              # KDE music player.
home/modules/ethtool/default.nix                            # ethtool Ethernet diagnostics
home/modules/eza/default.nix                                # modern ls replacement with theme-derived color scheme.
home/modules/fastfetch/default.nix                          # fastfetch system info display
home/modules/ffmpeg/default.nix                             # ffmpeg multimedia framework
home/modules/flatpak/default.nix                            # declarative Flatpak management via nix-flatpak with flathub remote.
home/modules/fzf/default.nix                                # fuzzy finder with ripgrep/fd integration and theme-derived colors.
home/modules/gamescope/default.nix                          # Valve's micro-compositor for gaming.
home/modules/gcc/default.nix                                # GCC compiler
home/modules/gdb/default.nix                                # GNU debugger with custom ~/.gdbinit and theme integration.
home/modules/gemini-cli/default.nix                         # Google Gemini terminal AI assistant with pinned-version selection.
home/modules/git/default.nix                                # git version control with GitHub CLI and delta pager integration.
home/modules/glow/default.nix                               # terminal markdown renderer with theme integration.
home/modules/gnumake/default.nix                            # GNU Make
home/modules/goxlr/default.nix                              # declarative GoXLR/GoXLR Mini mixer configuration (EQ, denoise, routing).
home/modules/goxlr/denoise.nix                              # pipewire RNNoise filter chain for GoXLR Chat Mic.
home/modules/goxlr/eq.nix                                   # pipewire parametric EQ filter chains for GoXLR channels.
home/modules/goxlr/toggle.nix                               # script for switching between active and sleep GoXLR profiles.
home/modules/gparted/default.nix                            # GParted graphical partition editor
home/modules/gpg/default.nix                                # GnuPG with optional pinentry agent integration.
home/modules/gtk/default.nix                                # GTK theme configuration (Breeze Dark) with theme-module derived colors.
home/modules/heroic/default.nix                             # Heroic Games Launcher
home/modules/htop/default.nix                               # interactive process viewer with theme-aware color defaults.
home/modules/hwinfo/default.nix                             # hwinfo hardware information
home/modules/hyperfine/default.nix                          # hyperfine command-line benchmarking
home/modules/ifuse/default.nix                              # ifuse (FUSE mount for iOS devices)
home/modules/inxi/default.nix                               # inxi system information
home/modules/iodiag/default.nix                             # one-shot I/O pressure diagnostic snapshot.
home/modules/iommu/default.nix                              # helper script that lists IOMMU groups for PCI passthrough planning.
home/modules/iotop/default.nix                              # per-process disk I/O monitor (iotop-c: colorised modern fork).
home/modules/iw/default.nix                                 # iw wireless configuration
home/modules/jaeger/default.nix                             # Jaeger all-in-one tracing backend (OTLP gRPC/HTTP + query UI) as user service.
home/modules/jq/default.nix                                 # command-line JSON processor with theme-derived JQ_COLORS.
home/modules/kate/default.nix                               # KDE text editor with theme-derived font and settings.
home/modules/kdotool/default.nix                            # kdotool (xdotool for KDE Wayland)
home/modules/kiro/default.nix                               # FHS-wrapped Kiro IDE with optional CLI companion.
home/modules/konsole/default.nix                            # KDE terminal emulator with theme-derived colors and optional GPU acceleration.
home/modules/lact/default.nix                               # LACT AMD GPU overclocking/monitoring GUI
home/modules/lazygit/default.nix                            # terminal Git UI with theme-derived colors.
home/modules/libimobiledevice/default.nix                   # libimobiledevice (iOS device communication)
home/modules/llmfit/default.nix                             # llmfit LLM context window calculator
home/modules/lm-sensors/default.nix                         # lm_sensors hardware monitoring
home/modules/lmstudio/default.nix                           # LM Studio desktop app (stable/beta channel) with optional user daemon.
home/modules/looking-glass/default.nix                      # Looking Glass client for KVMFR frame relay
home/modules/lsfg-vk/default.nix                            # Vulkan frame generation via Lossless Scaling shim.
home/modules/lshw/default.nix                               # lshw hardware lister
home/modules/lsof/default.nix                               # lsof open files lister
home/modules/macbook/default.nix                            # HM ergonomics umbrella for Apple hardware.
home/modules/macbook/dock.nix                               # MacBook dock tweaks (remove virtual desktop pager on small screens).
home/modules/macbook/keyboard.nix                           # MacBook keyboard remap (Cmd→Ctrl via xkb).
home/modules/macbook/workspaces.nix                         # MacBook Mac-like virtual desktops (KWin Spaces emulation).
home/modules/man-pages/default.nix                          # Linux man pages
home/modules/mangohud/default.nix                           # Vulkan/OpenGL performance overlay with theme-derived colors.
home/modules/mangojuice/default.nix                         # MangoJuice GUI for MangoHud configuration
home/modules/memtest-vulkan/default.nix                     # memtest_vulkan GPU memory test
home/modules/minicom/default.nix                            # serial terminal emulator.
home/modules/models/default.nix                             # Models CLI — TUI for AI models, benchmarks, and coding agents
home/modules/moonlight/default.nix                          # Moonlight game streaming client
home/modules/mullvad/default.nix                            # thin wrapper over Daaboulex/mullvad-vpn-nix homeManagerModules.default.
home/modules/nano/default.nix                               # GNU nano text editor with theme-aware defaults.
home/modules/neovim/default.nix                             # Neovim text editor with nixd LSP host and theme integration.
home/modules/neovim/lsp.nix                                 # Neovim language servers, formatters, snippets, direnv, treesitter.
home/modules/neovim/ui.nix                                  # Neovim visual IDE polish (sidebar, bufferline, notifications, icons).
home/modules/nil/default.nix                                # nil Nix language server
home/modules/nix-output-monitor/default.nix                 # nix-output-monitor (nom) — pretty nix build output
home/modules/nix-prefetch-git/default.nix                   # nix-prefetch-git
home/modules/nix-tree/default.nix                           # nix-tree — explore Nix store dependency trees
home/modules/node/default.nix                               # Node.js environment
home/modules/ns-usbloader/default.nix                       # Nintendo Switch USB loader and NSP installer
home/modules/nvd/default.nix                                # nvd — Nix version diff between system generations
home/modules/occt/default.nix                               # OCCT stability test/benchmark
home/modules/okular/default.nix                             # KDE PDF viewer.
home/modules/opencode/default.nix                           # OpenCode AI terminal agent
home/modules/openviking/default.nix                         # OpenViking context database with configurable read-only search paths.
home/modules/pastel/default.nix                             # pastel color manipulation CLI
home/modules/pciutils/default.nix                           # pciutils (lspci)
home/modules/piper/default.nix                              # Piper mouse configuration tool
home/modules/pkg-config/default.nix                         # pkg-config build helper
home/modules/plasma/appearance.nix                          # Plasma workspace theme, KDE globals, window decorations, session restore.
home/modules/plasma/default.nix                             # KDE Plasma core packages, programs.plasma.enable, and app configFile entries.
home/modules/plasma/input.nix                               # Plasma input devices (keyboard, mouse, touchpad) and KRunner settings.
home/modules/plasma/kwin.nix                                # Plasma KWin virtual desktops, tiling, night light, effects, and overrides.
home/modules/plasma/panels.nix                              # Plasma bottom panel with all widgets (launcher, pager, tasks, tray, clock).
home/modules/plasma/power.nix                               # Plasma Powerdevil and KScreenLocker settings.
home/modules/plasma/shortcuts.nix                           # Plasma keyboard shortcut bindings.
home/modules/powershell/default.nix                         # PowerShell (pwsh)
home/modules/powertop/default.nix                           # powertop power analysis
home/modules/prismlauncher/default.nix                      # Prism Launcher for Minecraft
home/modules/protonplus/default.nix                         # ProtonPlus for managing Proton versions
home/modules/pulsemixer/default.nix                         # PipeWire/PulseAudio TUI mixer with theme integration.
home/modules/python/default.nix                             # Python environment
home/modules/qpwgraph/default.nix                           # qpwgraph PipeWire patchbay
home/modules/radeontop/default.nix                          # radeontop AMD GPU utilization monitor
home/modules/radv/default.nix                               # RADV Vulkan driver session variables (RADV_PERFTEST, device selection).
home/modules/ripgrep/default.nix                            # fast recursive search with theme-derived colors.
home/modules/ryubing/default.nix                            # Ryubing Switch emulator
home/modules/saleae/default.nix                             # Saleae Logic analyzer
home/modules/samba/default.nix                              # Samba SMB client and server tools
home/modules/sd/default.nix                                 # sd intuitive find-and-replace (sed alternative)
home/modules/sherlock/default.nix                           # Sherlock username OSINT tool
home/modules/smartmontools/default.nix                      # smartmontools disk health (smartctl)
home/modules/starship/default.nix                           # cross-shell prompt with theme-aware styling.
home/modules/streamcontroller/default.nix                   # declarative Stream Deck page/key configuration via StreamController.
home/modules/stress-ng/default.nix                          # stress-ng stress testing
home/modules/syncthing/default.nix                          # Syncthing folder sync configuration with declarative folders and peer devices.
home/modules/sysbench/default.nix                           # sysbench system benchmark
home/modules/sysdiag/default.nix                            # system diagnostics helper script with theme-aware output.
home/modules/sysdiag/sysdiag-script.nix                     # Comprehensive NixOS system diagnostics script
home/modules/sysstat/default.nix                            # sar/iostat/pidstat performance monitoring toolkit.
home/modules/tcpdump/default.nix                            # tcpdump — network packet analyzer
home/modules/tealdeer/default.nix                           # tldr command cheatsheets with theme-derived colors.
home/modules/testdisk/default.nix                           # TestDisk/PhotoRec data recovery tools
home/modules/theme/default.nix                              # unified palette + font source for downstream modules (Breeze Dark base).
home/modules/tidalcycles/default.nix                        # TidalCycles live-coding environment with optional SuperDirt autostart.
home/modules/tokei/default.nix                              # tokei fast code statistics
home/modules/tree/default.nix                               # recursive directory listing with theme-derived LS_COLORS mapping.
home/modules/usbutils/default.nix                           # usbutils (lsusb)
home/modules/virt-manager/default.nix                       # virt-manager and virt-viewer VM management GUIs
home/modules/vkbasalt/default.nix                           # Vulkan post-processing overlay (CAS/FXAA/SMAA) with configurable shaders.
home/modules/vkbasalt/shaders.nix                           # ReShade + vkBasalt shader-collection helper (pure Nix, not a module).
home/modules/vscode/default.nix                             # VSCodium editor with theme-derived settings and font.
home/modules/vulkan-tools/default.nix                       # Vulkan and Mesa graphics diagnostic tools
home/modules/wget/default.nix                               # HTTP download client with user .wgetrc configuration.
home/modules/wine/default.nix                               # Wine installation with variant selection and optional Bottles frontend.
home/modules/xdg/default.nix                                # XDG user directory configuration (Downloads, Documents, etc.).
home/modules/xh/default.nix                                 # xh friendly HTTP client (curl alternative)
home/modules/yazi/default.nix                               # terminal file manager with theme-derived colors.
home/modules/yeetmouse/default.nix                          # YeetMouse configuration GUI (requires NixOS yeetmouse driver).
home/modules/zellij/default.nix                             # terminal workspace/multiplexer with theme-derived colors.
home/modules/zoxide/default.nix                             # smart directory jumper (z/zi replacement for cd).
home/modules/zsh/default.nix                                # Zsh shell with custom functions, aliases, and theme-aware colors.

Flake Inputs

• NixVirt
• agenix
• antigravity
• cachyos-settings-nix
• claude-code
• coolercontrol
• disko
• durdraw-nix
• eden
• flake-parts
• gemini-cli-nix
• git-hooks-nix
• goxlr-hm-nix
• home-manager
• impermanence
• lanzaboote
• linux-corecycler
• lmstudio
• lsfg-vk
• mesa-git-nix
• models-nix
• mullvad-vpn-nix
• nix-cachyos-kernel
• nix-flatpak
• nix-vscode-extensions
• nixpkgs
• nx-save-sync
• occt-nix
• openviking
• plasma-manager
• portmaster
• ripgrep-nix
• rocksmith-nix
• sops-nix
• streamcontroller-nix
• tidalcycles
• treefmt-nix
• vfio-stealth
• vkbasalt-overlay
• yeetmouse-nix

Total: 40 flake inputs. Run nix flake metadata for pinned revisions + URLs.

---

Auto-generated sections above regenerate from the live flake tree via the update-docs pre-commit hook. Source: scripts/generate-readme-sections.nix. No manual maintenance — every new module, input, or rename propagates on commit.