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

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 (check the code):
  
• 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 first under /usr/share/icons/Arc/ folder.

Installation

This widget reads the output of acpi tool.

• install acpi and check the output:

$ 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:

require("battery")
...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
		...
		battery_widget,
		...