Battery

> Published on Wed, Feb 4, 2026> Updated on Wed, Feb 4, 2026

Description #

The Battery widget shows current battery percentage and charging state.

Interactions #

  • Click to toggle caffeinate (if enabled).

Available settings #

  • Show icon: Show or hide the battery icon. Default is true.
  • Toggle caffeinate on click: Enable click-to-caffeinate. Default is true.
  • Caffeinate option: Choose what to prevent (display/system/disk/all). Default is "systemSleep".
  • Background color: Theme color for the widget background. Default is "magenta".
  • Refresh interval: Refresh cadence in seconds. Default is 10.
Something is wrong in this documentation? Please open an issue on GitHub in a-bar repo.
ProcessPrevious articleWeatherNext article
Toggle documentation menu