LOWBAT

NAME

lowbat - A minimal battery level monitor daemon, written in C

DESCRIPTION

lowbat is configured by default to check the system battery level every 3 seconds. It is able to detect each of the system’s batteries, and calculate the remaining sum capacity of all installed batteries. Additional batteries installed during runtime will also be detected and summed.

The daemon will send a warning notification the user when the sum battery level drops below 20% while any battery is discharging, and another critical warning at 5%.

BATTERY STATUS LOG

The current charging status and sum capacity will be logged in stdout whenever a change is detected.

Each possible battery status value is assigned a single character symbol which will prefix the current battery level. E.g. ‘-50%‘ if any attached battery is currently discharging and the current sum capacity equals 50%. The symbols are defined as follows in order of highest to lowest priority:

	-		Discharging
	+		Charging
	=		Full / Not charging
	?		Unknown

USAGE

Call the lowbat executable in your xinitrc or xprofile.

CUSTOMIZATION

There are no runtime flags or configuration files. Simply modify the source code to suit your needs.

COPYRIGHT

Copyright 2024 Tim Keller <tjk@tjkeller.xyz>.

MIT License.

<https://TJKeller.xyz>

SEE ALSO

notify-send(1)

<https://www.kernel.org/doc/Documentation/ABI/testing/sysfs-class-power>