HyprMac

A keyboard-driven tiling window manager for macOS.

Finally give your Caps Lock key a purpose and let it become ⇪hypr

Free and open source, MIT. macOS 13 or later.

HyprMac in eighteen seconds

An eighteen-second showreel. A Caps Lock key labelled hypr is pressed, and the words "Tile your Mac from the keyboard" appear. A Mac desktop full of overlapping windows snaps into a tiled layout, then each shortcut plays in turn, shown as keycaps under the screen: open a terminal, move focus, swap windows, resize, flip a split, float a window, and switch workspaces. The tiles fold into the HyprMac logo, followed by the line "Keyboard-driven tiling for macOS" and the address hyprmac.app.

Want to see it in action? Watch it on a real Mac.

How it works

The real keymap, on a pretend desktop. Watch the tour, then take the keyboard.

Rather see it on a real Mac? Watch the one-minute recording.

Simpler on purpose. One key. A few chords. Hypr+K when you forget.

Simpler on purpose

There is one modifier and a short set of bindings. They become muscle memory in a few days. If you get lost, hyprK opens the whole list, searchable, on top of whatever you're doing.

Every binding is editable in Settings → Keys, with a key recorder. So is the Hypr key itself. Add your own bindings that launch apps: pick an app, record a chord.

Keybinds

KeybindshyprK
Tutorial

Focus & Navigation

  • Focus directionhypr←↑↓→
  • Cycle Floating Windows (floating layer)hypr⇧T
  • Focus Menu Barhypr`

Window Management

  • Swap directionhypr⇧←↑↓→
  • Resize windowhypr⌃⇧←↑↓→
  • Toggle Floating (floating layer)hyprT
  • Toggle Split DirectionhyprJ
  • Toggle Scratchpad (floating layer)hyprS
  • Send to Scratchpad (floating layer)hypr⇧S
  • Close WindowhyprW
  • Swap tiles by dragginghyprdrag

Workspaces

  • Switch to workspace NhyprN
  • Move window to workspace Nhypr⇧N
  • Move window to workspace N and followhypr⌃⇧N
  • Move to monitorhypr⌃←→
  • Move to dedicated workspacehyprF
  • Next WorkspacehyprTab
  • Previous Workspacehypr⇧Tab

Apps

  • Launch TerminalhyprReturn

System

  • Save Layouthypr⌃S
  • Restore Layouthypr⌃R
  • Retile All SpaceshyprR
  • Show Keybind OverlayhyprK
  • Show Workspace OverviewhyprO
  • Pause / Resume TilinghyprP

hypr = Caps Lock·N = workspace key (1–9, 0 for 10)

◇ marks actions that touch the floating layer; the overlay draws it in magenta. Every default, explained.

Setup and install

1 Install

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

Or download the DMG. Source is on GitHub, MIT licensed.

Latest release and changelog

2 Pick your Hypr key

Caps Lock by default. You can change it in Settings → Keys, with the same key recorder the bindings use.

hypr

Step by step setup, including the Caps Lock note, is in the install guide.

Contribute

HyprMac is open source, MIT.

Bug reports, feature requests and pull requests are all welcome. It is in active development, so the issue tracker is the right place to say what is broken or missing.

FAQs

So you're telling me I have to watch YouTube windowed now? Pass.
No, you can watch your Mr. Beast video in fullscreen. HyprMac politely steps out of the way.
My floating window vanished. Did you send it into another dimension?
Calm down, it's behind the tiled ones. hypr⇧T cycles through all your floating windows and raises them. More on floating windows in the Hyprland on a Mac guide.
But what about my eleven virtual Desktops I made??
Nobody uses those anyways. Keep one macOS Space per monitor and let workspaces do the rest.
On what planet do I need a shortcut to get to my menu bar?
Because focus follows your mouse. Cross another window on the way up and you get its menus instead. hypr` jumps straight to the menu bar of the app you're in, over everything else. Plus, it's fast.
Who has a shortcut to open the terminal? Do you ever go outside?
No I do not. While this app was built in my dark bedroom, anybody can use it. It only opens Terminal by default. Any binding can launch any app you want.
This app sucks. Who do I yell at?
Me, on GitHub. It's in active development, and bug reports and contributions are welcome.

Why I built it

I use Hyprland on Linux and fell in love with the workflow. Windows tile themselves, focus moves with a keystroke, and my hands never leave the keyboard. I needed that on macOS and nothing gave me the same feel, so I built it. It now works well enough that I can't go back.

I write software all day. Reaching for the mouse to find a window is a small cost paid hundreds of times a day. HyprMac removes it.