# Creating TTS commands

TTS (text-to-speech) commands are how viewers can create TTS audio messages that are played on stream. By sending a TTS command in the stream chat (for example `!tts I love your stream)`, the audio will be automatically generated over a couple seconds and outputted into your streaming software.

### Adding Voices from the Library

By default you should already see a default male and female TTS voice in your command list, but to add additional voices to your command list you can do so through the [voice library](https://vox.bot/dashboard/library). The VoxBot voice library contains hundreds of AI voices, including voices of celebrities, other streamers, TV/movie characters, and more. Non AI voices voices can also be found here, such as the TikTok text-to-speech voice and other iconic TTS voices.

To add a voice to your command list click the plus button next to the voice.

<figure><img src="/files/A5B9CCHgk1WWvMPaoMtg" alt="VoxBot TTS Voice Library"><figcaption></figcaption></figure>

### Configuring TTS Commands

On the [TTS Commands](https://vox.bot/dashboard/commands) page you can view and configure all TTS voices & commands on your account. Each command has multiple settings that can be edited:

* **Command:** The command to activate this TTS voice. All text following this command will be played as text-to-speech.
* **Permissions:** Restrict this command to viewers with a specific role, such as only mods or only subs. By limiting voices to subs only you can encourage viewers to sub to your channel and reward those who already have. Many streamers have increased their sub count by doing this.
* **Toggle Command:** Enable or disable this command. If needed, you can enable/disable all TTS in the [playback settings](https://vox.bot/dashboard/playback).

<figure><img src="/files/Anlnj85MrLlYSIaKFpgM" alt="Example TTS command"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vox.bot/getting-started/creating-tts-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.