❤️ Heart Rate-Actuated Vibrator Control System
September 13, 2025 · View on GitHub
https://discord.gg/gwnvrSYtjp Check out our Discord Server
❤️ Heart Rate-Actuated Vibrator Control System
A Node.js system that connects heart rate monitoring from OBS to vibrator control via the Buttplug protocol. Automatically adjusts vibration intensity based on real-time heart rate data, with a web UI for manual control and monitoring.
🚀 Features
- 🩺 Real-time heart rate monitoring via OBS WebSocket
- 📈 Automatic vibrator control based on configurable HR threshold
- 🕹 Web-based control panel with manual override
- 🔌 Supports any Buttplug-compatible device via Intiface Central
- 🛠 Graceful shutdown and error handling
- 📱 Mobile-friendly UI
🔧 Prerequisites
📦 Installation
git clone https://github.com/Das-L1/Heartrate-Buttplug.git
cd hr-a
npm install
⚙️ Configuration
Intiface Central Setup
- Launch Intiface Central
- Enable WebSocket Server in Settings
- Keep default port (12345)
▶️ Usage
1. Start the system
npm start
2. Device Connection Flow
- Ensure Intiface Central is running
- Turn on your Bluetooth device
- The web UI will auto-connect to the first available device
3. Web Interface
- Access at
http://localhost:3000 - Real-time heart rate display
- Manual override switch
- Connection status monitoring
🎥 OBS Setup with HeartRateOnStream
Android App
- Install HeartRateOnStream on your Android device
- Pair with your heart rate sensor
- Set OBS WebSocket URL in app to
ws://your-pc-ip:4456 - Start broadcasting HR data
🛠 Troubleshooting
| Issue | Solution |
|---|---|
| No device found | Ensure Intiface Central is running and the device is paired |
| WebSocket errors | Check firewall settings for port 4456 |
| HR data not updating | Verify HeartRateOnStream connection in OBS |
| Connection retries | Restart Intiface Central and the system |
📄 License
ISC License. See LICENSE for details.
Note: Always ensure proper consent and safety measures when using physiological data for actuation systems.