HyprMac showreel
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. The Hypr key is picked from a list in the same tab. Add your own bindings that launch apps: pick an app, record a chord.
Keybinds
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
- Maximize windowhyprF
- 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⌃←↑↓→
- 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.
There when you want more
One key and a few chords are the whole pitch. This is what is waiting once they are muscle memory.
Focus you can see
Windows you are not using dim. Corner brackets mark the focused one while you hold Hypr, and they glide to the next window when focus moves.
Drag with a preview
Drag a window onto a tile’s edge to put it there. Hold Hypr as you drag to swap the two. A highlight shows where it will land.
Every monitor
Each workspace has a home monitor. hypr⌃←↑↓→ sends a window to the next display.
Overview
hyprO shows every workspace and what is on it. Give workspaces names and the names show up there.
Maximize and float
hyprF fills the display and puts the window back. hyprT floats a window above the tiles.
Pin apps
Send an app to the same workspace every time it opens, or to the scratchpad. Keep other apps out of tiling.
Saved layouts
hypr⌃S saves the layout for the displays you have. Plug the same displays back in and it comes back.
Settings, not dotfiles
Gaps, the focus look, keybinds and the Hypr key live in a Settings window. It is plain JSON on disk too.
Your own tools
Bind a key to a script. Drive HyprMac from Raycast or BetterTouchTool with
hyprmac://links. Feed sketchybar fromstate.json.
How each one works is in the shortcut guide and the install guide.
- 10workspaces
- 60+default shortcuts, all remappable
- 14choices for the Hypr key
- 1,900+unit tests
- 60+releases since April 2026
Setup and install
1 Install
brew trust --cask zacharytgray/hyprmac/hyprmac && brew install --cask zacharytgray/hyprmac/hyprmacHomebrew refuses casks from third-party taps until you trust them. brew trust trusts only this cask, which also lets brew upgrade --cask hyprmac work later.
Or download the DMG. It is a signed and notarized universal app, for Apple silicon and Intel, and it updates itself through Sparkle. Source is on GitHub, MIT licensed.
2 Pick your Hypr key
Caps Lock by default. Settings → Keys has 14 choices if you want another key.
Keeping Caps Lock? In System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys, leave it set to “⇪ Caps Lock”. That pane is per keyboard, so check each one you use.
hyprStep 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 still here. Floating windows stay above your tiles, but the window you focus comes to the front where they overlap. 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.