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.

What you'll need

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

  1. Open Heart-Rate Settings

    In VMSC, go to Sources > Heart Rate and enable the source.

  2. Choose Your Provider

    Select Pulsoid or HypeRate.

  3. 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.

  4. Connect

    Click connect. Once your sensor is reporting, VMSC starts receiving BPM updates and the live value appears in the panel.

Graceful by design

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-rate event carrying the current bpm. 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.
Privacy

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.