wmacpi - Battery status monitor for systems supporting ACPI

wmacpi [ -c value ] [ -d display ] [ -m battery no ] [ -s sample rate ] [ -f ] [ -v ] [ -n ] [ -w ] [ -a samples ] [ -V ] [ -h ]

This manual page documents briefly the wmacpi command.

wmacpi is a program that displays the current battery status in a WindowMaker dock app, on systems that support Intel's Advanced Configuration and Power Interface specification (ACPI).

The program monitors a battery, displaying its current percentage charge via a bar and a numeric value. It also displays the current power status for the system, the time remaining (calculated based on the remaining battery capacity and the current rate of power usage), and a scrolling message with some hopefully useful information.

Clicking on the window cycles through the batteries that the ACPI system knows about.

-c percentage

Set critical low alarm at <value>% (default: 10%).

-d display

Set the X display to open the window on.

-m battery number

Set the battery to monitor initially.

-s sample rate

Set the rate at which to sample the ACPI data, in number of times per minute. Minimum is 1, ie once a minute, default is 20, maximum is 600.

-n

Disable blinking power glyph when charging. Note that it still blinks when the battery reports its capacity state as critical.

-f

Force the use of capacity mode for calculating time remaining. By defalt wmacpi will use the reported values of remaining capacity and present rate to calculate the time remaining on battery. This flag will force the use of the remaining capacity and time samples to calculate the present rate of drain, and from there the time remaining. Note that this mode of calculation generally underreports the time remaining. This mode works around certain buggy ACPI BIOSes that fail to report the current rate.

-w

Run wmacpi in command line mode.

-a num

Average the time remaining over num samples. This greatly improves the accuracy of the reported time remaining.

-v

Increase the verbosity of the program. Can be used more than once - each successive use increases the verbosity.

-V

Print the version information.

-b

Enable blinking of the power glyph when charging the batteries.

-r

Disable scrolling message.

-h

Display help.

wmacpi was originally written by Tim Copperfield <timecop@japan.co.jp>, then completely rewritten after 1.34 by Simon Fowler <simon@dreamcraft.com.au>.

This manual page was originally written by Simon Richter <sjr@debian.org> for the Debian GNU/Linux system, and then updated by Simon Fowler.