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.

New Feature

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.
Launch Order

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

  1. Launch Voicemod

    Open Voicemod and ensure it is running in the system tray or foreground.

  2. Open Voicemod Settings in VMSC

    In VMSC, navigate to Outputs > Voicemod.

  3. Connect

    Click Connect. VMSC opens a WebSocket connection to ws://localhost:59129/v1/. A green status indicator confirms the connection is active.

  4. 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.

  5. 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 robot to 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.
Combine with TTS

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.