Documentation

How Deckz works

Short, because there is not much to learn. Deckz has four arrangements, a set of workspaces and a handful of keys.

Getting started

Deckz needs the Accessibility permission to move another application's windows, and macOS asks for it the first time Deckz opens. Nothing else is required: there is no account and no launch agent.

  • Grant Accessibility when asked, in System Settings → Privacy & Security
  • Press ⌥⇧1 to send the window you are in to workspace 1, then ⌥1 to come back to it
  • Everything else is discoverable from the menu bar

Workspaces

A workspace is a set of windows shown together, and each display shows one of its own. Switching brings a workspace's windows forward on its display and moves the rest of that display's windows off-screen — they are not closed, minimised or touched, only parked, and their positions are recorded before they move. The keyboard goes with you, to the window you used last there.

  • A workspace is named by the key that reaches it
  • Pin an application and its windows follow the workspace
  • Send a window to an unused key and that workspace comes into being
  • ⌥⇧⇥ carries the workspace you are on to the next display, and it stays there
  • A display playing something full screen keeps its workspace until you leave full screen; the others carry on

Arrangements

Each workspace carries one of four arrangements. The grid works its own shape out from how many windows are open; the cascade fans them out leaving a corner of each; blocks are rectangles you draw; keeping positions groups windows without moving them.

  • Change the arrangement on the workspace's own page in Settings; ⌃⌥L steps through grid, cascade and the zones you drew
  • Click a block in the preview to keep it for one application
  • Drag a window low to ask the grid for another row, or press ⌃⌥R to turn it

Inside a workspace

The keyboard reaches the windows of the workspace you are in. Moving the focus leaves every window where it is; moving a window swaps it with whatever is in the block it lands on. Windows moved by a shortcut land at once, without sliding.

  • ⌃⌥⌘ and an arrow puts the keyboard on the neighbouring window
  • ⌃⌥ and an arrow or a number moves the focused window
  • ⌃⌥Z shows the focused window alone in Zen; switching windows hands Zen to the new one, and ⌃⌥Z again puts everything back

Language

Deckz speaks English, Portuguese, Spanish and French. It opens in the language your Mac uses when it is one of the four, and in English otherwise.

  • Change it in Settings → General → Language, without quitting
  • Choose System to follow your Mac again

When something goes missing

Hidden windows are parked in the corner of the furthest display, and every position is written down before a window moves. If a window ever ends up somewhere you cannot reach — a display was unplugged, an application crashed — Recover All Windows brings it back.

  • ⌘⌥R, or Recover All Windows in the menu
  • Deckz also sweeps for stranded windows when it starts
  • Configuration lives in ~/Library/Application Support/Deckz

The keys themselves are on the shortcuts page.