Setting Up OSC Apps for the Heart Rate Prefabs

We recently released the Glowy Heart Rate Prefab, and to work correctly, it requires receiving specific parameters from OSC apps.

• HR (Int): required to display your heart rate.

• isHRBeat (Bool): required if you want the prefab to stop showing on your avatar when heart rate data isn’t being received for some time.
  

In this article, we’ll explain how to set up these parameters in different OSC apps (scroll below), and how to get everything working if you don’t have any OSC app yet.

Setting Up PulsoidToOSC from the Beginning

If you don’t have any OSC app working yet, PulsoidToOSC is a good choice for quickly sending heart rate data to VRChat. Before we go further, make sure your Pulsoid account is set up and you have the supported heart rate device. Not sure how? Check out this article (1-3 steps). Here’s how to set the PulsoidToOSC:

1. Install the PulsoidToOSC app (click on the PulsoidToOSC.zip)

   

   
   

2. Open PulsoidToOSC and go to the Settings

   

3. Click on "Get Pulsoid Token" and authorize Pulsoid.

   

4. That's all! If you're wearing your heart rate device, you should be able to see your heart rate in the app. Click "Start" to start sending heart rate parameters to VRChat.

   

   
   

OSC Apps That Work Without Changes

Some apps already use the correct parameters out of the box:

• TTS Voice Wizard

• PulsoidToOSC

• HRtoVRChat_OSC (no longer supported)

Note: TTS Voice Wizard does not send the isHRBeat parameter. This means you won’t be able to use timeout detection with the Heart Rate Core Prefab if you’re using that app.

Setting Up MagicChatBox

MagicChatBox already uses the correct parameter names (HR and isHRBeat). The only thing you need to do is enable OSC output so that the data is sent to VRChat:

1. Open MagicChatBox settings.

   

2. Locate the Pulsoid to OSC section.

3. Enable OSC support.

   

No renaming is required: once enabled, your prefab will receive both parameters correctly.

Setting Up VRCOSC

VRCOSC includes the needed parameters, but the default names are different. To make it work with the prefab:

1. Go to the Modules tab.

2. Locate Pulsoid and click the Link icon.

   

3. Update the parameter names as follows:

   Change VRCOSC/Heartrate/Value → HR (just HR, without the VRCOSC/Heartrate/ part)

   Change VRCOSC/Heartrate/Beat → isHRBeat (just isHRBeat, without the VRCOSC/Heartrate/ part)

   

Save your changes. After this, VRCOSC will send the correct parameters for both heart rate display and timeout detection. With the correct setup in your OSC app, the Heart Rate Prefab will work seamlessly, showing your heart rate in real time and automatically hiding if data stops coming in (in case you've added the Heart Rate Auto-Hide prefab).