ChatVibes TTS Bot Commands

Commands

All TTS commands are prefixed with !tts.

For example: !tts status

Click any command row below to expand and see usage details.

Broadcasters and viewers can also configure settings using the ChatVibes Web Dashboard.

Viewers can set their own TTS preferences using the web UI by sending !tts prefs in chat.

Text-To-Speech Commands

Command	Description
General
!tts status	Gets the current status of the TTS application for the channel. ▼
`!tts status` Notes: Displays engine state, mode, queue length, default voice, pitch, speed, emotion, and language boost settings. Permission: Everyone
!tts voices	Provides a link to the documentation section for available TTS voices. ▼
`!tts voices` Permission: Everyone
!tts languageslist	Provides a link to the documentation section for available TTS language boost options. ▼
`!tts languageslist` Permission: Everyone
!tts commands (Alias: !tts help)	Provides a link to the full list of !tts subcommands. ▼
`!tts commands` `!tts help` Permission: Everyone
!tts prefs (Alias: !tts preferences)	Sends you a short-lived link to your personal TTS settings page. ▼
`!tts prefs` `!tts preferences` Configure your own voice, pitch, speed, emotion, and language on a per-channel basis. Includes a red-outlined "Danger Zone" where you can add yourself to the channel's TTS and/or Music ignore lists (only a moderator can undo this). The bot posts the link publicly in chat; it is signed for you only and expires after first access or 10 minutes. The page is pre-filled with the current channel. Permission: Everyone
Engine & Mode Control (Moderator Only)
!tts on (Alias: !tts enable)	Enables the TTS engine. Messages and events may be spoken based on the current mode. ▼
`!tts on` `!tts enable` Permission: Moderator
!tts off (Alias: !tts disable)	Disables the TTS engine entirely. No messages or events will be spoken. ▼
`!tts off` `!tts disable` Permission: Moderator
!tts mode [all\|command]	Toggles the TTS mode. ▼
`!tts mode all` (Speak all chat messages & events; this is the default mode) `!tts mode command` (Only speak on command or for events) `!tts mode` (Displays current mode) Notes: all: All chat messages (not from ignored users or commands) and enabled events will be spoken, subject to the !tts permission setting. command: Only messages triggered by specific TTS commands (like !tts <message>) or enabled events will be spoken. Regular chat is ignored. Permission: Moderator
!tts permission [everyone\|all\|mods]	Sets a filter on who can trigger TTS when the bot is in all mode. ▼
`!tts permission everyone` `!tts permission mods` `!tts permission` (displays the current permission filter) Notes: everyone or all: Any user's chat message can be spoken. (Default) mods: Only messages from moderators and the broadcaster will be spoken. This does not affect command mode. Permission: Moderator
!tts bits [on\|off\|min <amount>]	Configures the Bits-for-TTS feature, allowing channels to require a minimum Cheer amount to trigger TTS. ▼
`!tts bits on` `!tts bits off` `!tts bits min 100` `!tts bits` (displays current Bits-for-TTS status) Description: on: Enables Bits-for-TTS mode. Only messages with a sufficient cheer will be read. off: Disables Bits-for-TTS mode. min <amount>: Sets the minimum number of Bits required (e.g., min 100). Permission: Moderator
Queue Management (Moderator Only)
!tts pause	Pauses the processing of the TTS event queue. ▼
`!tts pause` Notes: New messages/events will still be added to the queue but won't be spoken until resumed. Permission: Moderator
!tts resume	Resumes processing of the TTS event queue if it was paused. ▼
`!tts resume` Permission: Moderator
!tts clear	Clears all pending messages and events from the TTS queue. ▼
`!tts clear` Notes: This command only removes messages waiting in the queue. It does not stop audio that is currently playing or actively being generated by the TTS engine. Permission: Moderator
!tts stop	Stops the currently playing or generating TTS audio. ▼
`!tts stop` Notes: If TTS is currently speaking or generating audio, this command will attempt to stop it. Any user can stop a message if it was triggered by their own chat message. Moderators and the broadcaster can stop any TTS audio. Permission: Everyone for their own messages, Moderator for others
User & Event Preferences
!tts voice <voice_id\|reset>	Allows a user to set their preferred voice for messages they send. ▼
`!tts voice Friendly_Person` `!tts voice reset` `!tts voice` (displays current personal preference) Notes: Use reset to revert to the channel's default voice. Use !tts voices to get a link to available voice IDs. Permission: Everyone (for their own preference)
!tts emotion <emotion_name\|reset\|auto>	Allows a user to set their preferred emotion for their messages. ▼
`!tts emotion happy` `!tts emotion reset` `!tts emotion` (displays current personal preference) Notes: Valid emotions: auto, neutral, happy, sad, angry, fearful, disgusted, surprised. Use reset or auto for the channel default. Permission: Everyone (for their own preference)
!tts language <language\|reset> (Alias: !tts lang)	Sets your preferred language boost for TTS. ▼
`!tts language English` `!tts lang Japanese` `!tts language reset` `!tts language` (displays current personal preference) Notes: Affects how speech is interpreted and generated. Use reset, auto, or none to use the channel's default. See Language Boost section or use !tts languageslist for available options. Permission: Everyone (for their own preference)
!tts pitch <value\|reset>	Sets your personal TTS pitch. ▼
`!tts pitch 2` `!tts pitch -3` `!tts pitch reset` `!tts pitch` (displays current personal preference) Notes: Value must be an integer between -12 and 12 (0 is normal). Use reset for the channel default. Permission: Everyone (for their own preference)
!tts speed <value\|reset>	Sets your personal TTS speed. ▼
`!tts speed 1.2` `!tts speed 0.8` `!tts speed reset` `!tts speed` (displays current personal preference) Notes: Value must be a number between 0.5 and 2.0 (1.0 is normal). Use reset for the channel default. Permission: Everyone (for their own preference)
!tts ignore <username> !tts ignore add <username>	For any user: Add yourself to the TTS ignore list for the channel. Your messages will not be spoken. For Moderators/Broadcaster: Add any specified Twitch user to the TTS ignore list for the channel. ▼
Usage: `!tts ignore yourusername` (if you want to ignore yourself) `!tts ignore add SomeOtherUser` (if you are a mod/broadcaster) Permission: Everyone (to add themselves), Moderator (to add others)
!tts ignore del <username> (Aliases: delete, rem, remove)	Removes the specified Twitch user from the TTS ignore list. ▼
`!tts ignore del SomeUser` Permission: Moderator
!tts ignored	Lists all users currently on the TTS ignore list for the channel. ▼
`!tts ignored` Permission: Moderator
!tts events [on\|off]	Toggles whether Twitch events (like subscriptions, cheers, raids, etc.) are announced by TTS. ▼
`!tts events on` `!tts events off` `!tts events` (displays current event announcement status) Permission: Moderator
Channel-Wide Default Configuration (Moderator Only)
!tts defaultvoice <voice_id\|reset>	Sets the default TTS voice for the channel. ▼
`!tts defaultvoice Friendly_Person` `!tts defaultvoice reset` `!tts defaultvoice` (displays current channel default) Notes: Use reset to revert to the system default. Use !tts voices for a link to voice IDs. Permission: Moderator
!tts defaultemotion <emotion_name\|reset>	Sets the default TTS emotion for the channel. ▼
`!tts defaultemotion happy` `!tts defaultemotion reset` `!tts defaultemotion` (displays current channel default) Notes: Valid emotions: auto, neutral, happy, sad, angry, fearful, disgusted, surprised. Use reset for system default (auto). Permission: Moderator
!tts defaultlanguage <language\|reset>	Sets the default TTS language boost for the channel. ▼
`!tts defaultlanguage English` `!tts defaultlanguage reset` `!tts defaultlanguage` (displays current channel default) Notes: Use reset, auto, or none to use the system default (usually 'Automatic' or 'None'). See Language Boost section or use !tts languageslist for options. Permission: Moderator
!tts defaultpitch <value\|reset>	Sets the default TTS pitch for the channel. ▼
`!tts defaultpitch 2` `!tts defaultpitch reset` `!tts defaultpitch` (displays current channel default) Notes: Value must be an integer between -12 and 12 (0 is normal). Use reset for system default (0). Permission: Moderator
!tts defaultspeed <value\|reset>	Sets the default TTS speed for the channel. ▼
`!tts defaultspeed 1.2` `!tts defaultspeed reset` `!tts defaultspeed` (displays current channel default) Notes: Value must be a number between 0.5 and 2.0 (1.0 is normal). Use reset for system default (1.0). Permission: Moderator
Direct TTS
!tts <message> (Alias: !tts say <message>)	Immediately enqueues the provided message for TTS. This works in both all and command modes. Uses the requesting user's preferences (or channel defaults) for voice, pitch, speed, and emotion. ▼
`!tts Welcome everyone to the stream!` `!tts say Welcome everyone!` Permission: Everyone
!tts say <message>	(Deprecated: see above)

