Yocraft-2000andGitHub
e9121c114c
* 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
40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# 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.
|