Skip to content

Keyboard shortcuts

Almost every Shoji shortcut starts with ⌃ Control and ⌥ Option, so it doesn’t clash with the shortcuts you already use in your apps. The one exception is Tab View, which uses ⌥⇥ like ⌘⇥. They act on the active window and the screen it’s on.

Shortcut What it does
⌃⌥← Swap with the window on the left
⌃⌥→ Swap with the window on the right
⌃⌥↑ Swap with the window above
⌃⌥↓ Swap with the window below

With no window in that direction, the arrows move the window to the next screen that way, if it has room. See Rearranging windows.

Shortcut What it does
⌃⌥↩ Make the active window primary
⌃⌥] Activate the next window
⌃⌥[ Activate the previous window
⌃⌥` Show the next window in this tile (Stacks)
⌃⌥⇧` Show the previous window in this tile
⌥⇥ Tab View: see every window by screen and switch to one
⌥⇧⇥ Tab View, moving backwards
Shortcut What it does
⌃⌥= Make the active window bigger
⌃⌥- Make the active window smaller
⌃⌥0 Reset window sizes on this screen
Shortcut What it does
⌃⌥F Float the active window, or tile it again
⌃⌥Z Focus mode: fill the screen with the active window, or put it back
⌃⌥D No peek mode: fade every window except the active one, or stop
⌃⌥P Clean Space: make this screen plain for sharing or presenting, or bring it back
⌃⌥⌘1 Tile 1 window on this screen
⌃⌥⌘2 Tile up to 2 windows on this screen
⌃⌥⌘3 Tile up to 3 windows on this screen
⌃⌥⌘4 Tile up to 4 windows on this screen
Action What it does
Hold ⌘ and drag a title bar onto another window Swap the two windows
Hold ⌥⌘ and drag a title bar onto another window Add the window to that tile’s stack
Drag the edge between two windows Resize; the neighbors make room
Drag a window onto another screen Move it to that screen
Rest the pointer on the grip above the active window Open the quick actions
  • Shortcuts are handled by macOS, which tells Shoji only about these key combinations and nothing else you type. A shortcut press doesn’t also reach the app you’re using.
  • Holding a shortcut acts once, not over and over.
  • If another app already uses a shortcut, Shoji can’t use it. Settings → Keyboard says which ones and dims them, and the Keyboard shortcuts row in the menu bar panel shows a warning.
  • Turn them all off with the switch at the top of Settings → Keyboard if you never use them. They stay listed there so you can still learn them.
  • Shortcuts pause while another app uses Secure Input (for example, while a password field is focused). The menu bar panel tells you when this happens.