Battery Power Monitor for GNOME Shell

Battery Power Monitor - A GNOME Shell extension showing battery percentage, time remaining, and real-time power consumption.

Status: Live on GNOME Extensions (ID: 9023).

Features

• Battery Percentage: Shows the current battery percentage.
• Time Remaining: Displays the estimated time remaining until the battery is fully charged or discharged.
• Power Consumption: Shows the current power consumption in Watts.
• Indicator: Shows a simple percentage indicator in the panel (configurable).
• Positioning: Choose to place the indicator on the Left or Right of the QuickSettings area.

Validation Status

Linting Status

Status: ✅ Passing
Last Updated: 2026-04-23 04:55:08 UTC
Summary: 0 errors, 0 warnings

Click to view full lint output

> batt-watt-power-monitor@22.0.0 lint:fix
> eslint --fix extension .scripts --format stylish || true; echo LINT_DONE

LINT_DONE

Latest Update (v22)

• Stock Icon Mode: Added a new preference to use the native GNOME battery icon instead of the custom bar or circular indicator.
• Charging Color Tuning: Colored mode now falls back to the theme foreground while charging, avoiding misleading low-battery red/orange states.
• Panel Sync: The stock icon path now respects the same panel visibility flow as the custom indicators.
• Version Art: Added a dedicated v22 SVG concept icon under assets/.
• Text Stroke Setting: Added a global "Text Stroke" preference that toggles a dark outline around percentage text and the charging bolt SVG across all indicator modes (bar, landscape, circular).
• DRY Stroke Helpers: Extracted duplicated stroke-rendering logic into reusable drawTextStroke() and drawBoltStroke() helpers in drawing.js, eliminating ~150 lines of inline duplicate code across indicator modules.
• Circular Font Size: Increased CIRCLE.FONT_SIZE_RATIO from 0.42 to 0.5 for better legibility at typical panel sizes (e.g., 37px diameter).
• Bolt Stroke Fix: Fixed bolt SVG stroke not respecting the textStroke toggle in circular mode (with text displayed), ensuring stroke is disabled consistently when the setting is off.
• Preferences Cleanup: Added close-request handler to destroy Gtk.ListBox and Adw.ToastOverlay objects when the preferences window closes, fixing EGO-L-006 warning.
• Charging Color Refactor: Removed the invalid implicit charging fallback and restored Gradient as the default color logic for both charging and discharging.
• Explicit Charging Overrides: Added Charging Icon Color and Charging Text Color modes with explicit Gradient, Theme Foreground, and Custom Color behavior.
• Defaults Update: Color Gradient Icon and Color Gradient Text now default to true.
• Preferences Polish: Cleaned up inconsistent preferences icons and replaced invalid symbolic icon names with working ones.

Configuration

General

Setting	Default	Description
Interval	10	Refresh rate in seconds.
Battery Bar Orientation	portrait	Use portrait or landscape for the battery bar.
Indicator Position	right	Place the indicator on the left, right, or default slot.
Show Icon	true	Toggle the panel icon.
Use Circular Indicator	false	Replace battery icon with a circular meter.
Use GNOME Stock Icon	false	Use the stock GNOME battery icon instead of custom indicators.
Color Gradient Icon	true	Enable the red-to-green gradient for the icon. Disable for themed monochrome.
Charging Icon Color	gradient	Charging override for the icon: gradient, theme, or custom.
Custom Charging Icon Color	#ffffff	Custom icon color used only when charging icon mode is custom.
Color Gradient Text	true	Enable the red-to-green gradient for text. Disable for themed monochrome.
Charging Text Color	gradient	Charging override for text: gradient, theme, or custom.
Custom Charging Text Color	#ffffff	Custom text color used only when charging text mode is custom.
Text Stroke	true	Draw a dark outline around text and the charging bolt.
Show Percentage	true	Show battery percentage text.
Percentage Outside	false	Show percentage text adjacent to the icon.
Time Remaining	true	Show time to full/empty.
Show Watts	true	Show power consumption in Watts.
Show Decimals	false	Show wattage with 2 decimal places.
Hide Charging	false	Hide indicator while charging.
Hide Full	false	Hide indicator when fully charged.
Hide Idle	false	Hide indicator when not charging/discharging.
Battery	0 (Auto)	Select battery device (0=Auto, 1=BAT0, etc).

Battery Bar / Circular

Setting	Default	Description
Battery Width	34	Width of the battery icon (Bar mode).
Battery Height	40	Height of the battery icon (Bar mode).
Circular Size	36	Diameter of the circular indicator (Circular mode).

Debug

Setting	Default	Description
Enable Debug	false	Enable build info and logs.
Force Bolt	false	Always show charging bolt.
Fake Charging	false	Force synthetic charging state.
Fake Discharging	false	Force synthetic discharging state.
Fake Charge Min	50	Lower bound for synthetic percentage.
Fake Charge Max	100	Upper bound for synthetic percentage.
Log Level	1	0=Verbose, 1=Debug, 2=Info, 3=Warn, 4=Error.
Log to File	true	Write debug logs to file.
Log File Path	''	Custom path (empty = default cache).

Install

• GNOME Extensions: https://extensions.gnome.org/extension/9023/batt-watt-power-monitor/

• Local build:

  ./build.sh

Project Docs

• Changelog
• Contributing
• Third-party notices
• License