KEYBINDINGS.md

wm keyboard shortcuts — how they work

wm is Omarchy's tiling window manager rebuilt in makepad, and it keeps Omarchy's keymap (read from omarchy/default/hypr/bindings/*.lua). Omarchy builds every shortcut from one modifier, SUPER — the Logo key: the Windows key on a PC keyboard, ⌘ Cmd on a Mac — plus optional Shift / Ctrl / Alt. wm accepts ⌘ as SUPER exactly like Linux, and also a second spelling, Ctrl+Alt, for the few chords macOS keeps for itself (⌘Tab, ⌘⇧3/4/5). If you still have Spotlight on ⌘Space, unbind it in System Settings → Keyboard → Shortcuts, or use Ctrl+Alt+Space.

On macOS, ⌘A reaches the focused app for Select All. Use Ctrl+Alt+A for the window manager's alternate-layer prefix; it does not take over ⌘A.

Omarchy layer	Press on macOS	Fallback spelling
SUPER	⌘	Ctrl+Alt
SUPER+SHIFT	⌘+Shift	Ctrl+Alt+Shift
SUPER+CTRL	⌘+Ctrl	Ctrl+Alt+Cmd (legacy)
SUPER+ALT	⌘+Alt (⌥ Option)	Ctrl+Alt+A, then key
SUPER+SHIFT+CTRL	⌘+Shift+Ctrl	Ctrl+Alt+Shift+Cmd
SUPER+SHIFT+ALT	⌘+Shift+Alt	—
ALT / ALT+SHIFT	Alt / Alt+Shift	(same on every OS)

Quitting wm itself is ⌘⇧Q (the app menu) — plain ⌘Q closes the focused window, as in Omarchy. Press ⌘K at any time for the in-app cheat sheet; it prints the exact chords for the OS you are on.

In the Windows style, SUPER+Z opens Snap Layouts for the focused window. You can also hover its maximize button, or drag its title bar to the top center to choose a slot. Drag to a side for half the desktop, or a corner for a quarter; the preview shows where the window will land. SUPER+Left and SUPER+Right select a half. Dragging a snapped or maximized title bar restores the window's previous floating size under the pointer. Layouts follow the available desktop area, excluding the bars; wide layouts offer thirds and portrait layouts offer top/bottom halves.

Starting things

Chord	Does
⌘ Return	New terminal, opened in the focused terminal's directory
⌘ Space	The Omarchy menu (Apps, Learn, Trigger, Style, Setup, … System)
⌘⌥ Space	Apps menu straight away (the launcher)
⌘ Esc	System menu (lock, suspend, logout, reboot, shutdown)
⌘ K	Keybindings cheat sheet
⌘⇧⌃ Space	Theme menu
⌘⌃ Space	Next wallpaper
⌘⇧ Space	Show / hide the top bar

With the mouse: the Omarchy button at the far left of the bar opens the menu (right-click it for a new terminal); the focused window's title in the bar focuses it on left-click and closes it on middle- or right-click.

Inside a menu: type to filter, Enter or Right activates, Backspace or Left goes back a level (so does clicking the header), Esc clears the filter and then closes; hover selects, click activates, click outside closes.

Moving around the tiles

New windows split the focused tile (dwindle layout: the longer side splits).

Chord	Does
⌘ Arrows	Focus the window left / right / up / down
⌘⇧ Arrows	Swap the window in that direction
Alt+Tab / Alt+Shift+Tab	Next / previous window
⌘ J	Toggle the split direction of the focused pair
⌘ W or Q	Close the window
Ctrl+Alt+Delete	Close all windows, back to workspace 1
⌘ L	Toggle the workspace layout (dwindle / scrolling)

Mouse: ⌘ + left-drag moves a window (a tiled one swaps with the tile you drop it on), ⌘ + right-drag resizes it from the corner nearest your grab.

Sizing

Chord	Does
⌘ - / =	Move the nearest divider left / right by 100 px
⌘⇧ - / =	…up / down by 100 px
⌘⌥ - / =	…by 25 px
⌘⇧⌥ - / =	…by 25 px vertically
⌘⌃ - / =	…by 300 px
⌘⇧⌃ - / =	…by 300 px vertically

Window modes

Chord	Does
⌘ F	Full screen (the window covers the desk, bar hidden; on a floating desk the bar, its title bar and the dock come out at the screen's edges, as the green button does)
⌘⌥ F	Full width (maximized inside the gaps, bar stays)
Esc	Leave an app's presentation full screen (window.fullscreen), where no edge brings the bar or the dock out
⌘⌃ F	Tiled full screen (the app is told it is fullscreen, tile stays)
⌘ T	Toggle floating / tiled
⌘ O	Pop the window out: float it at 1300×900, center, pin on top on every workspace; again to tile it back
⌘ P	Pseudo-tile: keep the app's own size centered inside its tile

Workspaces and the scratchpad

Chord	Does
⌘ 1…0	Go to workspace 1…10
⌘⇧ 1…0	Move the window there and follow it
⌘⇧⌥ 1…0	Move it there silently (stay where you are)
⌘ Tab / ⌘⇧ Tab	Next / previous workspace
⌘⌃ Tab	The workspace you came from
⌘ + mouse wheel	Scroll through workspaces
⌘ S or `	Show / hide the scratchpad (a drop-down console over the top half)
⌘⌥ S, ⌘⇧ `	Send the window to the scratchpad

Groups (tabbed windows)

Chord	Does
⌘ G	Turn the window into a group (tabs) / dissolve it
⌘⌥ Arrows	Move the window into the group next to it
⌘⌥ G	Move the window out of its group
⌘⌥ Tab / ⌘⇧⌥ Tab	Next / previous tab in the group
⌘⌃ Left/Right	Same, Omarchy's other spelling
⌘⌥ 1…5	Jump to the nth tab

When a chord does nothing

macOS swallowed it. Use the Ctrl+Alt spelling, or for the SUPER+ALT layer press Ctrl+Alt+A, let go, then press the key. Everything above is generated from apps/wm/src/binds.rs; the cheat sheet (⌘K) is always the authoritative list.