awesome-wm-widgets/BatteryWidget/README.md

27 lines
789 B
Markdown

## Battery widget
Simple and easy-to-install widget for Awesome Window Manager.
This widget consists of
- an icon which shows the battery status: ![Battery Widget](./batWid1.png)
- a pop-up window, which shows up when you hover over it: ![Battery Widget](./batWid2.png)
- a pop-up warning message which appears when battery level is less that 15%: ![Battery Widget](./batWid3.png)
## Installation
This widget uses the output of acpi tool.
- install `acpi` tool:
```
sudo apt-get install acpi
```
- clone/copy battery.lua file and battery-icons folder to your ~/home/username/.config/awesome/ folder;
- change path to the icons in `battery.lua`;
- include `battery.lua` and add battery widget to your wibox in rc.lua:
```
require("battery")
...
right_layout:add(batteryIcon)
```