{"id":15138810,"url":"https://github.com/hyroevrc/tiktoktooscvrchat","last_synced_at":"2025-08-21T07:39:25.399Z","repository":{"id":241457509,"uuid":"806815216","full_name":"HyroeVRC/TiktokToOSCVRChat","owner":"HyroeVRC","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-27T21:06:04.000Z","size":40527,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T17:52:29.955Z","etag":null,"topics":["osc","tiktok","vrchat"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HyroeVRC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-28T00:54:36.000Z","updated_at":"2024-10-27T21:06:07.000Z","dependencies_parsed_at":"2024-10-27T22:43:50.910Z","dependency_job_id":null,"html_url":"https://github.com/HyroeVRC/TiktokToOSCVRChat","commit_stats":{"total_commits":30,"total_committers":2,"mean_commits":15.0,"dds":0.4666666666666667,"last_synced_commit":"43f741e084a6006ac8cec3bcb056a32ab5a7be88"},"previous_names":["hyroevrc/tiktoktooscvrchat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HyroeVRC/TiktokToOSCVRChat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HyroeVRC%2FTiktokToOSCVRChat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HyroeVRC%2FTiktokToOSCVRChat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HyroeVRC%2FTiktokToOSCVRChat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HyroeVRC%2FTiktokToOSCVRChat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HyroeVRC","download_url":"https://codeload.github.com/HyroeVRC/TiktokToOSCVRChat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HyroeVRC%2FTiktokToOSCVRChat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271446468,"owners_count":24761312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["osc","tiktok","vrchat"],"created_at":"2024-09-26T07:44:42.809Z","updated_at":"2025-08-21T07:39:25.364Z","avatar_url":"https://github.com/HyroeVRC.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔴 How People Can Interact With My Avatar In Live ? 👥\n\n![Group 564](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/fc085160-6bb6-41eb-a3e1-0c737d851392)\n\n# Hey there, it's Hyroe ! :3\n\nWelcome! I'll guide you through how your audience on TikTok Live can interact with your avatar on VRChat.\n\n## 1. Link TikTok Chat and Send it to the OSC Server\n\n### Step 1 : Download PyCharm Community\n\n➥ Download PyCharm Community from this link : [Download](https://www.jetbrains.com/pycharm/download/download-thanks.html?platform=windows\u0026code=PCC)\n\n### Step 2 : Set Up a New Python Project\n\n➥ Create a new Python project and a Python file within the project folder.\n\n![New Project](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/983f4efb-e8aa-4b4a-a22f-8c6d1c4c356b)\n![Create Python File](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/e8fccf90-bea9-4789-bfa1-5dd68f568ac3)\n\n### Step 3 : Install Necessary Libraries\n\n➥ Copy and paste the provided code and install the required libraries:\n\n- Install the `TiktokLive` package :\n\n  ![Install TiktokLive](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/4597f5a0-6f6a-447b-8261-60fee8fabf33)\n\n- Import the `python-osc` package from GitHub :\n\n  ![Import python-osc](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/c7d4fa9b-0182-4f69-a528-291f2a9bcf48)\n\n### Step 4 : Configure Your TikTok Name Tag\n\n➥ Set your TikTok name tag (e.g., `@hyroe`) at line 51 in the code and run the Python program when you go live.\n\n![Set TikTok Name](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/100a0e86-8733-46ae-927f-052b550b4581)\n\n## 2. Link Parameters in Your `.Json` File\n\nWith 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.\n\n### Step 1 : Understand OSC Parameters\n\n➥ Read the official VRChat documentation on OSC parameters: [OSC Avatar Parameters](https://docs.vrchat.com/docs/osc-avatar-parameters)\n\n### Step 2 : Copy Your Avatar's Blueprint ID\n\n➥ Copy the Blueprint ID from the Pipeline Manager component of your avatar in Unity.\n\n![Blueprint ID](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/24a76fe5-8c09-4d54-9ab6-4e35a7a5a23b)\n\n### Step 3 : Modify the `.json` File\n\n➥ Navigate to `C:\\Users\\YourName\\AppData\\LocalLow\\VRChat\\VRChat\\OSC`, search for your Blueprint ID, and open the corresponding `.json` file.\n\n![Open JSON File](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/aeea7185-e6a8-48ce-b9f0-ce510e7440cb)\n\n➥ Add the new parameter `BoopToggle`:\n\n```json\n{\n  \"name\": \"BoopToggle\",\n  \"input\": {\n    \"address\": \"/avatar/parameters/BoopToggle\",\n    \"type\": \"Boolean\"\n  },\n  \"output\": {\n    \"address\": \"/avatar/parameters/BoopToggle\",\n    \"type\": \"Boolean\"\n  }\n}\n```\n\n### Step 4 : Check Parameter Type\n\n➥ Ensure the `BoopToggle` parameter in your Unity project is set as a Boolean. If not, change the type accordingly.\n\n## 3. Test On VRChat :3\n\n### Step 1 : Enable OSC Server\n\n➥ Enable the OSC server in VRChat.\n\n![Enable OSC](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/3411ea1b-76cd-4bc1-b9fe-a91c14ae7df7)\n![OSC Server](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/78359d0e-7062-4bb9-b16a-b3816f448580)\n\n### Step 2 : Run Your Code\n\n➥ Start your TikTok Live and run your Python program. You should see interactions reflected in your OSC Debug Panel.\n\n![OSC Debug Panel](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/5b4cf95a-1ff3-4b30-a78a-72b157a58a08)\n![Debug Panel](https://github.com/HyroeVRC/TiktokToOSC/assets/170990155/9524090b-ffe9-4c01-90c9-57908f367a52)\n\n\u003e Note : If it doesn't work for some people during your live, feel free to reach out for assistance!\n\nHave a wonderful day/night !\n\n➥ Follow me on my socials:\n\n- [TikTok](https://www.tiktok.com/@hyroe)\n- [X](https://x.com/_Hyroe_)\n- [Instagram](https://www.instagram.com/hyroevr/)\n\nBoop from Hyroe :3\n\n\n![ttov0 3](https://github.com/user-attachments/assets/3340da5c-93dd-42c7-b6ac-850850c0fb34)\n\n![updates](https://github.com/user-attachments/assets/ecb1128f-a351-4c3e-bae2-970597da4cf8)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyroevrc%2Ftiktoktooscvrchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyroevrc%2Ftiktoktooscvrchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyroevrc%2Ftiktoktooscvrchat/lists"}