# Hyprland for Mac: the Linux compositor, on macOS

> Hyprland is a Wayland compositor for Linux, so it cannot run on macOS. Here is the closest thing on a Mac, and how its scrolling layout maps across.

Source: https://www.ribbonmac.com/guides/hyprland-for-mac · Updated 2026-11-13

**Hyprland** is a dynamic tiling Wayland compositor for Linux, and the one most people mean when they say they have "riced" their desktop. Animations, blur, rounded corners, four layouts, plugins, a config file that reloads the moment you save it. Sitting down at a Mac afterwards feels like being handed a locked box.

Hyprland will not run on macOS. But the part of it you spend the day in can.

## Why Hyprland cannot run on a Mac

On Linux, Hyprland is not an app that manages windows. It *is* the display server: it draws every window, takes every keypress and decides what is on the screen. Its own docs are blunt about the trade: Hyprland is "a set of tools to allow you to create your own Desktop Environment", and the install page opens with a warning that it is "not meant to be a full and user-friendly Desktop Environment" and that apps, integrations and shells are your responsibility to pick and maintain.

It also installs the way a system component does, per distribution. `pacman -S hyprland` on Arch, `programs.hyprland.enable` on NixOS, `pkg install hyprland` on FreeBSD, `zypper in hyprland` on openSUSE. There is no macOS entry, because there is nothing to install into.

