Jump to content

Niri

From NixOS Wiki
Revision as of 03:26, 3 July 2025 by 34j (talk | contribs)

Niri is a scrollable tiling Wayland compositor.

Installation

Simply enable programs.niri:

❄︎ /etc/nixos/configuration.nix
programs.niri.enable = true;
Note: Niri can be enabled without installing custom flake such as niri-flake. It is only necessary if you want to use a very recent version of Niri or if you want to write configurations in the Nix language, although as of 2025 this repository is listed near the top in search engines.

Configuration

The configuration path for Niri is $XDG_CONFIG_HOME/niri/config.kdl. Therefore Home Manager can be used for configuration:

❄︎ ~/.config/home-manager/home.nix
xdg.configFile."niri/config.kdl".source = "config.kdl";

You might want to start from the default configuration file described at [1].

See the wiki for configuration options for Niri.