Social Stream Ninja - TTS Voice Guide

Overview

Social Stream Ninja offers multiple Text-to-Speech (TTS) options, from free system voices to premium services. This guide covers everything you need to know about configuring and using TTS effectively.

Quick Start: Add ?speech=en-US to your URL to enable English TTS

Where is TTS Used?

Social Stream Ninja: Reads out messages from audiences in multiple areas
CAPTION.Ninja: Offers closed-captioning, transcription, and translation with TTS
Both services offer premium and free TTS options

Free TTS Limitations:

OBS browser sources cannot capture system TTS audio directly
Requires complex audio routing solutions
Limited browser support (Opera, Firefox may lack TTS)
Premium services are recommended for easier integration

TTS Provider Options

System TTS (Free)

Uses your operating system's built-in voices
Limited language support based on system installation
Audio plays through system speakers - requires special capture methods
Browser compatibility varies significantly

Premium TTS Options (Direct Browser Audio)

Provider	Cost	OBS Capture	Features
Kokoro TTS	Free	Direct	Browser-based, requires powerful computer
Google Cloud	API costs apply	Direct	Professional quality, multiple languages
ElevenLabs	Free tier available	Direct	Custom voice training, natural sounding
Speechify	API costs apply	Direct	High-quality voices, multiple languages

Browser Support

Chrome

✓ Full Support

Google-powered voices + system voices

Edge

✓ Full Support

Microsoft voices + Windows TTS packs

Firefox

⚠ Limited Support

Local system languages only

Opera

✗ No Support

May lack TTS functionality

Browser Limitations:

Not all browsers support text-to-speech (Opera, some Firefox versions)
Chrome offers Google-powered TTS options
Edge supports Microsoft TTS and Windows service pack add-ons
Safari requires user interaction to start audio
Check available voices for your browser

Windows TTS Audio Capture Methods for OBS

Premium TTS Services (Recommended)

All premium services play audio directly through the browser:

Simply enable "Control audio via OBS" in browser source
No virtual audio cables needed
Works with SSN app and OBS browser sources

System TTS Capture Methods

Important: OBS Studio's browser source cannot capture system-level TTS audio directly. This limitation affects all browsers and requires special audio routing methods.

Free text-to-speech comes with limitations:

Cannot be captured directly by OBS browser sources
Limited support across browsers (Opera, Firefox may lack TTS)
Chrome offers Google-powered options, Edge has Microsoft options
Requires complex audio routing for capture

Method 1: Default Audio Route (Most Common)

1. Set Virtual Cable as Windows default output - Sound Settings > Output > Virtual Cable 2. OBS: - Add Audio Input Capture - Source: Virtual Cable - Monitor: Monitor Only

Method 2: Windows 10 App Route

1. Sound Settings > App volume and device preferences 2. Find browser in list 3. Output: Virtual Cable 4. OBS setup same as Method 1

Method 3: Windows 11 App Route

1. Settings > System > Sound > Volume Mixer 2. Locate browser 3. Output: Virtual Cable 4. OBS setup same as Method 1

Method 4: Audio Router Software

1. Install Audio Router 2. Route browser to Virtual Cable 3. OBS setup same as Method 1

Method 5: Voicemeeter (Advanced)

1. Install Voicemeeter 2. Set as Windows default output 3. Route: - Hardware out > speakers - Virtual out > OBS 4. OBS captures Voicemeeter output

Testing Your Setup

1. Play TTS 2. Check OBS meter 3. Verify system audio 4. Adjust levels if needed

Alternatives: If these methods don't work, consider using premium options (Google Cloud, ElevenLabs, Speechify) or explore self-hosted open-source TTS solutions.

Installing Additional Language Packs

Windows 11

Navigate to Start > Settings > Time & Language > Speech
Under Manage Voices, click Add Voices
Select desired languages and click Add
Restart browsers to refresh available voices

Windows 10

Follow Microsoft's official guide for installing language packs.

Tip: Some third-party voices may not appear in browsers due to compatibility issues. Firefox often shows more system voices than Chromium-based browsers.

URL Parameters for TTS Configuration

Basic Parameters

Parameter	Description	Example
&speech	Enable TTS with language code	&speech=en-US
&pitch	Voice pitch (0.1 to 2.0)	&pitch=1.2
&volume	Volume level (0.0 to 1.0)	&volume=0.8
&rate	Speaking rate (0.1 to 10.0)	&rate=1.5
&voice	Partial voice name match	&voice=google
&ttsprovider	Select provider (system/kokoro/elevenlabs/google/speechify)	&ttsprovider=kokoro

Advanced Parameters

Parameter	Description
&simpletts	Don't say "says" or "someone says"
&simpletts2	Don't read chatnames at all
&ttscommand	Enable custom TTS command (default: !say)
&readevents	Include stream events in TTS
&skipmessages=3	Read every 3rd message only

Premium TTS Service Configuration

Kokoro TTS (Free, Browser-based)

Enable with ?ttsprovider=kokoro
Requires powerful computer
Works directly with OBS browser source
Voice selection: &voicekokoro=af_bella
Speed control: &kokorospeed=1.2

Google Cloud TTS

Enable with ?ttsprovider=google&ttskey=YOUR_API_KEY
Professional quality voices
Voice selection: &voicegoogle=en-GB-Standard-A
Language: &googlelang=en-US

ElevenLabs TTS

Enable with ?ttsprovider=elevenlabs&elevenlabskey=YOUR_API_KEY
Voice ID: &voice11=YOUR_VOICE_ID
Model: &elevenlabsmodel=eleven_multilingual_v2
Parameters: stability, similarity, style can be adjusted

Speechify TTS

Enable with ?ttsprovider=speechify&speechifykey=YOUR_API_KEY
Voice: &voicespeechify=henry
Model: &speechifymodel=simba-english

Troubleshooting

Common Issues

No audio playing: Click on the page first - browsers require user interaction for audio
Voices not showing: Restart browser after installing language packs
OBS not capturing: For system TTS, use one of the capture methods above
Safari issues: Safari has limited automatic TTS support
Premium service not working: Check API key and ensure provider is correctly specified

Best Practices

Use premium TTS services for easiest OBS integration
Test your setup with simple phrases before going live
Consider user-generated content risks with TTS
Have a toggle to quickly disable TTS if needed

Test Your Browser's TTS Support

Click the button below to see available voices in your browser: