Custom widgets
> Published on Wed, Feb 4, 2026> Updated on Wed, Feb 4, 2026
Description #
Custom widgets let you run shell commands and display their output in the bar. They can also run a separate command on click.
Interactions #
- Click to run the widget click command (if set).
- Refresh, toggle, hide, or show via AppleScript commands.
Available settings #
Custom widget options are configured in the Custom tab:
Name: Display name (must be unique).Icon: SF Symbol name.Command: Shell command whose output is displayed.Refresh interval: How often to refresh in seconds. Default is 60.Click command: Optional command to run on click.Background color: CSS color or theme color name.Active: Toggle visibility of the widget.Hide icon: Hide the icon.Hide when empty: Hide the widget if output is empty.