Niri vs PaperWM: the real differences (and what runs on a Mac)

Both put your windows on an endless horizontal strip. The difference is what sits underneath — and that decides which one fits you. If you're on a Mac, neither runs; skip to the Mac section.

tl;dr

Same scrolling-strip idea, different foundations. Niri is a standalone Wayland compositor written in Rust — minimal, fast, you log into it. PaperWM is a GNOME Shell extension — you keep the whole GNOME desktop. Neither runs on macOS; on a Mac the equivalents are ChainYourMac, OmniWM (macOS 26+) and PaperWM.spoon.

Try it right here — this is a working model of ChainYourMac, not a video.

A working model of ChainYourMac, not a video. Drag a title bar to reorder, click a Dock icon to open an app, close a window with its red button. In the real app every key here is plus the key.

  • Notarized by Apple
  • Signed with Developer ID
  • No account, no telemetry in the app
  • Only needs the Accessibility permission
  • Automatic updates

What they share

Both are scrolling window managers. Windows sit side by side on a strip that continues past the edges of your screen. Opening a window adds a column next to the focused one; nothing else resizes. You move through your work by scrolling the strip, not by rearranging a grid. If you like one, the other will feel familiar within minutes.

Niri vs PaperWM: the differences that matter

NiriPaperWM
What it isStandalone Wayland compositorGNOME Shell extension
Written inRustJavaScript (GNOME Shell)
Desktop around itNone — bring your own bar, launcher, notificationsAll of GNOME
ConfigurationText config fileGNOME extension preferences
SetupInstall, pick the Niri session at loginEnable the extension
Depends onNothing but itselfYour GNOME version being supported
Runs on macOSNoNo

Foundations decide the feel

Because Niri is the display server, it draws every frame itself. That's why people describe it as smooth and tight — there's no host environment to negotiate with. The cost is that you assemble the rest of the desktop yourself.

PaperWM lives inside GNOME Shell. You get GNOME's settings, app grid, notifications and extensions for free, and PaperWM rearranges the windows. The cost is coupling: when GNOME ships a new major version, PaperWM has to catch up.

Configuration

Niri is configured in a text file, which suits people who keep dotfiles in git. PaperWM exposes its options through GNOME's extension preferences, which suits people who'd rather click than edit.

Who should pick which (on Linux)

  • Pick Niri if you want a minimal, standalone setup, you're happy to choose your own bar and launcher, and you like a config file.
  • Pick PaperWM if you're already on GNOME and want the strip without giving up the rest of your desktop.

On a Mac? Here's what actually runs

Neither Linux original will ever run on macOS — Apple's compositor can't be replaced and there's no GNOME. What you can install are Mac implementations of the same model:

ChainYourMacOmniWMPaperWM.spoon
What it isNative app (SwiftUI + Rust engine)Native app, open sourceLua script for Hammerspoon
macOS13 Ventura and later26 Tahoe and laterAny version Hammerspoon supports
Closest toNiri's strip, stacks and tabbed columnsNiri (plus a Dwindle layout)PaperWM
ConfigurationGUI, applies instantlyGUI + TOMLinit.lua
Price$9.99 one timeFreeFree

If you liked PaperWM and enjoy scripting, PaperWM.spoon is the faithful free recreation. If you liked Niri's calm strip and want it to feel built into macOS — GUI settings, a trackpad swipe that follows your fingers, stacks, tabbed columns — that's what ChainYourMac is for, and it runs back to macOS 13. On macOS 26 Tahoe, OmniWM is a strong free alternative. The full Mac rundown lives at Niri for Mac.

The Niri/PaperWM strip, as a Mac app.

No Hammerspoon, no SIP, no config file — a native app with a trackpad swipe that follows your fingers.

Get ChainYourMac — $9.99 $19.9950% off one-time purchase · free updates forever · macOS 13+ on Apple silicon

FAQ

Is Niri better than PaperWM?

Neither is strictly better — they share the scrolling model. Niri is a standalone Wayland compositor, so it controls every frame and doesn't need a desktop environment. PaperWM runs inside GNOME, so you keep GNOME's apps, settings and extensions. Pick Niri for a minimal, fast, standalone setup; pick PaperWM if you want to stay on GNOME.

Did Niri copy PaperWM?

PaperWM popularised the scrolling strip on the Linux desktop, and Niri's own README credits PaperWM as its inspiration. Niri rebuilt the idea as a standalone compositor written in Rust.

Can I run Niri or PaperWM on a Mac?

No. Niri is a Wayland compositor and PaperWM is a GNOME Shell extension — both need Linux. On macOS you use a Mac implementation of the same model: ChainYourMac, OmniWM (macOS 26+) or PaperWM.spoon.

Is PaperWM.spoon the same as PaperWM?

No. PaperWM.spoon is a separate project: a Lua recreation of PaperWM's layout for Hammerspoon on macOS, not a port of the GNOME extension. The strip model is faithful; the environment is completely different.

Which is easier to set up?

PaperWM, if you already run GNOME — it's an extension you enable. Niri means installing and logging into a new session and writing its config file. On a Mac, the easiest is a native app you drag to Applications.