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

2.2 KiB

Batteryarc widget

This widget is more informative version of battery widget.

Depending of the battery status it could look following ways:

  • 10_d - less than 15 percent
  • 10_c - less than 15 percent, charging
  • 20_d - between 15 and 40 percent
  • 20_c - between 15 and 40 percent, charging
  • 80_d - more than 40 percent
  • 80_c - more than 40 percent, charging

If a battery level is low then warning popup will show up:

warning

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
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%
charging beautiful.fg_color Color of the circle inside the arc when charging
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

Clone repo, include widget and use it in rc.lua:

local batteryarc_widget = require("awesome-wm-widgets.batteryarc-widget.batteryarc")
...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
		...
        --[[default]]
		batteryarc_widget(),		
        --[[or customized]]
        batteryarc_widget({
            show_current_level = true,
            thickness = '1',
        }),
	}
	...

Troubleshooting

In case of any doubts or questions please raise an issue.