https://github.com/euav/patme-in-vr

Bridges VRChat's OSC avatar parameters to a Bluetooth LE haptic device, so your friends can pat you in VR
https://github.com/euav/patme-in-vr

ble esp32 osc vrchat

Last synced: about 2 months ago
JSON representation

Bridges VRChat's OSC avatar parameters to a Bluetooth LE haptic device, so your friends can pat you in VR

• Host: GitHub
• URL: https://github.com/euav/patme-in-vr
• Owner: euav
• License: mit
• Created: 2026-02-12T10:06:33.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-03-05T15:21:42.000Z (3 months ago)
• Last Synced: 2026-04-17T01:09:22.246Z (about 2 months ago)
• Topics: ble, esp32, osc, vrchat
• Language: Rust
• Homepage:
• Size: 161 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![PatMe Headband](images/patme-headband.jpg)

Inspired by the [Patstrap](https://github.com/danielfvm/Patstrap) project by [danielfvm](https://github.com/danielfvm).

# PatMe in VR, Haptic Feedback for VRChat

Bridges VRChat's OSC avatar parameters to a Bluetooth LE haptic device, so your friends can **pat you in VR**. The host app is written in Rust; the device firmware is an Arduino (ESP32) sketch; build instructions will be provided.

- **Input**: OSC messages with addresses

  - `/avatar/parameters/PatMe/Intensity` from Expression Menu 

  - `/avatar/parameters/PatMe/` from Contact Receivers, where `id` is 0, 1 and so on

- **Processing**: Values are time-smoothed and compacted into a small,

  fixed-size haptic state.

- **Output**: The current haptic state is sent over BLE to the PatMe device in equal periods of time.

## Host application configuration

- **OSC bind address**

  - Flag: `--osc-port `

  - Env: `PATME_OSC_PORT`

  - Default: `9001`

- **Haptics count (number of vibros)**

  - Flag: `--haptics-count `

  - Env: `PATME_HAPTICS_SIZE`

  - Default: `2`

- **Send interval (ms)**

  - Flag: `--send-interval-ms `

  - Env: `PATME_SEND_INTERVAL_MS`

  - Default: `30`

- **Headless mode without GUI**

  - Flag: `--headless`

## Notes

- The host smooths incoming parameters with a decay filter and sends compacted float values to the device BLE characteristic.

- BLE service/characteristic UUIDs are defined in the firmware and matched by the host: see [firmware/firmware.ino](firmware/firmware.ino) and [src/ble.rs](src/ble.rs).