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

Updated 2026-10-22 · by the maker of Ribbon

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 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:

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 layoutClosest on macOSHow close
dwindleyabai (BSP)Very close; same binary-tree idea
dwindleOmniWM's dwindle modeClose; macOS 26 Tahoe, Apple silicon only
dwindleAeroSpaceTree tiling, but i3-style manual splits
masterAmethyst (Tall, Wide and others)Close; xmonad-style main and stack
scrollingRibbonClose; preset widths, centring, trackpad swipe
scrollingOmniWMClose; also has dwindle and its own workspaces
scrollingPaperWM.spoon, PaneruClose; free, config in Lua or TOML
monocleAmethyst's Fullscreen layout, AeroSpace accordionPartial
Per-workspace layoutsOmniWM, Amethyst, yabaiPartial; 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 or 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 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:

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, and you can try Ribbon's strip in the live demo.

What you'll miss: the eye candy

Be ready to let go of these:

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. If scrolling is the one you want, Ribbon's 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