Skip to content

v1.0.0 – reconnect fixes and Google Health guide

Choose a tag to compare

@Hemiize Hemiize released this 04 Nov 04:15
· 3 commits to main since this release

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

  1. Download Source code (zip) below and unpack it, e.g. to C:\Tools\fitbit-osc.
  2. Run install.bat (needs Python 3.11+ from python.org).
  3. On the phone, once: Google Health → Connections → Fitbit Air → Share heart rate → Always visible on.
  4. start-tray.bat, or register_steamvr.py for 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.