Jump to content

Noctalia Shell: Difference between revisions

From Official NixOS Wiki
Lukec (talk | contribs)
Create a page for Noctalia Shell with installation instructions
 
m Changed links from `github.com/noctalia-dev/noctalia-shell` to `github.com/noctalia-dev/noctalia` following a recent renaming they did.
 
Line 1: Line 1:
[https://github.com/noctalia-dev/noctalia-shell Noctalia Shell] is a sleek and minimal desktop shell thoughtfully crafted for Wayland.
[https://github.com/noctalia-dev/noctalia Noctalia Shell] is a sleek and minimal desktop shell thoughtfully crafted for Wayland.


Noctalia provides native support for [[Niri]], [[Hyprland]], [[Sway]], [[Scroll]], [[Labwc]] and [[MangoWC]]. Other Wayland compositors may work but could require additional configuration for compositor-specific features like workspaces and window management.<ref>https://github.com/noctalia-dev/noctalia-shell/blob/d1c0374f73ea687ae33b30fe6c4257dc0995d4f3/README.md</ref>
Noctalia provides native support for [[Niri]], [[Hyprland]], [[Sway]], [[Scroll]], [[Labwc]] and [[MangoWC]]. Other Wayland compositors may work but could require additional configuration for compositor-specific features like workspaces and window management.<ref>[https://github.com/noctalia-dev/noctalia-shell/blob/d1c0374f73ea687ae33b30fe6c4257dc0995d4f3/README.md https://github.com/noctalia-dev/noctalia/blob/d1c0374f73ea687ae33b30fe6c4257dc0995d4f3/README.md]</ref>


== Installation<ref>https://docs.noctalia.dev/getting-started/nixos/</ref> ==
== Installation<ref>https://docs.noctalia.dev/getting-started/nixos/</ref> ==
Line 18: Line 18:


     noctalia = {
     noctalia = {
       url = "github:noctalia-dev/noctalia-shell";
       url = "github:noctalia-dev/noctalia";
       inputs.nixpkgs.follows = "nixpkgs";
       inputs.nixpkgs.follows = "nixpkgs";
     };
     };
Line 49: Line 49:
     ];
     ];


     programs.noctalia-shell = {
     programs.noctalia = {
       enable = true;
       enable = true;
       settings = {
       settings = {

Latest revision as of 10:06, 10 June 2026

Noctalia Shell is a sleek and minimal desktop shell thoughtfully crafted for Wayland.

Noctalia provides native support for Niri, Hyprland, Sway, Scroll, Labwc and MangoWC. Other Wayland compositors may work but could require additional configuration for compositor-specific features like workspaces and window management.[1]

Installation[2]

A Nix package for Noctalia is currently available on the unstable channel.

❄︎ /etc/nixos/configuration.nix
environment.systemPackages = with pkgs; [
  noctalia-shell
];

Noctalia Shell Flake

You can also get the latest Git version of Noctalia by using flakes.

❄︎ flake.nix
{
  description = "NixOS configuration with Noctalia";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

    noctalia = {
      url = "github:noctalia-dev/noctalia";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = inputs@{ self, nixpkgs, ... }: {
    nixosConfigurations.awesomebox = nixpkgs.lib.nixosSystem {
      specialArgs = { inherit inputs; };
      modules = [
        # ... other modules
        ./noctalia.nix
      ];
    };
  };
}

If not using the NixOS or Home Manager module, we can install Noctalia using:

❄︎ noctalia.nix
{ pkgs, inputs, ... }:
{
  environment.systemPackages = with pkgs; [
    inputs.noctalia.packages.${pkgs.stdenv.hostPlatform.system}.default
  ];
}

Alternatively, we can just enable Noctalia using the NixOS or Home Manager module. For example, for Home Manager:

❄︎ noctalia.nix
{ pkgs, inputs, ... }:
{
  home-manager.users.foobar = {
    # import the home manager module
    imports = [
      inputs.noctalia.homeModules.default
    ];

    programs.noctalia = {
      enable = true;
      settings = {
        # configure options
      };
    };
  };
}