Hyprland on a Mac: what you can and can't get
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:
- 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 (BSP) | Very close; same binary-tree idea |
| dwindle | OmniWM's dwindle mode | Close; macOS 26 Tahoe, Apple silicon only |
| dwindle | AeroSpace | Tree tiling, but i3-style manual splits |
| master | 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, 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 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:
column_widthandexplicit_column_widths→ Column width presets, cycled with ⌃⌥R.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,expelandconsume_or_expel→ stack and pop-out keys like ⌃⌥] and ⌃⌥⇧].
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:
- 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. 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.