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

Requirements

The plugin requires gdbus on PATH and upower.

Usage

Add it to your desktop/lockscreen widgets using the widget editor. You can configure it in the widget settings.

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.
label_content	select	percent	What the battery label shows: charge percentage, time remaining, or power draw.
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 warning threshold.
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.

Notes

hide_full and hide_plugged do not hide the background due to plugin limitations. The warning threshold is pulled from noctalia's settings.