🔊 Guide

Get Bozos TTS speaking naturally

Start with a clean voice connection, then choose language and voice scope. Bozos handles speech cleanup and conversation flow automatically.

1. Join the voice channel first

Enter the Discord voice channel you want to use and run /join. The bot connects to your current voice channel and begins handling eligible text-channel messages for that voice session.

If the bot does not join, first confirm that you are actually connected to a voice channel and that Bozos TTS can View Channel, Connect and Speak there. Channel-specific Discord permission overrides can block a bot even when its server role normally has access.

2. Choose the right language scope

Run /language and choose whether the setting should apply to the Server or Only me. Server scope is useful when most people in a community use the same language. Personal scope is better for multilingual communities where members want different voices or accents without changing everybody else.

3. Pick a regional accent and voice

The language menu includes regional locales where available. After choosing the language/accent, /voice lets you select from matching neural voices. Voice selection can also be server-wide or personal, so a member can customize their own speech without changing the server default.

4. Let the pronunciation system do the cleanup

The Grand Pronunciation Engine runs automatically before speech is generated. It improves how chat-oriented text is spoken by handling common acronyms, slang, gaming and technology terms, file formats, units and Discord-style usernames. Message cleanup also makes markdown, mentions, URLs, emoji, numbers, dates, times and punctuation easier to understand when read aloud.

5. Understand speaker-name behavior

Bozos avoids announcing the same speaker name before every consecutive message. When another person starts speaking, their name can be announced so listeners know who is talking. In very small calls, unnecessary speaker-name announcements may be reduced even further to keep the conversation natural.

6. Adjust live playback

Use /volume to adjust server playback from 0% to 200%. If a long or unwanted TTS message is currently playing, use /skip to move on. These controls are intended for the active voice session, so use them from the same voice context where Bozos TTS is connected.

7. Optional join/leave announcements

A member with Manage Server permission can use /announce to enable or disable localized voice-channel join/leave announcements. They are off by default. Once enabled, announcement speech follows the supported localization system instead of always using one fixed language.

8. When speech does not play

  1. Confirm Bozos TTS is still connected to the expected voice channel.
  2. Check that the bot can Speak in that channel and has not been server-muted.
  3. Make sure the message is being sent in the text channel associated with the active voice session.
  4. Try a short plain-text message to rule out a message-specific issue.
  5. If playback was intentionally skipped or the session was disconnected, reconnect with /join.

9. A clean setup for active communities

For a multilingual server, a good default is to choose a widely used server language and let individual members override it with personal scope. Keep announcements disabled until staff decide they add value, and use moderate playback volume so TTS remains understandable without overpowering people who are speaking live.

Full TTS documentation →TTS commands →