# Hyprland on a Mac: what you can and can't get

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

Hyprland doesn't run on macOS and never will: it's a Wayland compositor, and macOS doesn't let anyone replace its compositor. But Hyprland's layouts each have a Mac stand-in. Dwindle maps to yabai, AeroSpace or OmniWM, scrolling to Ribbon, OmniWM or PaperWM.spoon, and master to Amethyst. The blur and shaders stay on Linux.

## Why Hyprland can't come to macOS

[Hyprland](https://github.com/hyprwm/Hyprland) is a compositor. It draws every window itself, which is how it can blur what's behind a terminal, run shaders and animate every window as it opens and closes.

On a Mac, only Apple's WindowServer draws windows. A third-party window manager is an ordinary app that asks other apps, through the Accessibility API, to move and resize their windows. It can place windows anywhere and it can draw a simple overlay, like a border. It can't change how another app's window looks.

So the realistic goal is Hyprland's *layouts* and keyboard flow, not its looks.

## Hyprland's layouts in 2026

Hyprland used to be "dwindle, plus plugins". That changed in 0.54. The layout system was rewritten, the official scrolling plugin moved into core, and a monocle layout arrived. `general:layout` now takes four values:

- **dwindle** (the default): a binary tree, like bspwm. Each new window splits the focused one.
- **master**: one or more main windows on the left, the rest stacked on the right.
- **scrolling**: columns on a strip that scrolls, like niri or PaperWM.
- **monocle**: every window fills the workspace.

You can also pick a layout per workspace, say dwindle on 1 to 4 and scrolling on 9 and 10.

The config is changing too. From 0.55, Hyprland reads `hyprland.lua`, and the old `hyprland.conf` format is only supported for a release or two after that. If you're rewriting your config anyway, it's a good moment to look at what you actually use.

## The closest Mac option for each layout

| Hyprland layout | Closest on macOS | How close |
| --- | --- | --- |
| dwindle | [yabai](https://github.com/asmvik/yabai) (BSP) | Very close; same binary-tree idea |
| dwindle | [OmniWM](https://github.com/OmniNull/OmniWM)'s dwindle mode | Close; macOS 26 Tahoe, Apple silicon only |
| dwindle | [AeroSpace](https://github.com/nikitabobko/AeroSpace) | Tree tiling, but i3-style manual splits |
| master | [Amethyst](https://github.com/ianyh/Amethyst) (Tall, Wide and others) | Close; xmonad-style main and stack |
| scrolling | Ribbon | Close; preset widths, centring, trackpad swipe |
| scrolling | OmniWM | Close; also has dwindle and its own workspaces |
| scrolling | [PaperWM.spoon](https://github.com/mogenson/PaperWM.spoon), [Paneru](https://github.com/karinushka/paneru) | Close; free, config in Lua or TOML |
| monocle | Amethyst's Fullscreen layout, AeroSpace accordion | Partial |
| Per-workspace layouts | OmniWM, Amethyst, yabai | Partial; each in its own way |

### If you lived in dwindle

yabai is the nearest thing. It tiles with binary space partitioning and also has `stack` and `float` layouts per Space. It uses native Spaces, needs skhd for hotkeys, and is configured with a shell script. Some features, including window animations, opacity and moving Spaces around, need System Integrity Protection partly disabled. Read [Ribbon vs yabai](https://ribbonformac.com/ribbon-vs-yabai) or [yabai without SIP](https://ribbonformac.com/yabai-without-sip) before you decide.

AeroSpace is the other big free choice. It's closer to i3 than to dwindle: you choose split directions yourself rather than letting the tree spiral. It never needs SIP changes and uses its own workspaces. [Ribbon vs AeroSpace](https://ribbonformac.com/ribbon-vs-aerospace) compares it with a scrolling approach.

On macOS 26 Tahoe with Apple silicon, OmniWM's dwindle mode is free and also gives you scrolling on other workspaces, which is the most Hyprland-like mix on a Mac.

### If you lived in master

Amethyst is built around xmonad-style layouts: Tall, Wide, Two Pane, three-column variants and more, with BSP and fullscreen too. You cycle between them per screen or Space. It has a GUI preferences window plus an optional YAML file, and needs only Accessibility.

### If you moved to scrolling

This is where the Mac has the most choice. Hyprland's scrolling options map well onto Ribbon's settings window:

- `column_width` and `explicit_column_widths` → **Column width presets**, cycled with <kbd>⌃⌥R</kbd>.
- `focus_fit_method` (centre or fit) → **Centre the focused column**: Always, On overflow or Never.
- `wrap_focus` → no direct match; Ribbon has **Width presets wrap around** for the width cycle instead.
- Layout messages `consume`, `expel` and `consume_or_expel` → stack and pop-out keys like <kbd>⌃⌥]</kbd> and <kbd>⌃⌥⇧]</kbd>.

Ribbon is paid ($9.99 once), runs on macOS 13 and later on Apple silicon (M1 or later), and uses macOS Spaces. Free alternatives are OmniWM (Tahoe only), PaperWM.spoon (Lua) and Paneru (TOML or Lua; Ribbon's engine is built on it). There's more in [the best scrolling window managers for Mac](https://ribbonformac.com/best-scrolling-window-managers-for-mac), and you can try Ribbon's strip in the [live demo](https://ribbonformac.com/#demo).

## What you'll miss: the eye candy

Be ready to let go of these:

- **Blur** behind transparent windows. Not possible from a window manager.
- **Shaders** and screen effects. Not possible.
- **Decorations drawn by the compositor.** Mac tools can at most draw an overlay border around the focused window.
- **Open, close and workspace animations on every window.** Mac window managers can animate a window sliding to a new spot by moving it in steps, and Ribbon does this with a spring. They can't add a fade or a pop-in to someone else's window. yabai can do more here, but only with SIP partly turned off.
- **Per-window opacity.** Again, yabai only, with SIP changes.

Ribbon's own visual touches are modest: an optional focus border, dimming for inactive windows, and a strip indicator with app icons.

## If Lua config is what you liked

Hyprland's move to Lua won't follow you to most Mac tools. AeroSpace uses TOML, yabai a shell script, Amethyst a GUI plus YAML, and Ribbon a settings window. The exceptions are PaperWM.spoon, which is Lua through Hammerspoon, and Paneru, which accepts an `init.lua` as well as TOML.

## The honest answer

If you can run Linux, run Hyprland. It's free, and no Mac tool will match it. If you need macOS, pick the layout you used most and take the matching tool from the table above. Coming from i3 or sway rather than Hyprland? See [i3 for Mac](https://ribbonformac.com/i3-for-mac). If scrolling is the one you want, Ribbon's [pricing](https://ribbonformac.com/#pricing) is one line: $9.99 once.

## FAQ

### Can I install Hyprland on macOS?

No. Hyprland is a Wayland compositor for Linux, and macOS doesn't allow third-party compositors. You can copy its layouts with Mac window managers instead.

### Does Hyprland have a scrolling layout now?

Yes. Since 0.54, scrolling is built into Hyprland alongside dwindle, master and monocle. The old hyprscrolling plugin moved into core.

### What is the closest thing to Hyprland's dwindle layout on a Mac?

yabai, which uses binary space partitioning. OmniWM also has a dwindle mode on macOS 26 Tahoe with Apple silicon.

### Can a Mac window manager do blur and animations like Hyprland?

Not really. macOS window managers move windows through Accessibility and can't change how other apps draw. yabai can add opacity and some animations, but only with SIP partly disabled.

### Is there a Mac tool that uses Lua like the new Hyprland config?

Yes, a couple. PaperWM.spoon is configured in Lua through Hammerspoon, and Paneru accepts an init.lua file.

## Keep reading
- [Niri for Mac](https://ribbonformac.com/niri-for-mac) — Niri itself is Linux-only. Five ways to get its scrolling strip on macOS.
- [i3 for Mac](https://ribbonformac.com/i3-for-mac) — No i3 or sway on macOS. Match the i3 habit you miss to the right Mac tiler.
- [Ribbon vs yabai](https://ribbonformac.com/ribbon-vs-yabai) — Free BSP tiling driven by scripts vs a paid scrolling strip you set up in a window.
- [Ribbon vs AeroSpace](https://ribbonformac.com/ribbon-vs-aerospace) — Free i3-style tree with its own workspaces vs a paid strip that keeps macOS Spaces.
- [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.