Niri: Difference between revisions
Adjust the position of page translation tags |
Add tvar tags for links |
||
| Line 17: | Line 17: | ||
<translate> | <translate> | ||
[https://github.com/niri-wm/niri Niri] is a scrollable-tiling [[Special:MyLanguage/Wayland|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 == | ||
| Line 28: | Line 28: | ||
}} | }} | ||
{{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 [<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|Configuration]] or [[#Additional Setup|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 [[<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> | ||
| Line 37: | Line 37: | ||
== Configuration == | == Configuration == | ||
The configuration path for niri is {{ic|$XDG_CONFIG_HOME/niri/config.kdl}}. Therefore [[Special:MyLanguage/Home Manager|Home Manager]] can be used for configuration: | 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> | ||
| Line 45: | Line 45: | ||
<translate> | <translate> | ||
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 [<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]. | ||
See [https://niri-wm.github.io/niri/ the wiki] for configuration options for niri. | See [<tvar name="1">https://niri-wm.github.io/niri/</tvar> the wiki] for configuration options for niri. | ||
=== Greetd === | === Greetd === | ||
| Line 77: | Line 77: | ||
== Additional Setup == | == Additional Setup == | ||
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 [[Special:MyLanguage/Swayidle|Swayidle]], [[Special:MyLanguage/Swaylock|Swaylock]], [[Special:MyLanguage/Waybar|Waybar]], [[Special:MyLanguage/Polkit|Polkit]] and [[Special:MyLanguage/Secret Service|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]. | 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 90: | Line 90: | ||
<translate> | <translate> | ||
Or using [[Special:MyLanguage/Home Manager|Home Manager]]: | Or using [[<tvar name=1>Special:MyLanguage/Home Manager</tvar>|Home Manager]]: | ||
</translate> | </translate> | ||
| Line 111: | Line 111: | ||
=== IME not working on Electron apps === | === IME not working on Electron apps === | ||
There is a general workaround to set {{ic|NIXOS_OZONE_WL}} as described in [[Special:MyLanguage/Wayland#Electron_and_Chromium|Wayland#Electron_and_Chromium]]: | 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 143: | Line 143: | ||
=== 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/niri-wm/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 [<tvar name=1>https://github.com/niri-wm/niri/wiki/Xwayland</tvar> this] article to learn more about this) | ||
</translate> | </translate> | ||
| Line 151: | Line 151: | ||
<translate> | <translate> | ||
Or using [[Special:MyLanguage/Home Manager|Home Manager]] | Or using [[<tvar name=1>Special:MyLanguage/Home Manager</tvar>|Home Manager]] | ||
</translate> | </translate> | ||
| Line 175: | Line 175: | ||
=== Waybar launches twice === | === 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. | 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 == | == See Also == | ||
* [[Special:MyLanguage/Wayland|Wayland]] | * [[<tvar name=1>Special:MyLanguage/Wayland</tvar>|Wayland]] | ||
* [[Special:MyLanguage/Sway|Sway]] | * [[<tvar name=2>Special:MyLanguage/Sway</tvar>|Sway]] | ||
* [[Special:MyLanguage/Wallpapers for Wayland|Wallpapers for Wayland]] | * [[<tvar name=3>Special:MyLanguage/Wallpapers for Wayland</tvar>|Wallpapers for Wayland]] | ||
* [https://github.com/sodiboo/niri-flake/ niri-flake] | * [<tvar name=4>https://github.com/sodiboo/niri-flake/</tvar> niri-flake] | ||
</translate> | </translate> | ||
[[Category:Window managers]] | [[Category:Window managers]] | ||
[[Category:Applications{{#translation:}}]] | [[Category:Applications{{#translation:}}]] | ||