Overview
This section documents Noctalia: a lightweight Wayland implementation in C++ and OpenGL ES.
The v5 docs are still being built out. Start with How configuration works if you want to understand where settings live and which file wins when the GUI and your config both set the same option.
Topics
Section titled “Topics”- How configuration works - Config files, GUI-managed overrides, load order, and hot reload.
- Shell - Global UI scale, fonts, animations, shadows, OSD, keybinds, and hooks.
- Launcher - Application search, calculator, emoji picker, and wallpaper browser.
- Bars - Top, bottom, left, and right bars, including per-monitor changes.
- Widgets - The clock, tray, volume, workspaces, media, and other things you place inside a bar.
- Dock - Optional app dock, pinned apps, running apps, and auto-hide.
- Desktop widgets - On-desktop widgets, edit mode, and state file layout.
- Wallpaper & backdrop - Wallpaper folders, automation, per-monitor choices, and overview backdrop.
- Theme - Built-in themes, wallpaper colors, dark/light mode, and shell color roles.
- Services - Audio, brightness, night light, weather, idle behavior, and notifications.
- IPC - Commands for keybinds, scripts, automation, and hooks.
- Scripted widgets - Advanced custom bar widgets written in Luau.
On the Quickshell-based v4 line? See the overview and installation.