From d3807dcdce20ad359436358e68525d464cdc1262 Mon Sep 17 00:00:00 2001
From: 4rmcyt <4rmcyt@gmail.com>
Date: Sat, 6 Jun 2026 15:44:40 -0600
Subject: [PATCH 1/3] feat(auto-cpufreq): add auto-cpufreq daemon monitor and
control plugin
---
auto-cpufreq/BarWidget.qml | 311 +++++++++++++++++++++++
auto-cpufreq/Panel.qml | 467 +++++++++++++++++++++++++++++++++++
auto-cpufreq/README.md | 49 ++++
auto-cpufreq/Settings.qml | 96 +++++++
auto-cpufreq/i18n/en.json | 54 ++++
auto-cpufreq/manifest.json | 32 +++
auto-cpufreq/preview.png | Bin 0 -> 813642 bytes
auto-cpufreq/setup_polkit.sh | 76 ++++++
8 files changed, 1085 insertions(+)
create mode 100644 auto-cpufreq/BarWidget.qml
create mode 100644 auto-cpufreq/Panel.qml
create mode 100644 auto-cpufreq/README.md
create mode 100644 auto-cpufreq/Settings.qml
create mode 100644 auto-cpufreq/i18n/en.json
create mode 100644 auto-cpufreq/manifest.json
create mode 100644 auto-cpufreq/preview.png
create mode 100644 auto-cpufreq/setup_polkit.sh
diff --git a/auto-cpufreq/BarWidget.qml b/auto-cpufreq/BarWidget.qml
new file mode 100644
index 000000000..8a8030274
--- /dev/null
+++ b/auto-cpufreq/BarWidget.qml
@@ -0,0 +1,311 @@
+import QtQuick
+import QtQuick.Layouts
+import Quickshell
+import Quickshell.Io
+import qs.Commons
+import qs.Widgets
+import qs.Services.UI
+import qs.Services.System
+
+Item {
+ id: root
+
+ property var pluginApi: null
+ property ShellScreen screen: null
+ property string widgetId: ""
+ property string section: ""
+ property int sectionWidgetIndex: -1
+ property int sectionWidgetsCount: 0
+
+ property var cfg: pluginApi?.pluginSettings || ({})
+ property var defaults: pluginApi?.manifest?.metadata?.defaultSettings || ({})
+
+ // ── Per-screen bar properties ─────────────────────────────────────────────
+ readonly property string screenName: screen?.name ?? ""
+ readonly property string barPosition: Settings.getBarPositionForScreen(screenName)
+ readonly property bool isBarVertical: barPosition === "left" || barPosition === "right"
+ readonly property real capsuleHeight: Style.getCapsuleHeightForScreen(screenName)
+ readonly property real barFontSize: Style.getBarFontSizeForScreen(screenName)
+ readonly property string fixedFont: Settings.data?.ui?.fontFixed ?? "monospace"
+ readonly property bool compact: cfg.compactMode ?? defaults.compactMode ?? false
+
+ // ── State ─────────────────────────────────────────────────────────────────
+ property string governor: "—"
+ property string turboState: "—"
+ property bool daemonRunning: false
+ property string forceOverride: "default"
+ property string turboOverride: "auto" // "never" | "always" | "auto"
+ property bool pkexecFailed: false
+
+ // Battery state (sysfs — more reliable than UPower on this system)
+ property int batCapacity: -1 // -1 = no battery
+ property string batStatus: "" // Charging / Discharging / Full
+ property real batWatts: 0.0
+ property string batDevice: "" // BAT0, BAT1, etc.
+
+ readonly property color govColor: {
+ if (governor === "performance") return Color.mTertiary
+ if (governor === "powersave") return Color.mPrimary
+ return Color.mOnSurface
+ }
+
+ // ── Widget dimensions ─────────────────────────────────────────────────────
+ readonly property real contentWidth: compact
+ ? capsuleHeight
+ : (content.implicitWidth + Style.marginM * 2)
+ readonly property real contentHeight: capsuleHeight
+
+ implicitWidth: contentWidth
+ implicitHeight: contentHeight
+
+ Component.onCompleted: {
+ if (pluginApi) pluginApi.mainInstance = root
+ }
+
+ // ── Sysfs: governor ───────────────────────────────────────────────────────
+ FileView {
+ id: governorFile
+ path: "/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor"
+ printErrors: false
+ onLoaded: root.governor = text().trim() || "—"
+ }
+
+ FileView {
+ id: noTurboFile
+ path: "/sys/devices/system/cpu/intel_pstate/no_turbo"
+ printErrors: false
+ onLoaded: {
+ let v = text().trim()
+ if (v !== "") root.turboState = (v === "0") ? "on" : "off"
+ }
+ }
+
+ FileView {
+ id: boostFile
+ path: "/sys/devices/system/cpu/cpufreq/boost"
+ printErrors: false
+ onLoaded: {
+ if (noTurboFile.text().trim() !== "") return
+ let v = text().trim()
+ if (v !== "") root.turboState = (v === "1") ? "on" : "off"
+ }
+ }
+
+ // ── Battery — sysfs ──────────────────────────────────────────────────────
+ Process {
+ id: batFinder
+ command: ["sh", "-c", "for d in /sys/class/power_supply/*/type; do [ \"$(cat $d 2>/dev/null)\" = 'Battery' ] && basename $(dirname $d) && exit 0; done"]
+ running: false
+ stdout: StdioCollector {
+ onStreamFinished: {
+ let dev = text.trim()
+ if (dev !== "") { root.batDevice = dev; batUevent.reload() }
+ }
+ }
+ }
+
+ FileView {
+ id: batUevent
+ path: root.batDevice !== "" ? "/sys/class/power_supply/" + root.batDevice + "/uevent" : "/dev/null"
+ printErrors: false
+ onLoaded: {
+ let cap = -1, status = "", currentUa = 0, voltageUv = 0
+ for (let line of text().split("\n")) {
+ if (line.startsWith("POWER_SUPPLY_CAPACITY=")) cap = parseInt(line.split("=")[1]) || -1
+ else if (line.startsWith("POWER_SUPPLY_STATUS=")) status = line.split("=")[1]?.trim() ?? ""
+ else if (line.startsWith("POWER_SUPPLY_CURRENT_NOW=")) currentUa = parseInt(line.split("=")[1]) || 0
+ else if (line.startsWith("POWER_SUPPLY_VOLTAGE_NOW=")) voltageUv = parseInt(line.split("=")[1]) || 0
+ }
+ root.batCapacity = cap
+ root.batStatus = status
+ root.batWatts = (voltageUv > 0 && currentUa > 0)
+ ? Math.round((voltageUv / 1e6) * (currentUa / 1e6) * 10) / 10
+ : 0.0
+ }
+ }
+
+ // ── Override state — read pickle files ───────────────────────────────────
+ // Pickle is binary but contains the string value — grep works fine
+ Process {
+ id: overrideReader
+ // Try common paths: NixOS uses /run/, classic installs use /opt/auto-cpufreq/
+ command: ["sh", "-c",
+ "for f in /run/override.pickle /opt/auto-cpufreq/override.pickle; do " +
+ " [ -f \"$f\" ] && strings \"$f\" | grep -oE '(powersave|performance)' | head -1 && exit 0; " +
+ "done; echo 'default'"]
+ running: false
+ stdout: StdioCollector {
+ onStreamFinished: {
+ let v = text.trim()
+ if (v === "powersave" || v === "performance") root.forceOverride = v
+ else root.forceOverride = "default"
+ }
+ }
+ }
+
+ Process {
+ id: turboOverrideReader
+ command: ["sh", "-c",
+ "for f in /run/turbo-override.pickle /opt/auto-cpufreq/turbo-override.pickle; do " +
+ " [ -f \"$f\" ] && strings \"$f\" | grep -oE '(never|always)' | head -1 && exit 0; " +
+ "done; echo 'auto'"]
+ running: false
+ stdout: StdioCollector {
+ onStreamFinished: {
+ let v = text.trim()
+ root.turboOverride = (v === "never" || v === "always") ? v : "auto"
+ }
+ }
+ }
+
+ // ── Daemon check ──────────────────────────────────────────────────────────
+ Process {
+ id: daemonChecker
+ command: ["systemctl", "is-active", "--quiet", "auto-cpufreq"]
+ running: false
+ onExited: (code) => { root.daemonRunning = (code === 0) }
+ }
+
+ // ── Actions ───────────────────────────────────────────────────────────────
+ Process {
+ id: forceProc
+ running: false
+ onExited: (code) => {
+ if (code === 0) { root.pkexecFailed = false; root.refreshAll() }
+ else if (code === 126 || code === 127) root.pkexecFailed = true
+ }
+ }
+
+ Process {
+ id: turboProc
+ running: false
+ onExited: (code) => {
+ if (code === 0) { root.pkexecFailed = false; root.refreshAll() }
+ else if (code === 126 || code === 127) root.pkexecFailed = true
+ }
+ }
+
+ function setForce(mode) {
+ forceProc.command = ["pkexec", "auto-cpufreq", "--force=" + mode]
+ forceProc.running = false
+ forceProc.running = true
+ // don't set locally — refreshAll() will read real state from pickle
+ }
+
+ function setTurbo(mode) {
+ turboProc.command = ["pkexec", "auto-cpufreq", "--turbo=" + mode]
+ turboProc.running = false
+ turboProc.running = true
+ }
+
+ function refreshAll() {
+ governorFile.reload()
+ noTurboFile.reload()
+ boostFile.reload()
+ daemonChecker.running = false
+ daemonChecker.running = true
+ overrideReader.running = false
+ overrideReader.running = true
+ turboOverrideReader.running = false
+ turboOverrideReader.running = true
+ if (root.batDevice === "") { batFinder.running = false; batFinder.running = true }
+ else batUevent.reload()
+ }
+
+ // ── Poll timer ────────────────────────────────────────────────────────────
+ Timer {
+ interval: root.cfg.refreshInterval ?? root.defaults.refreshInterval ?? 3000
+ running: true
+ repeat: true
+ triggeredOnStart: true
+ onTriggered: root.refreshAll()
+ }
+
+ // ── Visual capsule (correct noctalia pattern) ─────────────────────────────
+ Rectangle {
+ id: visualCapsule
+ x: Style.pixelAlignCenter(parent.width, width)
+ y: Style.pixelAlignCenter(parent.height, height)
+ width: root.contentWidth
+ height: root.contentHeight
+ radius: Style.radiusL
+ color: mouseArea.containsMouse ? Color.mHover : Style.capsuleColor
+ border.color: Style.capsuleBorderColor
+ border.width: Style.capsuleBorderWidth
+
+ RowLayout {
+ id: content
+ anchors.centerIn: parent
+ spacing: Style.marginS
+
+ NIcon {
+ icon: "cpu"
+ color: mouseArea.containsMouse ? Color.mOnHover : root.govColor
+ pointSize: Style.fontSizeM
+ applyUiScale: false
+ }
+
+ ColumnLayout {
+ visible: !root.compact
+ spacing: 1
+ Layout.rightMargin: Style.marginS
+
+ NText {
+ text: root.governor
+ pointSize: root.barFontSize
+ font.family: root.fixedFont
+ font.weight: Font.Bold
+ color: mouseArea.containsMouse ? Color.mOnHover : root.govColor
+ }
+
+ NText {
+ visible: root.turboState !== "—"
+ text: "turbo: " + root.turboState
+ pointSize: root.barFontSize * 0.85
+ color: mouseArea.containsMouse ? Color.mOnHover : Color.mOnSurfaceVariant
+ }
+ }
+ }
+ }
+
+ // ── Context menu ──────────────────────────────────────────────────────────
+ NPopupContextMenu {
+ id: contextMenu
+ model: [
+ { "label": pluginApi?.tr("menu.force-performance"), "action": "force-performance", "icon": "gauge", "enabled": root.daemonRunning },
+ { "label": pluginApi?.tr("menu.force-powersave"), "action": "force-powersave", "icon": "leaf", "enabled": root.daemonRunning },
+ { "label": pluginApi?.tr("menu.force-reset"), "action": "force-reset", "icon": "refresh", "enabled": root.forceOverride !== "default" },
+ { "label": pluginApi?.tr("menu.turbo-on"), "action": "turbo-on", "icon": "bolt", "enabled": root.daemonRunning },
+ { "label": pluginApi?.tr("menu.turbo-off"), "action": "turbo-off", "icon": "bolt", "enabled": root.daemonRunning },
+ { "label": pluginApi?.tr("menu.turbo-auto"), "action": "turbo-auto", "icon": "cpu", "enabled": root.daemonRunning },
+ { "label": pluginApi?.tr("actions.widget-settings"), "action": "widget-settings", "icon": "settings" }
+ ]
+ onTriggered: action => {
+ contextMenu.close()
+ PanelService.closeContextMenu(screen)
+ if (action === "widget-settings") BarService.openPluginSettings(screen, pluginApi.manifest)
+ else if (action === "force-performance") root.setForce("performance")
+ else if (action === "force-powersave") root.setForce("powersave")
+ else if (action === "force-reset") root.setForce("reset")
+ else if (action === "turbo-on") root.setTurbo("always")
+ else if (action === "turbo-off") root.setTurbo("never")
+ else if (action === "turbo-auto") root.setTurbo("auto")
+ }
+ }
+
+ MouseArea {
+ id: mouseArea
+ anchors.fill: parent
+ hoverEnabled: true
+ cursorShape: Qt.PointingHandCursor
+ acceptedButtons: Qt.LeftButton | Qt.RightButton
+ onClicked: (mouse) => {
+ if (mouse.button === Qt.LeftButton)
+ pluginApi?.togglePanel(root.screen, root)
+ else
+ PanelService.showContextMenu(contextMenu, root, screen)
+ }
+ onEntered: TooltipService.show(root, root.governor + " · turbo: " + root.turboState, BarService.getTooltipDirection())
+ onExited: TooltipService.hide()
+ }
+}
diff --git a/auto-cpufreq/Panel.qml b/auto-cpufreq/Panel.qml
new file mode 100644
index 000000000..d48d1518c
--- /dev/null
+++ b/auto-cpufreq/Panel.qml
@@ -0,0 +1,467 @@
+import QtQuick
+import QtQuick.Layouts
+import qs.Commons
+import qs.Services.UI
+import qs.Services.System
+import qs.Widgets
+// BatteryService import kept for potential future use
+
+Item {
+ id: root
+ property var pluginApi: null
+
+ readonly property var main: pluginApi?.mainInstance
+ readonly property var geometryPlaceholder: panelContainer
+ readonly property bool allowAttach: true
+
+ property real contentPreferredWidth: 360 * Style.uiScaleRatio
+ property real contentPreferredHeight: mainCol.implicitHeight + Style.marginL * 4
+
+ anchors.fill: parent
+
+ // Register with SystemStatService so it runs while panel is open
+ Component.onCompleted: SystemStatService.registerComponent("auto-cpufreq-panel")
+ Component.onDestruction: SystemStatService.unregisterComponent("auto-cpufreq-panel")
+
+ Rectangle {
+ id: panelContainer
+ anchors.fill: parent
+ color: "transparent"
+
+ ColumnLayout {
+ id: mainCol
+ anchors { fill: parent; margins: Style.marginL }
+ spacing: Style.marginM
+
+ // ── Header ────────────────────────────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: headerRow.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+
+ RowLayout {
+ id: headerRow
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginM
+
+ NIcon {
+ icon: "cpu"
+ pointSize: Style.fontSizeXL
+ color: root.main?.daemonRunning ? Color.mPrimary : Color.mError
+ }
+
+ ColumnLayout {
+ spacing: 2
+ Layout.fillWidth: true
+ NText {
+ text: "auto-cpufreq"
+ pointSize: Style.fontSizeM
+ font.weight: Font.Bold
+ color: Color.mOnSurface
+ }
+ NText {
+ text: root.main?.daemonRunning
+ ? pluginApi?.tr("panel.daemon-running")
+ : pluginApi?.tr("panel.daemon-stopped")
+ pointSize: Style.fontSizeXS
+ color: root.main?.daemonRunning ? Color.mOnSurfaceVariant : Color.mError
+ }
+ }
+
+ NIconButton {
+ icon: "refresh"
+ onClicked: root.main?.refreshAll()
+ }
+ }
+ }
+
+ // ── CPU stats (SystemStatService) ─────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: statsRow.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+
+ RowLayout {
+ id: statsRow
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginL
+
+ StatCell {
+ icon: "activity"
+ label: pluginApi?.tr("panel.cpu-usage")
+ value: Math.round(SystemStatService.cpuUsage) + "%"
+ valueColor: {
+ let u = SystemStatService.cpuUsage
+ if (u >= 90) return Color.mError
+ if (u >= 70) return Color.mTertiary
+ return Color.mOnSurface
+ }
+ }
+
+ StatCell {
+ icon: "cpu"
+ label: pluginApi?.tr("panel.cpu-freq")
+ value: SystemStatService.cpuFreq || "—"
+ }
+
+ StatCell {
+ icon: "thermometer"
+ label: pluginApi?.tr("panel.cpu-temp")
+ value: SystemStatService.cpuTemp > 0
+ ? Math.round(SystemStatService.cpuTemp) + "°C"
+ : "—"
+ valueColor: {
+ let t = SystemStatService.cpuTemp
+ if (t >= 90) return Color.mError
+ if (t >= 75) return Color.mTertiary
+ return Color.mOnSurface
+ }
+ }
+ }
+ }
+
+ // ── Battery (sysfs via BarWidget mainInstance) ────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: batRow.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+ visible: (root.main?.batCapacity ?? -1) >= 0
+
+ RowLayout {
+ id: batRow
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginM
+
+ NIcon {
+ icon: {
+ let s = root.main?.batStatus ?? ""
+ let c = root.main?.batCapacity ?? 0
+ if (s === "Charging") return "battery-charging"
+ if (c >= 80) return "battery-4"
+ if (c >= 60) return "battery-3"
+ if (c >= 40) return "battery-2"
+ if (c >= 20) return "battery-1"
+ return "battery"
+ }
+ color: {
+ let s = root.main?.batStatus ?? ""
+ let c = root.main?.batCapacity ?? 100
+ if (s === "Charging") return Color.mTertiary
+ if (c <= 20) return Color.mError
+ return Color.mOnSurface
+ }
+ pointSize: Style.fontSizeXL
+ }
+
+ ColumnLayout {
+ spacing: 2
+ Layout.fillWidth: true
+
+ NText {
+ text: (root.main?.batCapacity ?? 0) + "% · " + (root.main?.batStatus ?? "—")
+ pointSize: Style.fontSizeM
+ font.weight: Font.Bold
+ color: Color.mOnSurface
+ }
+
+ NText {
+ visible: (root.main?.batWatts ?? 0) > 0
+ text: {
+ let s = root.main?.batStatus ?? ""
+ let w = root.main?.batWatts ?? 0
+ return (s === "Charging" ? "+" : "−") + w.toFixed(1) + " W"
+ }
+ pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant
+ }
+ }
+ }
+ }
+
+ // ── Governor & turbo ──────────────────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: govCol.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+
+ ColumnLayout {
+ id: govCol
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginS
+
+ NText {
+ text: pluginApi?.tr("panel.section-governor")
+ pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant
+ font.weight: Font.Medium
+ }
+
+ RowLayout {
+ Layout.fillWidth: true
+ spacing: Style.marginM
+
+ NIcon {
+ icon: {
+ let g = root.main?.governor ?? ""
+ if (g === "performance") return "gauge"
+ if (g === "powersave") return "leaf"
+ return "cpu"
+ }
+ color: {
+ let g = root.main?.governor ?? ""
+ if (g === "performance") return Color.mTertiary
+ if (g === "powersave") return Color.mPrimary
+ return Color.mOnSurface
+ }
+ }
+
+ NText {
+ text: root.main?.governor ?? "—"
+ pointSize: Style.fontSizeM
+ font.weight: Font.Bold
+ font.family: Settings.data?.ui?.fontFixed ?? "monospace"
+ color: Color.mOnSurface
+ Layout.fillWidth: true
+ }
+
+ NText {
+ visible: (root.main?.forceOverride ?? "default") !== "default"
+ text: pluginApi?.tr("panel.forced")
+ pointSize: Style.fontSizeXS
+ color: Color.mTertiary
+ }
+ }
+
+ RowLayout {
+ Layout.fillWidth: true
+ spacing: Style.marginM
+
+ NIcon {
+ icon: "bolt"
+ color: (root.main?.turboState ?? "") === "on"
+ ? Color.mTertiary : Color.mOnSurfaceVariant
+ }
+
+ NText {
+ text: pluginApi?.tr("panel.turbo") + ": " + (root.main?.turboState ?? "—")
+ pointSize: Style.fontSizeS
+ color: Color.mOnSurface
+ Layout.fillWidth: true
+ }
+ }
+ }
+ }
+
+ // ── pkexec error banner ───────────────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: errorRow.implicitHeight + Style.marginM * 2
+ color: Qt.rgba(Color.mError.r, Color.mError.g, Color.mError.b, 0.15)
+ radius: Style.radiusM
+ visible: root.main?.pkexecFailed ?? false
+
+ RowLayout {
+ id: errorRow
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginM
+ NIcon { icon: "alert-triangle"; color: Color.mError; pointSize: Style.fontSizeM }
+ NText {
+ text: pluginApi?.tr("panel.pkexec-error")
+ pointSize: Style.fontSizeXS
+ color: Color.mError
+ Layout.fillWidth: true
+ wrapMode: Text.WordWrap
+ }
+ }
+ }
+
+ // ── Force override ────────────────────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: forceCol.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+ opacity: (root.main?.daemonRunning ?? false) ? 1.0 : 0.4
+
+ ColumnLayout {
+ id: forceCol
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginS
+
+ NText {
+ text: pluginApi?.tr("panel.section-force")
+ pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant
+ font.weight: Font.Medium
+ }
+
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: 44 * Style.uiScaleRatio
+ color: Color.mSurface
+ radius: Style.radiusS
+ border.color: Color.mOutline
+ border.width: 1
+ clip: true
+
+ Row {
+ anchors.fill: parent
+
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "leaf"; label: pluginApi?.tr("panel.powersave")
+ active: (root.main?.forceOverride ?? "") === "powersave"
+ enabled: root.main?.daemonRunning ?? false
+ showDivider: true
+ onClicked: root.main?.setForce("powersave")
+ }
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "scale"; label: pluginApi?.tr("panel.auto")
+ active: (root.main?.forceOverride ?? "default") === "default"
+ enabled: root.main?.daemonRunning ?? false
+ showDivider: true
+ onClicked: root.main?.setForce("reset")
+ }
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "gauge"; label: pluginApi?.tr("panel.performance")
+ active: (root.main?.forceOverride ?? "") === "performance"
+ enabled: root.main?.daemonRunning ?? false
+ showDivider: false
+ onClicked: root.main?.setForce("performance")
+ }
+ }
+ }
+ }
+ }
+
+ // ── Turbo boost ───────────────────────────────────────────────────
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: turboCol.implicitHeight + Style.marginM * 2
+ color: Color.mSurfaceVariant
+ radius: Style.radiusM
+ property bool turboAvailable: (root.main?.turboState ?? "n/a") !== "n/a"
+ opacity: ((root.main?.daemonRunning ?? false) && turboAvailable) ? 1.0 : 0.4
+
+ ColumnLayout {
+ id: turboCol
+ anchors { fill: parent; margins: Style.marginM }
+ spacing: Style.marginS
+
+ NText {
+ text: pluginApi?.tr("panel.section-turbo")
+ pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant
+ font.weight: Font.Medium
+ }
+
+ Rectangle {
+ Layout.fillWidth: true
+ implicitHeight: 44 * Style.uiScaleRatio
+ color: Color.mSurface
+ radius: Style.radiusS
+ border.color: Color.mOutline
+ border.width: 1
+ clip: true
+
+ Row {
+ anchors.fill: parent
+ property bool avail: (root.main?.daemonRunning ?? false) && (root.main?.turboState ?? "n/a") !== "n/a"
+
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "bolt-off"; label: pluginApi?.tr("panel.turbo-never")
+ active: (root.main?.turboOverride ?? "") === "never"
+ enabled: parent.avail; showDivider: true
+ onClicked: root.main?.setTurbo("never")
+ }
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "cpu"; label: pluginApi?.tr("panel.turbo-auto")
+ active: (root.main?.turboOverride ?? "auto") === "auto"
+ enabled: parent.avail; showDivider: true
+ onClicked: root.main?.setTurbo("auto")
+ }
+ SegItem {
+ width: parent.width / 3; height: parent.height
+ icon: "bolt"; label: pluginApi?.tr("panel.turbo-always")
+ active: (root.main?.turboOverride ?? "") === "always"
+ enabled: parent.avail; showDivider: false
+ onClicked: root.main?.setTurbo("always")
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+
+ component StatCell: ColumnLayout {
+ id: statCell
+ property string icon: ""
+ property string label: ""
+ property string value: "—"
+ property color valueColor: Color.mOnSurface
+ spacing: 2
+ Layout.fillWidth: true
+ NIcon {
+ icon: statCell.icon; pointSize: Style.fontSizeM
+ color: Color.mOnSurfaceVariant; Layout.alignment: Qt.AlignHCenter
+ }
+ NText {
+ text: statCell.value; pointSize: Style.fontSizeM; font.weight: Font.Bold
+ color: statCell.valueColor; Layout.alignment: Qt.AlignHCenter
+ }
+ NText {
+ text: statCell.label; pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant; Layout.alignment: Qt.AlignHCenter
+ }
+ }
+
+ component SegItem: Item {
+ id: segItem
+ property string icon: ""
+ property string label: ""
+ property bool active: false
+ property bool enabled: true
+ property bool showDivider: false
+ signal clicked()
+
+ Rectangle {
+ anchors { fill: parent; margins: 3 }
+ radius: Style.radiusS
+ color: segItem.active ? Color.mPrimary : "transparent"
+ }
+ Rectangle {
+ anchors.right: parent.right; anchors.verticalCenter: parent.verticalCenter
+ width: 1; height: parent.height * 0.5
+ color: Color.mOutline; opacity: 0.5
+ visible: segItem.showDivider
+ }
+ ColumnLayout {
+ anchors.centerIn: parent
+ spacing: 1
+ NIcon {
+ icon: segItem.icon; pointSize: Style.fontSizeS
+ color: segItem.active ? Color.mOnPrimary : Color.mOnSurfaceVariant
+ Layout.alignment: Qt.AlignHCenter
+ }
+ NText {
+ text: segItem.label; pointSize: Style.fontSizeXS
+ color: segItem.active ? Color.mOnPrimary : Color.mOnSurfaceVariant
+ Layout.alignment: Qt.AlignHCenter
+ }
+ }
+ MouseArea {
+ anchors.fill: parent; enabled: segItem.enabled
+ cursorShape: Qt.PointingHandCursor
+ onClicked: segItem.clicked()
+ }
+ }
+}
diff --git a/auto-cpufreq/README.md b/auto-cpufreq/README.md
new file mode 100644
index 000000000..61464320b
--- /dev/null
+++ b/auto-cpufreq/README.md
@@ -0,0 +1,49 @@
+# auto-cpufreq
+
+Monitor and control the [auto-cpufreq](https://github.com/AdnanHodzic/auto-cpufreq) daemon from your Noctalia bar.
+
+## Features
+
+- **Bar widget** — active CPU governor and turbo state, color-coded by profile
+- **Panel** — CPU usage, frequency, temperature, battery status, governor info, force override and turbo boost controls
+- **Right-click menu** — quick force/turbo override without opening the panel
+- Works with Intel (`intel_pstate`) and AMD (`k10temp`, `amd_pstate`) CPUs
+- Reads override state directly from auto-cpufreq pickle files — always in sync with the daemon
+
+## Requirements
+
+- [auto-cpufreq](https://github.com/AdnanHodzic/auto-cpufreq) installed with daemon running
+- polkit setup for force override / turbo boost controls (see below)
+
+## Polkit Setup
+
+Force override and turbo boost buttons use `pkexec`. Run the setup script once:
+
+```bash
+cd ~/.config/noctalia/plugins/auto-cpufreq/
+chmod +x setup_polkit.sh
+sudo ./setup_polkit.sh
+```
+
+### NixOS
+
+```nix
+environment.etc."polkit-1/actions/org.auto-cpufreq.pkexec.policy".text = ''
+
+
+
+
+ Run auto-cpufreq
+ Authentication is required to run auto-cpufreq
+
+ auth_admin
+ auth_admin
+ auth_admin_keep
+
+ ${pkgs.auto-cpufreq}/bin/auto-cpufreq
+
+
+'';
+```
diff --git a/auto-cpufreq/Settings.qml b/auto-cpufreq/Settings.qml
new file mode 100644
index 000000000..491f4262e
--- /dev/null
+++ b/auto-cpufreq/Settings.qml
@@ -0,0 +1,96 @@
+import QtQuick
+import QtQuick.Layouts
+import qs.Commons
+import qs.Widgets
+
+ColumnLayout {
+ id: root
+ property var pluginApi: null
+
+ property var cfg: pluginApi?.pluginSettings || ({})
+ property var defaults: pluginApi?.manifest?.metadata?.defaultSettings || ({})
+
+ // Edit copies
+ property int editRefreshInterval: cfg.refreshInterval ?? defaults.refreshInterval ?? 3000
+ property bool editShowGovernor: cfg.showGovernor ?? defaults.showGovernor ?? true
+ property bool editShowTurbo: cfg.showTurbo ?? defaults.showTurbo ?? true
+ property bool editCompactMode: cfg.compactMode ?? defaults.compactMode ?? false
+
+ spacing: Style.marginL
+
+ NToggle {
+ Layout.fillWidth: true
+ label: pluginApi?.tr("settings.compact.label")
+ description: pluginApi?.tr("settings.compact.desc")
+ checked: root.editCompactMode
+ onToggled: root.editCompactMode = checked
+ }
+
+ NToggle {
+ Layout.fillWidth: true
+ label: pluginApi?.tr("settings.show-governor.label")
+ description: pluginApi?.tr("settings.show-governor.desc")
+ checked: root.editShowGovernor
+ onToggled: root.editShowGovernor = checked
+ }
+
+ NToggle {
+ Layout.fillWidth: true
+ label: pluginApi?.tr("settings.show-turbo.label")
+ description: pluginApi?.tr("settings.show-turbo.desc")
+ checked: root.editShowTurbo
+ onToggled: root.editShowTurbo = checked
+ }
+
+ ColumnLayout {
+ Layout.fillWidth: true
+ spacing: Style.marginS
+
+ NText {
+ text: pluginApi?.tr("settings.refresh.label")
+ pointSize: Style.fontSizeS
+ font.weight: Font.Medium
+ color: Color.mOnSurface
+ }
+
+ NText {
+ text: pluginApi?.tr("settings.refresh.desc")
+ pointSize: Style.fontSizeXS
+ color: Color.mOnSurfaceVariant
+ Layout.fillWidth: true
+ wrapMode: Text.WordWrap
+ }
+
+ RowLayout {
+ Layout.fillWidth: true
+ spacing: Style.marginM
+
+ NSlider {
+ Layout.fillWidth: true
+ from: 1000
+ to: 10000
+ stepSize: 500
+ value: root.editRefreshInterval
+ onMoved: root.editRefreshInterval = value
+ }
+
+ NText {
+ text: (root.editRefreshInterval / 1000).toFixed(1) + "s"
+ pointSize: Style.fontSizeS
+ font.family: Settings.data?.ui?.fontFixed ?? "monospace"
+ color: Color.mOnSurface
+ Layout.preferredWidth: 36 * Style.uiScaleRatio
+ horizontalAlignment: Text.AlignRight
+ }
+ }
+ }
+
+ function saveSettings() {
+ if (!pluginApi) return
+ pluginApi.pluginSettings.refreshInterval = root.editRefreshInterval
+ pluginApi.pluginSettings.showGovernor = root.editShowGovernor
+ pluginApi.pluginSettings.showTurbo = root.editShowTurbo
+ pluginApi.pluginSettings.compactMode = root.editCompactMode
+ pluginApi.saveSettings()
+ }
+}
diff --git a/auto-cpufreq/i18n/en.json b/auto-cpufreq/i18n/en.json
new file mode 100644
index 000000000..649278831
--- /dev/null
+++ b/auto-cpufreq/i18n/en.json
@@ -0,0 +1,54 @@
+{
+ "panel": {
+ "title": "auto-cpufreq",
+ "daemon-running": "daemon running",
+ "daemon-stopped": "daemon not running",
+ "cpu-usage": "usage",
+ "cpu-freq": "frequency",
+ "cpu-temp": "temp",
+ "section-governor": "GOVERNOR",
+ "section-force": "FORCE OVERRIDE",
+ "section-turbo": "TURBO BOOST",
+ "forced": "forced",
+ "turbo": "turbo",
+ "pkexec-error": "pkexec not authorized. See README for polkit setup.",
+ "bat-charging": "Charging",
+ "bat-discharging": "Discharging",
+ "bat-plugged": "Plugged in",
+ "powersave": "powersave",
+ "auto": "auto",
+ "performance": "performance",
+ "turbo-never": "never",
+ "turbo-auto": "auto",
+ "turbo-always": "always"
+ },
+ "menu": {
+ "force-performance": "Force performance",
+ "force-powersave": "Force powersave",
+ "force-reset": "Reset override",
+ "turbo-on": "Turbo: always on",
+ "turbo-off": "Turbo: always off",
+ "turbo-auto": "Turbo: auto"
+ },
+ "actions": {
+ "widget-settings": "Widget settings"
+ },
+ "settings": {
+ "compact": {
+ "label": "Compact mode",
+ "desc": "Show only the CPU icon, hide governor and turbo text"
+ },
+ "show-governor": {
+ "label": "Show governor",
+ "desc": "Display the active CPU frequency scaling governor"
+ },
+ "show-turbo": {
+ "label": "Show turbo state",
+ "desc": "Display whether turbo boost is on or off"
+ },
+ "refresh": {
+ "label": "Refresh interval",
+ "desc": "How often to poll sysfs for governor, turbo, and CPU stats"
+ }
+ }
+}
diff --git a/auto-cpufreq/manifest.json b/auto-cpufreq/manifest.json
new file mode 100644
index 000000000..1d427ee38
--- /dev/null
+++ b/auto-cpufreq/manifest.json
@@ -0,0 +1,32 @@
+{
+ "id": "auto-cpufreq",
+ "name": "auto-cpufreq",
+ "version": "2.5.0",
+ "minNoctaliaVersion": "4.4.1",
+ "author": "4rmcyt",
+ "license": "MIT",
+ "repository": "",
+ "description": "Monitor and control auto-cpufreq daemon: governor, turbo boost, CPU stats, and force-override.",
+ "tags": [
+ "Bar",
+ "Panel",
+ "System",
+ "Utility"
+ ],
+ "entryPoints": {
+ "barWidget": "BarWidget.qml",
+ "panel": "Panel.qml",
+ "settings": "Settings.qml"
+ },
+ "dependencies": {
+ "plugins": []
+ },
+ "metadata": {
+ "defaultSettings": {
+ "refreshInterval": 3000,
+ "showGovernor": true,
+ "showTurbo": true,
+ "compactMode": false
+ }
+ }
+}
diff --git a/auto-cpufreq/preview.png b/auto-cpufreq/preview.png
new file mode 100644
index 0000000000000000000000000000000000000000..c7ec6d301473cd150f1e95986ea1ce2ae6698d92
GIT binary patch
literal 813642
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