Help / FAQ

Set up WearStream.

Install the apps, connect your devices, and get your heart rate into VRChat. If something stops working, start with the troubleshooting checks.

Android + Wear OS

Install WearStream on both devices

Your watch reads heart rate. WearStream Phone receives those readings and forwards them to your desktop. Install and open WearStream on both devices.

1. Join the closed test

Request access first. Use the invited Google account to join the test. Select that account in Play Store on both devices. If your invitation names a Google Group, join that group before opting in.

The link works after your account has been added to the test. New releases and invitations can take several hours to appear.

2. Install on your phone

Open the WearStream Play listing with your eligible account and install the phone app. Open WearStream Phone when it finishes.

Keep the direct link from your invitation: a closed-test app may not appear in Play Store search.

3. Install on your watch

On the phone's Play listing, look for the device selector beside Install, choose your watch, then install. On the web listing, use Install and choose the watch. Labels may vary.

Check the watch's app list for WearStream Watch and open it. If the watch is missing from the install list, check that it uses your invited account and is supported by the test release.

Other ways to install on the watch

In phone versions with Install watch app help, choose your watch and use Open Play on watch. Finish installation in Play Store on the watch, then open WearStream. If the shortcut is unavailable or fails, use Open listing on phone or the web listing's device selector above.

In Play Store on the watch, check Apps on your phone if available. Google Play may also offer a companion-install notification. After installing, open WearStream from the watch's app list.

Google Play's optional App sync can install compatible apps on selected devices using the same Google account. You can find it under Play Store > profile > Manage apps & device > Sync apps to devices. You do not need to enable it for WearStream. Google's App sync help · Install on another device

The test is unavailable, or my watch is not listed

Check that the browser, phone Play Store, and watch Play Store use the invited account, and that you have opted in. Follow any group-joining step in your invitation. Being paired to the phone does not by itself grant the watch access to a test release.

If it is still unavailable, contact WearStream with the device models, OS versions, and the exact Play message. We may need to check compatibility and phone/watch track availability. Do not send passwords or account screenshots. Google's testing guidance

Already have both apps? Open WearStream Watch, tap Start streaming, and follow the permission steps. Then connect the desktop below. Watch streaming and the phone relay have separate Start/Stop controls.

First launch

Opening the desktop app

Windows safety prompt

If SmartScreen appears because the app is unsigned, confirm the file came from WearStream or the GitHub release, then choose More info and Run anyway.

macOS safety prompt

The macOS download is not Developer ID signed or notarized. Confirm it came from WearStream's official site or GitHub release, unzip it, and try opening WearStream.

If macOS still blocks it

After trying to open the app, go to System Settings -> Privacy & Security, use Open Anyway for WearStream, then confirm Open. See Apple's opening instructions.

Pairing

Connect your desktop and phone

QR pairing

Keep the phone and desktop on the same trusted local network; Ethernet on the desktop is fine. On Windows, leave Test mode off and click Start Relay. Scan the QR code in the phone app, then tap Start Relay there.

You can also copy or enter the full URL, such as ws://192.168.x.x:6124/ws. This address goes in WearStream Phone, not VRChat.

Check for live readings

With test mode off, check for a recent heart-rate reading on both the phone and desktop. Pairing is saved between sessions, but the watch still needs to be streaming.

On returning sessions, use your remembered desktop address. Scan again if the desktop address changes. Leave Network on Automatic unless it selects an address your phone cannot reach.

Check the desktop relay

On Windows 0.2.2, use Check connection in Relay setup, then read Connection help. A local listener check does not confirm phone access. macOS v0.2.0 uses the same action labels. Windows 0.2.1 called the button Check desktop relay; older versions may use Test listener.

VRChat output

Choose where your heart rate appears

First check that recent BPM reaches the desktop. Then enable chatbox, compatible avatar parameters, or both. You can also keep readings on the desktop without enabling VRChat output. Formatting and smoothing are optional.

Chatbox

Enable OSC and Chatbox in VRChat and the chatbox output in WearStream. For VRChat running on the same PC, keep the default target 127.0.0.1:9000.

Use Send chatbox test on Windows, then check for the sample message in VRChat. WearStream can report that it sent a message, but it cannot check whether VRChat displayed it.

Avatar OSC

Enable OSC in VRChat and avatar OSC output in WearStream. Your avatar must support the parameter names and types configured in WearStream. Check the avatar's setup instructions if the desktop receives BPM but the avatar does not respond.

Test without a watch

On Windows, enable Test mode and click Start Test Mode to try the desktop display and output. Phone Test mode sends simulated readings to the desktop.

Turn test mode off before checking the watch. To check watch permissions and screen-off streaming, start a real watch session and let the screen sleep.

Troubleshooting

Fix a connection or missing reading

Phone cannot connect

Check that the desktop relay is running and both devices are on the same trusted local network. Compare the desktop's current address with the phone's saved address; scan again if it changed. Use Check connection and Connection help on Windows for listener and network details, then try connecting from the phone.

VPNs, multiple adapters, or guest Wi-Fi

Windows and macOS v0.2.0 include a Network choice. Start with Automatic; if the address is wrong, select the home-network adapter and scan its QR code. Check your VPN's local-network access option. Guest Wi-Fi may prevent devices from reaching each other. Keep firewall protection enabled and use a network you trust.

