ryan4yin | 二花
c277c81cd6
* feat(nixpak): sandbox six desktop apps * chore(nixpak): trim OBS plugin set * fix(nixpak): enable OBS on aarch64 * fix(nixpak): let imv read the full home directory * fix(home): drop redundant freerdp package * fix(nixpak): grant OBS access to V4L2 camera devices * fix(nixpak): expose V4L2 sysfs to OBS * fix(nixpak): expose NVIDIA encode library to OBS * docs(nixpak): record OBS interactive validation * docs(nixpak): record OBS RTMP validation * fix(nixpak): run MuseScore via XWayland and PulseAudio * docs(nixpak): explain app sandboxing rationale * fix(nixpak): route MuseScore ALSA through PipeWire
Base Desktop Environment Configuration
This directory contains base configurations for Linux desktop environments.
Overview
The configuration is split into modules:
- Desktop shell: Noctalia Shell
- Applications: desktop tools, browsers, editors, media players
- Development tools: IDEs and development utilities
- System integration: input methods, theming, XDG specifications, GPU settings
Noctalia
Noctalia (v5) is a native C++/Wayland desktop shell that replaces multiple separate tools. It is
installed through the upstream
programs.noctalia Home Manager
module.
Configuration
Noctalia merges every *.toml in the config directory (~/.config/noctalia/), sorted
alphabetically, and then layers the state directory's settings.toml on top:
| Layer | Location | Notes |
|---|---|---|
| Config | ~/.config/noctalia/*.toml |
Merged alphabetically; [include] supported; host-specific overrides |
| State | ~/.local/state/noctalia/settings.toml |
Written by the Settings UI; loads last and wins |
The shared baseline (noctalia/config/config.toml) is deployed as an out-of-store symlink, so
manual edits hot-reload without a home-manager switch. Noctalia never rewrites files in the config
layer, so volatile runtime data (wallpaper rotation, widget geometry) stays in the state file and
out of the repository.
noctalia config export prints the merged 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 upstreamprograms.noctaliamodule and symlinks the baseline out of store -
noctalia/config/config.toml: declarative baseline (v5 TOML), tracked in the repo and hot-reloadedCovers the 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, and clipboard.
-
hypridle/: Idle management
Desktop Environment
Input & Localization
fcitx5/: Fcitx5 input method with Rime (Chinese), Mozc (Japanese), and Hangul (Korean) enginesvinput/: Voice input onai(OpenVINO) andshoukei(CPU)
Applications
desktop-tools.nix: Wayland session tools (clipboard, brightness, screen recording, auto-mount, virt-manager/virt-viewer,wlogoutemergency fallback)browsers.nix: Web browsersmedia.nix: Audio control, mpv, go-musicfox, an image viewer, GPU video diagnostics, Zoom (x86_64 only), and EasyEffects loudness normalizationgaming.nix: Gaming applicationscreative.nix: Creative softwarenote-taking.nix: Note-taking apps
Development
dev-tools.nix: Android platform tools (android-tools)
System Utilities
misc.nix: Misc GUI apps (e-book reader, remote desktop, hardened IM clients)
Related Documentation
- Noctalia Shell: https://docs.noctalia.dev/noctalia/
- Parent:
../README.md