🎙️ AI Text-To-Speech

The AI Text-To-Speech (TTS) widget allows viewers to send messages that are read aloud on stream using AI-generated voices, including celebrity-style voices.

---

Overview

Viewers use the !tts command followed by their message. The message is converted to speech using advanced AI voice technology and plays through your stream overlay.

Default Cost: 5 Juice

---

How It Works

1. Viewer types: !tts Hello streamer!
2. Juice is deducted from their balance
3. AI generates the audio in your selected voice
4. Audio plays on your TTS overlay
5. Optional: Message broadcasts in chat

---

Settings

Basic Settings

Setting	Description	Default
Cost	Juice per TTS message	5
Enabled	Master toggle for TTS	On
Broadcast to Chat	Announce TTS in chat	Off

Voice Selection

Citrus offers 25+ AI voices including:

Standard Voices

• Male/Female natural voices
• Various accents (British, Australian, etc.)

Celebrity-Style Voices

• SpongeBob
• Kanye West
• Morgan Freeman
• Donald Trump
• And many more!

Voice Modifiers

• Pitch adjustment
• Speed control

To select voices:

1. Go to Widgets → TTS
2. Find the Available Voices section
3. Toggle voices ON/OFF to allow viewers to use them

Viewer Voice Selection

Viewers can specify a voice with: !tts voice:spongebob Hello!

Or use the short format: !tts -spongebob Hello!

---

Content Filtering

Profanity Filter

Enable the built-in profanity filter to automatically block inappropriate words:

1. Go to TTS settings
2. Toggle Use Basic Filter to ON

Custom Word Filter

Add your own blocked words and phrases:

1. Go to Chat Bot → Moderation
2. Find Blacklist section
3. Add words/phrases to block

Blocked words will:

• Prevent the TTS from playing
• Not charge the viewer Juice
• Optionally timeout the user

---

Setup Instructions

Step 1: Enable TTS

1. Go to Widgets → TTS in your dashboard
2. Ensure the Enabled toggle is ON
3. Set your desired Juice cost

Step 2: Add Overlay to OBS

1. Copy the TTS overlay URL from the dashboard
2. In OBS, add a Browser Source
3. Paste the URL
4. Set dimensions: 1920 x 1080 (recommended)
5. Enable "Refresh browser when scene becomes active"

Step 3: Configure Voices

1. In TTS settings, scroll to Available Voices
2. Enable the voices you want viewers to use
3. Optionally set a default voice

---

Commands

Command	Description
!tts <message>	Send a TTS message (default voice)
!tts voice:name <message>	Send TTS with specific voice
!tts -name <message>	Short format for voice selection

Voice Command Examples

!tts Hello everyone!
!tts voice:spongebob I'm ready!
!tts -morgan Welcome to the stream

---

Troubleshooting

TTS Not Playing

Issue	Solution
Overlay not showing	Check browser source URL is correct
No audio	Ensure browser source audio is enabled in OBS
Command ignored	Verify widget is enabled in dashboard
"Insufficient Juice"	Viewer needs to purchase more Juice

Audio Quality Issues

• Check your internet connection
• Ensure the overlay isn't being blocked by ad blockers
• Try refreshing the browser source

Voices Not Available

• Verify voices are enabled in your dashboard
• Check that the voice name is spelled correctly in the command

---

Best Practices

1. Set Appropriate Costs: Higher costs reduce spam but may decrease engagement
2. Enable Filters: Always use the profanity filter for public streams
3. Test Before Streaming: Use the Test button to verify audio is working
4. Monitor the Queue: Keep dashboard open to see incoming TTS messages
5. Limit Voices: Don't enable all voices—curate a selection that fits your stream

---

FAQ

Q: Can I preview voices before enabling them? A: Yes! Use the Test button next to each voice in the settings.

Q: What happens if a TTS message is filtered? A: The message won't play and the viewer won't be charged.

Q: Can I change the TTS cost mid-stream? A: Yes, changes take effect immediately.

Q: Is there a character limit? A: Messages are limited to 500 characters by default.