Ricing

Yabai

A tiling window manager for macOS (but more like a window resizer because macs are macs)

Installing Yabai

yabai can be installed using homebrew from a tap.

brew install asmvik/formulae/yabai

If you are installing from HEAD, you will have to uninstall any release versions before installing. You will also have to create a user-signed certificate for yabai.

System Integrity Protection

To use yabai as a proper WM, SIP needs to be partially disabled.

1. Enter macOS Recovery

   Intel: hold CMD + R during boot

   Apple Silicon: long press power button to boot

2. Open Terminal (CMD + SHIFT + T)

   Enter:

   csrutil enable --without fs --without debug --without nvram
   

3. Restart

Visit the yabai wiki for more info.

Scripting Additions

For more useful features, you will need to configure scripting additions.

1. Run

   echo "$(whoami) ALL=(root) NOPASSWD: sha256:$(shasum -a 256 $(which yabai) | cut -d " " -f 1) $(which yabai) --load-sa" | sudo tee /private/etc/sudoers.d/yabai
   

2. Add the following lines near the top of your yabairc file.

   yabairc

   yabai -m signal --add event=dock_did_restart action="sudo yabai --load-sa"
   sudo yabai --load-sa
   

Installing from HEAD may require slighty different procedures.