Kenan's NixOS Configuration Suite

NixOS Configuration Suite (nixosc) - Snowfall Edition

A comprehensive, declarative, and modular NixOS configuration built on Snowfall Lib. It manages both system (NixOS) and user (Home Manager) layers from a single flake, featuring a highly customized Wayland desktop environment.

• Architecture: Snowfall Lib (auto module discovery)
• Desktop:
  • Niri (Primary): Scrollable-tiling compositor, powered by niri-flake for build-time config validation and binary caching.
  • Hyprland (Secondary): Dynamic tiling compositor with extensive customization.
  • GNOME: Fallback session.
• Shell / Panel: DankMaterialShell (DMS) integration for panels, widgets, and lock screen.
• Greeter: greetd + DMS Greeter (dms-greeter) support.
• Theme: Catppuccin (Mocha) end-to-end integration.
• Secrets: SOPS-Nix (Age) for secure credential management.

The repository follows the Snowfall Lib layout, where modules are automatically discovered and imported.

.
├── flake.nix             # Core configuration & inputs
├── install.sh            # Unified installation & management tool
├── systems/              # ❄️ Host configurations (hardware-specific)
│   ├── hay/              # Workstation (Laptop)
│   └── vhay/             # Virtual Machine profile
├── modules/              # 🍱 Modular configs
│   ├── nixos/            # System-level modules (services, hardware, greeters)
│   └── home/             # User-level modules (apps, WMs, shell config)
│       ├── niri/         # Modular Niri config (binds, rules, settings)
│       ├── hyprland/     # Modular Hyprland config
│       └── dms/          # DankMaterialShell configuration
├── homes/                # Home-Manager profiles per host/user
├── overlays/             # 🔧 Nixpkgs overlays
└── secrets/              # 🔐 SOPS-encrypted secrets

git clone https://github.com/kenanpelit/nixosc ~/.nixosc
cd ~/.nixosc

Use the helper script to build and switch configurations:

# For Physical Machine (hay)
./install.sh install hay

# For Virtual Machine (vhay)
./install.sh install vhay

To update flake inputs (including Niri unstable):

./install.sh update

• Modifier: Super (Windows Key)
• General:
  • Super + Enter -> Terminal (Kitty)
  • Super + Q -> Close Window
  • Super + F -> Maximize Column / Shift+F Fullscreen
  • Super + Space -> DMS Spotlight (Launcher)
  • Super + Tab -> Recent Windows (Alt-Tab switcher)
• Navigation:
  • Super + Arrows or h/j/k/l -> Move focus
  • Super + Shift + Arrows -> Move window
  • Super + Wheel -> Scroll workspaces
• DMS Features:
  • Super + C -> Control Center
  • Super + N -> Notifications
  • Alt + L -> Lock Screen (DMS Lock)

• Modifier: Super
• Same core navigation bindings (h/j/k/l).
• Super + F -> Toggle Float
• Super + G -> Toggle Group
• Super + Tab -> DMS Hypr Overview

Both Niri and Hyprland configurations are split into granular Nix files for better maintainability:

• binds.nix: Keybindings
• rules.nix: Window & Layer rules
• settings.nix: Core compositor settings
• variables.nix: Environment variables & theming constants

This repo includes a custom power management stack for laptops (especially Intel HWP / intel_pstate=active) that aims to stay consistent across boot/suspend/AC changes and avoid “mystery overrides”.

• Module: modules/nixos/power/default.nix
• Status CLI: osc-system status (use sudo osc-system turbostat-quick to validate real CPU MHz under HWP)
• Note: Under Intel HWP, scaling_cur_freq can report ~400MHz even when the CPU is busy; prefer turbostat for truth.

On physical hosts, the module manages:

• ACPI Platform Profile (/sys/firmware/acpi/platform_profile)
• CPU governor (policy-level scaling_governor)
• Intel EPP (HWP energy preference; policy-level energy_performance_preference)
• Minimum performance floor (/sys/devices/system/cpu/intel_pstate/min_perf_pct)
• RAPL power limits (MSR interface via /sys/class/powercap/intel-rapl:0)
• Thermal guard that clamps PL1/PL2 when package temp crosses thresholds
• Drift guard (power-policy-guard) to re-apply settings if firmware/other services revert them shortly after boot/resume

The main units you’ll see on a running system:

• platform-profile.service
• cpu-governor.service
• cpu-epp.service
• cpu-min-freq-guard.service
• rapl-power-limits.service
• rapl-thermo-guard.service
• battery-thresholds.service
• power-policy-guard.service

To re-apply everything after changes or debugging:

sudo osc-system profile-refresh

This module disables power-profiles-daemon to prevent it from overriding platform profile / EPP / governor after boot. If you use other power tools (e.g. tlp, auto-cpufreq, thermald), double-check that they are not fighting your policy.

• Themes: Automatically managed by DMS/Matugen or manually pinned via settings.nix.
• Plugins: Installed via imperative dms-plugin-sync service (best-effort).
• Greeter: Fully supported via modules/nixos/dms-greeter.

• Niri Config Validation: If the build fails with a KDL error, check modules/home/niri/default.nix. The config is validated at build time!
• Keyring/PAM: If you see gkr-pam errors in logs, ensure seahorse shows the Login keyring as unlocked. It usually works despite the log noise.
• Discord: Use WebCord for better Wayland support if standard Discord crashes.

This project is licensed under the MIT License - see the LICENSE file for details.