NAME
wmacpi - Battery status monitor for systems supporting ACPI
SYNOPSIS
wmacpi [ -c value ] [ -d display ] [ -m battery no ] [ -s sample rate ]
[ -f ] [ -v ] [ -n ] [ -x ] [ -a samples ] [ -v ] [ -h ]
DESCRIPTION
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.
OPTIONS
-c, --critical=percentage
Set critical low alarm at <percentage>% (default: 10%).
-d, --display=display
Set the X display to open the window on.
-m, --battery=battery number
Set the battery to monitor initially.
-s, --sample-rate=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, --no-blink
Disable blinking power glyph when charging. Note that it still
blinks when the battery reports its capacity state as critical.
-f, --force-capacity-mode
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.
-x, --cmdline
Run wmacpi in command line mode.
-a, --samples=samples
Average the time remaining over num samples. This greatly
improves the accuracy of the reported time remaining.
-V, --verbosity=num
Increase the verbosity of the program. Setting this to 1 will
print extra error information; 2 will produce informational
output; 3 will produce copious debugging output.
-v, --version
Print the version information.
-r, --no-scroll
Disable scrolling message.
-h, --help
Display help.
AUTHOR
wmacpi was originally written by Tim Copperfield <timecop@japan.co.jp>,
then completely rewritten after 1.34 by Simon Fowler <simon@himi.org>.
This manual page was originally written by Simon Richter
<sjr@debian.org> for the Debian GNU/Linux system, and then updated by
Simon Fowler.
Last modification by Simon Fowler <simon@himi.org>, 2007-07-13.
July 13 2007