Switching from yabai
A yabai setup is usually four tools: yabai arranges the windows, skhd binds the keys, JankyBorders draws the focus
border and SketchyBar shows the spaces. TilingBud does all four in one app, configured in one file,
~/.config/TilingBud/config.toml. The file reloads when you save it, and Settings writes to the same file.
TilingBud works with System Integrity Protection on. It has no scripting addition and loads nothing into the Dock.
What replaces what
Section titled “What replaces what”| Before | In TilingBud |
|---|---|
| yabai | The layout of each space, window rules, signals and the tilingbud command |
| skhd | [shortcuts] in the configuration file, or Settings › Shortcuts |
| JankyBorders | [borders], on by default |
| SketchyBar | The pills in the menu bar, one per space, and the control bar at the edge of each space |
Commands
Section titled “Commands”The command names follow yabai’s where an equivalent exists. Drop yabai -m and write tilingbud:
| yabai | TilingBud |
|---|---|
yabai -m window --focus west |
tilingbud window --focus west |
yabai -m window --swap east |
tilingbud window --swap east |
yabai -m window --warp east |
tilingbud window --warp east |
yabai -m window --space 3 |
tilingbud window --space 3 |
yabai -m window --toggle float |
tilingbud window --toggle float |
yabai -m window --toggle zoom-fullscreen |
tilingbud window --toggle zoom-fullscreen |
yabai -m space --focus 2 |
tilingbud space --focus 2 |
yabai -m space --balance |
tilingbud space --balance |
yabai -m space --rotate 90 |
tilingbud space --rotate 90 |
yabai -m space --mirror y-axis |
tilingbud space --mirror y |
yabai -m space --layout stack |
tilingbud space --layout stacked |
yabai -m space --layout float |
tilingbud space --layout off |
yabai -m space --create |
tilingbud space --create |
yabai -m query --windows |
tilingbud query --windows |
Space numbers count over all displays, as in yabai. A space can also be named by its name
(space --focus Mail), which keeps pointing at the same space when the numbers shift. The JSON of query has its
own field names. Every command is in the command line reference.
Settings
Section titled “Settings”| yabai | TilingBud |
|---|---|
layout bsp |
[tiling] layout = "bsp" (the default) |
window_gap 8 |
inner_gap = 8 |
top_padding, right_padding, bottom_padding, left_padding |
outer_gap = [top, right, bottom, left] |
split_ratio 0.5 |
split_ratio = 0.5 |
window_placement second_child |
new_window_placement = "second" |
auto_balance on |
auto_balance = true |
mouse_follows_focus on |
mouse_follows_focus = true (the default) |
focus_follows_mouse autoraise |
focus_follows_mouse = "autoraise" |
mouse_modifier alt |
[keyboard] drag_windows = true, drag_modifier = "option" |
mouse_action2 resize |
right_drag = "resize" (the default) |
yabai -m rule --add app="^Calculator$" manage=off |
[[rule]] with app = "Calculator" and float = true |
yabai -m signal --add event=space_changed action="…" |
[[signal]] with event and action |
In a [[rule]], app is the app’s name, not a regular expression; title
is a regular expression. The signal events have yabai’s names
(space_changed, window_focused and the others), and the command gets the values as TILINGBUD_* variables. A bar
can also listen with tilingbud subscribe.
skhd lines
Section titled “skhd lines”A line of skhd becomes an entry of [shortcuts]: the keys in quotes, the command without yabai -m.
# skhdrclalt - h : yabai -m window --focus westshift + alt - 1 : yabai -m window --space 1rctrl - f : open ~[shortcuts]"lalt+h" = "window --focus west""shift+alt+1" = "window --space 1""rctrl+f" = "open ~"lalt,ralt,lctrl,rctrl,lshift,rshift,lcmdandrcmdbind one side only, as in skhd.altmeans either side.- A value that is not a TilingBud command runs in your login shell, as an skhd line does. A line that starts with
tilingbudruns inside TilingBud. - A list runs several commands in order:
"ctrl+alt+m" = ["space --focus 3", "open -a Mail"]. - Modes are tables
[shortcuts.mode.<name>], entered withshortcuts --mode <name>. Inside a mode the keys need no modifier; Escape leaves it.capture = trueswallows the keys the mode does not bind. - A table with
appsorexcept_appslimits a shortcut to some apps,pass = truelets the key reach the app too, andexclude_appsturns every shortcut off in games or virtual machines.
The full syntax is under Apps, shell commands, lists, modes and per-app shortcuts.
Borders
Section titled “Borders”JankyBorders colors are 0xAARRGGBB; TilingBud takes "#RRGGBB" or "#RRGGBBAA", or two colors for a gradient.
borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0[borders]focused_color = "#E1E3E4"unfocused_color = "#494D64"width = 5An app without a border is a rule with border = false.
The bar
Section titled “The bar”The menu bar shows a pill per space with an icon for each window. Click a pill to switch; rest the pointer on it to see
its windows. With several displays, each display’s menu bar shows its own spaces. The control bar at the edge of each
space shows its layout, its windows and its floating windows. If you keep SketchyBar, a signal or tilingbud subscribe
tells it when the space changes.
Spaces with SIP on
Section titled “Spaces with SIP on”TilingBud works on the spaces of Mission Control. It switches, creates, removes, moves and swaps them with SIP on.
Creating and removing go through Mission Control, which opens for a moment. A space can belong to a display
([[space]] display) and goes back there when the display returns.
What has no equivalent
Section titled “What has no equivalent”macOS does not allow these with SIP on, or TilingBud does not offer them:
- Keeping another app’s window above the others (yabai’s layers). A rule can dock a window to an edge so the tiled
windows leave room for it, and
space --raise-floatingbrings the floating windows forward. window --raiseandwindow --lower.window --focusraises and focuses.- Switching spaces without the slide animation.
- Window opacity, shadows and animation settings.
- Scratchpads.
- Sending a space to another display by command. The
displaykey of a[[space]]entry places it. - On all spaces for one window:
all_spacesworks per app.