> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Text to Speech

> Speak bound text aloud.

<Info>
  **Category:** Display · **Reads data:** text · **Sends commands:** no
</Info>

## Mental model

A **Text to Speech widget is a loudspeaker.** Give it text — static or pushed from a
device — and it reads it aloud. The reverse of
[Voice to Text](/dashboard/widgets/voice-to-text).

## When to use it

* Spoken alerts and announcements
* Accessibility / hands-free readout

## Settings

### General

* **Voice** · **rate** · **pitch** · **volume**
* **Auto play** · **loop playback**
* **Show controls**

## Example — speak an alert from firmware

```cpp theme={null}
device.updateWidget(targetId, "announcer", String("Tank is full"));
```

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
// Speak when a switch arms the alarm
widget.on('alarmSwitch', 'on', () => widget.setValue('announcer', 'Alarm armed'));
```

<Card title="Voice to Text" icon="microphone" href="/dashboard/widgets/voice-to-text">
  The reverse — speech to text.
</Card>