Astal Shell

Astal-based shell for my NixOS configuration.

Development

# Run the main shell
nix run path:.

Using with Home Manager

{ inputs, pkgs, ... }: {
  imports = [ inputs.astal-shell.homeManagerModules.default ];

services.astal-shell = {
    enable = true;

    # Optional: configure display margins
    displays = {
      "LG HDR 4K" = [390 145];
      "DP-1" = [250 80];
    };

    # Optional: configure theme
    theme = {
      iconTheme = "Adwaita";

      background = {
        primary = "rgba(30, 30, 46, 1.0)";
        secondary = "rgba(24, 24, 37, 1.0)";
      };
      text = {
        primary = "rgba(205, 214, 244, 1.0)";
        secondary = "rgba(186, 194, 222, 0.7)";
      };
      # ... other theme options
    };

    # Optional: use a different package
    package = pkgs.astal-shell;
  };
}

Module Options

services.astal-shell.enable

Enable the Astal Shell service. Default: false.

services.astal-shell.enable = true;

services.astal-shell.displays

Map display names to [horizontal, vertical] margin pairs. Monitors are matched by connector name (e.g., DP-1), model info, or fallback monitor_{N} naming.

Default: {}

services.astal-shell.displays = {
  "DP-1" = [250, 80];
  "HDMI-A-1" = [400, 120];
};

services.astal-shell.theme

Theme configuration. Supports the following options:

• iconTheme — GTK icon theme name. Default: "Adwaita".

Additional theme keys (background colors, text colors, accent colors, etc.) are passed through to the shell's theme config.

services.astal-shell.theme = {
  iconTheme = "Yaru";

  background = {
    primary = "rgba(30, 30, 46, 1.0)";
    secondary = "rgba(24, 24, 37, 1.0)";
  };
  text = {
    primary = "rgba(205, 214, 244, 1.0)";
    secondary = "rgba(186, 194, 222, 0.7)";
  };
};

services.astal-shell.quickSettings

List of quick settings buttons shown in the top bar. Includes built-in defaults for shutdown, reboot, and logout — override the list to customize.

Each entry supports:

• id — unique identifier
• icon — GTK icon name
• label — tooltip text
• command — command to execute (string or list of strings)
• confirm — show confirmation dialog before executing (default: false)

services.astal-shell.quickSettings = [
  {
    id = "lock";
    icon = "system-lock-screen-symbolic";
    label = "Lock";
    command = ["swaylock" "-c" "000000"];
    confirm = false;
  }
  {
    id = "shutdown";
    icon = "system-shutdown-symbolic";
    label = "Shutdown";
    command = ["systemctl" "poweroff"];
    confirm = true;
  }
];

services.astal-shell.package

The astal-shell package to use. Default: pkgs.astal-shell.

services.astal-shell.package = pkgs.astal-shell;