Music Generation Commands

All music generation commands are prefixed with !music

For example: !music 90s soulful house

Click any command row below to expand and see usage details.

Music Generation Commands

Command	Description
!music <prompt>	Generates a short piece of music based on your prompt. ▼
`!music epic orchestral battle theme` Permission: Configurable by mods (default: everyone, can be mods only). User must not be on music ignore list.
!music on !music off	(Mod only) Enables or disables the music generation feature for the channel. ▼
`!music on` `!music off` Permission: Moderator
!music mode <all\|mods>	(Mod only) Sets who can use the !music <prompt> command. all: Everyone can generate music. mods: Only moderators and the broadcaster can generate music. ▼
`!music mode all` `!music mode mods` Permission: Moderator
!music bits [on\|off\|min <amount>]	(Mod only) Configures Bits-for-Music. When enabled, users must cheer with their prompt to generate music. ▼
`!music bits on` `!music bits off` `!music bits min 100` `!music bits` (displays current status) Description: on: Enables Bits-for-Music mode. off: Disables Bits-for-Music mode. min <amount>: Sets the minimum number of Bits required (e.g., min 100). Permission: Moderator
!music status	Shows the current status of music generation (enabled/disabled, mode, queue length). ▼
`!music status` Permission: Everyone
!music clear	(Mod only) Clears all pending music generation requests from the queue. ▼
`!music clear` Permission: Moderator
!music ignore <username> !music ignore add <username>	For any user: Add yourself to the music ignore list. Your !music <prompt> requests will be ignored. For Moderators/Broadcaster: Add any specified Twitch user to the music ignore list. ▼
Usage: `!music ignore yourusername` (if you want to ignore yourself) `!music ignore add SomeOtherUser` (if you are a mod/broadcaster) Permission: Everyone (to add themselves), Moderator (to add others)
!music ignore del <username> (Aliases: delete, rem, remove)	(Mod only) Removes the specified Twitch user from the music ignore list. ▼
`!music ignore del SomeUser` Permission: Moderator
!music ignored	(Mod only) Lists all users currently on the music ignore list for the channel. ▼
`!music ignored` Permission: Moderator

