docs: document the column switcher
- commit
- ebbed3b37a7da213d1305c87e085e06f35c4fc4a
- author
- brice · · 2026-10-08 17:31 UTC
- parent
- 480a380
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
2 files · +6 -0
M README.md +2 -0
| @@ -280,6 +280,8 @@ bind.cmd+shift+f = toggle-fullscreen | |||
| 280 | 280 | bind.cmd+s = toggle-stash-visible | |
| 281 | 281 | bind.cmd+shift+s = toggle-window-stash | |
| 282 | 282 | bind.cmd+o = toggle-overview | |
| 283 | + | bind.cmd+tab = switch-column-next | |
| 284 | + | bind.cmd+shift+tab = switch-column-prev | |
| 283 | 285 | ||
| 284 | 286 | # Workspaces | |
| 285 | 287 | bind.cmd+pageup = focus-workspace-prev | |
| @@ -280,6 +280,8 @@ bind.cmd+shift+f = toggle-fullscreen | |||||
| 280 | bind.cmd+s = toggle-stash-visible | 280 | bind.cmd+s = toggle-stash-visible | ||
| 281 | bind.cmd+shift+s = toggle-window-stash | 281 | bind.cmd+shift+s = toggle-window-stash | ||
| 282 | bind.cmd+o = toggle-overview | 282 | bind.cmd+o = toggle-overview | ||
| 283 | + | bind.cmd+tab = switch-column-next | |||
| 284 | + | bind.cmd+shift+tab = switch-column-prev | |||
| 283 | 285 | ||||
| 284 | # Workspaces | 286 | # Workspaces | ||
| 285 | bind.cmd+pageup = focus-workspace-prev | 287 | bind.cmd+pageup = focus-workspace-prev | ||
M docs/config.md +4 -0
| @@ -250,6 +250,8 @@ Cascade supports dropping onto tiles, but not gap insertion or edge scrolling du | |||
| 250 | 250 | | `toggle-floating` | Make the focused tile a [free floating window](#free-floating-windows) at its current size, centred; on a floating window, send it back to its former place in the columns (a native dialog becomes a new column). Does nothing on a stashed or fullscreen window | | |
| 251 | 251 | | `toggle-stash-visible` | Hide the stash and give the focus back to the tiles, or show it again with the focus on its selected window. Native dialogs stay as they are. Over a fullscreen window, shows the stash on top with the focus; the window stays fullscreen behind (composed, so no direct scanout while the stash shows) and is back when the stash hides or the focus leaves it. `toggle-window-stash` or `toggle-fullscreen` on a stashed window there leaves that fullscreen for it. New windows never join or show over it; the fullscreen window's own dialogs show above it | | |
| 252 | 252 | | `toggle-overview` | Open the [overview](#overview), or close it on the selected window | | |
| 253 | + | | `switch-column-next` | Switch to the column used before this one on the workspace. Hold Cmd and press again to go further back; after a short hold a strip of cards shows the columns, most recent first, and releasing Cmd focuses the selected one. Escape cancels; clicking a card picks it. A maximized column hands its maximization to the target. A workspace capture session pauses while the strip shows, as in the overview | | |
| 254 | + | | `switch-column-prev` | The same, in the opposite direction | | |
| 253 | 255 | | `maximize-column` | Toggle full usable width for the focused column, preserving gaps and its saved width; in fixed overflow, other columns are hidden until focus moves or it is toggled off. On a window that made itself fullscreen (e.g. a Wine app at monitor size), it first returns the window to its column | | |
| 254 | 256 | | `cycle-column-width` | Step through `layout.presets`. In fixed overflow, toggle the focused column to `max-columns - 1` cells in place; the other columns stack on each side in the last cell. One column is expanded at a time | | |
| 255 | 257 | | `focus-column-left/right` | Focus the neighbor column; at the edge, the neighbor monitor. In fixed overflow, the neighbor on screen. From a fullscreen window, the neighbor column comes first and fullscreen ends; at the edge it stays | | |
| @@ -348,6 +350,8 @@ With `keyboard.cmd = alt`, the `cmd+alt+…` binds have the same keys as `cmd+ | |||
| 348 | 350 | | `cmd+shift+s` | `toggle-window-stash` | | |
| 349 | 351 | | `cmd+shift+space` | `toggle-floating` | | |
| 350 | 352 | | `cmd+o` | `toggle-overview` | | |
| 353 | + | | `cmd+tab` | `switch-column-next` | | |
| 354 | + | | `cmd+shift+tab` | `switch-column-prev` | | |
| 351 | 355 | | `cmd+q` | `close-window` | | |
| 352 | 356 | | `ctrl+alt+backspace` | `quit` | | |
| 353 | 357 | | `ctrl+cmd+space` | `spawn fuzzel` | | |
| @@ -250,6 +250,8 @@ Cascade supports dropping onto tiles, but not gap insertion or edge scrolling du | |||||
| 250 | | `toggle-floating` | Make the focused tile a [free floating window](#free-floating-windows) at its current size, centred; on a floating window, send it back to its former place in the columns (a native dialog becomes a new column). Does nothing on a stashed or fullscreen window | | 250 | | `toggle-floating` | Make the focused tile a [free floating window](#free-floating-windows) at its current size, centred; on a floating window, send it back to its former place in the columns (a native dialog becomes a new column). Does nothing on a stashed or fullscreen window | | ||
| 251 | | `toggle-stash-visible` | Hide the stash and give the focus back to the tiles, or show it again with the focus on its selected window. Native dialogs stay as they are. Over a fullscreen window, shows the stash on top with the focus; the window stays fullscreen behind (composed, so no direct scanout while the stash shows) and is back when the stash hides or the focus leaves it. `toggle-window-stash` or `toggle-fullscreen` on a stashed window there leaves that fullscreen for it. New windows never join or show over it; the fullscreen window's own dialogs show above it | | 251 | | `toggle-stash-visible` | Hide the stash and give the focus back to the tiles, or show it again with the focus on its selected window. Native dialogs stay as they are. Over a fullscreen window, shows the stash on top with the focus; the window stays fullscreen behind (composed, so no direct scanout while the stash shows) and is back when the stash hides or the focus leaves it. `toggle-window-stash` or `toggle-fullscreen` on a stashed window there leaves that fullscreen for it. New windows never join or show over it; the fullscreen window's own dialogs show above it | | ||
| 252 | | `toggle-overview` | Open the [overview](#overview), or close it on the selected window | | 252 | | `toggle-overview` | Open the [overview](#overview), or close it on the selected window | | ||
| 253 | + | | `switch-column-next` | Switch to the column used before this one on the workspace. Hold Cmd and press again to go further back; after a short hold a strip of cards shows the columns, most recent first, and releasing Cmd focuses the selected one. Escape cancels; clicking a card picks it. A maximized column hands its maximization to the target. A workspace capture session pauses while the strip shows, as in the overview | | |||
| 254 | + | | `switch-column-prev` | The same, in the opposite direction | | |||
| 253 | | `maximize-column` | Toggle full usable width for the focused column, preserving gaps and its saved width; in fixed overflow, other columns are hidden until focus moves or it is toggled off. On a window that made itself fullscreen (e.g. a Wine app at monitor size), it first returns the window to its column | | 255 | | `maximize-column` | Toggle full usable width for the focused column, preserving gaps and its saved width; in fixed overflow, other columns are hidden until focus moves or it is toggled off. On a window that made itself fullscreen (e.g. a Wine app at monitor size), it first returns the window to its column | | ||
| 254 | | `cycle-column-width` | Step through `layout.presets`. In fixed overflow, toggle the focused column to `max-columns - 1` cells in place; the other columns stack on each side in the last cell. One column is expanded at a time | | 256 | | `cycle-column-width` | Step through `layout.presets`. In fixed overflow, toggle the focused column to `max-columns - 1` cells in place; the other columns stack on each side in the last cell. One column is expanded at a time | | ||
| 255 | | `focus-column-left/right` | Focus the neighbor column; at the edge, the neighbor monitor. In fixed overflow, the neighbor on screen. From a fullscreen window, the neighbor column comes first and fullscreen ends; at the edge it stays | | 257 | | `focus-column-left/right` | Focus the neighbor column; at the edge, the neighbor monitor. In fixed overflow, the neighbor on screen. From a fullscreen window, the neighbor column comes first and fullscreen ends; at the edge it stays | | ||
| @@ -348,6 +350,8 @@ With `keyboard.cmd = alt`, the `cmd+alt+…` binds have the same keys as `cmd+ | |||||
| 348 | | `cmd+shift+s` | `toggle-window-stash` | | 350 | | `cmd+shift+s` | `toggle-window-stash` | | ||
| 349 | | `cmd+shift+space` | `toggle-floating` | | 351 | | `cmd+shift+space` | `toggle-floating` | | ||
| 350 | | `cmd+o` | `toggle-overview` | | 352 | | `cmd+o` | `toggle-overview` | | ||
| 353 | + | | `cmd+tab` | `switch-column-next` | | |||
| 354 | + | | `cmd+shift+tab` | `switch-column-prev` | | |||
| 351 | | `cmd+q` | `close-window` | | 355 | | `cmd+q` | `close-window` | | ||
| 352 | | `ctrl+alt+backspace` | `quit` | | 356 | | `ctrl+alt+backspace` | `quit` | | ||
| 353 | | `ctrl+cmd+space` | `spawn fuzzel` | | 357 | | `ctrl+cmd+space` | `spawn fuzzel` | | ||