https://github.com/mercuso/headpat-vr
Device that brings tactile feelings of VR head pats using mechanical force applied by brushes
https://github.com/mercuso/headpat-vr
arduino esp8266 haptic-feedback headpats osc python vrchat
Last synced: 3 months ago
JSON representation
Device that brings tactile feelings of VR head pats using mechanical force applied by brushes
- Host: GitHub
- URL: https://github.com/mercuso/headpat-vr
- Owner: Mercuso
- License: mit
- Created: 2024-03-24T22:31:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-06T22:22:27.000Z (4 months ago)
- Last Synced: 2025-01-30T19:12:12.052Z (3 months ago)
- Topics: arduino, esp8266, haptic-feedback, headpats, osc, python, vrchat
- Language: HTML
- Homepage:
- Size: 49.8 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HeadpatVR
[**Youtube overview**](https://youtu.be/_8gu3-EAek4)
[](https://youtu.be/_8gu3-EAek4)
Device that brings tactile feelings of VR head pats using mechanical force applied by brushes
> [!WARNING]
> This project is in the development phase. The types of peripherial parts (fasteners, springs, printable parts) can be changed for further improvements
## Introduction
Feel VR head pats in real life!
This device monitors hand collisions with a head in VRChat the sensation of cuddles on a head in real life using brushes controlled by servo motors
The current fastening system is compatible only with BOBOVR M2/M3 head straps for Meta Quest 2 and 3. However, there are plans to develop a universal solution for the most common head straps in the future
Inspired by a [similar project that uses vibrating motors](https://github.com/danielfvm/Patstrap)
Why another version?
I found vibrations on a head too unpleasant and decided to try to reproduce head pats in another way
## Project parts
### Desktop application
This repository includes only the application that should be launched on the PC alongside VRChat. The server application communicates with VRChat application using the OSC protocol (you can find more details about VRChat OSC [here](https://docs.vrchat.com/docs/osc-overview))
It has UI implemented as a webpage, which opens automatically when the application is launched. The UI helps track the device's status, monitor the current intensity level on each side, and send test signals
### Firmware
The source code is available [here](https://github.com/Mercuso/headpat-vr-esp)
The code is written based on Arduino framework
### Hardware
- 2 servo motors
- ESP-WROOM-32 38pin board
- esp-32 expansion board
- fasteners
- silicone brushes
- mount system for the motors
- mount system for esp-32 expansion board
- power supply
The detailed list of parts with description can be found [here](docs/PARTS.md)
## Setup
### Firmware
The documentation and source code of the firmware can be found [here](https://github.com/Mercuso/headpat-vr-esp)
You need PlatformIO IDE to compile and upload it to your esp32-based board
### Hardware
Since there are only 3 electronic components, the wiring is simple
You can use a regular power bank as a power supply by connecting it to the expansion board. Make sure that the board jumper is in the right position (in the 5V position)
This is the minimal device setup to do basic tests
The motors with brushes and the board should be mounted on the VR headset with the help of additional printable plastic parts
The latest assembly instructions can be found here:
- [Controller board basement assembly](docs/MC_CASE_ASSEMBLY.md)
- [Motors mount assembly](docs/HEAD_MOUNT_ASSEMBLY.md)
### Desktop application
The latets binary file can be downloaded from the [Releases](https://github.com/Mercuso/headpat-vr/releases) section
Alternatively, you can build it locally. Download repository, install Python and execute the `build.bat` file. The executable file will be located in the `dist` folder
### Preparing VRChat avatar
Follow the instructions described in the Patstrap project documentation's VRChat section:
https://github.com/danielfvm/Patstrap?tab=readme-ov-file#vrchat
### Settings in VRChat
[Enable OSC support in VRChat](https://docs.vrchat.com/docs/osc-overview#enabling-it)