HeartRate to VRC

VRC心率OSC工具 - 支持 BLE 蓝牙和 Pulsoid 双数据源

功能特性

• BLE 蓝牙模式：通过 PC 蓝牙连接支持标准心率广播协议的设备（如小米手环）
• Pulsoid 模式：通过 Pulsoid/Stromno WebSocket API 获取心率数据
• OSC 输出：实时发送心率数据到 VRChat
• OBS 模式：输出心率到 rate.txt 文件，便于 OBS 调用

快速开始

预编译版本（推荐）

直接下载最新版本的可执行文件，无需安装 Python 环境：

前往 Releases 下载

下载 VRC_HR_Tool.exe 后双击运行即可，首次运行会自动生成 config.ini 配置文件。

从源码运行

如果你想从源码运行或进行开发，请参考下面的安装依赖和快速开始步骤。

安装依赖

pip install -r requirements.txt

方式一：BLE 蓝牙模式

1. 打开手环的心率广播功能
2. 确保电脑蓝牙已开启
3. 在"配置"标签页设置设备名称（支持模糊匹配）
4. 点击"连接并发送参数"

方式二：Pulsoid 模式

1. 访问 pulsoid.net 注册并获取 Widget ID
2. 在"配置"标签页选择数据源为 "Pulsoid"
3. 输入 Widget ID
4. 点击"连接并发送参数"

配置说明

OSC 参数

参数	默认值	说明
IP 地址	127.0.0.1	OSC 目标地址
端口	9000	VRChat OSC 默认端口
int 参数	/avatar/parameters/HR	心率整数值
float 参数	/avatar/parameters/HRF	心率百分比 (0.0-1.0)
bool 参数	/avatar/parameters/isHRActive	连接状态

心率范围

• 最低心率 / 最高心率：仅影响 float 参数的计算

工作模式

• 普通模式：仅发送 OSC
• OBS 模式：同时输出 rate.txt 文件

MA插件

下载链接：https://github.com/SinkStarUR/PCBLEtoVRC/releases/download/1.0.1/Heart_Rate_MA.unitypackage

界面预览

开发者说明

本地打包

如果你想自己打包可执行文件：

# 安装 PyInstaller
pip install pyinstaller

# 使用配置文件打包
pyinstaller VRC_HR_Tool.spec

# 打包后的文件在 dist/VRC_HR_Tool.exe

发布新版本

推送带有版本号的 tag 即可自动触发 GitHub Actions 构建和发布：

git tag v1.0.3
git push origin v1.0.3

GitHub Actions 会自动构建 exe 文件并创建 Release。