# &applet; Applet Manual

2005
Davyd Madeley
2004
Angela Boyle
2004
Sun Microsystems
2002
Trevor Curtis
1999
2000
Jorgen Pehrson
GNOME Documentation Project

&legal;

Sun
GNOME Documentation Team
Sun Microsystems
Trevor
Curtis
GNOME Documentation Project

     tcurtis@somaradio.ca

Jorgen
Pehrson
GNOME Documentation Project

     jp@spektr.eu.org

Angela
Boyle
GNOME Documentation Project
Davyd
Madeley
GNOME Project
Version 2.10
March 2005

Davyd Madeley

Version 2.8
Unknown

Angela Boyle

GNOME Documentation Project

Battery Charge Monitor Applet Manual V2.2
August 2004

Sun GNOME Documentation Team

GNOME Documentation Project

Battery Charge Monitor Applet Manual V2.0
May 2002

Trevor Curtis tcurtis@somaradio.ca

Jorgen Pehrson jp@spektr.eu.org

GNOME Documentation Project

This manual describes version &appletversion; of &applet;.

## 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

### &applet; Applet

The &applet; applet.

The &applet; panel application shows the status of any batteries in your laptop computer. You can configure the applet to show any of the following pieces of information on your panel:

- Power connection status (battery or mains power);

- A graphical representation of battery charge;

- The current battery charge as a percentage; or

- Battery time remaining/time remaining for recharge

### To Add &applet; to a Panel

To add &applet; to a panel, right-click on the panel, then choose Add to Panel. Select &applet; in the Add to the panel dialog, then click OK.

The layout of the &applet; applet varies depending on the size and type of panel in which the applet resides.

## Determining Status

### Determining the Power Connection Status

The power connection status shows the current status of the laptop power supply:

Icon | Power Status
--- | ---
Shows icon for AC power. | The laptop is connected to a power supply.
Shows icon for battery recharging. | The laptop battery is recharging.
Shows icon for battery power. | The laptop is using battery power.
Shows icon for low power. | The laptop power is very low.

### Determining the Battery Status

The battery-status icon is a progress bar within a battery image. The size and color of the progress bar indicate how much charge remains in the battery:

Icon | Battery Charge Level
--- | ---
Shows icon for high battery-charge level. | High
Shows icon for medium battery-charge level. | Medium
Shows icon for low battery-charge level. | Low
Shows icon for very low battery-charge level. | Very low

For information about how to display the current battery charge as a percentage, see .

## Customizing the &applet;

Right-click on the applet, then choose Preferences

### Preferences Dialog

Preferences Dialog

Appearance
  Show battery status

    The battery status is a progress bar within a battery image. Select this option to display a graphical representation of the the battery status. For more details on what this representation means, a table is available in .

  Show power connection status

    The power connection status shows the current status of the laptop power supply. Select this option to display an icon representing the power connection status. A table of icons is available in .

  Show time/percentage remaining

    Selecting this option will display one of two pieces of information. Show time remaining will tell you how many hours and minutes until the battery is fully discharged or recharged. Show percentage remaining will tell you the percentage charge remaining in the battery.

Warnings

  - Warn when battery charge is low

    Selecting this displays a warning dialog whenever your laptop battery reaches the Red Zone, indicating a critically low remaining charge. This warning dialog can either be closed by you, or will vanish automatically when you plug your laptop into mains power.

  - Warn when battery is fully re-charged

    Selecting this options displays a warning dialog whenever your laptop has fully recharged.

Suspend

  This is the command that will be run when you right click on the &applet; and select Suspend Computer.

## Suspending the Computer

To suspend the computer, right-click on the applet, then choose Suspend Computer.

To configure the command that is run when you suspend the computer see .