home-assistant.io/source/voice_control/using_tts_in_automation.markdown

title

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, select Play media and select the media player you want to use for this automation.

4. Select Pick media, then, select Text-to-speech.

5. To use fully local text-to-speech processing, select Piper.

6. Enter the text you want to hear for this automation.

7. Your text-to-speech action is now ready to be used in your script or automation.

8. Save your action.

9. If you want, you can edit this service in YAML.

   service: media_player.play_media
   target:
     entity_id: media_player.m5stack_atom_echo_a61920
   data:
     media_content_id: media-source://tts/tts.piper?message=Your+coffee+is+ready%21+Enjoy.
     media_content_type: provider
   metadata:
     title: Your coffee is ready! Enjoy.
     thumbnail: https://brands.home-assistant.io/_/tts/logo.png
     media_class: app
     children_media_class: null
     navigateIds:
         - {}
         - media_content_type: app
           media_content_id: media-source://tts
         - media_content_type: provider
           media_content_id: media-source://tts/tts.piper?message=Your+coffee+is+ready%21+Enjoy.