home-assistant.io/source/voice_control/using_tts_in_automation.markdown
Brooks Johnson 42ac2a87bc
Update documentation for piper TTS automation (#36927)
* Update documentation for piper TTS automation

* Remove old images

* Obey the AI

This suggestion results in a broken preview build, and I imagine it will
break an actual deployment too. But the AI insisted that this was
correct.

* Revert "Obey the AI"

This reverts commit b8d54c32ea53532c51d8b18cc24b0b3d920724e7.
2025-01-15 09:01:02 +01:00

18 lines
1.0 KiB
Markdown

---
title: "Using Piper TTS in automations"
---
This procedure shows you how to create a text-to-speech {% term action %}. For this, we use our local text-to-speech engine, Piper, and the media player {% term service %}. Home Assistant can then speak to you over your media player as part of an {% term automation %}.
1. Go to **{% my automations title="Settings > Automations & Scenes" %}**, and select **Create automation**.
2. Select **Create new automation**, then **Add action**.
3. From the drop-down menu, search for or select **TTS: Speak**.
![Select the TTS action](/images/assist/speak-action.png)
4. To use fully local text-to-speech processing, select **piper** from the **Choose entity** control.
![Select Piper](/images/assist/select-entity.png)
5. Select the media player you want the automation to use.
6. Enter the text you want to hear for this automation.
![Enter text to be spoken](/images/assist/media-message.png)
7. Your text-to-speech action is now ready to be used in your script or automation.
8. Save your action.