Repository navigation
v1.0.0 – reconnect fixes and Google Health guide
First tagged release of the Fitbit Air → VRChat heart-rate bridge: no phone app, no HypeRate/Pulsoid, no account. A Python tray program reads the pulse from the band over Bluetooth LE and sends it to VRChat via OSC.
Install
- Download Source code (zip) below and unpack it, e.g. to
C:\Tools\fitbit-osc. - Run
install.bat(needs Python 3.11+ from python.org). - On the phone, once: Google Health → Connections → Fitbit Air → Share heart rate → Always visible on.
start-tray.bat, orregister_steamvr.pyfor the SteamVR autostart.
Full guide in the README.
Fixes in this release
- No more exit on Bluetooth errors. Unplugging the adapter or switching the radio off ended the bridge; it now logs the error and retries every 10 s.
- Other heart-rate bands connect after pairing. The reconnect went by the Windows device name (
--name fitbit), so a Polar or Garmin band paired and then never connected. The address from the scan is used directly now. --name ""no longer matches every paired BLE device, which could have unpaired a mouse or controller after two failed attempts.- No needless reconnect right after subscribing when the band dropped briefly during service discovery.
- Silent drops are detected. 20 s without a measurement while Windows still reports "connected" counts as disconnected, so the avatar no longer freezes on the last value.
- No console window flashing every 10 s in the SteamVR autostart (tray mode), and the SteamVR check no longer blocks the heartbeat toggle.
- Short heart-rate packets are ignored, 0 BPM shows in the tray tooltip, a leaked device handle is closed.
Documentation
- New section on setting up heart-rate sharing in Google Health (Android and iPhone), what Share heart rate and Always visible do, one listener at a time, pairing happens on the PC, address changes, 0 BPM, battery.
- First-run walkthrough with the expected log lines, more troubleshooting entries.
Tested with
Fitbit Air, Windows 10, Python 3.14, TP-Link UB500 (Realtek RTL8761B). Counterfeit "CSR8510 A10" sticks do not work reliably, see the README.