Skip to content
EN
Download

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 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.

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.

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.

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.

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".

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 --open starts 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.

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 }
  • apps makes a shortcut work only while one of these apps is in front; except_apps never while one of them is. While a shortcut does not apply, its keys reach the app.
  • pass = true runs the command and lets the key press reach the app in front as well.
  • exclude_apps turns 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 default leaves it too.
  • Keys a mode does not bind reach the app in front. With capture = true they are swallowed instead, and the mode ends after two minutes without a key press.
  • every_mode = true keeps 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.

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"

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 ⛔.

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.