Official NixOS Wiki

Niri: Difference between revisions

← Older edit
MiniBill (talk | contribs)
2 edits
VisualWikitext
m Update niri casing to lowercase "niri"
Add example on build-time validation
 
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
{{DISPLAYTITLE:niri}}
{{DISPLAYTITLE:niri}}
{{infobox application
{{infobox application
Line 9: Line 10:
| programmingLanguage = Rust, GLSL
| programmingLanguage = Rust, GLSL
| github = niri-wm/niri
| github = niri-wm/niri
| documentation = [https://yalter.github.io/niri/ Official wiki], [https://github.com/sodiboo/niri-flake/blob/main/docs.md niri-flake]
| documentation = [https://niri-wm.github.io/niri/ Official wiki], [https://github.com/sodiboo/niri-flake/blob/main/docs.md niri-flake]
| image = Niri-icon.svg
| image = Niri-icon.svg
| bugTracker = https://github.com/niri-wm/niri/issues
| bugTracker = https://github.com/niri-wm/niri/issues
| latestRelease = 25.11; 29 Nov 2025
| latestRelease = 26.04; 25 Apr 2026
}}
}}
<translate>


<translate>
<!--T:1-->
[https://github.com/YaLTeR/niri Niri] is a scrollable-tiling [[Wayland]] compositor.
[<tvar name="1">https://github.com/niri-wm/niri</tvar> Niri] is a scrollable-tiling [[<tvar name="2">Special:MyLanguage/Wayland</tvar>|Wayland]] compositor.


== Installation ==
== Installation == <!--T:2-->


<!--T:3-->
Simply enable {{nixos:option|programs.niri}}:
Simply enable {{nixos:option|programs.niri}}:
</translate>
</translate>
{{file|/etc/nixos/configuration.nix|nix|3=
{{file|/etc/nixos/configuration.nix|nix|3=
programs.niri.enable = true;
programs.niri.enable = true;
}}
}}


{{Note|<translate>Niri can be enabled <strong>without installing a custom flake</strong> such as [https://github.com/sodiboo/niri-flake niri-flake]. {{ic|niri-flake}} is only necessary if you would like to use a very recent version of Niri or if you would want to write configurations in the Nix language, although as of 2025 this repository is listed near the top in search engines.</translate>}}
{{Note|<translate><!--T:4--> Niri can be enabled <strong>without installing a custom flake</strong> such as [<tvar name="1">https://github.com/sodiboo/niri-flake</tvar> niri-flake]. {{ic|niri-flake}} is only necessary if you would like to use a very recent version of Niri or if you would want to write configurations in the Nix language, although as of 2025 this repository is listed near the top in search engines.</translate>}}
 


{{Warning|<translate>Without [[#Configuration]] or [[#Additional Setup]], or after a fresh installation, you may be unable to launch apps due to missing expected programs such as Alacritty and fuzzel. Press <kbd>Super</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd> to exit niri and proceed to one of them.</translate>}}
{{Warning|<translate><!--T:5--> Without [[<tvar name="1">#Configuration</tvar>|Configuration]] or [[<tvar name="2">#Additional Setup</tvar>|Additional Setup]], or after a fresh installation, you may be unable to launch apps due to missing expected programs such as Alacritty and fuzzel. Press <kbd>Super</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd> to exit niri and proceed to one of them.</translate>}}


<translate>
<translate>
== Configuration ==


The configuration path for niri is {{ic|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Home Manager]] can be used for configuration:
== Configuration == <!--T:6-->
 
<!--T:7-->
The configuration path for niri is {{ic|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[<tvar name="1">Special:MyLanguage/Home Manager</tvar>|Home Manager]] can be used for configuration:
 
</translate>
</translate>
{{file|~/.config/home-manager/home.nix|nix|3=
{{file|~/.config/home-manager/home.nix|nix|3=
xdg.configFile."niri/config.kdl".source = ./config.kdl;
xdg.configFile."niri/config.kdl".source = ./config.kdl;
}}
}}
<translate>
If you want to validate your configuration as part of the build process you can use {{ic|pkgs.runCommand}} like this:


</translate>
{{file|~/.config/home-manager/home.nix|nix|3=
xdg.configFile."niri/config.kdl".source =
  pkgs.runCommand "niri-config-checked"
    {
      nativeBuildInputs = [ pkgs.niri ];
    }
    ''
      niri validate --config ${./config.kdl}
      cp ${./config.kdl} $out
    '';
}}
<translate>
<translate>
You might want to start from [https://github.com/YaLTeR/niri/blob/main/resources/default-config.kdl the default configuration file] described at [https://github.com/YaLTeR/niri/wiki/Getting-Started#main-default-hotkeys].


See [https://yalter.github.io/niri/ the wiki] for configuration options for niri.


== Additional Setup ==
<!--T:8-->
You might want to start from [<tvar name="1">https://github.com/niri-wm/niri/blob/main/resources/default-config.kdl</tvar> the default configuration file] described at [<tvar name="2">https://github.com/niri-wm/niri/wiki/Getting-Started#main-default-hotkeys</tvar> here].
 
<!--T:9-->
See [<tvar name="1">https://niri-wm.github.io/niri/</tvar> the wiki] for configuration options for niri.
 
=== Greetd === <!--T:10-->
 
<!--T:11-->
You can start niri with greetd configuration:
 
</translate>
{{file|/etc/nixos/configuration.nix|nix|3=
programs.niri.enable = true;
 
services.greetd = {
  enable = true;
  settings = {
    default_session = {
      command = "${config.programs.niri.package}/bin/niri-session";
      user = "myuser";
    };
  };
};
 
# NixOS otherwise injects a stripped PATH via Environment= on the niri.service
# unit which shadows the imported user-manager PATH. Disabling the default
# lets niri inherit the full PATH set up by niri-session.
systemd.user.services.niri.enableDefaultPath = false;
 
}}
 
<translate>
== Additional Setup == <!--T:12-->


As described in [https://github.com/YaLTeR/niri/wiki/Example-systemd-Setup Example systemd Setup (niri wiki)], you might want to set up some additional services including [[Swayidle]], [[Swaylock]], [[Waybar]], [[Polkit]] and [[Secret Service]] as follows to complement the functionality of a regular window manager. Some of the these settings are also required to enable all the features of [https://github.com/YaLTeR/niri/blob/main/resources/default-config.kdl the default configuration file].
<!--T:13-->
As described in [<tvar name=1>https://github.com/niri-wm/niri/wiki/Example-systemd-Setup</tvar> Example systemd Setup (niri wiki)], you might want to set up some additional services including [[<tvar name=2>Special:MyLanguage/Swayidle</tvar>|Swayidle]], [[<tvar name=3>Special:MyLanguage/Swaylock</tvar>|Swaylock]], [[<tvar name=4>Special:MyLanguage/Waybar</tvar>|Waybar]], [[<tvar name=5>Special:MyLanguage/Polkit</tvar>|Polkit]] and [[<tvar name=6>Special:MyLanguage/Secret Service</tvar>|Secret Service]] as follows to complement the functionality of a regular window manager. Some of the these settings are also required to enable all the features of [<tvar name=7>https://github.com/niri-wm/niri/blob/main/resources/default-config.kdl</tvar> the default configuration file].
</translate>
</translate>


Line 58: Line 110:
programs.waybar.enable = true; # top bar
programs.waybar.enable = true; # top bar
environment.systemPackages = with pkgs; [ alacritty fuzzel swaylock mako swayidle ];
environment.systemPackages = with pkgs; [ alacritty fuzzel swaylock mako swayidle ];
|name=/etc/nixos/configuration.nix|lang=nix}}Or using [[Home Manager]]:{{file|~/.config/home-manager/home.nix|nix|3=
|name=/etc/nixos/configuration.nix|lang=nix}}
 
<translate>
<!--T:14-->
Or using [[<tvar name=1>Special:MyLanguage/Home Manager</tvar>|Home Manager]]:
</translate>
 
{{file|~/.config/home-manager/home.nix|nix|3=
programs.alacritty.enable = true; # Super+T in the default setting (terminal)
programs.alacritty.enable = true; # Super+T in the default setting (terminal)
programs.fuzzel.enable = true; # Super+D in the default setting (app launcher)
programs.fuzzel.enable = true; # Super+D in the default setting (app launcher)
Line 72: Line 131:


<translate>
<translate>
== Troubleshooting ==
== Troubleshooting == <!--T:15-->


=== IME not working on Electron apps ===
=== IME not working on Electron apps === <!--T:16-->


There is a general workaround to set {{ic|NIXOS_OZONE_WL}} as described in [[Wayland#Electron_and_Chromium]]:
<!--T:17-->
There is a general workaround to set {{ic|NIXOS_OZONE_WL}} as described in [[<tvar name=1>Special:MyLanguage/Wayland#Electron_and_Chromium</tvar>|Wayland#Electron_and_Chromium]]:
</translate>
</translate>


Line 84: Line 144:


<translate>
<translate>
<!--T:18-->
However, since niri does not support text-input-v1, sometimes enabling text-input-v3 by manually adding {{ic|<nowiki>--wayland-text-input-version=3</nowiki>}} flag is necessary for IME to work:
However, since niri does not support text-input-v1, sometimes enabling text-input-v3 by manually adding {{ic|<nowiki>--wayland-text-input-version=3</nowiki>}} flag is necessary for IME to work:
</translate>
</translate>


{{code|<nowiki>slack --wayland-text-input-version=3</nowiki>}}
<syntaxhighlight lang=console>
$ slack --wayland-text-input-version=3
</syntaxhighlight>


<translate>
<translate>
<!--T:19-->
<code>wrapProgram</code> may be used to add the flag automatically:
<code>wrapProgram</code> may be used to add the flag automatically:
</translate>
</translate>
Line 104: Line 168:


<translate>
<translate>
=== XWayland apps not working ===
=== XWayland apps not working === <!--T:20-->


There is a optional dependency for niri which is highly recommended to install (you can read [https://github.com/YaLTeR/niri/wiki/Xwayland this] article to learn more about this)
<!--T:21-->
There is a optional dependency for niri which is highly recommended to install (you can read [<tvar name=1>https://github.com/niri-wm/niri/wiki/Xwayland</tvar> this] article to learn more about this)
</translate>
</translate>


Line 114: Line 179:


<translate>
<translate>
Or using [[Home Manager]]
<!--T:22-->
Or using [[<tvar name=1>Special:MyLanguage/Home Manager</tvar>|Home Manager]]
</translate>
</translate>


Line 122: Line 188:


<translate>
<translate>
<!--T:23-->
After you installed {{ic|xwayland-satellite}} niri will integrate it out of the box and all of your XWayland apps will function properly.
After you installed {{ic|xwayland-satellite}} niri will integrate it out of the box and all of your XWayland apps will function properly.


=== File picker not working ===
=== File picker not working === <!--T:24-->


<!--T:25-->
If you are using <code>xdg-desktop-portal-gnome</code>, it will attempt to use Nautilus as the file picker, which will fail if Nautilus is not installed.
If you are using <code>xdg-desktop-portal-gnome</code>, it will attempt to use Nautilus as the file picker, which will fail if Nautilus is not installed.


<!--T:26-->
To work around this problem, you can force usage of the gtk or kde portals for file picker instead:
To work around this problem, you can force usage of the gtk or kde portals for file picker instead:
</translate>
</translate>
Line 136: Line 205:


<translate>
<translate>
== See Also ==
=== Waybar launches twice === <!--T:27-->
 
<!--T:28-->
When using a configuration option like programs.waybar.enable, waybar may launch twice on Niri. This is because the [<tvar name=1>https://github.com/niri-wm/niri/blob/b07bde3ee82dd73115e6b949e4f3f63695da35ea/resources/default-config.kdl#L271</tvar> default Niri config file launches waybar on launch]. Remove the spawn-at-startup "waybar" from the config file, or add waybar to your systems packages without using the home-manager option.
 
== See Also == <!--T:29-->


* [[Wayland]]
<!--T:30-->
* [[Sway]]
* [[<tvar name=1>Special:MyLanguage/Wayland</tvar>|Wayland]]
* [[Wallpapers for Wayland]]
* [[<tvar name=2>Special:MyLanguage/Sway</tvar>|Sway]]
* [https://github.com/sodiboo/niri-flake/ niri-flake]
* [[<tvar name=3>Special:MyLanguage/Wallpapers for Wayland</tvar>|Wallpapers for Wayland]]
* [<tvar name=4>https://github.com/sodiboo/niri-flake/</tvar> niri-flake]
</translate>
</translate>


[[Category:Window managers]]
[[Category:Window managers]]
[[Category:Applications]]
[[Category:Applications{{#translation:}}]]
Retrieved from "https://wiki.nixos.org/wiki/Niri"