# Can you run niri on a Mac?

Source: https://ribbonformac.com/niri-for-mac  
Updated: 2026-10-22

No. **niri** is a Wayland compositor, and macOS doesn't use Wayland, so there is no port and there can't be one. What you *can* get on a Mac is niri's layout: an endless strip of columns that scrolls. Ribbon, OmniWM, Nehir, PaperWM.spoon and Paneru all do that, each with different trade-offs.

## Why niri can't run on macOS

[niri](https://github.com/niri-wm/niri) is a compositor. On Linux it *is* the thing that draws the screen: it owns every pixel, renders window borders and shadows, runs its animations on the GPU, and decides where input goes. That only works because Wayland lets a compositor take that job.

macOS has exactly one compositor, Apple's WindowServer, and nobody else gets to replace it. A window manager on a Mac is a normal app that asks other apps to move and resize their windows through the Accessibility API. It can't draw on top of them, can't blur them, and can't make a window vanish off the edge of the screen without macOS having a say.

So "niri for Mac" really means: an app that copies niri's *layout* using the tools macOS allows. That turns out to be enough for the part most people care about.

## What carries over and what doesn't

The core idea moves across almost untouched:

- Windows sit in columns on a horizontal strip that is wider than your screen.
- A new window adds a column. Nothing else shrinks.
- You move focus left and right and the strip slides to follow.
- Columns have preset widths you cycle through, and several windows can share one column.
- Each monitor has its own strip.
- A three-finger trackpad swipe can scroll the strip.

Some things don't make it, or only partly:

- **Compositor effects.** Gradient borders, background blur, custom shaders and niri's own animation curves need a compositor. Mac tools draw a simple overlay border at most.
- **niri's workspaces.** On Linux each monitor has a vertical stack of dynamic workspaces. macOS has Spaces instead. Some Mac tools build their own workspaces; others, like Ribbon, use Spaces.
- **The overview.** niri zooms out to show everything. Only some Mac tools have an equivalent.
- **Screenshot UI, screencasting rules, Xwayland.** These are compositor jobs. On a Mac you use macOS's own screenshot tool.

If the idea of a scrolling layout is new to you, [what a scrolling window manager is](https://ribbonformac.com/what-is-a-scrolling-window-manager) explains it from scratch.

## Every way to get niri-style scrolling on macOS

### Ribbon

Ribbon is a paid native app ($9.99 once for one Mac) that does one thing: the scrolling strip. Every option sits in a settings window, so there is no config file to learn. It runs on macOS 13 Ventura and later, on Apple silicon (M1 or later), and needs only the Accessibility permission. It has stacks, tabbed columns, floating windows and a three- or four-finger swipe that follows your fingers. It uses macOS Spaces rather than its own workspaces, and it has no overview. You can try the layout in the [live demo](https://ribbonformac.com/#demo) before you buy.

### OmniWM

[OmniWM](https://github.com/OmniNull/OmniWM) is free and open source (GPL-2.0). It offers a niri-style scrolling layout or a Hyprland-style dwindle layout per workspace, plus an overview, its own workspaces, scratchpads and a command palette. It is the most niri-like option on paper. The catch: macOS 26 Tahoe or later, Apple silicon only. There's a full comparison in [Ribbon vs OmniWM](https://ribbonformac.com/ribbon-vs-omniwm).

### Nehir

[Nehir](https://github.com/apphane-dev/nehir) is a fork of OmniWM cut down to the niri column layout only. It's free (GPL-2.0), needs macOS 15 Sequoia or later, has its own workspaces and an overview, and is configured with TOML files plus a settings window. It is a smaller project, and the repo has been quiet since August 2026.

### PaperWM.spoon

[PaperWM.spoon](https://github.com/mogenson/PaperWM.spoon) is a free (MIT) plugin for [Hammerspoon](https://github.com/Hammerspoon/hammerspoon), configured in Lua. It's inspired by GNOME's PaperWM rather than niri, but the strip works the same way. It uses native Spaces and has an opt-in trackpad swipe. You need to be comfortable editing `init.lua`. See [PaperWM for Mac](https://ribbonformac.com/paperwm-for-mac) for the details.

### Paneru

[Paneru](https://github.com/karinushka/paneru) is a free (MIT) command-line window manager written in Rust, configured with TOML or Lua. It works with native Spaces, has trackpad swiping, and has experimental virtual workspaces. Ribbon's engine is built on Paneru, so if you're happy with a config file and the terminal, Paneru gives you the same core for free.

## Side by side

| | Ribbon | OmniWM | Nehir | PaperWM.spoon | Paneru |
| --- | --- | --- | --- | --- | --- |
| Price | $9.99 once | Free | Free | Free | Free |
| Source | Closed (engine built on Paneru) | GPL-2.0 | GPL-2.0 | MIT | MIT |
| Minimum macOS | 13 Ventura | 26 Tahoe | 15 Sequoia | 13 (via Hammerspoon) | Not stated |
| Intel Macs | No | No | Not stated | Not stated | Not stated |
| Workspaces | macOS Spaces | Its own | Its own | macOS Spaces | Spaces plus virtual rows |
| Overview | No (strip indicator) | Yes | Yes | No | No |
| Trackpad swipe | On by default | Yes | Yes | Opt-in | Yes |
| Configuration | Settings window | Settings window plus TOML | Settings window plus TOML | Lua | TOML or Lua |

## Quick key map

Ribbon uses Control + Option where niri uses Mod, so most binds are one swap away:

| niri | Ribbon |
| --- | --- |
| `Mod+H` / `Mod+L` | <kbd>⌃⌥H</kbd> / <kbd>⌃⌥L</kbd> (or arrows) |
| `Mod+Ctrl+H` / `Mod+Ctrl+L` | <kbd>⌃⌥⇧H</kbd> / <kbd>⌃⌥⇧L</kbd> |
| `Mod+R` | <kbd>⌃⌥R</kbd> |
| `Mod+F` | <kbd>⌃⌥F</kbd> |
| `Mod+C` | <kbd>⌃⌥C</kbd> |
| `Mod+V` | <kbd>⌃⌥T</kbd> |
| `Mod+1..9` | No match: <kbd>⌃⌥1</kbd>–<kbd>⌃⌥9</kbd> jump to a window, not a workspace |

The full list, including what has no equivalent, is in [niri keybindings on Mac](https://ribbonformac.com/niri-keybindings-mac). For gaps, preset widths, centring and focus rings, see [niri config on macOS](https://ribbonformac.com/niri-config-macos).

## Workspaces vs macOS Spaces, honestly

This is the biggest difference you'll feel. In niri, workspaces are cheap and dynamic: there's always an empty one below, and `Mod+U`/`Mod+I` move between them. macOS Spaces are heavier. You add them in Mission Control, and switching plays macOS's slide animation.

Ribbon gives each Space on each display its own strip and leaves Space switching to macOS: <kbd>⌃←</kbd> / <kbd>⌃→</kbd>, or a four-finger swipe. If you want workspaces that behave like niri's, OmniWM and Nehir are closer. If you'd rather keep Mission Control, full-screen apps and everything else macOS does with Spaces, Ribbon's approach fits better.

## If you're on Linux, just use niri

If you have a choice of operating system, niri on Linux is the real thing, free, and better than any Mac imitation. The Mac tools exist for people who need macOS for work or apps and miss the layout. If that's you, compare them in [the best scrolling window managers for Mac](https://ribbonformac.com/best-scrolling-window-managers-for-mac), or see [pricing](https://ribbonformac.com/#pricing) for Ribbon.

## FAQ

### Is there a macOS port of niri?

No. niri is a Wayland compositor, and macOS doesn't allow third-party compositors. Mac apps like Ribbon, OmniWM and Nehir copy niri's scrolling layout instead.

### Which Mac app is closest to niri?

OmniWM, if you count its own workspaces, an overview and a config file, but it needs macOS 26 Tahoe on Apple silicon. Nehir is similar on macOS 15 and later. Ribbon matches the strip itself and runs on macOS 13 and later.

### Can I use my niri config.kdl on a Mac?

Not directly. No Mac tool reads KDL. The [niri config on macOS](https://ribbonformac.com/niri-config-macos) page maps each option to the matching Ribbon setting.

### Is there a free way to get niri-style tiling on a Mac?

Yes. OmniWM, Nehir, PaperWM.spoon and Paneru are all free. Ribbon is paid; all sales are final with no refunds (see the [terms](https://ribbonformac.com/terms)), so try the [live demo](https://ribbonformac.com/#demo) first.

### Do I need to disable SIP?

No. Ribbon works through the Accessibility permission with System Integrity Protection left on, and OmniWM also runs with SIP enabled. Only some features of yabai, a different kind of tiler, need SIP changes.

## Keep reading
- [Niri config on macOS](https://ribbonformac.com/niri-config-macos) — Gaps, widths, centring, focus ring, input and rules: each niri option and its Mac twin.
- [Niri keybindings on Mac](https://ribbonformac.com/niri-keybindings-mac) — Each default niri bind next to its Ribbon shortcut, and the ones with no Mac twin.
- [Best scrolling WMs for Mac](https://ribbonformac.com/best-scrolling-window-managers-for-mac) — Ribbon, OmniWM, Nehir, Paneru, PaperWM.spoon and the rest, ranked by situation.
- [Ribbon vs OmniWM](https://ribbonformac.com/ribbon-vs-omniwm) — Free and Tahoe-only vs paid and macOS 13+. Spaces, gestures and setup compared.
- [Niri vs PaperWM](https://ribbonformac.com/niri-vs-paperwm-mac) — Compositor vs GNOME extension: the real differences, and the Mac options for both.