https://github.com/hyroevrc/tiktoktooscvrchat
https://github.com/hyroevrc/tiktoktooscvrchat
osc tiktok vrchat
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/hyroevrc/tiktoktooscvrchat
- Owner: HyroeVRC
- Created: 2024-05-28T00:54:36.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-10-27T21:06:04.000Z (6 months ago)
- Last Synced: 2025-01-30T19:11:56.745Z (3 months ago)
- Topics: osc, tiktok, vrchat
- Language: Python
- Homepage:
- Size: 38.6 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔴 How People Can Interact With My Avatar In Live ? 👥

# Hey there, it's Hyroe ! :3
Welcome! I'll guide you through how your audience on TikTok Live can interact with your avatar on VRChat.
## 1. Link TikTok Chat and Send it to the OSC Server
### Step 1 : Download PyCharm Community
➥ Download PyCharm Community from this link : [Download](https://www.jetbrains.com/pycharm/download/download-thanks.html?platform=windows&code=PCC)
### Step 2 : Set Up a New Python Project
➥ Create a new Python project and a Python file within the project folder.

### Step 3 : Install Necessary Libraries
➥ Copy and paste the provided code and install the required libraries:
- Install the `TiktokLive` package :

- Import the `python-osc` package from GitHub :

### Step 4 : Configure Your TikTok Name Tag
➥ Set your TikTok name tag (e.g., `@hyroe`) at line 51 in the code and run the Python program when you go live.

## 2. Link Parameters in Your `.Json` File
With the OSC server, you can send and receive data. For example, if someone types "boop" in the TikTok chat, the `BoopToggle` parameter will be set.
### Step 1 : Understand OSC Parameters
➥ Read the official VRChat documentation on OSC parameters: [OSC Avatar Parameters](https://docs.vrchat.com/docs/osc-avatar-parameters)
### Step 2 : Copy Your Avatar's Blueprint ID
➥ Copy the Blueprint ID from the Pipeline Manager component of your avatar in Unity.

### Step 3 : Modify the `.json` File
➥ Navigate to `C:\Users\YourName\AppData\LocalLow\VRChat\VRChat\OSC`, search for your Blueprint ID, and open the corresponding `.json` file.

➥ Add the new parameter `BoopToggle`:
```json
{
"name": "BoopToggle",
"input": {
"address": "/avatar/parameters/BoopToggle",
"type": "Boolean"
},
"output": {
"address": "/avatar/parameters/BoopToggle",
"type": "Boolean"
}
}
```### Step 4 : Check Parameter Type
➥ Ensure the `BoopToggle` parameter in your Unity project is set as a Boolean. If not, change the type accordingly.
## 3. Test On VRChat :3
### Step 1 : Enable OSC Server
➥ Enable the OSC server in VRChat.

### Step 2 : Run Your Code
➥ Start your TikTok Live and run your Python program. You should see interactions reflected in your OSC Debug Panel.

> Note : If it doesn't work for some people during your live, feel free to reach out for assistance!
Have a wonderful day/night !
➥ Follow me on my socials:
- [TikTok](https://www.tiktok.com/@hyroe)
- [X](https://x.com/_Hyroe_)
- [Instagram](https://www.instagram.com/hyroevr/)Boop from Hyroe :3

