You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Core-Monitor reads sensor data from the Apple SMC and standard macOS system APIs, then presents it in the menu bar, dashboard, and, on supported hardware, the Touch Bar. CPU, GPU, memory, battery,[...]
46
+
Core-Monitor reads sensor data from the Apple SMC and standard macOS system APIs, then presents it in the menu bar, dashboard, and, on supported hardware, the Touch Bar. CPU, GPU, memory, battery, thermals, power draw, USB-C controllers, and on supported Macs, the Touch Bar.
44
47
45
-
It is written in Swift and built around `host_statistics`, `IOKit`, and `IOPSCopyPowerSourcesInfo`. Sensor reads stay local to your Mac. The optional fan control helper is the only additional proc[...]
48
+
It is written in Swift and built around `host_statistics`, `IOKit`, and `IOPSCopyPowerSourcesInfo`. Sensor reads stay local to your Mac. The optional fan control helper is the only additional process.
46
49
47
50
Public builds are available through GitHub Releases as a signed DMG for standard installs and a signed ZIP for archive-friendly installs.
48
51
49
-
There is also a separate Core-Monitor Mac App Store edition: https://apps.apple.com/us/app/core-monitor/id6762558526?mt=12. That variant is sandboxed and intentionally different: it keeps read-onl[...]
52
+
There is also a separate Core-Monitor Mac App Store edition: https://apps.apple.com/us/app/core-monitor/id6762558526?mt=12. That variant is sandboxed and intentionally different: it keeps read-only sensor monitoring but removes fan control.
**Thermals** — CPU die temperature from `TC0P`, `Tp09`, `TCXC`, and fallbacks, GPU from `Tg0e`/`Tg0f`. You can also browse all readable SMC keys from the sensor explorer.
112
115
113
-
**Advanced rescue** — the dashboard's Rescue page reads AppleSmartBattery `PortControllerInfo` to surface USB-C controller firmware versions, I2C error counts, boot flags, and active power cont[...]
116
+
**Advanced rescue** — the dashboard's Rescue page reads AppleSmartBattery `PortControllerInfo` to surface USB-C controller firmware versions, I2C error counts, boot flags, and active power contracts.
114
117
115
118
## Fan control
116
119
117
120
Fan control is optional and requires a privileged helper called `smc-helper`. If you don't need it, you don't need the helper — everything else works without it.
118
121
119
-
The helper is bundled at `Core-Monitor.app/Contents/Library/LaunchServices/ventaphobia.smc-helper`, installed to `/Library/PrivilegedHelperTools/ventaphobia.smc-helper` via [`SMJobBless`](https:/[...]
122
+
The helper is bundled at `Core-Monitor.app/Contents/Library/LaunchServices/ventaphobia.smc-helper`, installed to `/Library/PrivilegedHelperTools/ventaphobia.smc-helper` via [`SMJobBless`](https://developer.apple.com/documentation/servicemanagement/smjobbless).
120
123
121
-
The Apple Silicon manual-control path is adapted from the MIT-licensed research project [`agoodkind/macos-smc-fan`](https://github.com/agoodkind/macos-smc-fan). Core Monitor now probes `F%dMd`vs[...]
124
+
The Apple Silicon manual-control path is adapted from the MIT-licensed research project [`agoodkind/macos-smc-fan`](https://github.com/agoodkind/macos-smc-fan). Core Monitor now probes `F%dMd`versus `F%dMc` to detect MMIO vs. normal fan mode on your specific chip.
122
125
123
126
**Fan modes:**
124
127
@@ -132,7 +135,7 @@ The Apple Silicon manual-control path is adapted from the MIT-licensed research
132
135
| Manual | You pick the RPM. |
133
136
| System | Restores automatic SMC control with `F{n}Md = 0`. |
134
137
135
-
The Smart curve accounts for system power draw as a temperature boost — at 40 W it adds up to 8°C to the effective temperature before mapping to a fan speed. Fan settings persist across sleep/[...]
138
+
The Smart curve accounts for system power draw as a temperature boost — at 40 W it adds up to 8°C to the effective temperature before mapping to a fan speed. Fan settings persist across sleep/wake.
136
139
137
140
**Helper commands** (also usable directly from the terminal):
138
141
@@ -155,7 +158,7 @@ Core-Monitor includes a Touch Bar layout editor in the app's **Touch Bar** secti
155
158
156
159
Every item in the active layout is stored in order and rendered in the live preview before you apply changes.
157
160
158
-
The point of the strip is that it stays available above your other apps. You can keep a live status HUD, weather, pinned apps, and quick actions one tap away while you are still in Xcode, Termina[...]
161
+
The point of the strip is that it stays available above your other apps. You can keep a live status HUD, weather, pinned apps, and quick actions one tap away while you are still in Xcode, Terminal, or another fullscreen app.
159
162
160
163
### Built-in widgets
161
164
@@ -270,7 +273,7 @@ The live preview strip above the editor reflects the current order and item widt
270
273
271
274
Presets still exist, but they now apply structured item layouts instead of the older widget-only stack.
272
275
273
-
Touch Bar layouts are stored in user defaults and older widget-only configurations are migrated forward into the richer item model automatically. Existing users should keep their built-in layouts[...]
276
+
Touch Bar layouts are stored in user defaults and older widget-only configurations are migrated forward into the richer item model automatically. Existing users should keep their built-in layouts.
274
277
275
278
### Current limits
276
279
@@ -306,23 +309,23 @@ Yes. Core-Monitor does not require an account, sensor reads stay on your Mac, an
306
309
307
310
### Is Core-Monitor a good open-source alternative to TG Pro, iStat Menus, Macs Fan Control, or Stats?
308
311
309
-
Yes, when you want Apple Silicon-first monitoring, open-source transparency, readable menu bar status, and optional fan control in one app. It is a particularly strong fit when privacy and local[...]
312
+
Yes, when you want Apple Silicon-first monitoring, open-source transparency, readable menu bar status, and optional fan control in one app. It is a particularly strong fit when privacy and local-first monitoring matter to you.
310
313
311
314
### What does Core-Monitor not try to be?
312
315
313
-
It is not a cloud monitoring platform, not a fleet-management product, and not the most sprawling all-purpose desktop stats suite. The product is intentionally centered on heat, power, battery, f[...]
316
+
It is not a cloud monitoring platform, not a fleet-management product, and not the most sprawling all-purpose desktop stats suite. The product is intentionally centered on heat, power, battery, and fan control for Apple Silicon Macs.
314
317
315
318
## Installation
316
319
317
-
**Download:** Use the signed [Core-Monitor.dmg](https://github.com/offyotto/Core-Monitor/releases/latest/download/Core-Monitor.dmg) for the standard install, or grab the [Core-Monitor.app.zip](ht[...]
320
+
**Download:** Use the signed [Core-Monitor.dmg](https://github.com/offyotto/Core-Monitor/releases/latest/download/Core-Monitor.dmg) for the standard install, or grab the [Core-Monitor.app.zip](https://github.com/offyotto/Core-Monitor/releases/latest/download/Core-Monitor.app.zip) for archive installs.
Open the project in Xcode, select the `Core-Monitor` scheme, and build. The `smc-helper` is a separate target. You can build and run Core-Monitor without it, but fan control will not be available[...]
328
+
Open the project in Xcode, select the `Core-Monitor` scheme, and build. The `smc-helper` is a separate target. You can build and run Core-Monitor without it, but fan control will not be available in the UI.
326
329
327
330
## Compatibility
328
331
@@ -337,7 +340,7 @@ Core-Monitor does not include analytics, ad SDKs, or account features. Sensor re
337
340
338
341
## WeatherKit
339
342
340
-
The optional Touch Bar weather item uses Apple WeatherKit and location access to show local conditions. Remove the weather item from your Touch Bar layout if you do not want Core-Monitor to reque[...]
343
+
The optional Touch Bar weather item uses Apple WeatherKit and location access to show local conditions. Remove the weather item from your Touch Bar layout if you do not want Core-Monitor to request your location.
0 commit comments