awesome-wm-widgets/_widgets/battery-widget.md

33 lines
1.5 KiB
Markdown

---
layout: page
---
# Battery widget
Simple and easy-to-install widget for Awesome Window Manager.
This widget consists of:
- an icon which shows the battery level:
![Battery Widget](../awesome-wm-widgets/assets/img/screenshots/battery-widget/bat-wid-1.png)
- a pop-up window, which shows up when you hover over an icon:
![Battery Widget](../awesome-wm-widgets/assets/img/screenshots/battery-widget/bat-wid-2.png)
Alternatively you can use a tooltip (check the code):
![Battery Widget](../awesome-wm-widgets/assets/img/screenshots/battery-widget/bat-wid-22.png)
- a pop-up warning message which appears on bottom right corner when battery level is less that 15% (you can get the image [here](../awesome-wm-widgets/assets/img/screenshots/battery-widgetttps://vk.com/images/stickers/1933/512.png)):
![Battery Widget](../awesome-wm-widgets/assets/img/screenshots/battery-widget/bat-wid-3.png)
Note that widget uses the Arc icon theme, so it should be [installed](../awesome-wm-widgets/assets/img/screenshots/battery-widgetttps://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder.
## Installation
This widget reads the output of acpi tool.
- install `acpi` and check the output:
```bash
$ sudo apt-get install acpi
$ acpi
Battery 0: Discharging, 66%, 02:34:06 remaining
```
Then refer to the [installation](../awesome-wm-widgets/assets/img/screenshots/battery-widgetttps://github.com/streetturtle/awesome-wm-widgets#installation) section of the repo.