A fresh macOS build is now available and fully working!
Important: The app is currently unsigned because Apple requires a $99/year Apple Developer ID to notarize and sign apps.
Because of this, macOS may show:
"Apple cannot verify that this app is free of malware."
This is expected for unsigned Electron apps.
If macOS blocks the app, you can still run it safely.
Video tutorial: https://www.youtube.com/watch?v=biIvAM94b98
Or follow these steps manually:
- Try to open the
.appmacOS will block it. - Open System Settings > Privacy & Security
- Scroll until you see App was blocked from opening
- Click Allow Anyway
- Re-open the app click Open
After this, the app will launch normally every time.
npm install
npm run startOpen Settings inside the app:
- Paste your Pulsoid Access Token
(Required scope:data:heart_rate:read) - (Optional) Add Discord Client ID, then toggle Discord RPC on
- Toggle Realtime to start/stop Pulsoid streaming
- Click Open OBS Overlay inside the app
- In OBS Sources + Window Capture
- Select the window titled Overlay
- Enable Allow Transparency (if supported)
- Make sure the overlay window is visible on the same desktop
Tip: The overlay window is resizable and click-through by default.
- Settings are saved locally using electron-store and loaded at startup
- Discord RPC requires the Discord desktop app running on the same machine
- The live chart stores the latest ~120 heart-rate points for performance