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 0.14. Anything you rebind wins over the table below, and ⇪hyprK shows what your own copy is actually using, searchable, on top of whatever you are doing.

⇪ is the Hypr key. N = workspace key (1–9, 0 for 10). ◇ marks the actions that touch the floating layer; the overlay draws those in magenta.

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.

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. 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, 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. Switching to a workspace always lands you on its home monitor, which is why the numbers stay predictable. Hypr and Control with the left or right arrow moves the focused window to the next monitor instead.

Two more workspace shortcuts are worth knowing. Hypr and F moves the focused window to the next empty workspace on the same display and leaves it there as the only tile, which is the fastest way to give one window the whole screen without fullscreen. Hypr and O opens the workspace overview, two rows of five, showing what is on each one.

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.

What moved recently

Two defaults changed, so older write-ups disagree with the table 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.

Make them yours

Open Settings, then Keys, to record a new chord for any action, including the Hypr key itself. 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.

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.