Omahub
← All plugins
P

Power + Battery Health

by Patrick Castiglia

The Omarchy power widget with battery charge protection.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
5216baa
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
5216baa
Reviewed
1 month ago

The plugin is a benign shell/QML power widget clone. The bundled helper script only reads UPower properties and calls EnableChargeThreshold on battery devices (explicitly via busctl) based on user action. No obfuscation, no persistence, no data exfiltration, and all destructive actions are limited to toggling a documented battery-charge setting.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/patcastle/omarchy-battery-health --enable
Hardware #bar #quickshell #power-management

Battery Health for Omarchy

The built-in Omarchy power widget, extended with a battery-health toggle that uses the charging policy exposed by your laptop through UPower.

The power panel showing battery health and power profile controls

Wallpaper by Simon Høiberg, featuring Switzerland, our home.

What it does

  • Shows battery level, capacity, charge cycles, charge rate, and remaining time.
  • Switches between the power profiles available on the system.
  • Enables or disables the laptop's firmware-provided charge limit.
  • Hides the battery-health control when the hardware does not support it.
  • Shows the battery percentage in the bar when you right-click the battery icon.

UPower reports the charging policy supported by the laptop. This may be a fixed limit, a start/end range, or a firmware-optimized charging mode.

Panel close-up

Battery health enabled with a 75-80% firmware charging policy

Installing it

omarchy plugin add https://github.com/patcastle/omarchy-battery-health --enable

The plugin declares itself as a clone of omarchy.power, so Omarchy replaces the built-in power widget in place and keeps its bar position and settings. You do not need to disable or move the original widget manually.

Click the battery icon and use Preserve battery health. The control only appears when UPower reports charge-threshold support.

Compatibility

Requires an Omarchy version with shell plugin support, plus upower and busctl. Those are part of a normal Omarchy installation.

Actual support depends on the laptop firmware, kernel driver, and UPower. The plugin uses UPower's D-Bus API and does not use sudo or pkexec.

If another tool already manages your charge threshold, use one or the other so they do not fight over the setting.

Removing it

omarchy plugin disable patcastle.power
omarchy plugin remove patcastle.power

Disabling or removing it restores the built-in omarchy.power widget.

Development

omarchy plugin validate .
./test.sh

This is a clone of Omarchy's power widget while the corresponding upstream change is under review in basecamp/omarchy#8579.

License

MIT