Files
nix-config/home/linux/gui/base
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
..

Base Desktop Environment Configuration

This directory contains base configurations for Linux desktop environments, providing essential components for a complete Wayland desktop experience.

Overview

The configuration is organized into modular components that can be selectively enabled:

  • Desktop Shell: Noctalia Shell for unified desktop environment
  • Applications: Desktop tools, browsers, editors, media players, etc.
  • Development Tools: IDEs and development utilities
  • System Integration: Input methods, theming, XDG specifications, GPU settings

Noctalia

Noctalia (v5) is a native C++/Wayland all-in-one desktop shell that replaces multiple separate tools with a single, unified solution. It is installed and configured through the upstream programs.noctalia Home Manager module, which validates the TOML at build time.

Configuration

Noctalia merges every *.toml in the config directory (~/.config/noctalia/), sorted alphabetically, and then layers the Settings UI's own overrides on top:

Layer Location Notes
Declarative baseline ~/.config/noctalia/*.toml (repo: noctalia/config/config.toml) Merged alphabetically; [include] supported
GUI overrides ~/.local/state/noctalia/settings.toml Written by the Settings UI; loads last and wins

noctalia config export merged prints the effective user config and noctalia config validate checks a file. Application theming stays with catppuccin/nix, so Noctalia's theme templates are disabled.

Component Replacement

Noctalia consolidates functionality that previously required multiple tools:

Traditional Component Purpose Noctalia counterpart
gammastep Blue light filter [nightlight]
swaylock Screen locker built-in lock screen ([lockscreen])
anyrun Application launcher launcher panel ([shell.launcher])
mako Notification daemon [notification]
waybar Status bar [bar] + [widget.*]
wallpaper-switcher Wallpaper management [wallpaper]
wlogout Session menu [shell.session]
wl-clipboard Clipboard management built-in clipboard (encrypted history)
grim/slurp/satty Screenshots + annotation built-in [shell.screenshot] + annotation editor

Configuration Modules

Desktop Shell

  • noctalia/default.nix: enables the upstream programs.noctalia module

  • noctalia/config/config.toml: declarative baseline (v5 TOML)

    Key features: bar and widgets, control center, desktop widgets, night light, wallpaper, session panel, screenshots with annotation, system monitor, audio/volume, brightness, calendar/weather, color schemes, dock, notifications, OSD, clipboard, and more.

  • hypridle/: Idle management

Desktop Environment

Input & Localization

  • fcitx5/: Fcitx5 input method with Mozc (Japanese input)

Applications

Development

System Utilities