cbatticon

lightweight battery indicator for the system tray

TLDR

Show the battery icon in the system tray
$ cbatticon
Set the update interval in seconds (default: 5)
$ cbatticon -u [10]
List available icon types
$ cbatticon -t
Show with a specific icon type
$ cbatticon -i [standard|notification|symbolic]
List available power supplies
$ cbatticon -p
Show icon for a specific battery
$ cbatticon [BAT0]
Set critical level command
$ cbatticon -r [5] -c [poweroff]

SYNOPSIS

cbatticon [options] [battery]

DESCRIPTION

cbatticon is a lightweight battery indicator for the system tray. It displays battery status with configurable icons and can execute commands when battery reaches critical levels.The tool is designed for minimal window managers and desktop environments that don't include battery monitoring.

PARAMETERS

-u, --update-interval seconds

Update interval in seconds (default: 5).
-i, --icon-type type
Icon style: standard, notification, or symbolic.
-t, --list-icon-types
List available icon types.
-p, --list-power-supplies
List available power supplies.
-r, --critical-level percent
Set critical battery level percentage (default: 5%).
-c, --command-critical-level cmd
Command to execute when critical level is reached.
-o, --command-low-level cmd
Command to execute when low level is reached.
-l, --low-level percent
Set low battery level percentage.
-x, --command-left-click cmd
Command to execute when left clicking on the tray icon.
-d, --debug
Display debug information.

INSTALL

sudo apt install cbatticon
sudo pacman -S cbatticon
sudo apk add cbatticon
nix profile install nixpkgs#cbatticon

CAVEATS

Requires a system tray to display. May not work with Wayland compositors that lack tray support. Critical level commands run with user privileges.

SEE ALSO

upower(1), acpi(1)