Voices

The following voices are available from the minimax/speech-02-turbo model on Replicate. The bot fetches this list periodically. The voice_id is used in commands like !tts voice <voice_id>.

Common Voice IDs

Featured voices from the Replicate minimax/speech-02-turbo model.

Wise_Woman
Friendly_Person
Inspirational_girl
Deep_Voice_Man
Calm_Woman
Casual_Guy
Lively_Girl
Patient_Man
Young_Knight
Determined_Man
Lovely_Girl
Decent_Boy
Imposing_Manner
Elegant_Man
Abbess
Sweet_Girl_2
Exuberant_Girl

Pre-trained Voice List (from minimax/speech-02-turbo README)

This is a more extensive list.

English_Trustworth_Man
English_Aussie_Bloke
English_CalmWoman
English_UpsetGirl
English_Gentle-voiced_man
English_Whispering_girl
English_Diligent_Man
English_Graceful_Lady
English_ReservedYoungMan
English_PlayfulGirl
English_ManWithDeepVoice
English_MaturePartner
English_FriendlyPerson
English_MatureBoss
English_Debator
English_LovelyGirl
English_Steadymentor
English_Deep-VoicedGentleman
English_Wiselady
English_CaptivatingStoryteller
English_DecentYoungMan
English_SentimentalLady
English_ImposingManner
English_SadTeen
English_PassionateWarrior
English_WiseScholar
English_Soft-spokenGirl
English_SereneWoman
English_ConfidentWoman
English_PatientMan
English_Comedian
English_BossyLeader
English_Strong-WilledBoy
English_StressedLady
English_AssertiveQueen
English_AnimeCharacter
English_Jovialman
English_WhimsicalGirl
English_Kind-heartedGirl
Chinese (Mandarin)_Reliable_Executive
Chinese (Mandarin)_News_Anchor
Chinese (Mandarin)_Unrestrained_Young_Man
Chinese (Mandarin)_Mature_Woman
Arrogant_Miss
Robot_Armor
Chinese (Mandarin)_Kind-hearted_Antie
Chinese (Mandarin)_Refreshing_Young_Man
Chinese (Mandarin)_HK_Flight_Attendant
Chinese (Mandarin)_Humorous_Elder
Chinese (Mandarin)_Gentleman
Chinese (Mandarin)_Warm_Bestie
Chinese (Mandarin)_Stubborn_Friend
Chinese (Mandarin)_Sweet_Lady
Chinese (Mandarin)_Southern_Young_Man
Chinese (Mandarin)_Wise_Women
Chinese (Mandarin)_Gentle_Youth
Chinese (Mandarin)_Warm_Girl
Chinese (Mandarin)_Male_Announcer
Chinese (Mandarin)_Kind-hearted_Elder
Chinese (Mandarin)_Cute_Spirit
Chinese (Mandarin)_Radio_Host
Chinese (Mandarin)_Lyrical_Voice
Chinese (Mandarin)_Straightforward_Boy
Chinese (Mandarin)_Sincere_Adult
Chinese (Mandarin)_Gentle_Senior
Chinese (Mandarin)_Crisp_Girl
Chinese (Mandarin)_Pure-hearted_Boy
Chinese (Mandarin)_Soft_Girl
Chinese (Mandarin)_IntellectualGirl
Chinese (Mandarin)_Warm_HeartedGirl
Chinese (Mandarin)_Laid_BackGirl
Chinese (Mandarin)_ExplorativeGirl
Chinese (Mandarin)_Warm-HeartedAunt
Chinese (Mandarin)_BashfulGirl
Japanese_IntellectualSenior
Japanese_DecisivePrincess
Japanese_LoyalKnight
Japanese_DominantMan
Japanese_SeriousCommander
Japanese_ColdQueen
Japanese_DependableWoman
Japanese_GentleButler
Japanese_KindLady
Japanese_CalmLady
Japanese_OptimisticYouth
Japanese_GenerousIzakayaOwner
Japanese_SportyStudent
Japanese_InnocentBoy
Japanese_GracefulMaiden
Cantonese_ProfessionalHost（F)
Cantonese_GentleLady
Cantonese_ProfessionalHost（M)
Cantonese_PlayfulMan
Cantonese_CuteGirl
Cantonese_KindWoman
Korean_SweetGirl
Korean_CheerfulBoyfriend
Korean_EnchantingSister
Korean_ShyGirl
Korean_ReliableSister
Korean_StrictBoss
Korean_SassyGirl
Korean_ChildhoodFriendGirl
Korean_PlayboyCharmer
Korean_ElegantPrincess
Korean_BraveFemaleWarrior
Korean_BraveYouth
Korean_CalmLady
Korean_EnthusiasticTeen
Korean_SoothingLady
Korean_IntellectualSenior
Korean_LonelyWarrior
Korean_MatureLady
Korean_InnocentBoy
Korean_CharmingSister
Korean_AthleticStudent
Korean_BraveAdventurer
Korean_CalmGentleman
Korean_WiseElf
Korean_CheerfulCoolJunior
Korean_DecisiveQueen
Korean_ColdYoungMan
Korean_MysteriousGirl
Korean_QuirkyGirl
Korean_ConsiderateSenior
Korean_CheerfulLittleSister
Korean_DominantMan
Korean_AirheadedGirl
Korean_ReliableYouth
Korean_FriendlyBigSister
Korean_GentleBoss
Korean_ColdGirl
Korean_HaughtyLady
Korean_CharmingElderSister
Korean_IntellectualMan
Korean_CaringWoman
Korean_WiseTeacher
Korean_ConfidentBoss
Korean_AthleticGirl
Korean_PossessiveMan
Korean_GentleWoman
Korean_CockyGuy
Korean_ThoughtfulWoman
Korean_OptimisticYouth
Spanish_SereneWoman
Spanish_MaturePartner
Spanish_CaptivatingStoryteller
Spanish_Narrator
Spanish_WiseScholar
Spanish_Kind-heartedGirl
Spanish_DeterminedManager
Spanish_BossyLeader
Spanish_ReservedYoungMan
Spanish_ConfidentWoman
Spanish_ThoughtfulMan
Spanish_Strong-WilledBoy
Spanish_SophisticatedLady
Spanish_RationalMan
Spanish_AnimeCharacter
Spanish_Deep-tonedMan
Spanish_Fussyhostess
Spanish_SincereTeen
Spanish_FrankLady
Spanish_Comedian
Spanish_Debator
Spanish_ToughBoss
Spanish_Wiselady
Spanish_Steadymentor
Spanish_Jovialman
Spanish_SantaClaus
Spanish_Rudolph
Spanish_Intonategirl
Spanish_Arnold
Spanish_Ghost
Spanish_HumorousElder
Spanish_EnergeticBoy
Spanish_WhimsicalGirl
Spanish_StrictBoss
Spanish_ReliableMan
Spanish_SereneElder
Spanish_AngryMan
Spanish_AssertiveQueen
Spanish_CaringGirlfriend
Spanish_PowerfulSoldier
Spanish_PassionateWarrior
Spanish_ChattyGirl
Spanish_RomanticHusband
Spanish_CompellingGirl
Spanish_PowerfulVeteran
Spanish_SensibleManager
Spanish_ThoughtfulLady
Portuguese_SentimentalLady
Portuguese_BossyLeader
Portuguese_Wiselady
Portuguese_Strong-WilledBoy
Portuguese_Deep-VoicedGentleman
Portuguese_UpsetGirl
Portuguese_PassionateWarrior
Portuguese_AnimeCharacter
Portuguese_ConfidentWoman
Portuguese_AngryMan
Portuguese_CaptivatingStoryteller
Portuguese_Godfather
Portuguese_ReservedYoungMan
Portuguese_SmartYoungGirl
Portuguese_Kind-heartedGirl
Portuguese_Pompouslady
Portuguese_Grinch
Portuguese_Debator
Portuguese_SweetGirl
Portuguese_AttractiveGirl
Portuguese_ThoughtfulMan
Portuguese_PlayfulGirl
Portuguese_GorgeousLady
Portuguese_LovelyLady
Portuguese_SereneWoman
Portuguese_SadTeen
Portuguese_MaturePartner
Portuguese_Comedian
Portuguese_NaughtySchoolgirl
Portuguese_Narrator
Portuguese_ToughBoss
Portuguese_Fussyhostess
Portuguese_Dramatist
Portuguese_Steadymentor
Portuguese_Jovialman
Portuguese_CharmingQueen
Portuguese_SantaClaus
Portuguese_Rudolph
Portuguese_Arnold
Portuguese_CharmingSanta
Portuguese_CharmingLady
Portuguese_Ghost
Portuguese_HumorousElder
Portuguese_CalmLeader
Portuguese_GentleTeacher
Portuguese_EnergeticBoy
Portuguese_ReliableMan
Portuguese_SereneElder
Portuguese_GrimReaper
Portuguese_AssertiveQueen
Portuguese_WhimsicalGirl
Portuguese_StressedLady
Portuguese_FriendlyNeighbor
Portuguese_CaringGirlfriend
Portuguese_PowerfulSoldier
Portuguese_FascinatingBoy
Portuguese_RomanticHusband
Portuguese_StrictBoss
Portuguese_InspiringLady
Portuguese_PlayfulSpirit
Portuguese_ElegantGirl
Portuguese_CompellingGirl
Portuguese_PowerfulVeteran
Portuguese_SensibleManager
Portuguese_ThoughtfulLady
Portuguese_TheatricalActor
Portuguese_FragileBoy
Portuguese_ChattyGirl
Portuguese_Conscientiousinstructor
Portuguese_RationalMan
Portuguese_WiseScholar
Portuguese_FrankLady
Portuguese_DeterminedManager
French_Male_Speech_New
French_Female_News Anchor
French_CasualMan
French_MovieLeadFemale
French_FemaleAnchor
French_MaleNarrator
Indonesian_SweetGirl
Indonesian_ReservedYoungMan
Indonesian_CharmingGirl
Indonesian_CalmWoman
Indonesian_ConfidentWoman
Indonesian_CaringMan
Indonesian_BossyLeader
Indonesian_DeterminedBoy
Indonesian_GentleGirl
German_FriendlyMan
German_SweetLady
German_PlayfulMan
Russian_HandsomeChildhoodFriend
Russian_BrightHeroine
Russian_AmbitiousWoman
Russian_ReliableMan
Russian_CrazyQueen
Russian_PessimisticGirl
Russian_AttractiveGuy
Russian_Bad-temperedBoy
Italian_BraveHeroine
Italian_Narrator
Italian_WanderingSorcerer
Italian_DiligentLeader
Dutch_kindhearted_girl
Dutch_bossy_leader
Vietnamese_kindhearted_girl
Arabic_CalmWoman
Arabic_FriendlyGuy
Turkish_CalmWoman
Turkish_Trustworthyman
Ukrainian_CalmWoman

