Window management

Niri for Mac: how to get the same workflow, step by step

If you are looking for Niri for Mac, Niri itself does not run on macOS: its project describes it as a scrollable-tiling Wayland compositor. You can get a related scrolling workflow on a Mac with tools such as PaperWM.spoon, OmniWM, Nehir, Ribbon, or SlidePane, though their setup and behavior differ. This guide compares those options and walks through a first hour with SlidePane.

Key facts

  • Niri is a Wayland compositor, not a macOS app.
  • PaperWM.spoon is a Hammerspoon plugin; OmniWM and Nehir are configurable Mac window managers.
  • Ribbon and SlidePane are paid scrolling-strip apps.
  • SlidePane costs $29.99 once, includes a 3-day trial, and supports one Apple silicon Mac running macOS 13 or later.
  • We make SlidePane; the workflow notes below describe its current app controls.

Pick the part of Niri you want to keep

Niri's official project page calls it a scrollable-tiling Wayland compositor. That distinction matters: macOS does not provide the Wayland session Niri expects. The Mac alternatives below are separate projects with their own implementations, not ports of Niri. Sources were checked on 2026-11-12.

OptionWhat its own project saysA good fit when
PaperWM.spoonA scrollable tiling window manager for macOS delivered as a Hammerspoon Spoon. Its README documents cloning it into Hammerspoon's Spoons folder and changing Mission Control settings.You want an open-source, scriptable approach and are comfortable maintaining Hammerspoon.
OmniWMA macOS tiling manager with scrolling columns and other layout options. Its documentation describes TOML configuration and Apple silicon/macOS requirements.You want configurable layouts, workspaces, or command-line control.
NehirA macOS tiling manager whose README describes horizontally scrolling columns, TOML configuration, app rules, and a CLI.You want a Niri-inspired column workflow and accept an evolving open-source project.
RibbonA scrolling window manager for macOS 14 or later on Apple silicon. Its site describes windows arranged on a horizontal strip.You want a focused paid scrolling app and your Mac meets its stated requirements.
SlidePaneA scrolling window manager with settings, profiles, stacks and tabs, and a menu bar popover.You want a paid app with a guided setup and prefer settings over writing a config file.

These descriptions are not a feature-for-feature test. Each link goes to the project's own page; check its latest requirements and setup notes before installing. PaperWM.spoon is the better choice if you want a free, open-source scriptable tool. OmniWM or Nehir suit people who want to edit a configuration and control the manager from a CLI. Choose Ribbon if its own requirements and one-strip model suit you. Keep macOS's built-in window arrangement if you only need occasional side-by-side placement.

Your first hour with SlidePane

Start by closing or pausing any other window manager. Two tools that reposition the same windows can compete. Open SlidePane, follow its first-run prompts, and grant Accessibility access when macOS asks; this is what lets the app manage windows. The app requires macOS 13 or later on Apple silicon.

Open three windows you already use for one task, such as a browser reference, a document, and a notes window. Enable window management from the app's setup flow. Move focus between windows with the configured shortcuts shown in the Shortcuts settings. If you prefer pointer navigation, use the app's menu bar popover to inspect the strip and select a window. Avoid carrying over keybindings from Niri by assumption; map only the actions you need.

Spend the next few minutes choosing useful widths. The strip allows windows to keep individual widths while you navigate horizontally. Set the document wide enough to read, keep a reference narrower, and move between them. If two windows need to remain together but you do not need both visible at once, use the app's stacks or tabs controls. The stacks and tabs guide explains how those groups behave.

Finally, try the recovery path before arranging a full work session. Use Pause and restore windows from the menu bar. It stops management and returns surviving windows to their original positions on connected displays. Turn management back on only after you understand how the strip feels with your real apps. You can test the app free for 3 days; a licence is a one-time $29.99 purchase for one Mac, with a 3-day refund period. It works offline for up to 7 days between licence checks and does not require an account.

What will feel different from Niri

A macOS window manager works with app windows inside the desktop environment. It does not replace the display server or provide Niri's Wayland session. Expect differences in how focus, workspaces, gestures, and windows outside the visible area behave. Test the apps you rely on, especially if your routine depends on strict keyboard-driven workspace movement.

SlidePane offers a scrolling strip and settings-oriented controls; it does not import a Niri config. You will need to choose the layout, widths, and shortcuts yourself. If you want a close match to Niri's configuration vocabulary, evaluate Nehir or OmniWM directly. If your priority is free code you can inspect and modify, PaperWM.spoon has the advantage. The right Mac option depends on which part of the workflow you want to preserve.

Keep exploring

We make SlidePane, so this walkthrough is product guidance, not an independent ranking. Read the shortcuts guide, the stacks and tabs guide, and profiles and undo before settling on a workflow.

Cite or share this page

Dapols. "Niri for Mac: how to get the same workflow, step by step." SlidePane, November 18, 2026. https://slidepane.com/en/blog/niri-on-mac

The link is stable. The citation uses the page's “Last updated” date.