Niri - Revision history

DHCP: /* Configuration */ update link (yalter -> niri-wm) in one more place

2026-05-20T22:17:54Z

Configuration: update link (yalter -> niri-wm) in one more place

← Older revision		Revision as of 22:17, 20 May 2026
Line 44:		Line 44:
	You might want to start from [https://github.com/niri-wm/niri/blob/main/resources/default-config.kdl the default configuration file] described at [https://github.com/niri-wm/niri/wiki/Getting-Started#main-default-hotkeys].		You might want to start from [https://github.com/niri-wm/niri/blob/main/resources/default-config.kdl the default configuration file] described at [https://github.com/niri-wm/niri/wiki/Getting-Started#main-default-hotkeys].

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

	=== Greetd ===		=== Greetd ===

DHCP: Fix broken syntax highlighting, update links, prefix shell command with "$"

2026-05-20T22:16:31Z

Fix broken syntax highlighting, update links, prefix shell command with "$"

← Older revision		Revision as of 22:16, 20 May 2026
Line 16:		Line 16:

	<translate>		<translate>
	[https://github.com/~~YaLTeR~~/niri Niri] is a scrollable-tiling [[Wayland]] compositor.		[https://github.com/niri-wm/niri Niri] is a scrollable-tiling [[Wayland]] compositor.

	== Installation ==		== Installation ==
Line 42:		Line 42:

	<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].		You might want to start from [https://github.com/niri-wm/niri/blob/main/resources/default-config.kdl the default configuration file] described at [https://github.com/niri-wm/niri/wiki/Getting-Started#main-default-hotkeys].

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

	You can start `niri` with greetd configuration:		You can start niri with greetd configuration:

	{{file\|/etc/nixos/configuration.nix\|nix\|3=		{{file\|/etc/nixos/configuration.nix\|nix\|3=
Line 68:		Line 68:
	systemd.user.services.niri.enableDefaultPath = false;		systemd.user.services.niri.enableDefaultPath = false;

	~~\|name=\|lang=~~}}		}}

	== Additional Setup ==		== Additional Setup ==

	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].		As described in [https://github.com/niri-wm/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/niri-wm/niri/blob/main/resources/default-config.kdl the default configuration file].
	</translate>		</translate>

Line 111:		Line 111:
	</translate>		</translate>

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

	<translate>		<translate>
Line 130:		Line 132:
	=== XWayland apps not working ===		=== XWayland apps not working ===

	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)		There is a optional dependency for niri which is highly recommended to install (you can read [https://github.com/niri-wm/niri/wiki/Xwayland this] article to learn more about this)
	</translate>		</translate>

Atemo C: Minor update to Niri's version and a website link.

2026-05-01T13:19:34Z

Minor update to Niri's version and a website link.

← Older revision		Revision as of 13:19, 1 May 2026
Line 9:		Line 9:
	\| 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
	}}		}}

DavHau: fix greetd setup to make programs in niri actually work

2026-04-29T09:53:46Z

fix greetd setup to make programs in niri actually work

← Older revision		Revision as of 09:53, 29 April 2026
Line 63:		Line 63:
	};		};

	}}		# 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;

			\|name=\|lang=}}

	== Additional Setup ==		== Additional Setup ==

Arcstur: /* Configuration */ with greetd

2026-03-26T17:36:01Z

Configuration: with greetd

← Older revision		Revision as of 17:36, 26 March 2026
Line 45:		Line 45:

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

			=== Greetd ===

			You can start `niri` with greetd configuration:

			{{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";
			};
			};
			};

			}}

	== Additional Setup ==		== Additional Setup ==

Denperidge: Added troubleshooting: waybar launches twice

2026-03-22T19:21:33Z

Added troubleshooting: waybar launches twice

← Older revision		Revision as of 19:21, 22 March 2026
Line 134:		Line 134:
	"org.freedesktop.impl.portal.FileChooser" = [ "gtk" ]; # or "kde"		"org.freedesktop.impl.portal.FileChooser" = [ "gtk" ]; # or "kde"
	};\|name=/etc/nixos/configuration.nix\|lang=nix}}		};\|name=/etc/nixos/configuration.nix\|lang=nix}}

			=== Waybar launches twice ===
			When using a configuration option like programs.waybar.enable, waybar may launch twice on Niri. This is because the [https://github.com/niri-wm/niri/blob/b07bde3ee82dd73115e6b949e4f3f63695da35ea/resources/default-config.kdl#L271 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.

	<translate>		<translate>

LuckShiba: Update niri casing to lowercase "niri"

2026-03-18T06:36:14Z

Update niri casing to lowercase "niri"

← Older revision		Revision as of 06:36, 18 March 2026
Line 1:		Line 1:
			{{DISPLAYTITLE:niri}}
	{{infobox application		{{infobox application
	\| name = ~~Niri~~		\| name = niri
	\| type = Wayland compositor		\| type = Wayland compositor
	\| initialRelease = 2023-11-26		\| initialRelease = 2023-11-26
Line 28:		Line 29:
	{{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>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>}}

	{{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>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>}}

	<translate>		<translate>
	== Configuration ==		== Configuration ==

	The configuration path for ~~Niri~~ is {{ic\|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Home Manager]] can be used for configuration:		The configuration path for niri is {{ic\|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Home Manager]] can be used for configuration:
	</translate>		</translate>

Line 43:		Line 44:
	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].		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~~.		See [https://yalter.github.io/niri/ the wiki] for configuration options for niri.

	== Additional Setup ==		== Additional Setup ==

	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].		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].
	</translate>		</translate>

Line 83:		Line 84:

	<translate>		<translate>
	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>

Line 105:		Line 106:
	=== XWayland apps not working ===		=== XWayland apps not working ===

	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)		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)
	</translate>		</translate>

Line 121:		Line 122:

	<translate>		<translate>
	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 ===

Ardenet at 15:29, 3 March 2026

2026-03-03T15:29:37Z

← Older revision		Revision as of 15:29, 3 March 2026
Line 104:		Line 104:
	<translate>		<translate>
	=== XWayland apps not working ===		=== XWayland apps not working ===

	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)		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)
	</translate>		</translate>
