Releases: StevenACZ/MacGauge
Release list
🌀 MacGauge v1.5.1 — Native Identity
Added
- A dedicated MacGauge app icon now appears in Finder, Applications, the DMG,
and system surfaces that represent the app bundle.
Fixed
- Sparkle update archives now include the app's stapled notarization ticket,
preserving offline Gatekeeper verification for in-app updates.
Install
- Download
MacGauge-v1.5.1.dmg. - Optionally verify it with
shasum -a 256 -c MacGauge-v1.5.1.dmg.sha256. - Open the DMG and drag MacGauge to Applications.
- Authorize the narrow fan-control helper from Settings > Safety only if you
want to use Manual or Curve mode.
Requires an Apple Silicon Mac (M1 or later) running macOS 13 Ventura or later.
Existing MacFan installations update in place because internal identifiers are
intentionally preserved.
Verification
- Apple notarization: Accepted
- App and DMG: stapled
- Gatekeeper: accepted
- SHA-256:
2395896d6d42f0eb7732f824937443487f8f35f56d00e323cba3dabecbeecc98 - Full changelog
Fan control can interfere with macOS thermal management. Monitor
temperatures during manual tests and return to automatic control when you
are done.
MacGauge v1.5.0 — One-Click In-App Updates
What's New
- One-click in-app updates. MacGauge now keeps itself up to date: it checks GitHub Releases once a day and, when a new version is out, a quiet row appears in the menu bar popover — one click downloads, installs, and relaunches the app. A manual "Check Now" and an on/off toggle live in Settings → General.
- Updates are EdDSA-signed and verified against the public key embedded in the app, on top of Apple's notarization. Nothing is ever sent to any server.
This is the last version you need to download by hand — from v1.5.0 on, updates are one click away.
Install
Download MacGauge-v1.5.0.dmg, open it, and drag MacGauge to Applications.
SHA-256
47445fc7d4c93f1b70c5357b1d1c8831a767cba502e38216c91bf87f5b76be9d MacGauge-v1.5.0.dmg
(MacGauge-v1.5.0.zip and appcast.xml are the Sparkle update-channel assets — the app consumes them automatically.)
🌀 MacGauge v1.4.0 — Crash-Safe Fan Control
The helper now protects you even when the app can't: a dead-man watchdog returns your fans to macOS control if the app ever crashes while driving them.
Added
- Crash-safe fan control: if the app stops responding (a crash, a force quit) while fans are under manual or curve control, the privileged helper now hands control back to macOS after three minutes of silence — fans no longer stay pinned at the last target until the next launch.
- Quitting normally with "restore automatic on quit" disabled keeps manual control exactly as before: the app explicitly releases the watchdog on a clean exit.
- Time asleep never counts toward the silence window, so the watchdog cannot misfire when the Mac wakes up.
- Helper protocol v5 — the app upgrades an older running helper automatically; no reauthorization needed.
Install
- Download
MacGauge-v1.4.0.dmgbelow. - Optional: verify the checksum —
shasum -a 256 -c MacGauge-v1.4.0.dmg.sha256. - Drag MacGauge to Applications and launch it.
- Authorize the fan-control helper in Settings > Safety (one-time approval in System Settings > Login Items).
Requires an Apple Silicon Mac (M1 or newer) running macOS 13+.
Upgrading from MacFan? MacGauge is the same app renamed — your helper authorization and settings carry over.
Verification
- Notarized by Apple, stapled, and Gatekeeper-accepted.
- SHA-256:
ea61a3b8b9f5bc247905e868cd6de50113f319b7d9cea281e74e5fb4258b4755
Full details: CHANGELOG
⚠️ MacGauge changes how your Mac manages its own cooling. Lower fan speeds mean higher temperatures. Use conservative settings unless you monitor temperatures actively.
🌀 MacGauge v1.3.0 — Deep Hardening & Reliability
A deep hardening pass over the whole app: a full audit of the fan engine, the privileged helper, the CLI, the menu bar pipeline, and the view layer — with every real-world finding fixed.
Fixed
- Restore automatic on quit now actually runs: quitting used to leave fans pinned at the last manual or curve target; termination now waits for the helper to hand control back to macOS.
- Fan control no longer misses the moment the helper becomes ready (saved curve mode could stay inactive until the temperature drifted).
- Menu bar appearance changes (temperature unit, band colors, styles) apply immediately.
- The helper's health check can no longer restart it mid-write, automatic restore is best-effort per fan (one stuck fan no longer blocks the others), and failed target writes roll back instead of pinning the fan manual.
- Fan writes report "contested" from the target readback, so a large legitimate speed change no longer flashes a false conflict.
- Network rates survive 4 GiB counter wraps (64-bit interface counters), the public IP refreshes after switching networks or VPN, and IPv6-only networks now populate.
- Non-finite curve points are rejected, RPM encoding clamps instead of crashing with dangerous ranges unlocked, and fanless Macs read cleanly again.
- Top-process sampling runs off the main thread; the fan spin pauses while the display sleeps.
- CLI: unknown flags error out, Ctrl-C interrupts long curve intervals promptly, and failed restores are reported honestly.
Changed
- Settings controls now use the app accent consistently (no more mixed accents on Macs with a custom system accent).
- macOS Reduce Motion is honored across the menu bar, popovers, and settings.
- The manual slider is keyboard-operable, color swatches expose their selected state, and symbol-only buttons carry accessibility labels.
- The privileged helper no longer writes logs to predictable /tmp paths and rejects oversized or stale queued commands.
- Internal restructure with more than 40 new unit tests (110 total).
Install
- Download
MacGauge-v1.3.0.dmgbelow. - Optional: verify the checksum —
shasum -a 256 -c MacGauge-v1.3.0.dmg.sha256. - Drag MacGauge to Applications and launch it.
- Authorize the fan-control helper in Settings > Safety (one-time approval in System Settings > Login Items).
Requires an Apple Silicon Mac (M1 or newer) running macOS 13+.
Upgrading from MacFan? MacGauge is the same app renamed — your helper authorization and settings carry over.
Verification
- Notarized by Apple, stapled, and Gatekeeper-accepted.
- SHA-256:
e02f54374482264f89d4e6a681c55808a9d2859754c34ca6fda82eccd28cb340
Full details: CHANGELOG
⚠️ MacGauge changes how your Mac manages its own cooling. Lower fan speeds mean higher temperatures. Use conservative settings unless you monitor temperatures actively.
🌀 MacGauge v1.2.0 — Performance Modes & Custom Module Styles
MacFan is now MacGauge. Brand only: the bundle ID, helper label, and settings keys are unchanged, so replacing MacFan.app with MacGauge.app keeps your helper authorization and settings.
Added
- Performance modes (Settings > General): Efficient (default) steps values and charts once per tick and keeps the fan icon still — MacGauge idles at a few percent of one core all day. Full plays every continuous animation, for Macs with power to spare.
- Menu bar module spacing (Together / Tight / Normal / Wide): trim the dead space around each module, or fuse them all into a single block — clicks stay per-module.
- Per-module styles: graph length for CPU/RAM, and color styles — Multicolor, Mono, Gray, or By load with your own 0-100% thresholds and a color per band; the network arrows get custom up/down colors. Detail popovers follow the exact same colors.
- Show more / Show less in the CPU and RAM popovers: the top-processes list expands from 5 to 15 rows.
- Simulated previews in Settings > Display: usage sweeps and network rates climb on their own, so your colors and thresholds visibly react while you adjust them — no need to load the Mac.
Changed
- The CPU and RAM popovers rank every process — compilers, helpers, and daemons included, like Activity Monitor — so a heavy build no longer hides the real culprits.
- Settings redesigned: performance mode as two selectable cards, a visual Display screen with a section sidebar (fan & temperature together; modules; CPU; RAM; network), each card ordered for live color testing.
- The CPU/RAM By-load bands read Low / Medium / High — "hot" stays exclusive to temperature.
Fixed
- Idle CPU usage: continuous menu bar animations and always-alive popover content kept the app at most of one core; popover content is now lazy and Efficient mode keeps the pipeline dry (~4% idle, 25 MB).
- The CPU popover could stay on "Measuring…" forever when switching between the CPU and RAM popovers.
- The settings window could drift from its designed size (macOS edge tiling, toolbar reshapes) and its cards could lose their margins; the window now pins its size and every tab keeps the designed width.
Install
- Download
MacGauge-v1.2.0.dmg(notarized and stapled). - Verify integrity (optional):
shasum -a 256 -c MacGauge-v1.2.0.dmg.sha256 - Drag MacGauge to Applications, then authorize the helper from Settings > Safety.
Requirements: Apple Silicon Mac (M1+), macOS 13 Ventura or later.
Verification
- DMG notarized and stapled; Gatekeeper assessment: accepted.
- SHA-256:
1c846af765048d96a0b4ac49a04c091515459a60e6b5f505fe489d3f985eb662
Full changelog: CHANGELOG.md
Warning: fan control can interfere with macOS thermal management. Use at your own risk and return to automatic control when unsure.
🌀 MacGauge v1.1.0 — Live system stats, RPM-aware curves, new settings
MacFan is now MacGauge. Brand only: the bundle ID, helper label, and settings keys are unchanged, so replacing MacFan.app with MacGauge.app keeps your helper authorization and settings. It covers live system stats now, not just fans.
Added
- Optional menu bar modules (Settings > Display) for CPU, memory, and network — each a compact live chart in the menu bar with a detail popover: usage history, chip and core layout (P+E), top apps by CPU/memory, memory pressure straight from the kernel, interface/local/public IP, and session traffic totals. Off by default; universal across Apple Silicon.
- RPM-aware curve editor: the drag bubble and point editor show the estimated RPM for each percent, a right-hand RPM axis maps the percent scale to your fan's real range, and the live marker carries the fan's actual measured RPM.
- Interactive temperature-colors editor with draggable 30-90 °C threshold handles and a live menu bar preview that mirrors the real icon, color band, and spin speed.
- Guided helper flow in Settings > Safety: status card, authorize → approve → ready steps, and plain-language explanations of the privileged helper and extreme ranges.
Changed
- The fan icon spins continuously, accelerating and coasting down with the fan's real speed.
- Menu bar modules keep a constant width — no more shifting as values change digits.
- Always-on performance pass: redundant menu bar updates are skipped, the settings window releases its UI on close, and caches are bounded.
Fixed
- The menu bar fan icon no longer wobbles while spinning. The glyph is rasterized once and rotated as a fixed bitmap around its true center, eliminating both the ~1px orbit and the intermittent 1-2px jumps caused by per-angle re-rasterization.
- Memory pressure now reads the kernel's actual level, matching Activity Monitor.
- Curve charts extend flat to both edges and no longer look cut off with few points.
Install
- Download
MacGauge-v1.1.0.dmg(notarized and stapled). - Verify integrity (optional):
shasum -a 256 -c MacGauge-v1.1.0.dmg.sha256 - Drag MacGauge to Applications, then authorize the helper from Settings > Safety.
Requirements: Apple Silicon Mac (M1+), macOS 13 Ventura or later.
Verification
- DMG notarized and stapled; Gatekeeper assessment: accepted.
- SHA-256:
5362332ebb64bb5f96a76a12ef8027ef92a6714d34e864ac4438e673da5e2b8c
Full changelog: CHANGELOG.md
Warning: fan control can interfere with macOS thermal management. Use at your own risk and return to automatic control when unsure.
🌀 MacFan v1.0.1 — Launch fix for all Macs
Fixed
- v1.0.0 crashed instantly at launch on most Macs (the app never appeared in the menu bar). The localized-resources lookup only worked on the machine the release was built on; v1.0.1 resolves resources from inside the installed app, so it launches correctly on any Apple Silicon Mac (M1, M2, M3, M4, …).
If v1.0.0 never opened for you, this release is the fix — just replace the app.
Install
- Download
MacFan-v1.0.1.dmg(notarized and stapled). - Verify integrity (optional):
shasum -a 256 -c MacFan-v1.0.1.dmg.sha256 - Drag MacFan to Applications, then authorize the helper from Settings > Safety.
Requirements: Apple Silicon Mac (M1+), macOS 13 Ventura or later.
Verification
- DMG notarized and stapled; Gatekeeper assessment: accepted.
- SHA-256:
f9105b0104091a1720772124482376457ccc5a064d8727d2c1973dfaa3c9852c
Full changelog: CHANGELOG.md
Warning: fan control can interfere with macOS thermal management. Use at your own risk and return to automatic control when unsure.
🌀 MacFan v1.0.0 — Universal Apple Silicon Fan Control
Highlights
- Works on any Apple Silicon Mac (M1 and later) — desktops and laptops. Every fan is discovered dynamically and controlled together, each converted to its own RPM range; fanless Macs (MacBook Air) are detected as passively cooled.
- Menu bar app with live temperature and per-fan RPM, a temperature-tinted status icon, and smooth animations throughout.
- Manual mode: percentage slider applied to all fans, with verified writes — the helper reads back fan mode and actual RPM and re-asserts the target when macOS overrides it.
- Curve mode with an interactive editor: drag points on the chart, double-click to add, right-click to delete, plus compact chips for precise values.
- Fully bilingual (English/Spanish): follows the macOS language, switchable instantly in Settings > General.
- Safe by design: read-only until you authorize a narrow privileged helper (one-time macOS approval); no Accessibility permission, no analytics, no network access.
- Also includes a
macfanCLI with dry-run-by-default writes.
Formerly known as M4FanControl — v1.0.0 renames the project and makes it universal.
Install
- Download
MacFan-v1.0.0.dmg(notarized and stapled). - Verify integrity (optional):
shasum -a 256 -c MacFan-v1.0.0.dmg.sha256 - Drag MacFan to Applications, then authorize the helper from Settings > Safety.
Requirements: Apple Silicon Mac (M1+), macOS 13 Ventura or later.
Verification
- DMG notarized and stapled; Gatekeeper assessment: accepted.
- SHA-256:
4e2a88aecf9b97fa2e26043ea3f1a9267322eb524a984e36e92a22870b8dadf2
Full changelog: CHANGELOG.md
Warning: fan control can interfere with macOS thermal management. Use at your own risk and return to automatic control when unsure.
0.2.0
What's new
Added
- Configurable app update tick (default 1s) for live temperature/RPM refresh and Curve target application.
- Draggable Curve preview points with 0-100 C and 0-100% grid axes.
- Thermal-mass temperature estimator based on stable M4 Pro SMC sensors, with lightweight app-side smoothing.
Changed
- Redesigned Manual target slider: rounded filled track and circular thumb, no per-step tick marks.
- Live Curve preview chart inside the menu bar popover.
- Stabilized popover layout during live updates; animated Manual/Curve height changes.
- Simplified footer and fan controls to Manual and Curve modes.
- Curve mode runs continuously until the user switches modes.
Fixed
- Centered popover arrow under the fan icon and temperature text.
- Tightened status item width to remove excess horizontal padding.
- Curve target application no longer lags behind live temperature changes.
- Fixed representative temperature spikes from unstable SMC readings.
- Fixed ambiguous duplicate-temperature curve points.
Install
Open the DMG and drag M4FanControl to Applications. Authorize the helper in Settings > Safety. Requires macOS 13+ on Apple Silicon. Ad-hoc signed; on first launch right-click > Open if Gatekeeper warns.