Repository navigation
No Python needed anymore: download fitbit-osc.exe below, put it in a folder of its own and double-click it. A heart icon appears in the tray. Then switch on heart-rate sharing once in Google Health (Connections → Fitbit Air → Share heart rate → Always visible). Full guide in the README.
Windows SmartScreen may warn because the file is not code-signed: More info → Run anyway. fitbit-osc.exe.sha256 holds the checksum. The exe is built by GitHub Actions from this tag.
New
- Standalone
fitbit-osc.exe. One file, runs in the tray, settings and log next to it. - Settings in the tray menu: VRChat chatbox, OBS overlay, Start with Windows, Start with SteamVR, settings file, log. All options are also stored in
config.json; command-line options still override them per run. - OSCQuery. With the default
"port": "auto"the bridge asks VRChat for its OSC port, so it also works when VRChat was started with--osc=.... Falls back to 9000. - OBS overlay. A local page (
http://127.0.0.1:8765/) with a beating heart and the BPM for a browser source. Size and colours via URL parameters. - Battery level in the tray and as the
HRBatteryparameter, for bands that report it. The Fitbit Air does not. --version, version info in the exe.
Improved
- No more frozen number on the avatar.
VRCOSC/Heartrate/EnabledandisHRActiveturn off after 5 s without a valid value, on 0 BPM or when the band reports no skin contact. - Leaving the room no longer removes the pairing. v1.0.0 unpaired after about 40 s without contact. Now the bridge scans briefly and only re-pairs when the band shows up under a new address, or keeps failing while in plain sight. Otherwise it keeps the pairing and retries with a growing pause.
- The tray status line updates. Before, it was built once and stayed at "No band connected".
- Heart-rate packets are parsed per the Bluetooth specification: skin contact, energy and RR-interval fields.
Under the hood
- Code split into the
fitbit_oscpackage.hr_osc.pyandregister_steamvr.pystay as entry points, so existing SteamVR registrations keep working after an update. - 33 automated tests, ruff, GitHub Actions for CI and for building the exe.
Upgrading from v1.0.0 (source install)
Download the new source, run install.bat once more (it adds zeroconf), done. Your pairing and SteamVR registration stay as they are.