Setup notes for pairing, VRChat output, and first launch.

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

If macOS blocks the app, unzip it, then Control-click or right-click the app and choose Open.

If macOS still blocks it

Open System Settings -> Privacy & Security, use Open Anyway for WearStream, then launch it again.

QR pairing

The desktop relay shows a local URL such as ws://192.168.x.x:6124/ws. Scan it in the phone app. VRChat does not use this URL.

VRChat outputs

For the normal same-PC setup, leave WearStream pointed at 127.0.0.1:9000 and enable OSC plus Chatbox in VRChat.

Test listener

Use Test listener in the desktop app if the phone cannot connect or the relay URL seems wrong.

Wear OS heart-rate access

When you tap Start streaming, allow heart-rate access. On newer Wear OS versions, background heart-rate access is separate.

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.

Phone long sessions

The Android phone relay uses a foreground service, so most users can leave battery settings alone. If a long session stops unexpectedly, open Android Settings -> Apps -> WearStream Phone -> Battery or App battery usage, then choose Unrestricted or allow background usage if your device offers it.

Wear OS + Android

The original path reads heart-rate data from a Wear OS watch, relays it through Android, then forwards it to desktop.

Apple Watch + iPhone

The Apple path uses native WatchConnectivity and the same local desktop listener contract.

Desktop app

The desktop receives telemetry, smooths the output, and sends BPM to local VRChat outputs.