Yocraft-2000andGitHub
ef4c3996fd
* fix: setUpdateInterval in update function * fix: add shellEscape on cat command * dump version * fix: migrate settings to desktop_widget.settings * feat: auto gap based on the layout * feat: retrieve warning threshold from noctalia's settings
36 lines
1.5 KiB
Markdown
36 lines
1.5 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` |
|
|
|
|
## 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. |
|
|
| `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. |
|
|
| `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.
|
|
The warning threshold is pulled from noctalia's settings.
|