zacharytgray/HyprMac: Keyboard-first tiling window manager for macOS, inspired by Hyprland

What it does

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. Hold one key, tap another, and the desktop does what you asked.

Windows arrange themselves Open an app and it slots into a tidy tiled layout. No dragging, no resizing, no digging.	Your keyboard drives Hypr + an arrow moves between windows. Add Shift to swap them. Hypr + J flips a split.
Ten workspaces Hypr + a number jumps to a workspace. Add Shift to send the focused window there.	A scratchpad one key away Keep music or notes on a floating layer. Hypr + S brings it up and puts it away.

The five keys to know

The Hypr key is Caps Lock out of the box. Hold it like a modifier.

| Keys | What happens | |------|--------------| | Hypr + ← → ↑ ↓ | Move between windows | | Hypr + Shift + ← → ↑ ↓ | Swap windows around | | Hypr + 1–9, 0 | Jump to workspace 1–9, or 10 | | Hypr + Return | Open Terminal | | Hypr + K | Show every keybind |

Most people have these down in a few minutes. Forgot one? Hypr + K lists every shortcut, and you can type to filter it. When you want more, every keybind is remappable and you can point keys at your own scripts.

Install

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.

No Homebrew? Download [HyprMac.dmg][dmg], open it, and drag HyprMac to Applications. Older versions are on the [releases page][releases].

Then follow the install guide for first-run setup, permissions, and the recommended macOS settings. A short tour on first launch walks you through the keys.

Requirements

• macOS 13 (Ventura) or later, on Apple silicon or Intel.
• Accessibility permission, in System Settings → Privacy & Security → Accessibility.
• Nothing else. System Integrity Protection stays on.

[!IMPORTANT]

With Caps Lock as your Hypr key, leave Caps Lock set to "⇪ Caps Lock" in System Settings →

Keyboard → Keyboard Shortcuts → Modifier Keys. Do not set it to "No Action". The pane is per

keyboard, so check each one you use. HyprMac remaps Caps Lock to F18 itself.

| In Hyprland | In HyprMac | |-------------|------------| | Dwindle layout | BSP dwindle. New windows split the focused one, and Hypr + J flips the split direction. | | Workspaces | Ten virtual workspaces on keys 1–9 and 0. macOS has no public API for this, so HyprMac keeps its own and hides the other workspaces' windows when you switch. | | Special workspace | The scratchpad, on Hypr + S. | | Fullscreen | Hypr + F fills the display over the workspace. Native macOS fullscreen spawns its own Space and wrecks the layout, so HyprMac does not use it. | | follow_mouse | Focus follows mouse, on by default, with an adjustable hover rate. | | SUPER | The Hypr key. Caps Lock by default. | | hyprland.conf | Settings, saved as JSON at ~/Library/Application Support/HyprMac/config.json. The schema is in Keybinds and actions. | | exec binds | 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. | | hyprctl dispatch | hyprmac://action/… links, once you turn on "Allow other apps to control HyprMac". |

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

Contributing

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

Inspired by

• 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

License

MIT

[site]: https://hyprmac.app [demo]: https://hyprmac.app/hyprmac-demo-github.mp4 [try]: https://hyprmac.app/#try [dmg]: https://github.com/zacharytgray/HyprMac/releases/latest/download/HyprMac.dmg [releases]: https://github.com/zacharytgray/HyprMac/releases [stargazers]: https://github.com/zacharytgray/HyprMac/stargazers [badge-release]: https://img.shields.io/github/v/release/zacharytgray/HyprMac?style=flat-square&label=release&labelColor=181a20&color=56d8f0 [badge-downloads]: https://img.shields.io/github/downloads/zacharytgray/HyprMac/total?style=flat-square&label=downloads&labelColor=181a20&color=56d8f0 [badge-stars]: https://img.shields.io/github/stars/zacharytgray/HyprMac?style=flat-square&label=stars&labelColor=181a20&color=56d8f0 [badge-macos]: https://img.shields.io/badge/macOS-13%2B-56d8f0?style=flat-square&labelColor=181a20 [badge-license]: https://img.shields.io/github/license/zacharytgray/HyprMac?style=flat-square&label=license&labelColor=181a20&color=56d8f0