Overview
VMSC can read your real-time heart rate from a chest strap, smartwatch, or fitness band relayed through Pulsoid or HypeRate. Every BPM update becomes a stream event you can react to like any other — so your avatar can flush when your heart races, an overlay can show your live BPM, or a rule can fire when you cross a threshold.
It is a low-latency WebSocket connection that runs quietly in the background for the whole stream, reconnecting on its own if the link drops.
A heart-rate sensor paired with the Pulsoid or HypeRate mobile app, plus an access token (Pulsoid) or session/device ID (HypeRate). Both have free tiers.
Supported Providers
| Provider | What VMSC Needs | Where to Find It |
|---|---|---|
| Pulsoid | Access token | pulsoid.net > account > API keys / access tokens |
| HypeRate | Access token + device/session ID | app.hyperate.io — the session ID shown for your device |
Setting Up Heart Rate
-
Open Heart-Rate Settings
In VMSC, go to Sources > Heart Rate and enable the source.
-
Choose Your Provider
Select Pulsoid or HypeRate.
-
Enter Your Credentials
Paste your access token (and, for HypeRate, the device ID). Credentials are stored locally and only sent to the provider you chose.
-
Connect
Click connect. Once your sensor is reporting, VMSC starts receiving BPM updates and the live value appears in the panel.
If your token is wrong or expires, VMSC won't spam errors — it tells you once, then keeps retrying quietly in the background and reconnects the moment the token is valid again.
Using Your BPM
Heart rate flows into VMSC in two ways, so you can use whichever fits:
- As a stream event — each update is a
heart-rateevent carrying the currentbpm. Use it as a rule trigger or filter (for example, "when BPM goes above 120, change avatar expression"). - As a live value — the latest BPM is available to overlays and other outputs, so you can show it on screen or feed it into VRChat OSC parameters in real time.
Example uses
Reactive avatar
Map BPM to a VRChat OSC float so your avatar visibly reacts — blush, sweat, or a racing-heart animation — as your pulse climbs.
On-stream BPM
Show your live heart rate in an overlay widget or the mobile deck so viewers can see the effect of a scary game or big moment.
Threshold triggers
Fire a sound alert, OWO heartbeat sensation, or chat message when your BPM crosses a value you set.
Notes & Reliability
- The connection auto-reconnects forever with a gentle backoff, so a brief Wi-Fi blip or phone hiccup won't end your heart-rate feed for the rest of the stream.
- Heart rate is a source, not an output — it provides data; what you do with it is up to your rules and overlays.
- Keep your sensor and phone app running; VMSC only relays what the provider sends.
Your heart rate is personal health-adjacent data. Only put it on stream if you're comfortable sharing it, and remember overlays showing BPM are visible to your whole audience.