Configuration

a-bar stores settings in two places:

• A JSON config file at ~/.a-barrc
• UserDefaults (for fast load and backup)

When a-bar starts, it loads settings, validates them, and merges invalid or missing values with defaults. Saving from the app will update both UserDefaults and ~/.a-barrc.

Launch at login #

You can enable Launch at login in the General tab. On macOS 13+, this uses the system service registration APIs.

Window manager #

a-bar supports both yabai and AeroSpace. You can choose which window manager to use in the General settings tab. Yabai is selected by default. Switching window managers will stop the current integration and start the new one automatically.

yabai path #

If you use yabai, set the absolute path to the binary in General. The default is:

/opt/homebrew/bin/yabai

AeroSpace path #

If you use AeroSpace, set the absolute path to the binary in General. The default is:

/opt/homebrew/bin/aerospace