Add plugin: Battery & Power Management by Piero-93 · Pull Request #864 · noctalia-dev/noctalia-plugins

Piero-93 · 2026-05-17T14:39:13Z

Description

This PR introduces the Battery & Power Mangement plugin for the Noctalia desktop shell. It provides real-time battery diagnostics and power optimization directly from the panel.

Features Included

Live Diagnostics: Displays current battery percentage, status, and precise power consumption or charge rate dynamically calculated in Watts (W).
Power Profile Selector: Native UI triggers via powerprofilesctl backend to alternate between power-saver, balanced, and performance profiles.
Hardware Charge Threshold Slider: A multi-step reactive custom QML slider targeting /sys/class/power_supply/BAT0/charge_control_end_threshold (clamped between 50% and 100%).
Documentation: Added a dedicated README.html detailing setup instructions, prerequisites, and mandatory udev configurations for unprivileged sysfs writes.

Testing Status

Verified QML reactivity and property bindings between BarWidget.qml and BatteryPopup.qml.
Confirmed sysfs read operations fallback safely during initial backend initialization cycles.
Tested on Niri

- Percentage & remaining time - Popup controls in a padded pill

spiros132

Some feedback about the PR! :)

spiros132 · 2026-05-21T21:47:32Z

+# ------------------------------
+set -e
+
+RULE_FILE="99-battery-threshold.rules"


Is this rules file supposed to be in this directory as well?

The file was missing. Now it's fixed, no need for the file, the script writes it itself.

spiros132 · 2026-05-21T21:49:29Z

+
+## Installation & Setup
+
+### 1\. Copy the Assets


This part isn't correct, the user needs only to go to their settings and install the plugin from there.

spiros132 · 2026-05-21T21:50:05Z

+Once permissions are initialized, trigger a reload or restart your Noctalia desktop interface instance to initialize the components:
+
+    killall quickshell
+    noctalia


This is not at all how you re-run noctalia.

Removed, setting the udev rule requires logout and login so it was redundant

spiros132 · 2026-05-21T21:50:58Z

+
+    readonly property string screenName: screen ? (screen.name ?? "") : ""
+    readonly property real capsuleHeight: (typeof Style !== "undefined" && typeof Style.getCapsuleHeightForScreen === "function") ? Style.getCapsuleHeightForScreen(root.screenName) : 26
+    readonly property real barFontSize: (typeof Style !== "undefined" && typeof Style.getBarFontSizeForScreen === "function") ? Style.getBarFontSizeForScreen(root.screenName) : 10


Style should never be undefined. You don't need to check if it is or not.

spiros132 · 2026-05-21T21:51:19Z

+    readonly property string screenName: screen ? (screen.name ?? "") : ""
+    readonly property real capsuleHeight: (typeof Style !== "undefined" && typeof Style.getCapsuleHeightForScreen === "function") ? Style.getCapsuleHeightForScreen(root.screenName) : 26
+    readonly property real barFontSize: (typeof Style !== "undefined" && typeof Style.getBarFontSizeForScreen === "function") ? Style.getBarFontSizeForScreen(root.screenName) : 10
+    readonly property string fixedFont: (typeof Settings !== "undefined" && Settings.data?.ui?.fontFixed) ? Settings.data.ui.fontFixed : "monospace"


Here neither, Style will always be defined if the imports are correct.

spiros132 · 2026-05-21T21:57:48Z

+            Layout.preferredHeight: 64 * Style.uiScaleRatio
+
+            color: (typeof Color !== "undefined") ? Color.mSurfaceVariant : "#313244"
+            radius: (typeof Style !== "undefined") ? (Style.capsuleRadius ?? Style.radiusM) : 6


Same thing as before here.

spiros132 · 2026-05-21T21:58:17Z

