Battery Widget

Desktop/lockscreen widget that displays the current battery level and charging status.

Plugin

Field	Value
ID	yocraft/battery-widget
Entries	Desktop widget: widget

Usage

Add it to your desktop/lockscreen widgets.

Settings

Setting	Type	Default	Description
layout	select	horizontal	Layout of the widget.
show_glyph	bool	true	Show the battery icon.
show_label	bool	true	Show text next to the icon.
hide_plugged	bool	false	Hide the battery widget when connected to AC power.
hide_full	bool	false	Hide the battery widget when fully charged.
color	color	on_surface	Color role for this widget's icon and label; fixed hex colors are also supported.
warning_color	color	error	Color applied when charge is at or below 20%.
charging_color	color	on_surface	Color applied when connected to AC power.
battery	select	auto	Detect the battery automatically or set a custom name.
battery_name	string	BAT0	Set a custom name for the battery.
refresh_interval	int	60	Controls how frequently the widget updates its content. (in seconds)

Notes

hide_full and hide_plugged do not hide the background due to plugin limitations.