Start
Installation and requirements
Install the plugin, then confirm that Tahoma Bold is present. No separate sensor app is needed. If it is already installed, get your first reading.
System requirements
The declared floor is what the package asks for. Actually run lists what ran on the measured Mac and on hosted CI.
| Requirement | Declared floor | Actually run |
|---|---|---|
| macOS | 13.5 or later | 27.0.1 on an Apple silicon M5 Pro. Hosted CI virtual machines ran the test suite and the native readers on macOS 26.6.2 (Apple silicon) and 26.6.1 (Intel). |
| Stream Deck app | 7.1 or later | 7.5.0 and 7.6.0 |
| Node runtime | Node 24, supplied by the Stream Deck app. You install nothing. | 24.13.1 with app 7.5.0 and 24.22.1 with app 7.6.0, the runtimes the app chose. |
| Tahoma Bold | Installed. It ships with macOS. | Present on the measured Mac |
| Processor | The package carries an arm64 reader for Apple silicon and an x86_64 reader for Intel | Apple silicon measured. Intel ran only on hosted virtual machines; physical Intel validation has not been done (Mac). |
| A deck | Sensor Reading goes on a display key. Sensor Dial goes on a dial of a Stream Deck + or + XL. Sensor Control can go on any key, including a Stream Deck Pedal or Corsair G-Keys (not checked on hardware), and steers dials on another deck (Stream Deck models). | The 8 by 4 Virtual Stream Deck, and a Stream Deck MK.2 for keys, presses and opening details. Other physical checks and Stream Deck + dial gestures have not run (Stream Deck models). |
Mac Sensors needs no administrator password, privileged helper, daemon or kernel extension. Which readings appear depends on the Mac and its macOS version. The compatibility matrix gives the evidence for each Mac and deck.
Install the plugin
Get the package
Install from the Elgato Marketplace, or download com.lawrensen.mac.streamDeckPlugin from the latest GitHub release. The current version is 1.0.1.0 on both.
Install from a .streamDeckPlugin file
- Open the Stream Deck app.
- In Finder, double-click
com.lawrensen.mac.streamDeckPlugin. The Stream Deck app asks whether to install it. Choose Install. - Find the Mac Sensors category in the actions list. It holds Sensor Reading, Sensor Dial and Sensor Control.
A browser download keeps the macOS quarantine flag, and you do not need to clear it. On the measured Mac, Finder passed a quarantined package straight to the Stream Deck app.
Check the download
Each GitHub release has SHA256SUMS.txt attached. Put the package, native-manifest.json and SHA256SUMS.txt from the same release in one folder and run:
shasum -a 256 -c SHA256SUMS.txt
Each line must end in OK. A matching checksum identifies the published bytes; it does not establish safety. The two native readers are ad-hoc signed, which checks file integrity. They have no Developer ID certificate and are not notarized. To inspect an extracted reader, run codesign --verify --strict <file> and codesign -dv --verbose=4 <file>.
Before loading a reader, the plugin compares the file’s SHA-256 with the record inside the package. A file that does not match is not loaded, and keys show Bridge failed. Quit and reopen Stream Deck. If it persists, remove Mac Sensors and install it again (Removing).
Elgato Marketplace
Install from the Marketplace listing. Checked 9 November 2026: the listing offers version 1.0.1.0. Elgato repackages Marketplace copies, so their checksums can differ from the GitHub package’s. Do not compare the two.
Updating
- Newer version: open the newer package the same way. The Stream Deck app replaces the installed plugin. Your keys, dials and their settings stay, because the Stream Deck app stores them outside the plugin folder. On the measured Mac, 1.0.0.0 installed this way over an earlier build.
- Same version: opening a package of the installed version changes nothing. The app writes
AlreadyInstalledto its log in~/Library/Logs/ElgatoStreamDeck, the running plugin keeps going, and its files stay as they were. To install the same version again, remove it first. - Detail view: after an update that changes the bundled detail view, Stream Deck asks again to install it the first time details open on each kind of deck. 1.0.1.0 ships the 1.0.0.0 detail view files unchanged.
Removing
- Export a backup of your Stream Deck profiles.
- Remove Mac Sensors from the Plugins list in the Stream Deck app’s settings.
The plugin itself writes only its logs, inside its own plugin folder. If you opened sensor details, the Stream Deck app also holds a Mac Sensors Details profile for each kind of deck you used, and one more after an update that changed the detail view. Whether removing the plugin also removes those profiles has not been checked. To remove one, delete Mac Sensors Details from the app’s profile list.
Where it installs
| What | Where on this Mac |
|---|---|
| Plugin files | ~/Library/Application Support/com.elgato.StreamDeck/Plugins/com.lawrensen.mac.sdPlugin |
| Plugin logs | The logs folder inside the plugin folder. com.lawrensen.mac.0.log is the newest. |
| Stream Deck app log | ~/Library/Logs/ElgatoStreamDeck |
| Key, dial and shared settings | Stored by the Stream Deck app, not in the plugin folder |
| Detail view profiles | Mac Sensors Details in the Stream Deck app’s profile list, once you accept the install prompt |
| Node runtime | Supplied by the app, under ~/Library/Application Support/com.elgato.StreamDeck/NodeJS/ |
The plugin loads the reader that matches the Node runtime the app starts: hwmac-arm64.node for arm64, hwmac-x86_64.node for x86_64. Both sit in the plugin folder’s bin folder.
Tahoma Bold prerequisite
Keys, dials and detail tiles draw their text in Tahoma Bold, and the plugin fits each label and value to that font’s measured widths. Tahoma Bold ships with macOS. On the measured Mac it is /System/Library/Fonts/Supplemental/Tahoma Bold.ttf. The package carries no font file.
On every system read, the plugin asks macOS for the font named Tahoma-Bold, with automatic font activation turned off, and accepts it only when macOS returns that exact font. Any other answer, such as a substitute font, counts as missing.
When the font is missing, every Sensor Reading key, Sensor Dial and detail tile shows a fixed setup image, Tahoma needed and Open Font Book, and readings are withheld until the font is back. Sensor Control keys keep their own image. The setup image is stored as pixels, so it draws without the font. In the settings panel, the problem notice says “Install Tahoma Bold in Font Book, then choose Check again.” and offers Check again.
- Open Font Book and search for Tahoma.
- Make sure Tahoma Bold is listed and turned on. If it is not listed, install a Tahoma Bold font file in Font Book.
- Select a Mac Sensors key, open its settings and choose Check again.
Do not remove a system font to test this screen. Status screens shows every status image, and Troubleshooting has the full repair.
Verify it works
Drag Sensor Reading onto a key and choose a Reading. The key shows a number and unit, and the settings header shows Live · Mac sensors. To see how many readings this Mac returned, open Advanced, then Support, choose Copy support report, and look at sourceRows in the mac section: public counts system readings and smc counts SMC readings. The measured M5 Pro reports public 14 and smc 38. Follow the five-step guide or find the exact message in Troubleshooting.
Next steps
Get started · Sensor Reading · Sensor Dial · Data sources · Hardware compatibility