---
name: noctalia-reference
description: "Quick reference for Noctalia desktop environment: config paths, IPC commands, app templates, palette, and migration checklist for Niri-based setups."
---

# Noctalia Desktop Environment

Noctalia is a Niri-based desktop environment at `/usr/bin/noctalia`.

## Config
- Main: `~/.config/noctalia/config.toml`
- Niri config: includes `noctalia.kdl` for display settings

## IPC
Direct `noctalia msg <command>` replaces `qs -c noctalia-shell ipc call` wrapper.
Key commands: `panel-toggle`, `session`, `lock`, `launcher`.

## App Templates
`/usr/share/noctalia/assets/templates/` contains: gtk, ghostty, alacritty, hyprland, sway, wezterm, helix, btop, starship, qt, kde, cava, scroll, mango, umbriel, foot, emacs, kitty.

## Palette
Generate from image: `noctalia theme [image]`

## Migration Checklist
- [ ] Niri keybinds → `noctalia msg` commands
- [ ] Alacritty → import noctalia.toml theme
- [ ] Ghostty → `theme = noctalia`
- [ ] GTK 3/4 → update accent palette (#b267e4 purple)

## Text Antialiasing
- **Ghostty**: `font-subpixel-render = "off"` to disable subpixel AA
- **Alacritty**: `font.antialias = false` in `alacritty.toml`