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.
Workspaces and spaces
Section titled “Workspaces and spaces”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).
The configuration file
Section titled “The configuration file”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:
on-window-detected = [ { if = 'test %{app-bundle-id} = com.apple.systempreferences', run = ['layout floating', 'move-node-to-workspace S'] },][[rule]]bundle = "com.apple.systempreferences"float = truespace = "Settings" # the name of a [[space]] entryLayouts
Section titled “Layouts”| 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,northandsouth. exec-and-forgetis 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+zis the key printed Z on any layout. lalt,ralt,lctrland 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.
What differs
Section titled “What differs”- 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-workspaceshas no equivalent: macOS spaces stay until you remove them. - TilingBud runs on macOS 26 and later.