# Voice conversations and text to speech

> Talk to Based out loud in a Discord voice channel: /join, Group and Focus modes, interruptions, /tts read-aloud, languages and voice controls.

URL: https://www.jalkarna.in/based/docs/voice/  
Last updated: 2026-11-16

Based can join your voice channel and hold a spoken conversation. Join a voice channel, then run `/join`. Talk normally and Based answers out loud. It uses a speech-to-speech model, so it hears your voice and replies in its own voice directly instead of converting everything to text first.

## Group and Focus modes
- **Group** (default) talks with everyone in the room, one speaker at a time.
- **Focus** listens only to the person who started the session, which works better in a noisy room.

Switch modes and the conversation language with `/voiceconfig`. With language set to automatic, Based follows the language members use.

## Interrupting and stopping
You can talk over Based to cut a reply short when interruptions are allowed. `/hush` stops the current reply and `/leave` ends the session. Both are limited to the person who started the session or a moderator. The session also ends when its starter leaves the channel.

## Typing into a voice conversation
`/say` sends typed text into the active voice conversation, which helps when you cannot use a microphone. `/tts` with a message reads that text aloud. `/tts` on its own opts you in to having your later messages in that text channel read aloud. Read-aloud mode never records microphone audio.

## Limits worth knowing
A bot can be in one voice channel per server at a time, so voice conversations and music share Based's voice connection. Based does not save voice recordings or transcripts. Learn more in [how voice AI assistants work](https://www.jalkarna.in/based/learn/how-voice-ai-assistants-work/).

## Settings
Change these in the [dashboard](https://www.jalkarna.in/based/dashboard/) or with `/setup` in Discord. They apply to one server at a time.

| Setting | Default | What it does |
|---|---|---|
| Enabled | On | Turn this feature on for this server. |
| Allowed channels | Not set | Leave empty to let Based work in every channel it can see. |
| Conversation language | Auto / multilingual | The language Based speaks. Auto follows whatever language members use. |
| Speaking voice | Ash | The voice Based uses when a new voice conversation starts. |
| Default conversation mode | Group conversation | Group talks with everyone in the room. Focused follows the person who started the session. |
| Text to speech | On | Let members ask Based to read text out loud. |
| Require the same voice channel | On | Only members in Based's voice channel can control it. |
| Allow interruptions | On | Let members talk over Based to cut a reply short. |
| Simultaneous interruptions | 2 | How many people talking at once count as an interruption. |

## Permissions Based needs
For this module Based's role needs: **View Channel**, **Connect**, **Speak**. See [permissions](https://www.jalkarna.in/based/docs/permissions/) for how to grant them only where they are needed.

## Commands
Every command works as a slash command and with the text prefix (default `.`), so `/join` and `.join` do the same thing.

### /join
Join your voice channel for a conversation.

- Usage: `/join`
- Who can use it: Anyone who can use the command, in servers only

### /leave
End the voice session (starter or moderator).

- Usage: `/leave`
- Who can use it: Anyone who can use the command, in servers only

### /tts
Read supplied text aloud or opt into automatic text reading.

- Usage: `/tts [message]`
- `message`: Text to read aloud; omit to opt into automatic reading
- Who can use it: Anyone who can use the command, in servers only

### /say
Send text to your active voice conversation.

- Usage: `/say <message>`
- `message` (required): Message for the active voice conversation
- Who can use it: Anyone who can use the command, in servers only

### /hush
Stop the current voice reply (starter or moderator).

- Usage: `/hush`
- Who can use it: Anyone who can use the command, in servers only

### /voiceconfig
Open voice language and session controls.

- Usage: `/voiceconfig`
- Who can use it: Anyone who can use the command, in servers only


## FAQ

### Can Based talk in Discord voice channels?

Yes. Join a voice channel and run /join. Based listens and replies out loud in real time.

### Does Based record voice chat?

No. Audio is processed live for the conversation and Based does not save recordings or transcripts.

### Why does Based not hear me?

In Focus mode it only listens to the session starter. Also check that Based has Connect and Speak, that you are in the same voice channel, and that you are not server-muted.
