Skip to content
EN
Download

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.

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

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.

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.

A line of skhd becomes an entry of [shortcuts]: the keys in quotes, the command without yabai -m.

Terminal window
# skhdrc
lalt - h : yabai -m window --focus west
shift + alt - 1 : yabai -m window --space 1
rctrl - f : open ~
config.toml
[shortcuts]
"lalt+h" = "window --focus west"
"shift+alt+1" = "window --space 1"
"rctrl+f" = "open ~"
  • lalt, ralt, lctrl, rctrl, lshift, rshift, lcmd and rcmd bind one side only, as in skhd. alt means 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 tilingbud runs 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 with shortcuts --mode <name>. Inside a mode the keys need no modifier; Escape leaves it. capture = true swallows the keys the mode does not bind.
  • A table with apps or except_apps limits a shortcut to some apps, pass = true lets the key reach the app too, and exclude_apps turns every shortcut off in games or virtual machines.

The full syntax is under Apps, shell commands, lists, modes and per-app shortcuts.

JankyBorders colors are 0xAARRGGBB; TilingBud takes "#RRGGBB" or "#RRGGBBAA", or two colors for a gradient.

Terminal window
borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0
[borders]
focused_color = "#E1E3E4"
unfocused_color = "#494D64"
width = 5

An app without a border is a rule with border = false.

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.

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.

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-floating brings the floating windows forward.
  • window --raise and window --lower. window --focus raises and focuses.
  • Switching spaces without the slide animation.
  • Window opacity, shadows and animation settings.
  • Scratchpads.
  • Sending a space to another display by command. The display key of a [[space]] entry places it.
  • On all spaces for one window: all_spaces works per app.