omarchy-battery-tooltip/README.md

omarchy-battery-tooltip

Replace Omarchy's minimal waybar battery tooltip with a richer one:

󰁿 Battery 69% · 03h:49m left · ↓10.3W/57Wh

…wrapped in an accent-coloured border that follows the active Omarchy theme.

The default tooltip on a stock Omarchy install shows just 5W↓ 69%. This installer adds time remaining, power direction, formatted power draw, and your battery's capacity in Wh — auto-detected from /sys/class/power_supply/.

Requirements

• Omarchy (waybar set up at ~/.config/waybar/)
• A laptop. The script auto-detects via hostnamectl / SMBIOS chassis type and exits cleanly on desktops, VMs, and servers (use --force to install anyway).
• bash, awk, find, python3 — all in Omarchy's base install.

Install

One-liner:

curl -fsSL https://git.no-signal.uk/nosignal/omarchy-battery-tooltip/raw/branch/main/install-battery-tooltip.sh | bash

GitHub mirror:

curl -fsSL https://raw.githubusercontent.com/28allday/omarchy-battery-tooltip/main/install-battery-tooltip.sh | bash

Or clone and run:

git clone https://git.no-signal.uk/nosignal/omarchy-battery-tooltip.git
cd omarchy-battery-tooltip
./install-battery-tooltip.sh

Hover the battery icon in waybar to see the new tooltip.

Options

Flag	Effect
(none)	Use the battery's design capacity (rated spec, never changes).
--current	Use the current full-charge capacity instead — reflects degradation. Re-run to refresh.
--force	Install even if the script doesn't think this is a laptop.
--help	Print the script's header.

Safe to re-run

The script is idempotent:

• config.jsonc — finds the existing "battery" block and replaces the tooltip keys in place (or inserts them if missing). Stock or already-patched configs both work.
• style.css — uses a /* >>> battery-tooltip */ marker block, so re-runs replace what's between the markers rather than accumulating.

A timestamped backup of each file is written next to it on every run:

~/.config/waybar/config.jsonc.bak.<unix-ts>
~/.config/waybar/style.css.bak.<unix-ts>

Theme follows automatically

• Border colour pulls @selected-text from the active theme's walker.css. Switching themes with omarchy-theme-set updates the border on the next waybar reload.
• Font follows because the tooltip wraps dynamic fields in <span face='monospace'>, which picks up whatever font omarchy-font-set configured.

Uninstall / revert

Restore the most recent backups:

cd ~/.config/waybar
ls -t config.jsonc.bak.* | head -1 | xargs -I{} cp {} config.jsonc
ls -t style.css.bak.*    | head -1 | xargs -I{} cp {} style.css
omarchy-restart-waybar

Note: this restores the most recent backup, which is the snapshot taken just before the last install run. If you've made unrelated waybar tweaks after installing, this will overwrite them too. In that case, either pick an older .bak.<timestamp> that pre-dates your other changes, or revert the patch by hand: remove format-time, tooltip-format-full, tooltip-format-plugged and reset tooltip-format-discharging/charging to upstream in config.jsonc, and delete the /* >>> battery-tooltip */ ... /* <<< battery-tooltip */ block from style.css.

Design notes

See install-battery-tooltip.NOTES.md for the why-it-works-this-way: laptop detection layering, idempotency strategy, capacity-mode trade-off, the GTK-tooltip monospace-wrapper workaround, and known edge cases.

Tested on

Acer Nitro laptop with Realtek BAT1 (Li-ion, ~57Wh design, charge-based sysfs), fresh stock Omarchy configs and already-patched configs, plus simulated desktop / unknown-flag / missing-battery paths.

License

MIT.