Customize the desktop chatbox

Add a message above or below BPM, or on the same line. You can change the text around BPM or choose a heart symbol. The preview updates as you type. If a draft is invalid, WearStream keeps sending the last valid format until you fix it.

WearStream is already running

Windows and macOS v0.2.0 bring the existing window forward when launched again. Before updating, use Exit WearStream in the Windows tray or Quit WearStream in the macOS menu bar or app menu. Older builds without this safeguard must be exited manually; closing their window may only hide them.

No BPM from watch

Open WearStream Watch on your watch. If stopped, tap Start streaming and follow any permission request. If streaming is active, check the watch's status and fit against your wrist, then the phone's watch status. If readings stop only when the screen sleeps, check background heart-rate access.

If the app is missing from the watch, follow the installation steps.

The phone cannot find the watch app

Open WearStream on the watch to check that it is installed. Older app versions may work without appearing in the phone's install-help check. An offline watch can still be paired and have the app installed.

Finding the app does not start streaming. Use Start streaming on the watch and check for a recent reading.

Windows settings and tray controls

Output and smoothing changes apply while the relay runs. Listener port, bind address, and path changes need Restart relay for network changes. Choosing another Network updates the pairing address and QR; scan the updated code if needed. Lower smoothing-response values are steadier; higher values react faster.

The optional Keep running in the system tray when minimized or closed setting keeps a session running after you close the window. Right-click the tray icon to show WearStream, stop the relay, or exit. This option is off by default.

macOS settings and menu-bar controls

Output and smoothing changes apply while the relay runs. Listener port, bind address, and path changes need Restart relay for network changes. Pairing uses the active listener settings until restart. Choosing another Network updates the pairing address and QR.

The optional Keep running in the menu bar when closed setting keeps a session running after you close the window. Use the menu-bar heart to show WearStream, stop the relay, or quit. This option is off by default. Launching WearStream again or clicking its Dock icon restores the window.

Desktop shows a dash instead of BPM

A dash means the relay is stopped or has not received a fresh heart-rate sample within eight seconds. A responsive phone can still be waiting for its watch. Check watch streaming and permissions, and make sure the phone and PC use the correct date and time.

VRChat does not show BPM

First check for recent BPM on the desktop. Then follow the chatbox or avatar output steps and check the result in VRChat.

Permissions

Watch permissions and long sessions

Wear OS heart-rate access

When you tap Start streaming, WearStream explains why it needs heart-rate access before the system prompt. Background access is a separate choice on Wear OS 4 and newer.

Allow all the time

If WearStream opens system settings, it may start on the WearStream app info page.

  1. Open Permissions.
  2. Tap Fitness and wellness.
  3. Scroll to Allowed to access.
  4. Change While in use to All the time.
  5. Swipe back to WearStream.

This lets the watch keep streaming after the screen sleeps. Menu names can vary slightly by watch and Wear OS version; on Wear OS 6 the permission may be described as background health data access.

Phone long sessions

Start with Android's normal Optimized battery setting. If a session stops, reopen WearStream Phone and read the reason before changing settings.

If Android ended the relay at its background time limit, bring WearStream to the foreground and use Restart relay in the recovery hint, or Start Relay when stopped. Changing battery mode does not remove that limit.

If Android reports a background restriction, use the app's settings shortcut, or Settings > Apps > WearStream Phone > Battery / App battery usage, and allow background usage. Avoid Restricted. An interruption by itself does not prove a battery restriction.

Supported devices

Which apps do I need?

Wear OS + Android

Currently in closed testing. A Wear OS watch reads your heart rate, then the Android phone app relays it to your desktop. Ask about testing access.

Apple Watch + iPhone

The Apple Watch and iPhone apps are in development and are not yet available to download.

Desktop app

The desktop receives readings, smooths them, and sends BPM to your selected VRChat outputs.

FAQ

Common questions

Do I need a WearStream account?

No. WearStream pairs your phone with your desktop by QR code or relay address. During Android closed testing, you need an invited Google account to install the phone and watch apps through Google Play.

Does the relay need internet access?

The phone-to-desktop relay uses your local network by default. On Wear OS, the watch-to-phone link uses Google Play services: Bluetooth is preferred, but when it is unavailable, readings may pass through Google's servers with end-to-end encryption. WearStream does not offer a mode that blocks this fallback and does not operate its own cloud relay. Installing apps, checking for updates, and playing VRChat also use internet services. See where readings go.

Does WearStream save my heart-rate history?

The Android apps do not keep a heart-rate history. The iPhone version in development saves a small queue of unsent readings for retries, and Apple Watch sessions can create workout records in Apple Health. The privacy policy explains local storage, diagnostics, and backups.

Can other players see my heart rate?

Yes, if you enable chatbox output or use avatar parameters that display it. Visibility depends on your VRChat and avatar settings. You can turn off both outputs in WearStream and keep readings on your desktop.

Can I use WearStream on a Quest without a computer?

The current setup needs the Windows or macOS desktop relay on your local network. There is no standalone WearStream app for Quest.

How do I remove saved data?

You can clear Android app storage in device settings. Desktop settings and logs need to be removed separately, and Apple Health workout records are managed in Apple Health. See deletion instructions for each platform.