Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

wmacpi(1) [debian man page]

WMACPI(1)						      General Commands Manual							 WMACPI(1)

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 Configura-
       tion 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 							 WMACPI(1)

Check Out this Related Man Page

XAPM(1) 																   XAPM(1)

NAME

       xapm - display Advanced Power Management (APM) BIOS information

SYNOPSIS

       xapm [ ... ]

DESCRIPTION

       xapm  puts up an X window that displays the remaining battery life.  The left side of the window contains a printed time or percentage; the
       right side of the window contains a bar indicating the percentage.  Clicking on the left side of the window will toggle the display between
       time and percentage.

OPTIONS AND RESOURCES

       In addition to standard Xt options, the following options are available:

       -V     Print the program version number and exit.

       -highcolor color
	      The color of the bar when the battery percentage is above highvalue.  Defaults to "green". (*highColor)

       -lowcolor color
	      The color of the bar when the battery percentage is between lowvalue and highvalue.  Defaults to "yellow". (*lowColor)

       -criticalcolor color
	      The  color  of  the  bar	when  the  battery percentage is below lowvalue.  Defaults to "red".  This color is also used to flash the
	      alphanumeric part of the display when the power status is critical. (*criticalCOlor)

       -highvalue highvalue
	      Set highvalue.  The default is 50. (*highValue)

       -lowvalue lowvalue
	      Set lowvalue.  The default is 10. (*lowValue)

       -chargingcolor color
	      The color of the printed display when charging.  The default is "blue".  Use -foreground to change the color used  when  on  battery
	      power. (*chargingColor)

       -delay delay
	      Sets the number of seconds delay between each update.  The default is 1. (*delay)

       -percent
	      Display percentage on startup, instead of time remaining. (*percent, boolean)

       -percentauto
	      Swap  automatically  between  displaying percentage and displaying the time remaining. When on ac power, display percentage, when on
	      battery power, display the time remaining.

BUGS

       There is no way to inhibit the alphanumeric display or the bar display.	When the battery percentage is low, using a bright color  to  warn
       you  of	impending  doom  may be futile because the bar is too short.  Because of the form widget's desire to maintain proportions, dynamic
       resizing of the window may not do what you want it to do.

FILES

       /proc/apm

AUTHOR

       This program was written by Rik Faith (faith@cs.unc.edu) and may be freely distributed under the terms of the GNU General  Public  License.
       There is ABSOLUTELY NO WARRANTY for this program.  The current maintainer is Avery Pennarun (apenwarr@worldvisions.ca).

SEE ALSO

       apm(1), apmd(8).

								   January 2004 							   XAPM(1)
Man Page