Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xbattbar(1) [debian man page]

XBATTBAR(1)						    BSD General Commands Manual 					       XBATTBAR(1)

NAME
xbattbar -- show battery status in X Window SYNOPSIS
xbattbar [-a] [-t thickness] [-p interval] [-I color] [-O color] [-i color] [-o color] [-c] [-s script-name] [top | bottom | left | right] DESCRIPTION
xbattbar shows the current (laptop) battery status in the X window environment. Battery status is obtained through the APM kernel module. The APM kernel module depends on your UNIX platform, therefore, consult your documentation for its detail. xbattbar shows its battery status in a simple bar indicator. -a option makes the indicator window keep always on top of your screen. The thickness of the indicator is 3 pixels in default and you can set the thickness as a parameter of -t option. This indicator is appeared in the bottom of the display, as its default. The option top, left, or right forces the status indicator to be at the top, left, and right of the display, respectively. Though it's a default, you can also use buttom as the option. In the case the AC line is on-line (plugged in), its color of the bar indicator consists of "green" and "olive drab" portions. The "green" portion shows its battery charging level. These colors can be changed by -I and -O options. In the other case (AC line is off-line), the "blue" portion of the bar indicator shows the percentage of its remaining battery level. The color conbination for the AC off-line case can be changed by -i and -o options. xbattbar trys to know its battery status in every 10 seconds in default. This is achived by APM polling. If it is used with option -c then ACPI polling will be used. You can use your external script for check battery status. It must print two lines to STDOUT 'battery=value' and 'ac_line=on|off -p option sets the polling interval in second. If the mouse cursor enters in the status indicator, the diagnosis window appears in the center of the display, which shows both AC line sta- tus and battery remaining level. This diagnosis window disappears if the mouse cursor leaves from the status indicator. AUTHOR
Suguru Yamaguchi <suguru@wide.ad.jp>, Akira Kato <kato@wide.ad.jp>, Noriyuki Shigechika <nazo@wide.ad.jp>, Dmitry E. Oboukhov <unera@debian.org> BSD
December 5, 1998 BSD

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