Troubleshooting Guide

Solutions to common issues with Vox Mimica.

Connection Issues

Bot Won't Connect to Discord

Symptoms: Connection status shows red, bot doesn't join voice channel

Solutions:

  1. Verify bot is installed

    • Check your Discord server member list
    • Bot should appear as "Vox Mimica Bot"

  2. Check permissions

    • Ensure you have permission to invite users
    • Verify voice channel isn't full
    • Check bot has Connect permission

  3. Try manual connection

    • Enable Developer Mode in Discord (User Settings -> Advanced)
    • Right-click server name -> Copy Server ID
    • Right-click voice channel -> Copy Channel ID
    • Use Manual Connection in Vox Mimica

  4. Restart the connection

    • Disconnect
    • Wait 10 seconds
    • Reconnect

OAuth Redirect Errors

Symptoms: "Redirect URI mismatch" after login

Solutions:

  1. Make sure you're logged into Discord in your browser
  2. Allow pop-ups for the Vox Mimica site
  3. Clear browser cache and cookies
  4. Try manual connection instead
  5. Check you're using the correct Discord account

Audio Issues

No Audio Playing in Discord

Symptoms: Bot connects but no audio plays

Solutions:

  1. Check Discord settings

    • Open Discord User Settings -> Voice & Video
    • Enable Voice Activity
    • Check input/output devices
    • Adjust input sensitivity

  2. Verify unmuted

    • Check you're not muted in Discord
    • Check bot isn't muted
    • Verify server/channel-wide mute isn't active

  3. Browser permissions

    • Allow microphone access in browser
    • Check browser isn't blocking audio
    • Try different browser (Chrome recommended)

  4. Test with different channel

    • Try a different voice channel
    • Create a new test channel
    • Verify region settings

Voice Quality Problems

Symptoms: Voice sounds robotic, choppy, unclear, or distorted

Solutions:

  1. Adjust voice settings

    Recommended:
- Stability: 0.5
- Similarity: 0.8
- Style: 0.0 (or 0.5)
- Speaker Boost: Enabled

  2. Try different model

    • Switch to Eleven Multilingual v2 (higher quality)
    • Use Eleven Flash v2.5 (lower latency)
    • Test Eleven Turbo v2.5 (balance)

  3. Improve input quality

    • Use better microphone
    • Reduce background noise
    • Speak clearly and at normal pace
    • Don't speak too close to mic

  4. Check internet connection

    • Run speed test (need 5+ Mbps upload)
    • Close bandwidth-heavy applications
    • Use wired connection if possible
    • Restart router if issues persist

Echo or Feedback

Symptoms: Hearing your own voice back or feedback loop

Solutions:

  1. Use headphones (prevents mic picking up speakers)
  2. Mute yourself while not speaking
  3. Reduce Discord output volume
  4. Check Echo Cancellation in Discord settings

Character Issues

Character Not Saving

Symptoms: Created character disappears after refresh

Solutions:

  1. Verify you're logged in (check top-right)
  2. Check internet connection is stable
  3. Look for errors in browser console (F12)
  4. Try creating with shorter name (< 50 characters)
  5. Refresh page and try again

Can't Edit Character

Symptoms: Edit button doesn't work or changes don't save

Solutions:

  1. Refresh the page
  2. Check internet connection
  3. Try deleting and recreating
  4. Clear browser cache
  5. Try different browser

Performance Issues

Slow Voice Transformation

Symptoms: Long delay between speaking and audio playing

Solutions:

  1. Use S2S mode instead of STT-TTS
  2. Speak shorter phrases (< 10 seconds)
  3. Check internet speed
    • Need 5+ Mbps upload/download
    • Close other applications
  4. Use recommended models
    • Eleven Flash v2.5 (fastest)
    • Eleven Turbo v2.5 (good balance)

Browser Performance

Symptoms: Browser sluggish, high CPU usage

Solutions:

  1. Close unnecessary browser tabs
  2. Close other applications
  3. Use Chrome or Edge (better performance)
  4. Disable browser extensions
  5. Restart browser

Rate Limiting

Hit Rate Limit

Symptoms: "Rate limit exceeded" error

Solutions:

  1. Wait for reset

    • TTS: Resets every 15 minutes
    • STT: Resets every 15 minutes
    • Voice Generation: Resets hourly

  2. Reduce frequency

    • Use longer phrases (fewer requests)
    • Don't spam preview button
    • Plan your character usage

  3. Upgrade plan

    • Pro tier has higher limits
    • Enterprise has custom limits

Error Messages

"Authentication Failed"

  1. Sign out and sign back in
  2. Clear browser cookies
  3. Check you're using correct Google account
  4. Try incognito/private mode

"Failed to Load Voices"

  1. Check internet connection
  2. Refresh the page
  3. Clear browser cache
  4. Try again in few minutes (API may be down)

"WebSocket Connection Failed"

  1. Check firewall isn't blocking WebSocket
  2. Disable VPN temporarily
  3. Try different network
  4. Check corporate firewall settings

Still Having Issues?

Get Help

  1. Check documentation

  2. Community support

  3. Report bugs

  4. Contact support

    • Email: support@voiceforge.com
    • Include error messages and screenshots

Information to Include

When reporting issues, include:

  • What you were trying to do
  • What happened instead
  • Steps to reproduce
  • Browser and OS version
  • Screenshots of errors
  • Console errors (F12 -> Console)