omarchy-battery-health

KO | EN

gitlite — search

#csharp #java #electron #http #devops #php #ui #reactjs #containers #cross-platform

omarchy-battery-health

(★ 9)

Omarchy power widget with battery charge protection

File Explorer

ZIP Download

- panel.png
- screenshot.png
- omarchy-battery-limit
.gitignore
LICENSE
manifest.json
Model.js
Panel.qml
README.md
test.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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](https://raw.githubusercontent.com/patcastle/omarchy-battery-health/main/assets/screenshot.png)

_Wallpaper by [Simon Høiberg](https://x.com/SimonHoiberg), 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](https://raw.githubusercontent.com/patcastle/omarchy-battery-health/main/assets/panel.png)

## Installing it

```bash
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

```bash
omarchy plugin disable patcastle.power
omarchy plugin remove patcastle.power
```

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

## Development

```bash
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](https://github.com/basecamp/omarchy/pull/8579).

## License

MIT

omarchy-battery-health

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README