Skip to content

Window: move and control windows

Move, resize, centre, cycle window states and control audio.

Window: move and control windowsMove, resize, centre, cycle window states and control audio.

How to use it

Entering Window activates and locks the window under the pointer. Moving the pointer elsewhere does not automatically change the target. Type a displayed window number to activate that window and move the pointer to its centre.

KeyAction in Window
H / J / K / LMove left / down / up / right; hold for continuous adjustment
SToggle movement and resizing around the centre
CCentre the window
DMove to the next display
F / Shift+FMaximize / restore; minimize / restore
NumberSelect a window by number
Tab / Shift+TabNext / previous window; prefer members of the current tab group
XRequest that the window close; the app may ask you to save
Z / Shift+ZUndo / redo window adjustments
Shift+CRestore positions, sizes, and window states from the start of this window session

By default, candidates are non-minimized windows on the current display. Existing numbers stay stable where possible: closing a window does not renumber the others, although re-entering may reclaim gaps. Only a prefix that could form a longer number waits, for 250 ms by default.

Need to click something? Hold Primary to temporarily use Normal's pointer movement, scrolling, and click bindings. Release it to resume the same target. Each window mode has independent direction bindings; remapping Normal does not automatically remap these modes.

Move with grid targeting

While Window is in Move state, Grid and Recursive Grid can run above the same locked window session. Defaults are G or Primary+G for Grid and Primary+F for Recursive Grid; bare F still maximizes.

Entrances come from Normal's effective bindings. Compilation borrows unoccupied Grid/Recursive Grid entrances after aliases and application overrides, preserving existing Window bindings, including none. The temporary Normal layer keeps its configured entrances as well; no physical G/F keys are hardcoded.

The actual modes retain their configuration, Tab/Backspace navigation, Space reset, cross-display path preservation, and completion behavior. Whenever the picker moves the pointer, the window center follows within the destination work area. Leaving for Normal/Idle resumes Window; keep continues targeting. One targeting session creates one window undo step.

Audio controls

These default combinations work in Window, Quick, and Editor. Hold V and press the partner key; add Shift for system controls.

ScopeVolume down / upToggle mutePrevious / next output device
Application owning the target windowV+J / V+KV+MV+H / V+L
SystemShift+V+J / Shift+V+KShift+V+MShift+V+H / Shift+V+L

Volume changes by 1% per step. Raising application volume does not automatically unmute it. Multiple windows from the same app may share an audio session.

  • Windows: application volume needs an available audio session; start playback if none is found. Whether a device change moves an existing stream immediately depends on the application.
  • macOS: system audio works on macOS 14+; independent application audio needs macOS 14.2+ and System Audio Recording permission. Local processing adds audio latency. Some output devices do not support software volume control.

Window management overview · Full configuration reference