CachyOS Apps

Install niri on CachyOS

Scrollable-tiling Wayland compositor.

From the official CachyOS repo. Install with pacman, no AUR helper needed.

Reviewed Nov 2, 2026 · independent guide

How do I install niri on CachyOS?

Run this in a terminal:

sudo pacman -S niri-git

niri-git is in the cachyos repo, the CachyOS project's own package repository, so pacman installs it directly with no AUR helper and no build script. The package is signed with the CachyOS repository key, and pacman checks the signature before it installs.

What should I do after installing niri?

  1. It installs these commands: niri and niri-session.
  2. The package ships the systemd unit niri.service. Read the project docs before you enable it.
  3. Run pacman -Qi niri-git to see the installed version and the optional dependencies.

How do I update or remove niri?

Update:

sudo pacman -Syu

Remove:

sudo pacman -Rns niri-git

What is niri?

A scrollable-tiling Wayland compositor.

Package description: Scrollable-tiling Wayland compositor

Reviews of niri on CachyOS

No reviews yet. Be the first to review niri.

    Leave a review

    Your rating

    No login. No links, please. We keep a one way hash of your connection to stop spam, never your IP address. Posts that break the rules may be hidden. Privacy

    From GitHub

    niri-wm/niri · ★ 28,833 stars · last commit Oct 31, 2026 · latest release Apr 25, 2026

    Real issues opened by users on the project's GitHub, shown as written with a link to each one. 10 most reacted issues opened in the last two years plus the 5 newest issues, bots, pull requests, non English and political posts skipped, capped at 15 per repo. Fetched Nov 1, 2026.

    1. Pinned/sticky/show on all workspaces floating windowsOpen

      Add some way to show a floating window on all workspaces. For things like picture-in-picture, webcam, etc. I'm not entirely sure what would be the best way to structure the code. 1. UX-wise, it would make sense to have an extra floating space for pinned windows on a Monitor, that…

      @YaLTeR · · 567 reactions · 54 comments · View on GitHub

    2. Vertical layout option for portrait monitorsOpen

      Instead of infinite horizontal and fixed vertical space, for portrait monitors it makes sense to have infinite vertical and fixed horizontal space. So the same scrolling layout, but going down instead of to the right. And I guess workspaces go sideways then? Originally requested…

      @YaLTeR · · 248 reactions · 40 comments · View on GitHub

    3. Implement input capture portalOpen

      Needs EIS most likely.

      @YaLTeR · · 208 reactions · 4 comments · View on GitHub

    4. Scratch workspacesOpen

      These are special workspaces that you can bring up on top of the current workspace. They don't show up in the workspace list. One example use is putting a volume control window on a scratch workspace, so that you can bring it up anywhere you are. Or a dropdown terminal like thing…

      @YaLTeR · · 158 reactions · 1 comments · View on GitHub

    5. Long-running custom shadersOpen

      Currently you can set a custom shader for short animations (window open, close, resize) but not for something long-running. For example, you can't put a custom shader on a window or an output in general. This can be used for fun effects, but also for things like grayscale mode,…

      @YaLTeR · · 115 reactions · 34 comments · View on GitHub

    6. Binding modes/binding submapsOpen

      The ability to configure multiple binding modes with separate binds. An example use-case is a "launcher" mode, where e.g. you press Super+D, then instead of the normal binds, you have binds to run applications, like F for firefox, N for nautilus, T for terminal, etc. So you press…

      @YaLTeR · · 107 reactions · 63 comments · View on GitHub

    7. OverviewClosed

      Something that zooms out and lets you see multiple workspaces and windows on each monitor. The design concepts here are very close to what I have in mind: Actual interactions in the overview (click on window to focus it scrolling it into view? moving windows around workspaces…

      @YaLTeR · · 106 reactions · 25 comments · View on GitHub

    8. Zoom/magnifierOpen

      Accessibility feature that zooms in the screen around the cursor. This works but is a bit fiddly to run. Need to see how the magnifier works in other compositors, especially GNOME and KDE. I pretty much never used it so I'm not sure what the expected UX is. Tentatively, I'm…

      @YaLTeR · · 95 reactions · 18 comments · View on GitHub

    9. Tearing flip supportOpen

      Useful for games and stuff to get the lowest input latency. We're mainly waiting for which is waiting for some driver stuff (?). Then on the niri side we can make tearing a window rule just like on-demand VRR. There's also for the Wayland protocol, which is needed so windows can…

      @YaLTeR · · 74 reactions · 28 comments · View on GitHub

    10. Add support for monitor bit depth configurationClosed

      Currently you can set resolution, refresh rate, vrr, scale, transform, etc for each output. However, there's no way to control the bit depth of a display through Niri (Such as running a display in 8 or 10 bit mode). This seems like a strange thing to not have access to…

      @Gwenodai · · 74 reactions · 36 comments · View on GitHub

    11. xwayland-satellite crashes when certain apps startClosed

      When launching certain apps (in my case, modded Celeste via Olympus, though other apps may also trigger it), xwayland-satellite crashes, taking down Steam and any other apps running through it. This does not appear to be an xwayland-satellite bug, as manually running it manually…

      @AdalynBlack · · 3 comments · View on GitHub

    12. Layer-shell surfaces occasionally become invisible after switching wallpapersOpen

      Hi, I'm using Niri on Arch Linux with Wayland, along with Kwybars and Ironbar. I've encountered an intermittent issue where Kwybars sometimes suddenly disappears from the screen, even though its process is still running. My configuration is correct, and this issue doesn't happen…

      @linux36524 · · 6 comments · View on GitHub

    13. Black screen when starting through DM, works when starting from TTYOpen

      When running niri-session through /usr/share/wayland-sessions/niri.desktop I only get a black screen. I can reliably reproduce this issue with SDDM and GDM. No obvious errors in the display manager's log. No logs at all for niri.service. When I log in on a TTY and run…

      @Chais · · 7 comments · View on GitHub

    14. `org.freedesktop.ScreenSaver`: niri owns the name but implements only `Inhibit`/`UnInhibit`, which breaks screen-lock detectionOpen

      niri owns the D-Bus session bus name org.freedesktop.ScreenSaver and exports that interface with only Inhibit and UnInhibit. However, I believe that niri's implementation is incomplete. While the freedesktop idle-inhibit spec defines only Inhibit and UnInhibit, the original KDE…

      @brianhelba · · 1 comments · View on GitHub

    15. Keyboard grabs don't inhibit pointer bindingsOpen

      For example, if a remote desktop client has the keyboard grabbed and niri's modifier is Super, and you try to Super+drag something around in it (with any mouse button), niri handles it itself (and the client just gets the Super press/release). This happens regardless of whether…

      @pgaskin · · 1 comments · View on GitHub

    niri on CachyOS: questions

    Is niri in the official CachyOS repo?

    Yes. The niri-git package is in the cachyos repo, version 26.04.r224.g9d8f4f8-1, built 2026-10-26. Install it with sudo pacman -S niri-git.

    Do I need an AUR helper for niri?

    No. It comes from the cachyos repo, so plain pacman installs and updates it, and sudo pacman -Syu keeps it current.

    What is the niri command?

    The package installs niri and niri-session.