* fix: invalid check in getWarningThreshold * fix: invalid status * feat: use dbus events instead of polling * fix: invalid status again * fix: dump version and set valid plugin API * fix: add commandExists check * fix: getColor function (warning color when not charging) * feat: use upower instead of cat /sys * feat: notify on error * fix: cleaner code * fix: use noctalia.tr for notification (not logs, intended) * feat: migrate from dbus-monitor to gdbus (everything in one line) * feat: use gdbus to init and update, parse only when needed * feat: add label_content and optimisations * fix: remove multiple commands check not needed anymore * fix: update README and dump version * fix: default data, warning_threshold check, floor percent
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.