vrcosc-magicchatbox

🪄 What it looks like in-game

VRChat gives you a 144-character chatbox above your head. You pick which integrations fill it, and MagicChatBox assembles them into one line.

Here is the same chatbox with four different setups — the toggles on the left, what VRChat shows on the right:

🎵  Music Display  +  Lyrics

▶ Ado — Show ♥        ♪ 世界中の誰よりきっと

_{The track you’re playing, and the lyric line as it’s sung.}

📡  VRChat Radar  +  Heart Rate  +  Time  +  Weather

👑 🌎 The Great Pug | 👥 24/40 | friends+ US-West     ♥ 82 bpm     21:41 CEST 🌧 14°C

_{Where you are, how full it is, your pulse, and your local time and weather.}

🖥️  Component Stats  +  Network  +  Tracker Battery

CPU 34% ¦ GPU 62°C ¦ RAM 41%      ↓ 842 Mbps      🔋 HMD 62% · L 41% · R 88%

_{Your rig at a glance — and a warning before a tracker dies mid-session.}

💭  Personal Status  +  Window Activity  +  Soundpad

💭 back in 5       On desktop ⁱⁿ Blender       🎶 'airhorn.mp3'

_{Your own message, what you’re busy with, and the sound you just played.}

[!TIP] Mix and match freely. Every integration is an independent toggle, and each one has separate VR and Desktop switches — so your chatbox can show your specs at your desk and your heart rate in the headset, automatically.

Run out of room? MagicChatBox doesn’t cut your text off mid-word. It drops the least important pieces first — the queue, then the volume, then the device — and keeps the things you actually care about, like the song title.

⚙️ How it works

New to this? It’s four steps, and MagicChatBox does three of them.

🧍 The second arrow: your avatar can react

The same connection can send numbers to your avatar instead of text. If your avatar is set up for it, your heart rate can drive a blush that deepens as your pulse rises, or a heart that beats in time with the real thing.

You don’t need this to use MagicChatBox — the chatbox works on its own. But if you build avatars, it’s there. See the Heart Rate guide for the full list of values you can hook up.

[!IMPORTANT] You NEED to ENABLE OSC inside VRChat in order to have the program working!
Open your action menu with R → Options → OSC → Enabled.

[!TIP] No headset? MagicChatBox works in desktop mode too — and it can run on a spare PC and send to a Quest over your network with Standalone setup.

[!IMPORTANT] We highly recommend reading our Terms of Service before you download or use MagicChatBox.
It doesn’t take long to get through the essential points, but it’s important to understand how we value and protect your privacy, as well as the rules for using our software.

Every name below links to a full guide covering all of its settings.

[!IMPORTANT] Heart Rate requires an official Pulsoid Member subscription.
MagicChatBox users get 15% off the Pulsoid BRO Plan.

🔐 Your data stays yours

MagicChatBox never quietly starts reading things. To show your GPU temperature it has to read your sensors; to show your music it has to read what Windows is playing. So it asks first — and it asks for one specific thing at a time, not blanket access.

How the permission prompt works

What each permission covers

Most of it never leaves your PC

Only 🌐 Internet Access involves the network at all — and each integration that has it only ever contacts its own service. Spotify talks to Spotify; Lyrics talks to LRCLIB. Nothing is pooled, and nothing is sent anywhere else.

[!NOTE] Two are worth a moment’s thought before you enable them in a public instance. Window Activity reads window titles, which often contain document names or video titles — so it has per-app privacy settings and content filters. VRChat Radar reads who joins and leaves your instance; it stays on your PC, but it is other people’s presence.

Read the full permissions breakdown →

📚 Additional Resources

Building with Voicemod Control

Voicemod’s Control API needs a client key, which you request from Voicemod through their form. There are two ways to supply one.

In the app. Open Options → Voicemod → Client key, paste the key and save it. It is stored with Windows DPAPI for your Windows user only, and it takes priority over any key baked into the build. This is the path for anyone running a build from source, and it needs no rebuild.

At build time. Pass the key as an MSBuild property so it is embedded as assembly metadata:

dotnet publish vrcosc-magicchatbox\MagicChatbox.csproj -c Release -r win-x64 --self-contained false -p:VoicemodClientKey=YOUR_KEY

Official releases do this from a repository secret named VOICEMOD_CLIENT_KEY, so the key never reaches source control. Builds without a key still work — Voicemod control simply reports that no key is configured until one is saved in Options.

Legal Notice

[!IMPORTANT] Legal Notice
MagicChatBox is released under a custom, source‑available proprietary license. Please review the following legal documents for important information regarding the use, modification, and distribution of MagicChatBox:

• Software License Agreement (SLA)
  This agreement outlines the rights and restrictions for modifying, redistributing, or creating derivative works of MagicChatBox. Any modifications or forks must include this SLA and the accompanying Terms of Service.

• Terms of Service (TOS)
  These terms govern your conduct and usage of MagicChatBox. By running the software, you agree to abide by these Terms, which help maintain a respectful, safe, and lawful user experience.

By using MagicChatBox, you confirm that you have read, understood, and agree to be bound by these legal documents. If you do not agree, you are not permitted to use the software.