Shortcuts
Every TilingBud action is a command, and any command can have a global keyboard shortcut. The Shortcuts page under Getting Started shows the default and the recommended shortcuts on an interactive keyboard.
The default shortcuts
Section titled “The default shortcuts”The first start binds:
- ⌥ T: take the focused window out of the layout, or put it back.
- ⌃ 1 to ⌃ 0: show space 1 to 10.
- ⌃ ⌥ 1 to 0: move the focused window to that space.
- ⌃ ⌥ ⇧ 1 to 0: move it and go along.
Recommended shortcuts on Settings › Shortcuts adds a set for tiling windows in one step, on the left Option key. Keys already in use stay as they are and are listed.
Binding a shortcut in Settings
Section titled “Binding a shortcut in Settings”Settings › Shortcuts lists the commands with their keys.
- Click a shortcut to record new keys: at least one of ⌃ ⌥ ⇧ ⌘, or a function key. Escape cancels.
- New keys replace the command’s old ones. Keys another command had move over after asking.
- Right-click a shortcut to bind its modifier keys to the left or right side only.
Add a Shortcut binds any command: choose it and its argument from lists, then record the keys. Open App… binds an app from the installed apps.
The search field at the top finds every command by its title, its command text or its keys. While it has the focus, press a combination and it shows what those keys do.
Shortcuts in the file
Section titled “Shortcuts in the file”Each entry of [shortcuts] binds a key combination to a command of the
command line, without the leading tilingbud:
[shortcuts]"alt+t" = "window --toggle float""ctrl+1" = "space --focus 1""alt+h" = "window --focus west""alt+l" = "window --focus east""shift+alt+h" = "window --swap west""alt+space" = "space --layout next"Modifiers are ctrl, alt (or opt), shift and cmd, in any order. Keys are letters, digits, f1 to f20, the
arrow keys left right up down, space, return, tab, escape, delete and the punctuation keys.
A letter names the key printed with it on your keyboard layout: alt+z is the Z key on a German keyboard too, and
alt+ö works there. When you switch the layout, the shortcuts are read again.
One side only
Section titled “One side only”lctrl, rctrl, lalt, ralt, lshift, rshift, lcmd and rcmd stand for one side only. With
"lalt+l" = "window --focus east", the right Option key with L still types what the layout says, such as @ on a
German keyboard. With both "lalt+x" and "alt+x" bound, the left side runs the first and the right side the second.
Spaces by name
Section titled “Spaces by name”space --focus 3 counts spaces over all displays, and the numbers shift when macOS moves spaces between displays. A
name stays with its space: "ctrl+alt+7" = "space --focus Comm".
Apps, shell commands and lists
Section titled “Apps, shell commands and lists”A value that starts with a domain such as space, window or app is a TilingBud command. Any other value is a
shell command.
[shortcuts]"alt+return" = "app --open iTerm""rctrl+f" = "open ~""ctrl+alt+m" = ["space --focus 3", "open -a Mail"]app --openstarts an app, or brings it to the front with its space.- A list runs its steps one after another. A step that fails stops the rest.
Per-app shortcuts and passthrough
Section titled “Per-app shortcuts and passthrough”A table adds options to a shortcut:
[shortcuts]exclude_apps = ["Factorio", "com.vmware.fusion"]"alt+h" = { command = "window --focus west", except_apps = ["iTerm2"] }"cmd+s" = { command = "~/bin/note-save.sh", pass = true }appsmakes a shortcut work only while one of these apps is in front;except_appsnever while one of them is. While a shortcut does not apply, its keys reach the app.pass = trueruns the command and lets the key press reach the app in front as well.exclude_appsturns every TilingBud shortcut off while one of these apps is in front, such as games or virtual machines. On Settings › Shortcuts this is Off in These Apps.
A mode is a set of shortcuts of its own. After shortcuts --mode resize, only its shortcuts work, and its keys need no
modifier:
[shortcuts]"alt+r" = "shortcuts --mode resize""ctrl+alt+q" = { command = "shortcuts --mode default", every_mode = true }
[shortcuts.mode.resize]capture = true"h" = "window --resize west 50""l" = "window --resize east 50""return" = "shortcuts --mode default"- Escape leaves a mode, unless the mode binds Escape itself.
shortcuts --mode defaultleaves it too. - Keys a mode does not bind reach the app in front. With
capture = truethey are swallowed instead, and the mode ends after two minutes without a key press. every_mode = truekeeps a shortcut of[shortcuts]working while a mode is on.
The mode that is on shows in the control bar’s Shortcut mode section, and the menu offers to leave it. Settings › Shortcuts edits modes under Modes.
Media keys
Section titled “Media keys”Play, next, previous, volume, mute and brightness keys can be shortcut keys, alone or with modifiers: play, next,
previous, volume_up, volume_down, mute, brightness_up, brightness_down. The press then does only the
shortcut.
[shortcuts]"shift+next" = "space --focus next"Conflicts
Section titled “Conflicts”Settings › Shortcuts marks keys that an enabled macOS shortcut also uses with ⚠, and keys that could not be registered because the system or another app holds them with ⛔.
Trying shortcuts
Section titled “Trying shortcuts”The tester on Settings › Shortcuts stops TilingBud’s shortcuts from running. Each press shows the keys and what they would do: the command and its line, the macOS shortcut that uses them, or that nothing is bound. It turns off when you leave the page and after two minutes without a press.
To see every shortcut as it runs, turn on shortcut hints.
All keys and options are in the reference.