Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

programs.noctalia.enable

Whether to enable noctalia, a lightweight Wayland shell and bar.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.noctalia.package

The noctalia package to use.

Type: null or package

Default:

pkgs.noctalia

Declared by:

programs.noctalia.checkConfig

Validate the configuration file at build time.

Type: boolean

Default:

true

Declared by:

programs.noctalia.customPalettes

Custom color palettes, keyed by name. Each value can be:

  • A Nix attrset (converted to JSON)
  • A raw JSON string
  • A path to a .json file

See https://docs.noctalia.dev/v5/theming/#custom_palette.

Type: attribute set of (JSON value or string or absolute path)

Default:

{ }

Declared by:

programs.noctalia.settings

Default settings for noctalia, can be written as:

  • A Nix attrset (converted to TOML via nixpkgs’ tomlFormat)
  • A raw TOML string
  • A path to a .toml file

See https://docs.noctalia.dev/v5 for more information and examples.

Note: these settings can still be overwritten at runtime via the settings menu.

Type: TOML value or string or absolute path

Default:

{ }

Example:

{
  shell = {
    font = "JetBrainsMono Nerd Font";
    settings_show_advanced = true;
  };

  theme = {
    mode = "dark";
    source = "builtin";
    builtin = "Catppuccin";
  };
}

Declared by:

programs.noctalia.systemd.enable

Whether to enable a systemd user service for noctalia.

Type: boolean

Default:

false

Example:

true

Declared by: