Speaker.bot TTS Setup¶
Streamer.bot kann Text-to-Speech via Speaker.bot ausgeben (separates Tool aus dem Streamer.bot-Ökosystem). Damit liest dein PC Donations, Bits-Messages oder Subs vor.
Doku: https://docs.streamer.bot/guide/integrations/speakerbot
Was ist Speaker.bot?¶
Eigenständige Anwendung von Streamer.bot-Devs für TTS. Bietet: - Mehrere Stimmen (Windows-TTS, Azure, ElevenLabs, etc.) - Voice-Aliase (z.B. "Bob", "Alice" als virtuelle Sprecher) - Bad-Word-Filter - Audio-Mixing - VoiceGate Profile
Läuft parallel zu Streamer.bot und kommuniziert via WebSocket.
Speaker.bot installieren¶
- Download: https://speaker.bot (gleicher Maintainer wie Streamer.bot)
- Installieren
- Beim ersten Start: Voice-Provider konfigurieren (Windows-TTS reicht für Anfänger)
Speaker.bot WebSocket aktivieren¶
In Speaker.bot:
1. Settings → WebSocket Server
2. Enable: ✅
3. Port: standardmäßig 7580 (kann geändert werden)
4. Password: optional
5. Apply
Verbindung in Streamer.bot¶
- Links Integrations → Speaker.bot
- Felder:
| Feld | Wert |
|---|---|
| Address | 127.0.0.1 (lokal) oder LAN-IP |
| Port | 7580 |
| Password | (wenn gesetzt in Speaker.bot) |
| Auto Connect | aktiv |
| Auto Reconnect | aktiv |
- Connect klicken
Status im SB-Pane: Connected = grün.
Voice-Aliase anlegen¶
In Speaker.bot:
1. Voices Tab
2. Pro Voice ein Alias vergeben (z.B. Default, Bob, Spongebob)
3. Voice-Provider auswählen (Windows: Microsoft Zira, Microsoft David, etc.)
4. Parameter: Speed, Pitch, Volume
Diese Aliase nutzt du in SB-Sub-Actions.
Sub-Actions im Überblick¶
| Sub-Action | Pfad |
|---|---|
| Speak | Speaker.bot → Speak |
| Speak (UDP) | Speaker.bot → Speak (UDP) |
| Activate VoiceGate Profile | Speaker.bot → Activate VoiceGate Profile |
| Clear Pending | Speaker.bot → Clear Pending |
| Set Enabled State | Speaker.bot → Set Enabled State |
| Set Paused State | Speaker.bot → Set Paused State |
| Stop Speaking | Speaker.bot → Stop Speaking |
Speak Sub-Action¶
Pfad: Speaker.bot → Speak
| Feld | Bedeutung |
|---|---|
| Voice Alias | Welche Voice (aus Speaker.bot) |
| Message | Text der vorgelesen wird. Variablen-Interpolation aktiv |
| Pass Through Bad Word Filter | Toggle für Wort-Filter |
| Silent | Generiert TTS-File ohne Playback (für custom Audio-Routing) |
| Delay | Wartet bis TTS fertig (max 30s) |
Output:
- %duration% — Audiodauer
- %speechFile% — Pfad zur generierten Datei (wenn Silent)
- %success% — bool
Test-Action¶
Wenn du das hörst, läuft die Verbindung.
Use-Cases in dieser Sektion¶
| Use-Case | MD |
|---|---|
| Sub-/Bits-Donations vorlesen | donation-tts.md |
Häufige Fallen¶
- Speaker.bot nicht gestartet — SB zeigt Disconnected. Vor Stream-Start manuell starten oder als Auto-Start beim Windows-Login
- Voice-Alias Tippfehler — Speaker.bot rejected die Action. Auf exakten Alias-Namen achten
- TTS hängt im Sound — Sub-Action
Stop Speakingals Mod-Command (!shutup😄) - Speaker.bot in falschem Audio-Output — in Speaker.bot Settings den Audio-Output-Device wählen (z.B. Virtual Audio Cable für OBS-Routing)
- Spam-Bots fluten TTS — Bad-Word-Filter aktivieren, plus Cooldown im Trigger-Filter
Quellen¶
- Speaker.bot Guide: https://docs.streamer.bot/guide/integrations/speakerbot
- Speak Sub-Action: https://docs.streamer.bot/api/sub-actions/speakerbot/speak
- Speaker.bot Website: https://speaker.bot