Twitch setup
How to get a Bot Chat Token
- Open twitchtokengenerator.com
- Click Bot Chat Token
- Authorize with Twitch and copy the ACCESS TOKEN and REFRESH TOKEN
- Paste both below (the
oauth:prefix is added automatically for the access token) - Enter your bot nick and stream channel name
TTS settings
Output
Uses the browser default device when unsupported or unset.
Streamer.bot setup
- Install the websocket-relay sub-action in Streamer.bot
- Open the TTS receiver page in an OBS Browser Source
- Connect below (default
ws://127.0.0.1:9090/)
Disconnected
Moderation
Chat reading
Reading options
Word replacements
Matches whole words or phrases, including next to punctuation. Leave the replacement empty
to remove a word. Put + before the stressed vowel, for example
з+амок becomes за́мок.
| Word or phrase | Replacement |
|---|
Special tags
Optional tags you can put in chat text. Results vary; notes below are from community testing.
| Tag | Type | Notes from community testing |
|---|---|---|
<laugh> |
Non-verbal | Often works; best at sentence end (×2–3) |
<breath> |
Non-verbal | Often works; best at sentence start (×3) |
<sigh> |
Non-verbal | Mixed; ×2 at start/end sometimes helps |
<surprise> |
Emotion / intonation | Inconsistent; may be read aloud |
<sad> |
Emotion | Sometimes works with ×3 at start and end |
<angry> |
Emotion | Often ignored or read as text |
<cough> |
Non-verbal | Sometimes works at start (×3) |
<yawn> |
Non-verbal | Often ignored or read as text |
<scream> |
Non-verbal | Usually read as text |
<throatclear> |
Non-verbal | Usually read as text |
Voices
Built-in and custom voices
Get custom voice JSON from
Supertonic Voice Builder,
train your own with
supertonic3-voice-clone,
or ask BigArt0 directly.
Load JSON files here (one or many); they are stored in this browser and included in settings export/import.
Uncheck Use for new chatters to keep a voice assignable manually but exclude it from random
assignment and !reroll_voice.
| Voice | Type | Use for new chatters | Remove voice |
|---|
Chatters
Chatter list
| User | Voice | Lang | Pronunciation |
|---|
Settings file
Do not share exported files — they may contain your Twitch access and refresh tokens.
Chat commands
Available chat commands
| Command | Who | On | Effect |
|---|---|---|---|
!call_me <name> |
Anyone | Set how TTS pronounces your username (saved in Chatters) | |
!reroll_voice |
Anyone | Get a random new voice; bot replies in chat | |
!rename @user "<name>" [voice] |
Moderator | Set a chatter’s pronunciation (optional voice), e.g. !rename @BigArt0 "Арт" |
|
!setvoice @user <voice> |
Moderator | Set a chatter’s voice without changing pronunciation, e.g. !setvoice @BigArt0 M3 (invalid voice is random) |
|
!setlang @user <lang> |
Moderator | Set a chatter’s TTS language, e.g. !setlang @BigArt0 en (ru, en, ja, …) |
|
!blacklist @user |
Moderator | Add a user to the TTS blacklist | |
!unblacklist @user |
Moderator | Remove a user from the TTS blacklist |