2018-09-15 23:33:42 +02:00
---
layout: page
---
# Batteryarc widget
2019-12-15 21:38:54 +01:00
This widget is more informative version of [battery widget ](../awesome-wm-widgets/assets/img/screenshots/batteryarc-widgetttps://github.com/streetturtle/awesome-wm-widgets/tree/master/battery-widget ).
2018-09-15 23:33:42 +02:00
2019-12-15 21:38:54 +01:00
Depending of the battery status it could look following ways:
2018-09-16 03:19:46 +02:00
2019-12-15 21:38:54 +01:00
-  - less than 15 percent
-  - less than 15 percent, charging
-  - between 15 and 40 percent
-  - between 15 and 40 percent, charging
-  - more than 40 percent
-  - more than 40 percent, charging
2018-09-15 23:33:42 +02:00
2019-12-15 21:38:54 +01:00
If a battery level is low then warning popup will show up:
2018-09-15 23:33:42 +02:00
2019-12-15 21:38:54 +01:00
2018-09-15 23:33:42 +02:00
2019-12-15 21:38:54 +01:00
## 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 6 |
| `arc_thickness` | 2 | Thickness of the arc |
| `show_current_level` | false | Show current charge level |
| `main_color` | `beautiful.fg_color` | Color of the text with the current charge level and the arc |
2020-03-02 03:40:04 +01:00
| `bg_color` | `#ffffff11` | Color of the charge level background |
2019-12-15 21:38:54 +01:00
| `low_level_color` | #e53935 | Arc color when battery charge is less that 15% |
| `medium_level_color` | #c0ca33 | Arc color when battery charge is between 15% and 40% |
2020-02-02 19:53:06 +01:00
| `charging` | `#43a047` | Color of the circle inside the arc when charging |
2019-12-15 21:38:54 +01:00
| `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 |
2018-09-15 23:33:42 +02:00
## Installation
Clone repo, include widget and use it in **rc.lua** :
```lua
local batteryarc_widget = require("awesome-wm-widgets.batteryarc-widget.batteryarc")
...
s.mytasklist, -- Middle widget
{ -- Right widgets
layout = wibox.layout.fixed.horizontal,
...
2019-12-15 21:38:54 +01:00
--[[default]]
batteryarc_widget(),
--[[or customized]]
batteryarc_widget({
show_current_level = true,
2020-02-21 20:53:38 +01:00
arc_thickness = 1,
2019-12-15 21:38:54 +01:00
}),
}
...
2018-09-15 23:33:42 +02:00
```
## Troubleshooting
2019-12-15 21:38:54 +01:00
In case of any doubts or questions please raise an [issue ](../awesome-wm-widgets/assets/img/screenshots/batteryarc-widgetttps://github.com/streetturtle/awesome-wm-widgets/issues/new ).
