# &applet; Applet Manual

## 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 battstat-appearance.

## 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 battstat-usage-progress.

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 battstat-usage-power.

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 battstat-appearance.