Jump to content

niri

From Official NixOS Wiki
Revision as of 17:36, 31 May 2026 by Ardenet (talk | contribs) (Created page with "Niri")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

警告:顯示標題「niri」覆蓋了之前的顯示標題「Niri」。

niri

Wayland compositor Application

100%
Initial release2023-11-26
Latest release26.04; 25 Apr 2026
StatusActive
Operating SystemLinux, FreeBSD
Language(s)Rust, GLSL
LicenseGNU General Public License v3.0 only
External links
GitHubniri-wm/niri
Bug trackerhttps://github.com/niri-wm/niri/issues
DocumentationOfficial wiki, niri-flake

Niri 是一個可滾動平鋪的 Wayland 合成器。

安裝

只需啟用 programs.niri

❄︎ /etc/nixos/configuration.nix
programs.niri.enable = true;
Note: 無需安裝自定義 flake(例如 niri-flake)即可啟用 Niri。儘管截至 2025 年,該存儲庫在搜索引擎中的排名仍然靠前,但只有當您想要使用最新版本的 Niri 或想要用 Nix 語言編寫配置時,才需要 niri-flake


⚠︎
Warning: 如果沒有進行 配置附加設置,或者在全新安裝後,您可能由於缺少 Alacritty 和 fuzzel 等預期程序而無法啟動應用程序。請按 Super+Shift+E 退出 niri 並繼續執行其中一項操作。


配置

niri 的配置路徑為 $XDG_CONFIG_HOME/niri/config.kdl。因此,可以使用 Home Manager 進行配置:

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

您可能想從默認配置文件開始,如這裡所述。

有關 niri 的配置選項,請參閱 此 wiki

Greetd

您可以使用 greeted 配置啟動 niri:

❄︎ /etc/nixos/configuration.nix
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;

額外設置

示例 systemd 設置 (niri wiki)中所述,您可能需要設置一些額外的服務,包括以下的 SwayidleSwaylockWaybarPolkitSecret Service,以補充常規窗口管理器的功能。其中一些設置也是啟用默認配置文件所有功能所必需的。

❄︎ /etc/nixos/configuration.nix
security.polkit.enable = true; # polkit
services.gnome.gnome-keyring.enable = true; # secret service
security.pam.services.swaylock = {};

programs.waybar.enable = true; # top bar
environment.systemPackages = with pkgs; [ alacritty fuzzel swaylock mako swayidle ];

或者使用 Home Manager

❄︎ ~/.config/home-manager/home.nix
programs.alacritty.enable = true; # Super+T in the default setting (terminal)
programs.fuzzel.enable = true; # Super+D in the default setting (app launcher)
programs.swaylock.enable = true; # Super+Alt+L in the default setting (screen locker)
programs.waybar.enable = true; # launch on startup in the default setting (bar)
services.mako.enable = true; # notification daemon
services.swayidle.enable = true; # idle management daemon
services.polkit-gnome.enable = true; # polkit
home.packages = with pkgs; [
  swaybg # wallpaper
];

故障排除

IME 在 Electron 應用中無法正常工作

There is a general workaround to set NIXOS_OZONE_WL as described in Wayland#Electron_and_Chromium:

❄︎ /etc/nixos/configuration.nix
environment.sessionVariables.NIXOS_OZONE_WL = "1";

However, since niri does not support text-input-v1, sometimes enabling text-input-v3 by manually adding --wayland-text-input-version=3 flag is necessary for IME to work:

$ slack --wayland-text-input-version=3

wrapProgram may be used to add the flag automatically:

❄︎ /etc/nixos/configuration.nix
environment.systemPackages = [
  (pkgs.symlinkJoin {
    pname = pkgs.vscode.pname;
    paths = [ pkgs.vscode ];
    buildInputs = [ pkgs.makeWrapper ];
    postBuild = "wrapProgram $out/bin/code --add-flags --wayland-text-input-version=3";
  };)
];

XWayland 應用無法正常工作

There is a optional dependency for niri which is highly recommended to install (you can read this article to learn more about this)

❄︎ /etc/nixos/configuration.nix
environment.systemPackages = with pkgs; [ 
    xwayland-satellite # xwayland support
];

Or using Home Manager

❄︎ ~/.config/home-manager/home.nix
home.packages = with pkgs; [
  xwayland-satellite # xwayland support
];

After you installed xwayland-satellite niri will integrate it out of the box and all of your XWayland apps will function properly.

文件選擇器無法正常工作

If you are using xdg-desktop-portal-gnome, it will attempt to use Nautilus as the file picker, which will fail if Nautilus is not installed.

To work around this problem, you can force usage of the gtk or kde portals for file picker instead:

❄︎ /etc/nixos/configuration.nix
xdg.portal.config.niri = {
  "org.freedesktop.impl.portal.FileChooser" = [ "gtk" ]; # or "kde"
};

Waybar 啟動兩次

When using a configuration option like programs.waybar.enable, waybar may launch twice on Niri. This is because the 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.

另見