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

34 lines
916 B
Markdown
Raw Normal View History

2017-02-02 02:52:08 +01:00
# 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](./bat-wid-1.png)
- a pop-up window, which shows up when you hover over an icon: ![Battery Widget](./bat-wid-2.png)
- a pop-up warning message which appears on bottom right corner when battery level is less that 15%: ![Battery Widget](./bat-wid-3.png)
## 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
```
- clone/copy battery.lua file to ~/.config/awesome/ folder;
- include `battery.lua` and add battery widget to your wibox in rc.lua:
```lua
require("battery")
...
s.mytasklist, -- Middle widget
{ -- Right widgets
layout = wibox.layout.fixed.horizontal,
...
battery_widget,
...
```