Files
nix-config/home/linux/gui/README.md
T
Ryan Yin 001d180b22 feat(noctalia): upgrade to the native v5 shell
Noctalia v5 is the native C++/Wayland rewrite; the Quickshell-based v4 line (pkgs.noctalia-shell) is EOL and its JSON config is not migrated upstream.

- use the upstream home-manager programs.noctalia module (present at our pinned HM revision) instead of the hand-rolled package + symlink module: it installs pkgs.noctalia, validates config.toml at build time via checkConfig, and supports customPalettes; drop the v4 Qt/Qt6ct session setup
- replace the v4 settings.json/plugins.json with a minimal shared config.toml (font, Catppuccin shell palette, templates off, screenshot annotation, accessibility/bar scale, night light, wallpaper, location/weather); host-specific bits live in per-host files (shoukei's eDP-1 backlight in noctalia/host-shoukei.toml), which merge after config.toml. Application theming stays with catppuccin/nix
- treat config.toml as the single source of truth: do NOT persist ~/.local/state/noctalia and set setup_wizard_enabled = false, so UI tweaks are promoted back into the repo instead of accumulating in app-owned state
- port niri keybinds to 'noctalia msg ...', update spawn-at-startup and the backdrop layer namespace, fix the broken 'octalia-shell' media-previous bind, and replace the grim/slurp/satty screenshot stack with Noctalia's native region/fullscreen/annotate commands (drop the unused packages)
- drop the now-redundant swaybg and swaylock (Noctalia owns the wallpaper and lock screen, the latter authenticating against the PAM 'login' service) and its PAM entry; keep wlogout as an emergency fallback
- update hypridle's lock commands and the matching eval test
- refresh the noctalia docs
2026-09-19 15:07:54 +08:00

1.9 KiB

Desktop Environment Configurations

This directory contains desktop environment and window manager configurations managed by Home Manager.

Available Configurations

Window Managers

  • niri: Niri compositor configuration with custom settings, keybindings, spawn-at-startup rules, and window rules

Base Desktop Environment

  • base: Common desktop configurations shared across all environments, including:
    • Noctalia: native (v5) all-in-one Wayland desktop shell (replaces gammastep, swaylock, anyrun, mako, waybar, wallpaper-switcher, wlogout, grim/slurp/satty, and other desktop tools)
    • Creative tools and media applications
    • Development tools
    • Fcitx5 input method framework
    • Games and gaming utilities
    • GTK theme configurations
    • Immutable file handling
    • Note-taking applications
    • Wayland applications
    • XDG desktop configurations

Editor Configurations

  • editors: Text editor configurations and integrations

Why install Desktop Environments in Home Manager instead of NixOS Module?

  1. Configuration Location: Desktop environment configuration files are located in ~/.config, which can be easily managed by Home Manager.

  2. User-specific Services: User-specific systemd services (noctalia, fcitx5, hypridle, etc.) can be easily managed by Home Manager. If desktop environments were configured via NixOS Module, these user-level services might fail to start automatically. With Home Manager modules, we can control systemd service dependency order more effectively.

  3. System Benefits: By minimizing package installation through NixOS Module:

    • Makes the NixOS system more secure and stable
    • Increases portability to non-NixOS systems, as Home Manager can be installed on any Linux system
    • Allows for easier switching between different window managers without system-level changes