{"id":13783627,"url":"https://github.com/cyberkitsune/vrc-osc-scripts","last_synced_at":"2025-10-23T15:31:49.082Z","repository":{"id":147690207,"uuid":"529411407","full_name":"cyberkitsune/vrc-osc-scripts","owner":"cyberkitsune","description":"VRChat Chatbox OSC scripts for speech to text and audio now playing","archived":false,"fork":false,"pushed_at":"2024-02-20T00:17:49.000Z","size":19566,"stargazers_count":121,"open_issues_count":11,"forks_count":17,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-01-30T19:12:36.670Z","etag":null,"topics":["osc","python","vrchat"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyberkitsune.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-08-26T21:38:13.000Z","updated_at":"2025-01-15T15:54:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"62bcb640-8c74-4d8d-9c40-8ade40b3f014","html_url":"https://github.com/cyberkitsune/vrc-osc-scripts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberkitsune%2Fvrc-osc-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberkitsune%2Fvrc-osc-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberkitsune%2Fvrc-osc-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberkitsune%2Fvrc-osc-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyberkitsune","download_url":"https://codeload.github.com/cyberkitsune/vrc-osc-scripts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237852407,"owners_count":19376675,"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","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","python","vrchat"],"created_at":"2024-08-03T19:00:26.921Z","updated_at":"2025-10-23T15:31:44.021Z","avatar_url":"https://github.com/cyberkitsune.png","language":"Python","funding_links":[],"categories":["Tutorials"],"sub_categories":["OSC"],"readme":"# vrc-osc-scripts\nThis repo contains various python OSC helper scripts that I made for VRChat, mostly stuff that interacts with the new chatbox api!\n\nFor additional feedback or help feel free to join [the Discord!](https://discord.gg/xKR4UbXS7Z)\n\nAll these scripts require python3 and use pip for dependency management unless otherwise specified.\n\n**Be sure to enable OSC in your VRChat radial menu before using these scripts!**\n\nIf you don't have python installed already, and you are running Windows, get it [from here](https://www.python.org/ftp/python/3.10.6/python-3.10.6-amd64.exe) **and be sure to click \"Add Python to environment variables\"** in the installer (Under Customize Install -\u003e Advanced Options)\n\nIf you want a quick video tutorial on how to use these scripts, check this [video I made](https://www.youtube.com/watch?v=y9XOGtOaIV8)!\n\n## VRCSubs\nThis script attempts to auto-transcribe your microphone audio into chat bubbles using the Google Web Search Speech API (via the `SpeechRecognition` package) -- It's considered a prototype and has many issues, but is kinda neat!\n\n![VRCSubs in action!](https://raw.githubusercontent.com/cyberkitsune/vrc-osc-scripts/main/img/subtitles.gif)\n\n### Usage\n#### Auto\nIf you're on windows, try double-clicking `RunVRCSubs.bat` after installing python!\n\n#### Manual\nFirst, install deps:\n```\npip install -r VRCSubs/Requirements.txt\n```\n\nThen, get in VR and launch the game, and **ensure your headset mic / mic you use is your default in windows!** (Setting a specific mic isn't supported yet)\n\nLast, run the script\n```\npython VRCSubs/vrcsubs.py\n```\n\nThe script should start listening to you right away and will send chatbox messages as you speak!\n\n### OSC Avatar Control\nYou don't _need_ any avatar-specific setup to use VRCSubs! But if you'd like you can add some additional paramaters to make controlling it easier. For more information check out: [VRCSubs OSC Avatar Toggle Setup](https://github.com/cyberkitsune/vrc-osc-scripts/wiki/VRCSubs-OSC-Avatar-Toggle-Setup)\n\n### Configuration\nSome options can be configured in `VRCSubs/Config.yml` -- Just edit that file and check the comments to see what the options are!\n\n#### Translation\nThere is a prototype live translation function in VRCSubs. It's considered a prototype and the output may not be very useful, but if you with to try it adjust the options `EnableTranslation` and `TranslateTo` in `VRCSubs/Config.yml`!\n\n### To-do\n- [x] ~~Make the hacky audio-chunking I use cut off words less~~\n- [ ] Consider alternative Speech-to-text API\n- [ ] Support swaping listened to / translated language via OSC input\n- [ ] Make a self-updating standalone exe\n- [ ] Support OSCQuery when it's out\n- [x] ~~Communicate VRC mic mute status~~\n- [ ] Support non-default mic / better handle mic switching\n- [X] ~~Support VRC's chatbox rate-limit~~\n- [x] ~~Add gif of this in action to this README~~\n\n\n## VRCNowplaying\nThis script broadcasts what you're currently listening to your chatbox, grabbing the data from the Windows MediaManager API.\n\n![VRCNowplaying in action!](https://raw.githubusercontent.com/cyberkitsune/vrc-osc-scripts/main/img/nowplaying.gif)\n\n### Usage\n#### Auto\nIf you're on windows, try double-clicking `RunVRCNowPlaying.bat` after installing python!\n\n#### Manual\nFirst, install deps:\n```\npip install -r VRCNowPlaying/Requirements.txt\n```\n\nThen, just run the Script\n```\npython VRCNowPlaying/vrcnowplaying.py\n```\n\nNow, listen to some music and watch your chatbox!\n\n### Config\nSome options can be configured in `VRCNowPlaying/Config.yml` -- Just edit that file and check the comments to see what the options are!\n\n### To-do\n- [x] ~~Support customizing output format via yml~~\n- [x] ~~Gif of this working~~\n- [ ] Anything else?\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberkitsune%2Fvrc-osc-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyberkitsune%2Fvrc-osc-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberkitsune%2Fvrc-osc-scripts/lists"}