Files
nix-config/home/linux/gui/base
Ryan Yin 98fbf010b8 docs: fix broken links and editor references in readmes
- root README: VS Code config moved from home/linux/gui/base/editors.nix to vscode.nix
- READMEs now list both GUI editors (Zed, the primary one, plus VS Code)
- base README: xdg is a directory now, nvidia.nix no longer exists, editors.nix -> vscode.nix
- idols-ai README: disko-fs-media.nix -> disko-fs-data.nix (/persistent/data)
- secrets README: password-store moved from home/base/desktop to home/base/tui
- drop unused link definitions (AstroNvim, wl-clipboard, Catppuccin)
- fix a pre-existing typo flagged by the typos hook (keeped -> kept)
2026-09-19 15:23:09 +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

  • gtk.nix: GTK theme configuration
  • xdg/: XDG specifications

Input & Localization

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

Applications

Development

System Utilities