45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
# Battery widget
|
|
|
|
Simple and easy-to-install widget for Awesome Window Manager.
|
|
|
|
This widget consists of:
|
|
|
|
- an icon which shows the battery level:
|
|
|
|
- a pop-up window, which shows up when you hover over an icon:
|
|
|
|
Alternatively you can use a tooltip:
|
|
|
|
- a pop-up warning message which appears on bottom right corner when battery level is less that 15%:
|
|
|
|
|
|
Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder.
|
|
|
|
Also it's worth mentioning that if the charge is more that 95% the widget is hidden. This is done intentionally in order to save some space on wibox when laptop is plugged in dock station or power socket. You can edit this behaviour [here](https://github.com/streetturtle/awesome-wm-widgets/blob/41b0476d84646fe04b5795e072f5ac8dfdb0066b/battery-widget/battery.lua#L37)
|
|
|
|
## 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,
|
|
...
|
|
```
|