HyprMac in eighteen seconds
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
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/hyprmacOr download the DMG. Source is on GitHub, MIT licensed.
2 Pick your Hypr key
Caps Lock by default. You can change it in Settings → Keys, with the same key recorder the bindings 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 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.