mirror of
https://github.com/streetturtle/awesome-wm-widgets.git
synced 2024-11-17 07:49:09 +01:00
.. | ||
bat-wid-1.png | ||
bat-wid-2.png | ||
bat-wid-3.png | ||
bat-wid-22.png | ||
battery.lua | ||
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% (you can get the image here):
Note that widget uses the Arc icon theme, so it should be installed first under /usr/share/icons/Arc/ folder.
Customization
It is possible to customize widget by providing a table with all or some of the following config parameters:
Name | Default | Description |
---|---|---|
font |
Font | Play 8 |
show_current_level |
false | Show current charge level |
margin_right |
0 | the right margin of the widget |
margin_left |
0 | the left margin of the widget |
notification |
false |
Display a notification on mouseover |
notification_position |
top_right |
The notification position |
warning_msg_title |
Huston, we have a problem | Title of the warning popup |
warning_msg_text |
Battery is dying | Text of the warning popup |
warning_msg_position |
bottom_right |
Position of the warning popup |
warning_msg_icon |
~/.config/awesome/awesome-wm-widgets/batteryarc-widget/spaceman.jpg | Icon of the warning popup |
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
local battery_widget = require("awesome-wm-widgets.battery-widget.battery")
...
s.mytasklist, -- Middle widget
{ -- Right widgets
layout = wibox.layout.fixed.horizontal,
...
battery_widget(),
...