System Tray

tarmac adds a menu bar icon (system tray) with quick access to workspace switching, settings, config reload, and quitting.

Tray icon

The tray icon is a landing airplane descending onto a runway strip — a nod to the "tarmac" name. It appears in the macOS menu bar as a template image, so it adapts to light/dark mode automatically.

Menu items

Clicking the tray icon opens a dropdown menu:

Workspace list

The top section shows workspaces that are either active (visible on a monitor) or have windows. Each entry shows:

1  (3 windows)  ✓
2  (1 window)

The checkmark indicates the currently focused workspace. Empty, non-active workspaces are hidden to keep the menu compact.

Click a workspace entry to switch to it.

Settings...

Opens the Settings Window where you can adjust gaps, borders, mouse behavior, and more through a GUI.

Reload Config

Hot reloads ~/.config/tarmac/init.lua. Same as pressing the reload keybind or running tarmacctl reload.

Quit tarmac

Gracefully exits the tarmac daemon. Windows return to their normal floating state.

Updating

The tray menu workspace list updates every 50ms as part of the main event loop polling. Window counts and active states always reflect the current state.