Note: The full list of pre-trained voices is extensive. The !tts voices command in chat links to here. For the most up-to-date list, refer to the source llms.txt file from Replicate or use the bot's capability to validate voices if a !tts voice command is implemented.

Language Boost

The language_boost feature helps the TTS model better understand and pronounce words from specific languages or dialects. This is particularly useful in multilingual chats or when a specific language's nuances are important for clear TTS.

You can set a personal language boost preference using !tts language <language_name> or moderators can set a channel default with !tts defaultlanguage <language_name>.

Available Language Boost Options

The following values are accepted:

Using Automatic or None will generally rely on the model's default language detection or no specific boost. English is often a good default for primarily English-speaking chats. Choosing a specific language can significantly improve pronunciation for that language.

Troubleshooting

Bot not responding to commands? Make sure the bot is a moderator in your channel. You can do this by typing /mod chatvibesbot in your Twitch chat. In many cases, the bot may need moderator permissions to read messages and respond to commands.
Bot not speaking? Make sure the bot is enabled in your channel. You can do this by typing !tts on in your Twitch chat. Also, check the current mode !tts mode and permissions !tts permission.
Bot not speaking in a specific language, or reading numbers in Chinese? Make sure the language boost is set to the correct language. You can do this by typing !tts language <language_name> for yourself or !tts defaultlanguage <language_name> for the channel in your Twitch chat. You can check the current language boost using !tts defaultlanguage.
Need help? Contact the developer via the contact form at Henry's portfolio website.

ChatVibes TTS Bot Documentation

Commands

Text-To-Speech Commands

Music Generation Commands

Music Generation Commands

Voices

Common Voice IDs

Pre-trained Voice List (from minimax/speech-02-turbo README)

Language Boost

Available Language Boost Options

Troubleshooting