Every provider uses the same item structure. Start with id and type, then add the settings listed on its page. Shared styling, actions, and refresh controls are available to every provider. Use text templates to customise displayed labels; provider pages describe their default labels.
Provider reference
| Provider | Updates | Dedicated configuration |
|---|---|---|
| Date and time | Every second | format, dateStyle, timeStyle |
| Front application | Native events | frontApplication block |
| Battery | Native events | battery block |
| Volume | Native events | volume block |
| Audio devices | Native events / 2-second retries when unavailable | audioDevice block |
| Configurable polling; 30 seconds by default | mail | |
| Network | Native events | network block |
| VPN | Native events / 2-second retries when unavailable | vpn block |
| Bluetooth | Native events / 2-second retries when unavailable | bluetooth block |
| CPU | 2-second sampling | cpu block |
| Memory | 2-second sampling | memory block |
| Disk | 2-second sampling | disk block |
| Throughput | 2-second sampling | throughput block |
| Media | Playback notifications | media block |
| Spaces | Native events | spaces block |
| AeroSpace | 2-second polling / fresh triggers | aerospace block |
| Yabai | 2-second polling / fresh triggers | yabai block |
| Shell command | Startup / trigger / interval | command block |
| Process plugin | Process stream | plugin block |
Layout items
Use these items for fixed text, containers, and spacing. See shared item options for containers and overflow.
| Type | Configuration | Behaviour |
|---|---|---|
text | text | Static text or a template using id and value; empty when omitted. |
group | children | Inline children, nesting up to eight levels. |
popup | text, children | Click to reveal children; label defaults to the item ID unless overridden. |
divider | Shared styling | Vertical separator. |
spacer | No dedicated options | Flexible empty space. |