noctalia-shell/CONFIG.md

Noctalia Configuration

Config file: $XDG_CONFIG_HOME/noctalia/config.toml (defaults to ~/.config/noctalia/config.toml)

Changes are hot-reloaded via inotify — no restart required.

A ready-to-use starting config with all defaults is at example.toml.

Notification daemon toggle: use [notification].enable_daemon (documented in config/services.md). Weather location visibility toggle: use [shell].show_location (documented in config/shell.md). Wallpaper automation: use [wallpaper.automation] (documented in config/wallpaper.md). Wallpaper single-color fallback/fill: use [wallpaper].fill_color (documented in config/wallpaper.md). Bar creation order: use [bar].order (documented in config/bar.md).

---

Reference

Section	Description
Bar	Bar layout, per-monitor overrides, auto-hide, widget capsule styling
Widgets	Widget definitions and all built-in widget types
Dock	Application dock — pinned apps, auto-hide, IPC
Desktop Widgets	Desktop overlay widgets — edit mode, state file format
Wallpaper	Wallpaper picker and overview backdrop
Theme	Color schemes, modes, wallpaper-derived palettes, app templates
Services	Audio, Sound cues, Brightness, Night Light, Weather, Idle, Notifications
Shell	Global UI settings, OSD, Keybinds, Hooks