Skip to content

Battery

Daniel Berger edited this page Oct 30, 2026 · 1 revision

Battery

The Battery window expands Waybar's compact battery indicator into a readable charge summary and a persistent low-battery warning threshold.

BSDRunner battery status and alert threshold controls

Open it

  • Click the battery module on Waybar.
  • Or run sh ~/.config/bsdrunner/scripts/bsdrunner-battery-window.sh.

Status card

The main card shows charge percentage, ACPI state, estimated remaining time when FreeBSD reports one, and the configured warning threshold. Color communicates the state: healthy or charging states use the success color, discharging uses the warning color, and a battery at or below the threshold uses the danger color.

The data comes from battery 0 through acpiconf -i 0. It refreshes when the window opens and every 30 seconds while it remains open. A system without readable ACPI battery information shows an unavailable state instead of inventing values.

Low-Battery Alert panel

Choose 3, 5, 7, 10, 15, or 20 percent. The selected value is saved to ~/.config/bsdrunner/battery-alert-threshold, so Waybar and the window use the same threshold across sessions. Selecting a new value immediately reevaluates whether a currently discharging battery is critical.

What it does not do

This app does not change CPU governors, suspend the machine, adjust screen brightness, or modify charging limits. It reports ACPI state and configures BSDRunner's warning point only.

Back to the BSDRunner Apps overview.

Clone this wiki locally