summaryrefslogtreecommitdiffstats
path: root/docs/content/usage/widgets/battery.md
blob: c1e62a751ce19dba9214b5b9ead7521e4f1e52bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# Battery Widget

The battery widget provides information about batteries on the system.

<figure>
    <img src="../../../assets/screenshots/battery.webp" alt="A picture of an expanded battery widget."/>
</figure>

The battery widget can be enabled through either the `--battery` flag, the `battery = true` option in a config file, or specifying the widget in a custom layout.

## Features

The following data is displayed for batteries:

- Charge percent
- Consumption
- Time to empty/charge, based on the current state
- Battery health percent

The battery widget also supports devices with multiple batteries, and you can switch between them using the keyboard or the mouse.

## Key bindings

Note that key bindings are generally case-sensitive.

| Binding                               | Action                                                     |
| ------------------------------------- | ---------------------------------------------------------- |
| ++left++ <br/> ++h++ <br/> ++alt+h++  | Moves to the battery entry to the left of the current one  |
| ++right++ <br/> ++l++ <br/> ++alt+l++ | Moves to the battery entry to the right of the current one |

## Mouse bindings

| Binding     | Action                  |
| ----------- | ----------------------- |
| ++lbutton++ | Selects a battery entry |