+                            if (root.mainWidget.batStatus === "Charging") {
+                                return "Time to full: " + root.mainWidget.timeRemaining;
+                            } else if (root.mainWidget.batStatus === "Discharging") {
+                                return "Remaining: " + root.mainWidget.timeRemaining;


Shouldn't these be included in the translation?

Yes, included translations. English and Italian

spiros132 · 2026-05-21T21:59:41Z

+                }
+
+                Item {
+                    id: customSlider


Is there a reason why this custom slider is needed? Why not use the noctalia slider?

The noctalia default slider was a bit too big. But I fixed the poupo width and used the default slider.

spiros132 · 2026-05-21T22:00:12Z

+            pointSize: Style.fontSizeS
+            color: parent.active 
+                ? ((typeof Color !== "undefined") ? Color.mOnPrimary : "#ffffff") 
+                : (parent.containsMouse ? ((typeof Color !== "undefined") ? Color.mPrimary : "#3355ff") : ((typeof Color !== "undefined") ? Color.mOnSurfaceVariant : "#a6adc8"))


As before, Color should never be undefined.

spiros132 · 2026-05-21T22:00:40Z

+    "System",
+    "Indicator",
+    "Utility",
+    "Battery"


There's no tag called Battery

"New tags can be added on a case-by-case basis. If your plugin doesn't fit the existing tags, feel free to propose a new one in your pull request."
I thought that this was the correct way to propose a new tag. I'll remove this by now.

No no you are correct, although I personally would have expected to see a I would like to propose to add the Battery tag in the PR description.

Maybe Battery would be a good fit as a tag since there are some plugins that have to do with battery. If you want add the tag back and I'll merge it in with the new tag.

Piero-93 · 2026-05-22T10:16:19Z

Thanks for the feedback. I'll work on them!

…ns) and setup_rules.sh (now it creates the udev rule file)

spiros132

Looks great, just some minor things :)

spiros132 · 2026-05-24T13:04:19Z

-        id: profileSetter
-        onExited: (code) => {
-            updatePowerProfile();
+            if (code !== 0) console.warn("Error writing battery threshold.");


Do not use console.warn, always use Logger

spiros132 · 2026-05-24T13:06:32Z

-                                return root.mainWidget.wattNum.toFixed(1) + " W";
-                            }
+                            if (root.mainWidget.batStatus === pluginApi?.tr("battery.status_charging")) return pluginApi?.tr("battery.time_to_full") + root.mainWidget.timeRemaining;
+                            else if (root.mainWidget.batStatus === pluginApi?.tr("battery.status_discharging")) return pluginApi?.tr("battery.remaining") + root.mainWidget.timeRemaining;


On these two, instead of using string concatenation, prefer to use translation interpolation.

Piero-93 added 6 commits May 15, 2026 22:05

V1: perc + watts + tooltip

50aa5f9

Better graphics, restored tooltip, first test on popup

1b94589

Removed duplicated files

1dfc4fa

Better popup appearance

640de8c

- Percentage & remaining time - Popup controls in a padded pill

Battery threshold & style fixes

f29f475

Renamed and ready for PR

eb48c0c

This comment was marked as resolved.

Sign in to view

Piero-93 force-pushed the feature/battery-wattage-bar-widget branch from 7fa2f19 to 9593250 Compare May 17, 2026 17:21

This comment was marked as resolved.

Sign in to view

Renamed in manifest

a5f28c9

Piero-93 force-pushed the feature/battery-wattage-bar-widget branch from 9593250 to a5f28c9 Compare May 17, 2026 17:23

Piero-93 added 2 commits May 19, 2026 20:20

100% now shows without be truncated

6deffe8

Fix, power-profile is read correcly

0c8fbcb

spiros132 reviewed May 21, 2026

View reviewed changes

spiros132 marked this pull request as draft May 21, 2026 22:01

Piero-93 added 5 commits May 22, 2026 12:53

Corrected README.md (removed wrong installation and reload instructio…

771c08c

…ns) and setup_rules.sh (now it creates the udev rule file)

Removed non exiting tag Battery

74ec04e

Removed null check for Color and Style

86a4528

Not checking pluginApi.openPanel

90be06b

Translations

59a388e

Piero-93 marked this pull request as ready for review May 22, 2026 13:06

Piero-93 marked this pull request as draft May 22, 2026 13:09

Using powerprofilesctl

1074835

Piero-93 marked this pull request as ready for review May 23, 2026 09:51

spiros132 reviewed May 24, 2026

View reviewed changes

spiros132 marked this pull request as draft May 24, 2026 13:28

Piero-93 added 2 commits May 29, 2026 10:25

Removed console.out, better string interpolation, some graphical fixes

d57fbd1

Time to full & to empty read corretcly

0df7418

Piero-93 marked this pull request as ready for review May 29, 2026 08:33

Conversation

Piero-93 commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Features Included

Testing Status

Uh oh!

This comment was marked as resolved.

This comment was marked as resolved.

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Piero-93 commented May 22, 2026

Uh oh!

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Piero-93 commented May 17, 2026 •

edited

Loading