Overview
Voicemod integration lets VMSC control the Voicemod voice changer application in real time through its local WebSocket API. When a viewer sends a gift, follows, or triggers a chat command, VMSC can switch your voice effect, toggle the voice changer on or off, play a soundboard clip, or pick a random voice — adding an interactive audio layer to your stream.
VMSC connects to Voicemod at ws://localhost:59129/v1/ and maintains the connection with automatic ping/pong keep-alive.
Voicemod integration was introduced in VMSC v1.2.55. Make sure you are running this version or later to access Voicemod controls.
Prerequisites
Before configuring the Voicemod integration in VMSC, ensure the following:
- Voicemod installed — Download and install Voicemod from the official website.
- Voicemod running — Voicemod must be open and running before VMSC attempts to connect. The WebSocket server is only available while Voicemod is active.
- Voicemod license — Some voices and soundboard features require a Voicemod Pro license. Free Voicemod users have access to a limited voice rotation.
Voicemod must be running before you click Connect in VMSC. If Voicemod is launched after VMSC, click the Reconnect button in the Voicemod output settings to establish the connection.
Setting Up Voicemod
-
Launch Voicemod
Open Voicemod and ensure it is running in the system tray or foreground.
-
Open Voicemod Settings in VMSC
In VMSC, navigate to Outputs > Voicemod.
-
Connect
Click Connect. VMSC opens a WebSocket connection to
ws://localhost:59129/v1/. A green status indicator confirms the connection is active. -
Verify Voice List
Once connected, VMSC fetches the full list of available voices from Voicemod. These appear in a searchable dropdown in the action editor.
-
Test
Select a voice from the list and click Test to switch to it. Speak into your microphone to verify the voice effect is applied.
Connection Details
| Property | Value |
|---|---|
| Protocol | WebSocket |
| Address | ws://localhost:59129/v1/ |
| Keep-Alive | Ping/pong frames sent automatically to maintain the connection |
| Reconnect | Manual reconnect button in the settings panel; VMSC does not auto-reconnect if Voicemod closes |
| Status Indicator | Green (connected), Red (disconnected), Yellow (connecting) — shown in the action editor and output settings |
Voicemod Actions
The following actions are available when adding a Voicemod action to a rule:
Switch Voice
Changes the active Voicemod voice to a specific voice selected from the searchable voice list.
- Voice list fetched dynamically from Voicemod
- Searchable dropdown in the action editor
- Takes effect immediately on the audio stream
Toggle Voice Changer
Turns the Voicemod voice changer on or off. When off, your natural voice passes through unmodified.
- Toggle on, toggle off, or flip (invert current state)
- Useful for "real voice reveal" moments
Play Soundboard
Plays a sound clip from the Voicemod soundboard. The sound is played through the Voicemod virtual microphone output.
- Select from available soundboard clips
- Audio routes through Voicemod's output device
Random Voice
Switches to a random voice from the available voice list. Creates unpredictable, entertaining voice changes.
- Picks from all enabled voices
- New random selection each trigger
Dynamic Voice List
When VMSC connects to Voicemod, it fetches the complete list of available voices. This list is displayed as a searchable dropdown in the action editor whenever you configure a Switch Voice action.
- Search — Type to filter voices by name.
- Live sync — If you install new voices in Voicemod, click Refresh Voices in the VMSC settings to update the list.
- Favorites — Voicemod Pro favorites are indicated in the list for quick identification.
Voicemod Actions in Rules
Voicemod is available as an action target in the Rules system. When adding an action to a rule, select Voicemod and choose from Switch Voice, Toggle Voice Changer, Play Soundboard, or Random Voice.
Example use cases:
- Gift alert — Switch to a funny voice for 30 seconds when a viewer sends a gift, then revert to the previous voice.
- Chat command — Let viewers type
!voice robotto switch your voice to the robot effect (with cooldown). - Follow alert — Play a soundboard clip through Voicemod when a new follower joins.
- Random voice roulette — On every subscription, switch to a random voice for an unpredictable effect.
Voicemod actions pair well with TTS. You could switch your live voice to a robot effect while TTS reads a gift alert in a completely different voice, creating a layered audio experience.
Troubleshooting
| Issue | Solution |
|---|---|
| Connection fails | Ensure Voicemod is running before clicking Connect. Check that no other application is using port 59129. |
| Voice list is empty | Click Refresh Voices after connecting. If still empty, restart Voicemod and reconnect. |
| Voice switch has no audible effect | Verify that Voicemod's voice changer is enabled (not bypassed). Check that your application (OBS, Discord, etc.) is using the Voicemod virtual microphone as its input device. |
| Connection drops intermittently | The ping/pong keep-alive should prevent disconnects. If drops persist, check for Voicemod updates or restart both applications. |
| Soundboard sounds are not heard | Soundboard audio routes through the Voicemod virtual output. Ensure your streaming software is capturing that audio source. |