# Keyboard shortcuts

Source: https://chainyourmac.com/docs/keyboard-shortcuts  
Updated: 2026-11-12 · Author: Ahmed Gagan (maker of ChainYourMac)

Every action on the strip has a shortcut. **The defaults all start with Control-Option (⌃⌥)**, take Vim keys or the arrows, and can be changed in the app.

These are the defaults on a new install of ChainYourMac 2.1 or later. Where two keys are listed, the second is the Vim-style alternative. The names are the ones the app's Shortcuts screen uses.

## Focus

| Action | Default |
|---|---|
| Focus Left / Right | ⌃⌥← ⌃⌥→ · ⌃⌥H ⌃⌥L |
| Focus Up / Down (in a stack, or tabs) | ⌃⌥↑ ⌃⌥↓ · ⌃⌥K ⌃⌥J |
| Focus First / Last | ⌃⌥⌘← ⌃⌥⌘→ |
| Jump to 1–8 / Jump to Last | ⌃⌥1…⌃⌥8 / ⌃⌥9 |
| Show Strip (minimap) | ⌃⌥S |

## Move windows

| Action | Default |
|---|---|
| Move Window Left / Right | ⌃⌥⇧← ⌃⌥⇧→ · ⌃⌥⇧H ⌃⌥⇧L |
| Move Window Up / Down (in a stack) | ⌃⌥⇧↑ ⌃⌥⇧↓ · ⌃⌥⇧K ⌃⌥⇧J |
| Move Window to First / Last | ⌃⌥⌘⇧← ⌃⌥⌘⇧→ |
| Move to 1–8 / Move to Last | ⌃⌥⇧1…⌃⌥⇧8 / ⌃⌥⇧9 |

## Size

| Action | Default |
|---|---|
| Resize Window (next preset width) | ⌃⌥R |
| Full Width (or back) | ⌃⌥F |
| Center Window | ⌃⌥C |
| Wider / Narrower | ⌃⌥= ⌃⌥- |
| Taller / Shorter | ⌃⌥⇧= ⌃⌥⇧- |
| Equal Heights | ⌃⌥0 |

## Columns and stacks

| Action | Default |
|---|---|
| Stack Left (into the column on the left) | ⌃⌥] |
| Stack Right (into the column on the right) | ⌃⌥[ |
| Unstack (to a new column on the right) | ⌃⌥⇧] |
| Unstack to the Left | ⌃⌥⇧[ |
| Tabs (stacked ↔ tabbed column) | ⌃⌥⇧T |

## Pin, float, displays

| Action | Default |
|---|---|
| Pin Left / Pin Right (again to unpin) | ⌃⌥P / ⌃⌥⇧P |
| Float / Unfloat | ⌃⌥T |
| Next Display | ⌃⌥N |
| Quit Window Manager | ⌃⌥Q |

While the ChainYourMac window is in front, ⌘, opens Settings, ⇧⌘S starts or stops the window manager, and ⇧⌘R restarts it. Those three are fixed.

## Changing shortcuts

- Open the **Shortcuts** screen in the app, click a shortcut and press the new keys. Changes save immediately.
- **+** adds another shortcut for the same action, **×** removes one, and Esc cancels recording.
- The app warns before you take a combination macOS uses (⌘Q, ⌘W, ⌥ with a letter and so on) or one another action already has.
- **Reset to Defaults…** restores this list without touching your other settings.
- Prefer text? The same bindings live in the `[bindings]` table of the settings file, written like `"ctrl + alt - leftarrow"`. See [settings](https://chainyourmac.com/docs/settings).

## Upgraded from 2.0?

Your own shortcuts are kept. If you're still on the old Option-based set, the Shortcuts screen offers a one-click switch to ⌃⌥ that only changes the shortcuts you never customised. Shortcuts added in later versions (jump by number, pins, Show Strip) were assigned only where the keys were free.

Coming from niri? [Every niri default keybinding, mapped to ChainYourMac](https://chainyourmac.com/niri-keybindings-mac).

**Your whole desktop, from the keyboard.** One-time purchase, free updates, macOS 13 or later on Apple silicon. Price and checkout: https://chainyourmac.com/#pricing (one-time purchase, lifetime license; macOS 13+ on Apple silicon).

## FAQ

### Why does ChainYourMac use ⌃⌥ instead of ⌥?

macOS uses plain Option for text: ⌥← and ⌥→ jump by word, and ⌥ with a letter types characters like ç and ®. Control-Option leaves all of that alone. Since version 2.1, new installs start with ⌃⌥.

### How do I change a shortcut?

Open the Shortcuts screen in the app, click a shortcut and press the new keys. It saves straight away. + adds a second shortcut for the same action, and the app warns you before you take a combination macOS or another action already uses.

### Do the shortcuts work on AZERTY, QWERTZ or Dvorak keyboards?

Yes. Shortcuts are recorded by the character on your keyboard, so non-US layouts work. On layouts without [ and ] where a US keyboard has them, the stack shortcuts use the two keys to the right of P.

### Can Raycast, Keyboard Maestro or BetterTouchTool trigger these?

Yes. Shortcuts sent by other apps work exactly like keys you type. There's also a URL scheme and a command-line tool: see [automation](https://chainyourmac.com/docs/automation).

## Related

- [Niri keybindings on Mac](https://chainyourmac.com/niri-keybindings-mac) — Every niri default bind mapped to a macOS shortcut.
- [Moving around the strip](https://chainyourmac.com/docs/navigating-the-strip) — Keys, swipes, mouse scrolling, the minimap and jumping by number.
- [Automation](https://chainyourmac.com/docs/automation) — The CLI, chainyourmac:// URLs, Raycast and Keyboard Maestro.
- [Window manager for coding](https://chainyourmac.com/window-manager-for-developers-mac) — A developer layout: editor, terminals, browser and agents side by side.
