SensorPulse Localhost API
The read-only HTTP API delivers live sensor data as JSON. Default port 8765. Enable in SensorPulse: Settings → Automation → Localhost sensor API.
Default: The API listens on
127.0.0.1 only – safe for Rainmeter and scripts on the same PC.Remote access
Optionally enable Remote access in Settings. SensorPulse then also listens on your LAN IPs on your home network or VPN – read-only, with API token.
Endpoints
| Path | Description |
|---|---|
GET /api/health | {"status":"ok"} – connection test |
GET /api/sensors | JSON array of all active sensors |
GET /api/quicklook | Compact CPU/GPU/RAM + alerts |
GET /api/alerts | Active warnings |
GET /api/history/{sensorId}?minutes=60 | Sensor history |
Authentication
When an API token is set (required for remote access):
Authorization: Bearer YOUR_TOKEN
Security
- Remote access on home network or VPN only – do not expose to the internet
- Windows Firewall: inbound TCP on the API port, Private profile
- Regenerate the token if it may be compromised
Rainmeter example
Download: Rainmeter skin (README).
Copy to Documents\Rainmeter\Skins\. Localhost (127.0.0.1) only.