diff --git a/source/_includes/asides/voice_navigation.html b/source/_includes/asides/voice_navigation.html index 3b7e74d57d5..b08c7938cb7 100644 --- a/source/_includes/asides/voice_navigation.html +++ b/source/_includes/asides/voice_navigation.html @@ -17,6 +17,7 @@
  • {% active_link /voice_control/voice_remote_expose_devices/ Exposing devices to voice assistant %}
  • {% active_link /voice_control/builtin_sentences/ Built-in sentences %}
  • {% active_link /voice_control/custom_sentences/ Custom sentences %}
  • +
  • {% active_link /voice_control/using_tts_in_automation/ Using Piper TTS in automations %}
  • {% active_link /voice_control/troubleshooting/ Troubleshooting Assist %}
  • diff --git a/source/images/assist/tts_action.png b/source/images/assist/tts_action.png new file mode 100644 index 00000000000..3fbee5f8574 Binary files /dev/null and b/source/images/assist/tts_action.png differ diff --git a/source/images/assist/tts_enter_text.png b/source/images/assist/tts_enter_text.png new file mode 100644 index 00000000000..b3710aae1eb Binary files /dev/null and b/source/images/assist/tts_enter_text.png differ diff --git a/source/images/assist/tts_select_media_player.png b/source/images/assist/tts_select_media_player.png new file mode 100644 index 00000000000..7e6fe819e02 Binary files /dev/null and b/source/images/assist/tts_select_media_player.png differ diff --git a/source/images/assist/tts_select_media_source.png b/source/images/assist/tts_select_media_source.png new file mode 100644 index 00000000000..80b4486e234 Binary files /dev/null and b/source/images/assist/tts_select_media_source.png differ diff --git a/source/images/assist/tts_select_piper.png b/source/images/assist/tts_select_piper.png new file mode 100644 index 00000000000..528ce128ad5 Binary files /dev/null and b/source/images/assist/tts_select_piper.png differ diff --git a/source/voice_control/using_tts_in_automation.markdown b/source/voice_control/using_tts_in_automation.markdown new file mode 100644 index 00000000000..ac50746bf2a --- /dev/null +++ b/source/voice_control/using_tts_in_automation.markdown @@ -0,0 +1,40 @@ +--- +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**. +1. Select **Create new automation**, then **Add action**. +1. From the drop-down menu, select **Play media** and select the media player you want to use for this automation. + ![Select your media player](/images/assist/tts_select_media_player.png) +1. Select **Pick media**, then, select **Text-to-speech**. + ![Select your media source](/images/assist/tts_select_media_source.png) +1. To use fully local text-to-speech processing, select **Piper**. + ![Select Piper](/images/assist/tts_select_piper.png) +1. Enter the text you want to hear for this automation. + ![Enter text to be spoken](/images/assist/tts_enter_text.png) +1. Your text-to-speech action is now ready to be used in your script or automation. + ![Enter text to be spoken](/images/assist/tts_action.png) +1. Save your action. +1. If you want, you can edit this service in YAML. + + ```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. + ```