xiph.org: MGM manual

[ home | FAQ | download | troubleshooting | manual | cvs | mailing lists ]

# Module: battery

The battery module watches the state of a portable computer's battery charge, providing a bargraph readout of charge remaining. Normally, the bargraph uses a fixed 100% scale and a green bar. Below 30% charge, the bar is changed to yellow. Below 8%, the bar is changed to red and the default text changes to read 'battery low'.

## Current platforms

Linux

## Instances

single only

## additional resources

lowbackground, lowforeground, lowlabel, midbackground, midforeground

Below 30%, the bar is reconfigured, by default using a yellow bar and the normal litforeground. 'midbackground' and 'midforeground' may be used to configure the colors. Similarly, below 8%, the bar normally turns red with white text. 'lowforeground' and 'lowbackground' configure these colors. Below 8%, the bar text is also changed; 'lowlabel' may set this text just as label sets the text for 8% and above.

## Resource defaults

Resource defaults explicitly altered from the global defaults by this module:

- label: battery
- litbackground: #60c060
- lowbackground: #ff4040
- lowforeground: #ffffff
- lowlabel: battery low
- midbackground: #d0d060
- midforeground: same as litforeground
- order: 201
- scalelenadj: 100
- scalerefresh:10000
- scalereturn:1
- scalewidadj: 80

## Possible enhancements

AC on/offline as well as charging status is also available from /proc/apm; battery should be enhanced to display these as well.

MGM will not get your whites whiter or your colors brighter. It will, however, sit there and look spiffy while sucking down a major honking wad of RAM.

MGM, Xiphophorus and their logos are trademarks (tm) of Xiphophorus. These pages are copyright (C) 1994-1999 Xiphophorus. All rights reserved.