# tts
## Syntax:
/tts **{text} {priority} {volume} {groupname}**
/tts **stop**
/tts **pause**
/tts **resume** (or **/tts unpause**)
/tts **skip {groupname}**
## Use Case:
Enables Text-To-Speech (TTS) auditory feedback by queuing messages to be spoken by your system's built-in synthesizer. It features a robust priority queue allowing critical alerts to cut to the front of the line and interrupt less important messages.
## Arguments:
- **{text}**: The text to be spoken.
- **{priority}**: (Optional) Integer priority level (default: 5). Lower numbers (e.g. 1) are higher priority and will interrupt higher numbers (e.g. 5).
- **{volume}**: (Optional) Volume from 0 to 100 (default: 100).
- **{groupname}**: (Optional) Categorize the TTS message to easily skip groups of messages.
## Special Commands:
- **/tts stop**: Immediately stops the current speech and clears all items in the queue.
- **/tts pause**: Pauses the currently playing speech.
- **/tts resume**: Resumes speech if it was paused.
- **/tts skip**: Instantly skips the currently playing message and moves to the next highest-priority message in the queue.
- **/tts skip {groupname}**: Wipes out all pending items that belong to the specified group and halts the current speech if it matches that group.
## Examples:
1. **/action {^Your health drops below 10%!} {/tts {Health Critical!} {1}}**
2. **/tts {This is a low priority message.} {10}**
3. **/tts {This is a standard message.}**
4. **/tts skip alerts**
## See Also:
playwav, playmidi
