Voicemod

Voicemod

Play sounds and switch voices without leaving VRChat.

The Voicemod integration puts your Voicemod soundboard on the Integrations page, so you can fire a sound with one click instead of alt-tabbing out of VR. It can also switch your voice, mute the mic, and tell the room what you just played.

---

What do I need?

1. Voicemod, installed and running, with its Control API available.
2. A Voicemod client key for this Windows user.
3. The 🎙️ Voicemod Control permission, which MagicChatbox asks for when you enable the integration.

Important

This integration needs the 🎙️ Voicemod Control permission. Without it MagicChatbox will not even try to connect, and the Options section says so. You can grant it later under Options → Privacy.

---

Getting a client key

• Voicemod's Control API only accepts connections from apps that present a client key. Voicemod issues these on request — ask them for one for MagicChatbox.

• Paste it into Options → Voicemod → Client key and save it. It is stored using Windows encryption, tied to your Windows user, and never leaves your machine.

Note

Official builds of MagicChatbox already carry a key. The Client key box exists for people building MagicChatbox themselves, and for anyone who has their own key. A key you save always takes priority over the one built in.

---

The three features

• Voicemod is split into three parts, and you can switch off the ones you never use. This is not cosmetic — MagicChatbox stops asking Voicemod about a switched-off feature entirely, so a soundboard-only setup never loads your voice list at all.

Feature	Default	What it gives you
Soundboard	On	The sound blobs, search, favourites, boards and paging
Voice	Off	Your voice list, with the active voice highlighted
Mic	Off	Mute, hear-myself and voice-changer switches

Tip

If you switch all three off, MagicChatbox stays connected but has nothing to show. Turn one back on, or switch the integration off from its tile.

---

The soundboard

• The soundboard lives on the Integrations page tile, not in Options — it is meant to be reachable while you are in a world.

• Click a sound to play it. The play glyph appears when you hover; the ★ in the corner pins a sound to your favourites.

• Favourites work across every board. Voicemod itself has no favourite flag for sounds, so MagicChatbox keeps your pinned list locally. That is what lets a favourite survive you switching boards.

• Scopes are the chip row above the sounds: ★ for your favourites, All for everything, then one chip per board. With a lot of boards that row scrolls sideways — ★ and All stay pinned in place so they can never scroll out of reach.

• Sorting is either Recent or A-Z. Under A-Z an alphabet row appears, which jumps straight to the page a letter starts on.

Note

Switching boards inside MagicChatbox only changes what you are looking at. Voicemod's Control API has no way to change its own active board, so this cannot drive Voicemod. If you switch board inside Voicemod, MagicChatbox follows along — unless you are looking at ★ or All, which it leaves alone.

---

Making a big library usable

• Under Options → Voicemod → Soundboard layout:

  1. Sounds per page — between 8 and 96. More per page means less clicking and a taller panel.
  2. Show thumbnails — artwork is fetched from Voicemod one page at a time. Turn it off and sounds become plain labels, with nothing extra asked of Voicemod.
  3. Compact blobs — smaller sound buttons, so more fit before you have to page.
  4. Show the board strip — hide it if you only ever use one board. Search, favourites and paging all stay.

Tip

A library of a few hundred sounds is normal and works fine. If it feels slow, turn thumbnails off first — that is the setting that costs the most.

---

Telling the room what you played

• Under Options → Voicemod → Chatbox output:

1. Announce sounds — when you start a sound from MagicChatbox, its name goes in the chatbox, in the same format Soundpad uses.
2. Show for — how long it stays, between 2 and 15 seconds.
3. Announce the active voice — stays in the chatbox for as long as a voice is active, and disappears when you go back to no effect.

🎶 'airhorn.mp3' · 🎙️ 'Robot'

Note

Sound announcements only fire for sounds you start from MagicChatbox. A sound triggered by a hotkey inside Voicemod is not announced, because the Control API does not report it.

Important

Each announcement also needs its own feature switched on. Announce the active voice does nothing while the Voice feature is off, and sound announcements need the Soundboard feature. This catches people who switch Voice off to keep things light and then wonder why the voice line never appears.

---

The DESKTOP and VR chips

• These decide where the chatbox announcement appears — nothing else.

• The soundboard, the voice list and the mic switches all keep working with both chips off. That is a legitimate setup: plenty of people want the buttons without telling the room anything.

---

How it works

• Voicemod exposes a local WebSocket Control API. MagicChatbox tries a list of ports Voicemod is known to use — starting at 59129 — until one answers, then authenticates with your client key.

• Everything is local. Nothing about your sounds, voices or usage is sent anywhere; the only traffic is between MagicChatbox and Voicemod on your own machine.

• The tile shows the connection state while this happens, including which port it is trying, so a failure tells you where it got to.

---

It will not connect

• Work through these in order.

  1. Is Voicemod running? The API only exists while it is.
  2. Was the permission granted? Check Options → Privacy for the 🎙️ Voicemod Control entry.
  3. Is there a client key? The Options section says plainly when there is not.
  4. Is the key the right one? A key is tied to the app it was issued for. If Voicemod refuses the connection, this is the usual reason.
  5. Is another app already using the API? Close anything else that talks to Voicemod and try again.

Tip

Restarting Voicemod after MagicChatbox is already running is fine — the integration keeps retrying and reconnects on its own.

---

Nothing is showing in the chatbox

1. Did you start the sound from MagicChatbox? Hotkeys pressed inside Voicemod are not announced.
2. Is Announce sounds on? It is on by default, but check.
3. Is a DESKTOP or VR chip lit? With neither lit there is no chatbox output, though the buttons still work.
4. Did it already disappear? The default is 8 seconds.

---

How do I get help?

• You can find help in our Discord Server by creating a ticket.

---