# &applet; Applet Manual V&manrevision;

1999
2000
Jorgen Pehrson
2002
Trevor Curtis
GNOME Documentation Project

&legal;

Jorgen
Pehrson
GNOME Documentation Project

     jp@spektr.eu.org

Trevor
Curtis
GNOME Documentation Project

     tcurtis@somaradio.ca

## Feedback

To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

The &applet; applet, shown in Figure 1, shows the status of the power subsystem in your laptop. To add this applet to your Panel, right click on the Panel and select Panel->Add to panel->Applet->Monitors->Battery Status Utility.

### &applet; Applet

The &applet; Applet.

## Usage

&applet; applet requires no user input. You can, if you so desire, configure it to some degree as described below.

The figure above is shown when the laptop battery is fully charged.

The little flash over the power cord is shown when the laptop battery is recharging. It's flashing on and off until the battery is fully recharged.

When you are running your laptop on battery it will display this image.

Right-clicking on the applet brings up a menu containing the following items:

Preferences

  Opens the Properties dialog window.

Help

  Displays this document.

About

  Shows basic information about this applet.

Suspend Computer

  Executes the command specified in the Preferences dialog.

## Customization

You can customize the Battstat applet somewhat by right-clicking on it and choose Preferences.... This will bring up the preferences dialog window.

### &applet; General Preferences

General preferences for the &applet; applet.

The properties are:

- Yellow: sets the battery level where the progress bar will switch from green to yellow. Default: 40.

- Orange: sets the battery level where the progress bar will switch from yellow to orange. Default: 25.

- Red: sets the battery level where the progress bar will switch from orange to red. Default: 15.

- The preview frame contains the battery progress bar and a draggable slider. By dragging the slider you can preview how it will look when the battery level actually changes. It doesn't affect the battery in any way.

- Notify me when battery charge is low: By selecting this, a warning dialog will appear when the power falls below the value in the Red entry box.

- Notify me when battery is fully re-charged: By selecting this, a dialog window will appear when the battery is fully re-charged.

- Beep when either of the above is true: If you select this, your laptop will make an audible beep when any of the two above happens.

- Suspend command: Whatever you enter here will be executed when you click on the Suspend Computer in the applet menu. For example, if you are using FreeBSD you could enter apm -z or zzz here. Before you enter anything though, first make sure that you can safely suspend your laptop by testing the command in a shell.

### &applet; Apperance Preferences

Apperance preferences for the &applet; applet.

The properties on this page are:

Move towards top:

  If you select this radio button, the battery charge level meter will drain from right to left.

Move towards bottom:

  If you select this radio button, the battery charge level meter will drain from left to right

Applet Layout:

  Here you can select which parts of the applets you want to have visible.

## About &applet;

To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the GNOME Feedback Page.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.