Skip to content
EN
Download

Switching from AeroSpace

AeroSpace and TilingBud are both tiling window managers that work with System Integrity Protection on and are configured in a TOML file. The main difference is what a workspace is.

AeroSpace has workspaces of its own. You keep one macOS space per display, and AeroSpace moves the windows of the workspaces you do not see to a corner of the screen. A workspace appears when it is used.

TilingBud uses the spaces of Mission Control. A space is a macOS desktop: it slides in when you switch, Mission Control shows it, and a window on it is really on that space. You add and remove spaces in Mission Control, in Settings › Spaces or with tilingbud space --create and space --destroy; creating and removing open Mission Control for a moment. Every display has its own spaces.

So when you switch:

  • Make as many spaces in Mission Control as you had workspaces you use.
  • Name them in Settings › Spaces. A name stays with its space when the numbers shift, and commands and rules can use it (space --focus Mail).

AeroSpace reads ~/.aerospace.toml; TilingBud reads ~/.config/TilingBud/config.toml. TilingBud reloads the file when you save it, and Settings writes changes back into it, keeping your comments.

AeroSpace TilingBud
gaps.inner.horizontal, gaps.inner.vertical [tiling] inner_gap
gaps.outer.top and the other edges outer_gap = [top, right, bottom, left]
default-root-container-layout = 'tiles' layout = "bsp"
focus-follows-mouse.enabled focus_follows_mouse = "autoraise" or "autofocus"
on-focused-monitor-changed = ['move-mouse monitor-lazy-center'] mouse_follows_focus = true (the default)
workspace-to-monitor-force-assignment display in a [[space]] entry
on-window-detected [[rule]] entries
Callbacks and aerospace subscribe [[signal]] entries and tilingbud subscribe
Per-monitor gap values [[display_profile]] entries

A rule that floats System Settings and sends it to a space:

~/.aerospace.toml
on-window-detected = [
{ if = 'test %{app-bundle-id} = com.apple.systempreferences', run = ['layout floating', 'move-node-to-workspace S'] },
]
~/.config/TilingBud/config.toml
[[rule]]
bundle = "com.apple.systempreferences"
float = true
space = "Settings" # the name of a [[space]] entry
AeroSpace TilingBud
tiles bsp: a new window splits the area of the focused one
accordion stacked: all windows on one frame, the focused one in front, with a bar of app icons
— main: a main area and the other windows beside it
— scroll: columns in a row that can be wider than the screen
layout floating window --toggle float, or layout = "off" for a whole space

A space keeps its own layout. Click the layout symbol on the control bar to choose another one; space --layout next steps through [tiling] layout_cycle. See Layouts.

AeroSpace normalizes its tree and lets you join windows into containers. In bsp, TilingBud’s window --stack west puts a window into the cell of its neighbor, and window --unstack takes it out again.

AeroSpace writes bindings as alt-h = 'focus left' in [mode.main.binding]. TilingBud writes them as "alt+h" = "window --focus west" in [shortcuts].

# AeroSpace
[mode.main.binding]
alt-h = 'focus left'
alt-shift-h = 'move left'
alt-1 = 'workspace 1'
alt-shift-1 = 'move-node-to-workspace 1'
alt-tab = 'workspace-back-and-forth'
alt-shift-semicolon = 'mode service'
[mode.service.binding]
esc = ['reload-config', 'mode main']
# TilingBud
[shortcuts]
"alt+h" = "window --focus west"
"alt+shift+h" = "window --swap west"
"alt+1" = "space --focus 1"
"alt+shift+1" = "window --space 1"
"alt+tab" = "space --focus recent"
"alt+shift+;" = "shortcuts --mode service"
[shortcuts.mode.service]
"escape" = ["config --reload", "shortcuts --mode default"]
  • Directions are west, east, north and south.
  • exec-and-forget is not needed: a value that is not a TilingBud command runs in your login shell.
  • Keys are read from the keyboard layout you use, so alt+z is the key printed Z on any layout.
  • lalt, ralt, lctrl and the other one-sided names bind only the left or right key.
  • Inside a mode the keys need no modifier, and Escape leaves the mode.

The commands are in the command line reference.

  • TilingBud has a Settings window for every option, next to the file.
  • The menu bar shows a pill per space with the icons of its windows, not only the name of the active workspace.
  • A control bar at the edge of each space shows its layout and windows.
  • The focus border is built in: [borders]. No JankyBorders is needed.
  • Saved layouts remember which app’s window goes where on a space.
  • Because spaces are macOS spaces, windows on other spaces are not parked in a screen corner, and Mission Control shows them on their spaces.
  • AeroSpace’s persistent-workspaces has no equivalent: macOS spaces stay until you remove them.
  • TilingBud runs on macOS 26 and later.