HyprMac guides

HyprMac keyboard shortcuts

Hypr is whichever physical key you picked, and Caps Lock until you change it. This is the default set that ships with HyprMac, grouped and ordered the way the app lists it. Anything you rebind wins over the list below, and hyprK shows what your own copy is actually using, searchable, on top of whatever you are doing.

Default bindings

hypr is the Hypr key: Caps Lock by default, and you can pick another in Settings, under Keys. ◇ marks the actions that touch the floating layer; the overlay draws those in your floating color, magenta unless you change it.

The set worth learning first

Focus and swap are the two you will use hundreds of times a day. Hypr and an arrow moves focus to the neighbouring window in that direction; add Shift and the focused window trades places with that neighbour. Add Control and Shift instead and the arrows resize, by moving the nearest split boundary one step. Hypr and J flips the split a pair of windows sits on, which is how you turn a side by side into a stack.

Hypr and F fills the screen with the focused window, over the rest of its workspace, and pressing it again puts it back in its tile. The layout underneath does not change, and unlike macOS fullscreen it does not open a new Space. Moving focus to another window, or anything that changes the layout, puts it back first.

Ten workspaces, and where each one lives

There are ten workspaces in total, not ten per screen. Hypr and a number switches to one, and Shift sends the focused window there instead. Add Control as well as Shift and the window goes there and you go with it. Hypr and Tab steps to the next occupied workspace on the monitor you are on, and Shift steps back.

Every workspace has a fixed home monitor. By default it is worked out by counting your enabled displays from left to right and dealing the numbers out like cards. On two displays the left one owns 1, 3, 5, 7, and 9, and the right owns 2, 4, 6, 8, and 10. On three, the first owns 1, 4, 7, and 10, and so on. You can choose the workspaces for each monitor yourself in Settings, under Layout; any you leave out keep their default home. Switching to a workspace always lands you on its home monitor, which is why the numbers stay predictable.

Hypr and Control with an arrow moves the focused window to the next monitor that way: left and right for displays side by side, up and down for stacked ones. Hypr and O opens the workspace overview, two rows of five, showing what is on each one. Workspaces can have names, set in Settings under General, and the overview, the menu bar and the switch display show the name instead of the number.

Floating windows and the scratchpad

Hypr and T lifts the focused window out of the layout so you can drag and resize it freely, and puts it back when you press it again. Floating is not the same as always on top, so a floater can end up behind a tiled window; Hypr and Shift with T cycles through the floating windows on your visible workspaces and raises each one as it goes.

The scratchpad is a separate layer for things you want near but not on screen. Hypr and Shift with S sends the focused window there, and Hypr and S summons the whole layer and puts it away again. You can also pin an app to the scratchpad in Settings, under General, and its windows go there when they open.

Saved layouts, and starting over

Hypr and Control with S saves which workspace each tiled window is on and how each workspace is split, for the displays you have connected right now. Hypr and Control with R puts it all back. Restore only moves windows that are open; it does not reopen apps you closed. Hypr and R retiles every workspace from scratch. It tiles your floating windows again, except apps you set to never tile and the scratchpad, and it moves any app you pinned to a workspace back to it.

What moved recently

Two defaults changed, so older write-ups disagree with the list above. In 0.13 the floating toggle moved from Hypr and Shift with T to plain Hypr and T. In 0.14 Hypr and F became “move to dedicated workspace”, and cycling floating windows took over the freed Hypr and Shift with T. Upgrades only migrate a binding that was still the untouched old default and only when the new chord is free, so anything you customized stays where you put it.

After that, defaults were only added: saved layouts in 0.15, move and follow in 0.16, Retile All on Hypr and R in 0.17, and the up and down arrows for moving a window between stacked monitors in 0.19. In 0.16 the Hypr+K overlay also became one scrolling list with a search field, grouped the same way as the list above.

In 0.21 Hypr and F changed again, from “move to dedicated workspace” to maximize. If your Hypr and F still ran the old action, the upgrade switches it over. The old action is still in Settings, under Keys, if you want it on another chord.

Make them yours

Open Settings, then Keys, to record a new chord for any action. The Hypr key is picked from a list at the top of the same tab. You can also add bindings that launch an app: pick the app, record the chord. Hypr and Return is one of those, and it opens Terminal only because that is the default. A binding can run a command too, which is how you hook your own scripts and tools to a chord. It runs the program directly, not through a shell, so put pipes and redirects inside a script.

The mouse still works. Drag a tiled window toward the edge of another one and it is removed from where it was and inserted on that side. Hold Hypr while dragging to swap the two windows instead; the modifier is latched for the gesture, so you can let go of it just before you let go of the mouse. Either way the new layout is checked against what the apps will accept before it is committed.

Next: how this compares to Hyprland on Linux, or install it.