Line 123:		Line 124:

	=== File picker not working ===		=== File picker not working ===

	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.

Ardenet: Adjust the position of translation tags

2026-03-03T15:27:57Z

Adjust the position of translation tags

← Older revision		Revision as of 15:27, 3 March 2026
Line 20:		Line 20:

	Simply enable {{nixos:option\|programs.niri}}:		Simply enable {{nixos:option\|programs.niri}}:
			</translate>

	{{file\|/etc/nixos/configuration.nix\|nix\|3=		{{file\|/etc/nixos/configuration.nix\|nix\|3=
Line 25:		Line 26:
	}}		}}

	{{Note\|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.}}		{{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>}}

	{{Warning\|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.}}		{{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>}}

			<translate>
	== Configuration ==		== Configuration ==

	The configuration path for Niri is {{ic\|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Home Manager]] can be used for configuration:		The configuration path for Niri is {{ic\|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Home Manager]] can be used for configuration:
			</translate>

	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=
Line 37:		Line 40:
	}}		}}

			<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].		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].

Line 44:		Line 48:

	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].		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].
			</translate>

	{{file\|3=		{{file\|3=
Line 65:		Line 70:
	\|name=~/.config/home-manager/home.nix\|lang=nix}}		\|name=~/.config/home-manager/home.nix\|lang=nix}}

			<translate>
	== Troubleshooting ==		== Troubleshooting ==

Line 70:		Line 76:

	There is a general workaround to set {{ic\|NIXOS_OZONE_WL}} as described in [[Wayland#Electron_and_Chromium]]:		There is a general workaround to set {{ic\|NIXOS_OZONE_WL}} as described in [[Wayland#Electron_and_Chromium]]:
			</translate>

	{{file\|/etc/nixos/configuration.nix\|nix\|3=		{{file\|/etc/nixos/configuration.nix\|nix\|3=
Line 75:		Line 82:
	}}		}}

			<translate>
	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>

	{{code\|<nowiki>slack --wayland-text-input-version=3</nowiki>}}		{{code\|<nowiki>slack --wayland-text-input-version=3</nowiki>}}

			<translate>
	<code>wrapProgram</code> may be used to add the flag automatically:		<code>wrapProgram</code> may be used to add the flag automatically:
			</translate>

	{{file\|/etc/nixos/configuration.nix\|nix\|3=		{{file\|/etc/nixos/configuration.nix\|nix\|3=
Line 91:		Line 102:
	];}}		];}}

			<translate>
	=== XWayland apps not working ===		=== XWayland apps not working ===
	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)		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)
			</translate>

	{{File\|3=environment.systemPackages = with pkgs; [		{{File\|3=environment.systemPackages = with pkgs; [
Line 98:		Line 111:
	];\|name=/etc/nixos/configuration.nix\|lang=nix}}		];\|name=/etc/nixos/configuration.nix\|lang=nix}}

			<translate>
	Or using [[Home Manager]]		Or using [[Home Manager]]
			</translate>

	{{File\|3=home.packages = with pkgs; [		{{File\|3=home.packages = with pkgs; [
Line 104:		Line 119:
	];\|name=~/.config/home-manager/home.nix\|lang=nix}}		];\|name=~/.config/home-manager/home.nix\|lang=nix}}

			<translate>
	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.

Line 110:		Line 126:

	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>

	{{File\|3=xdg.portal.config.niri = {		{{File\|3=xdg.portal.config.niri = {
	"org.freedesktop.impl.portal.FileChooser" = [ "gtk" ]; # or "kde"		"org.freedesktop.impl.portal.FileChooser" = [ "gtk" ]; # or "kde"
	};\|name=/etc/nixos/configuration.nix\|lang=nix}}		};\|name=/etc/nixos/configuration.nix\|lang=nix}}

			<translate>
	== See Also ==		== See Also ==

34j: /* Troubleshooting */ Use wrapProgram instead of commandLineArgs for build performance

2026-02-27T07:25:10Z

Troubleshooting: Use wrapProgram instead of commandLineArgs for build performance

← Older revision		Revision as of 07:25, 27 February 2026
Line 79:		Line 79:
	{{code\|<nowiki>slack --wayland-text-input-version=3</nowiki>}}		{{code\|<nowiki>slack --wayland-text-input-version=3</nowiki>}}

	~~Alternatively, if the package supports {{ic\|commandLineArgs}}, the following~~ may be used ~~instead~~:		<code>wrapProgram</code> may be used to add the flag automatically:

	{{~~code~~\|~~<nowiki>~~(pkgs.vscode.~~override {~~		{{file\|/etc/nixos/configuration.nix\|nix\|3=
	~~commandLineArgs~~ = [		environment.systemPackages = [
	"--wayland-text-input-version=3"		(pkgs.symlinkJoin {
	];		pname = pkgs.vscode.pname;
	});~~</nowiki>~~}}		paths = [ pkgs.vscode ];
			buildInputs = [ pkgs.makeWrapper ];
			postBuild = "wrapProgram $out/bin/code --add-flags --wayland-text-input-version=3";
			};)
			];}}

	=== XWayland apps not working ===		=== XWayland apps not working ===