macOS ships its own window server as part of the operating system, and nothing can swap it out or extend it the way a GNOME extension or a compositor plugin can. The one lever a Mac app has is the Accessibility permission: with it, an app can ask the system to move and resize windows it does not own. Every "window manager for Mac" is that, and so is [Ribbon](https://www.ribbonmac.com/).

## The layout you use most is the one that travels

Here is the part that usually surprises people. Hyprland ships four layouts, and one of them is scrolling. Straight from Hyprland's own wiki: "Scrolling is a layout where windows are positioned on an infinitely growing tape." Columns run along a tape that grows in one direction, a column is half the screen by default, and the preset widths are 0.333, 0.5, 0.667 and 1.0.

That is the same model Ribbon is built on, and the same idea behind [niri](https://www.ribbonmac.com/guides/niri-for-mac) and [PaperWM](https://www.ribbonmac.com/guides/paperwm-for-mac). So if the layout you actually live in is Hyprland's scrolling one, you are not leaving it behind on a Mac. You are moving it somewhere it runs natively.

## Hyprland's tape, and Ribbon's strip

| In Hyprland, scrolling layout | In Ribbon on macOS |
|---|---|
| Windows sit on an infinitely growing tape | Every window gets a full-height column on a strip that runs past both edges of the screen |
| Opening a window adds a column and never resizes the others | The same: a new window slides in beside the focused one |
| `column_width` defaults to 0.5, presets 0.333, 0.5, 0.667, 1.0 | ⌃⌥R cycles ⅓, ½ and ⅔; ⌃⌥F fills the screen and puts it back |
| `focus l/r`, with wrap at the ends of the tape | ⌃⌥ ← → to focus, and it wraps too |
| `swapcol l/r` to move a column | Add ⇧ to the arrows to carry the focused window |
| `focus_fit_method`: centre the column, or fit it into view | ⌃⌥C centres the focused window |
| `direction` set per workspace, including down and up | The strip is horizontal per display, and ⌃⌥N sends a window to the next display |
| Touchpad gestures for the tape | Three- or four-finger swipes that follow your fingers one to one, with flicks and rubber-banding at the ends |
| Optional bar or a map of where you are | A strip map that floats up while you move, in six styles |

Some Hyprland moves have no direct equivalent because macOS owns more of the screen than Hyprland does, but the daily ones all landed. Focus, carry, widths, centre, and a swipe that moves the strip with your hand.

## What does not come across

Worth being straight about the rest.

**The looks.** Hyprland draws every frame itself, which is why it can blur a wallpaper behind a terminal or animate a window onto a workspace. macOS draws its own windows and an app cannot restyle them. There is no Hyprland-grade blur or custom window animation on a Mac, from Ribbon or anything else.

**The config file and the plugin ecosystem.** Hyprland is configured in a text file with live reload, controlled at runtime over its IPC socket through `hyprctl`, and extended with plugins written in C++ and loaded into the process. A Mac window manager runs outside the window server, so there is no process to load a plugin into and no socket to drive the server with. Ribbon's answer is a Settings window with shortcuts, gaps, widths and per-app rules, plus `ribbon://` URLs, a `ribbon` command-line tool and Raycast scripts when you would rather script it.

**The layouts that split.** Dwindle, master and monocle all shrink your windows to make room. Ribbon never does, because not shrinking windows is the whole idea. If a shrinking grid is what you want, that is a different app.

**The Linux-only plumbing.** Xwayland, fractional scaling for X11 apps, NVIDIA and DRM quirks, Waybar modules, hyprlock. None of it applies. macOS apps are macOS apps, and a Mac window manager never sees a Wayland client.

**Workspaces.** Hyprland's workspaces, including special workspaces that slide in and out, are a compositor feature. macOS has Spaces, which you still create and switch with the system, plus Ribbon's own per-display strip on top. The two sit side by side rather than replacing one another. [Hot corners](https://www.ribbonmac.com/guides/how-to-use-hot-corners-on-mac) are the Mac way to get a workspace-like jump without a keybinding.

## The rest of the desktop comes with the Mac

On Linux you assemble the desktop. Hyprland gives you the compositor and you add the bar, the launcher, the lock screen, the notification daemon, the wallpaper tool, the screenshot picker. Half of what people love about a riced Hyprland setup is that stack, and none of it exists on macOS, because macOS already has a menu bar, a Dock, Spotlight, Notification Centre, a lock screen and a screenshot tool.

That cuts both ways. You lose the freedom to swap every piece. You also stop maintaining them. What is left for a window manager to do on a Mac is the one job Ribbon does: decide where windows sit. It leaves your menu bar, Dock and wallpaper alone, and there is nothing to install or keep updated behind it.

## If it is the tiling you miss, not the scrolling

Plenty of Hyprland users spend their day in dwindle and barely touch the scrolling layout. For that, you want a tiling window manager, and macOS has good ones: [AeroSpace](https://www.ribbonmac.com/guides/ribbon-vs-aerospace) is the closest thing to a keyboard-driven tiler, [yabai](https://www.ribbonmac.com/guides/ribbon-vs-yabai) is the closest to a fully scripted setup, and Amethyst does the job with a graphical setup. They bring dwindle's behaviour, and dwindle's trade-off: windows get smaller as you open more of them.

Ribbon is the other answer to the same question. [What a scrolling window manager is](https://www.ribbonmac.com/guides/what-is-a-scrolling-window-manager) explains the difference in full.

## The other Linux window managers people ask about

Hyprland is not the only one that cannot make the trip, and the answer is the same for each. [**i3**](https://www.ribbonmac.com/guides/i3-for-mac), the config-language father of the whole genre, is an X11 window manager. **sway** is i3 for Wayland. **dwm** is patched and compiled from source by hand. All three replace or sit inside a Linux display stack, so none of them run on macOS.

The useful question on a Mac is not which Linux window manager you miss, but which behaviour you miss. If it is columns on a strip, that is [PaperWM's](https://www.ribbonmac.com/guides/paperwm-for-mac) and [niri's](https://www.ribbonmac.com/guides/niri-for-mac) territory, and Ribbon. If it is i3's grid, it is AeroSpace and yabai.

## Getting set up

1. [Download Ribbon](https://www.ribbonmac.com/) and drag it to Applications.
2. Give it Accessibility access when it asks. That is the permission every window manager on macOS runs on.
3. Follow the setup checks. Ribbon warns you if a three-finger swipe is also switching full-screen apps, or if macOS's own edge tiling is on, and shows where to turn them off so the two do not fight.
4. Open a few apps and swipe. ⌃⌥ ← → and ⌃⌥R will feel like home within a minute.

## Try it

Ribbon runs on macOS 14 Sonoma or later on Apple silicon and Intel. A licence is $15 once, with a full refund within 10 days if it does not stick. You can also drive the strip on the [home page](https://www.ribbonmac.com/#drive) with your arrow keys before you install anything.

## FAQ

### Can I install Hyprland on macOS?

No. Hyprland is a Wayland compositor, which means that on Linux it is the display server as well as the window manager. macOS has its own window server and it cannot be replaced or extended, so there is nothing for Hyprland to install into. The Arch, NixOS, FreeBSD and openSUSE packages on Hyprland's own install page are the only routes.

### What is the closest thing to Hyprland on a Mac?

It depends which half of Hyprland you use. If you use its scrolling layout, Ribbon is the closest: a native Mac app that gives every window a full-height column on a strip running past the edges of the screen, with keyboard control and a trackpad swipe. If you use its dwindle layout, a tiling window manager such as AeroSpace or yabai is closer.

### Does Hyprland have a scrolling layout?

Yes. Hyprland ships four layouts, dwindle, master, monocle and scrolling, and its wiki defines the last one in one line: scrolling is a layout where windows are positioned on an infinitely growing tape. A column is half the screen by default, and the preset widths are 0.333, 0.5, 0.667 and 1.0.

### Can I use my hyprland.conf on a Mac?

No. There is no compositor on macOS to read it and no hyprctl socket to talk to. Ribbon keeps the same ideas in a Settings window you click through instead, plus ribbon:// URLs, a ribbon command-line tool and Raycast scripts if you would rather script it.

### Is there a Hyprland plugin for macOS?

No. Hyprland plugins are C++ modules loaded straight into the compositor process. On macOS a window manager runs as an ordinary app, outside the system's window server, so there is nothing to load a plugin into. Ribbon covers the usual plugin ground with per-app rules, its strip map and automation hooks.
