A keyboard-driven tiling window manager for macOS, inspired by Hyprland. Free, open source, and the first real job your Caps Lock key has ever had.

▶ Watch the one-minute demo · Try it in your browser · hyprmac.app

If your Mac usually looks like a pile of windows stacked on top of each other, and the one you want is always at the bottom, HyprMac is for you.

• Windows arrange themselves. Open an app and it slots into a tidy tiled layout. No dragging, no resizing, no digging.
• Your keyboard drives. Hold Caps Lock, which becomes your Hypr key out of the box (there are a bunch of alternatives!), and tap an arrow to jump between windows. Add Shift to swap them. Tap a number to switch workspaces.
• You can't get lost. Forgot a shortcut? Hypr + K shows every one of them.

A handful of keys covers the basics, and most people have them down in a few minutes. When you want more, every keybind is remappable and you can point keys at your own scripts.

Homebrew:

brew trust --cask zacharytgray/hyprmac/hyprmac
brew install --cask zacharytgray/hyprmac/hyprmac

Homebrew refuses to load casks from third-party taps until you trust them. The first line trusts only the HyprMac cask, which also lets brew upgrade --cask hyprmac work later.

Or grab the DMG: HyprMac.dmg, open it, and drag HyprMac to Applications. Older versions live on the releases page.

Then follow the install guide for first-run setup, permissions, and the recommended macOS settings.

• macOS 13 (Ventura) or later
• Accessibility permission, in System Settings → Privacy & Security → Accessibility. HyprMac uses the Accessibility APIs plus private window-server calls, and it runs with System Integrity Protection on.
• For the default Caps Lock Hypr key: Caps Lock must stay set to "⇪ Caps Lock" in System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys, not "No Action". The pane is per keyboard, so check each one you use. HyprMac remaps Caps Lock to F18 itself.
• The same holds if Option or Command is your Hypr key: leave it on its default there. Backslash and F13–F20 are not in that pane and need nothing.
• macOS gives apps no way to read that setting, so HyprMac shows this as a reminder in onboarding and in Settings → Keys, with an Open Keyboard Settings button.

You'll feel at home. The differences are mostly macOS being macOS:

• Tiling: BSP dwindle, like Hyprland's default layout. New windows split the focused one, and Hypr + J flips the split direction. Drag a tiled window by its title bar onto another tile's edge to insert it there, or hold Hypr while dragging to swap the two. The tile can be on another monitor, and an empty workspace there takes the window whole. A highlight shows where the window will land before you let go.
• Workspaces: ten of them (keys 1–9 and 0), plus a scratchpad and an overview on Hypr + O. macOS has no public API for this, so HyprMac keeps its own virtual workspaces and hides the other workspaces' windows when you switch.
• Hypr + F: native macOS fullscreen spawns its own Space and wrecks the layout, so HyprMac fills the display with the window over its workspace instead. Press it again and the window goes back to its tile.
• Focus follows mouse: on by default, with an adjustable hover rate.
• Hypr key: Caps Lock by default. Settings → Keys also offers backslash, F13–F20, and Option or Command on either side. If you pick the left Option or Command key, that key plus a key HyprMac uses goes to HyprMac, so type shortcuts like ⌘S or ⌘T with the right-hand key. Shift and Control are not offered because many default shortcuts add them to Hypr. Tab and backtick are not offered because Hypr+Tab, Hypr+Shift+Tab, and Hypr+` are default shortcuts. A config that already uses one of these keys keeps working, and Settings → Keys says why it is no longer recommended.
• Config: everything, including the Hypr key itself, lives in Settings and is saved as JSON at ~/Library/Application Support/HyprMac/config.json. The schema is in Keybinds and actions. A config file HyprMac can't decode is copied to config.json.unreadable before a save overwrites it.
• Your own tools: Settings → Keys → Add → Command… binds a chord to any program or script. It runs directly, not through a shell, so keep pipes and redirects inside a script.

Everything below is configurable in Settings → Keys. The full reference lives at hyprmac.app/guides/keybinds.

Settings → General → "Pin apps" sends an app to a workspace of your choice, or to the scratchpad. Every new window of a pinned app opens there, and HyprMac shows it. An app pinned to the scratchpad also goes back there at launch and on Hypr + R, with the scratchpad left closed. If a pinned workspace is full, the window goes to the next one with room. Hypr + R (Retile all spaces) also moves a pinned app's open windows back to its workspace. An app in "Never tile" can be pinned too: it goes to its workspace and stays floating.

Apps in "Never tile" can't be tiled by hand either. Hypr+T on one shakes red and says so; remove the app from the list to tile it again.

Hypr + Ctrl + S saves which workspace each tiled window is on and how each workspace is split, across every monitor, for the displays you have connected right now. Hypr + Ctrl + R puts all of it back. Restore only moves windows that are open; it doesn't reopen closed apps, and a saved window that isn't open is skipped. A HUD like the workspace switch one says whether the layout was saved, restored, or only partly restored.

HyprMac also saves on its own just before your displays change, and restores when you return to a display setup it has saved. To restore at launch too, turn on "Restore saved layout at launch" in Settings → General.

Saved layouts stay on this Mac in ~/Library/Application Support/HyprMac/layout-snapshots.json. The file keeps window titles so it can tell windows apart. To clear it, quit HyprMac and delete the file, plus layout-snapshots.json.unreadable if it exists. Setups with the same monitor models at the same resolutions share one saved layout, however they are arranged.

macOS was not built to let other apps manage its windows, and every tiling window manager on the Mac is working against that. Some apps push back, and now and then a window will insist on doing its own thing. HyprMac is in active development and very usable day to day. When something misbehaves, open an issue and tell me about it.

HyprMac checks for updates on its own through Sparkle and offers to install them, or use the menu bar icon → "Check for updates…". Homebrew installs can run brew upgrade --cask hyprmac. After any update, macOS may ask you to re-grant Accessibility permission, because the signature changes with each release.

git clone https://github.com/zacharytgray/HyprMac.git
cd HyprMac

brew install xcodegen
xcodegen generate

export DEVELOPMENT_TEAM=YOUR_TEAM_ID
xcodebuild -project HyprMac.xcodeproj -scheme HyprMac -configuration Debug \
  -derivedDataPath build DEVELOPMENT_TEAM=$DEVELOPMENT_TEAM build

cp -r build/Build/Products/Debug/HyprMac.app /Applications/

• Architecture: subsystems, ownership rules, threading
• Tiling algorithm: BSP dwindle, smart insert, two-pass layout
• Keybinds and actions: the Action enum and its JSON schema
• Status bars: state.json, the change hook and hyprmac:// links for sketchybar, turned on by hand in monitor-config.json
• Control from other apps: hyprmac://action/… links for BetterTouchTool, Raycast and scripts
• Debugging: Console filters, verbose logging, common recipes
• Release pipeline: how a release is built, signed, and published

Bug reports, ideas, and pull requests are all welcome. Before you open a pull request, run the test gate:

./scripts/test-isolated.sh --debug-variant

• Hyprland: the Wayland compositor this project takes after
• yabai: macOS tiling window manager
• AeroSpace: Swift tiling window manager with virtual workspaces
• Amethyst: macOS tiling window manager
• skhd: hotkey daemon

MIT