Skip to main content

Configuration

You can configure the following options for the chime_tts.say and chime_tts.say_url actions through the integration's configuration page:

Timeout

The duration (in seconds) to wait before terminating action calls.

Default Value:60
Required:Yes
tip

Increase the timeout duration intend to generate audio longer than 60 seconds in length.


Default TTS Platform

The default tts_platform value to use when not specified.

Default Value:None
Required:No

Default Language

The default language value to use if the tts_platform is set to the default TTS platform.

Default Value:None
Required:No

Default Voice

The default voice value to use if the tts_platform is set to the default TTS platform.

Default Value:None
Required:No

Default Dialect

The default dialect domain (tld) value if the tts_platform is set to Google Translate.

Default Value:None
Required:No

Default Offset

The default offset duration (in milliseconds) between chimes and TTS audio.
Positive values introduce a delay, while negative values overlap the audio segments.

Default Value:450
Required:No

Fade Transition

The fade out duration (in milliseconds) of the now playing audio before an announcement and fading it duration of the now playing music afterwards.

This applies to chime_tts.say action calls when the announce or fade_audio parameters are used.

Default Value:500
Required:No

Custom Chimes Folder

The local folder path containing custom audio files.

Any changes to the folder path or its contents will require a restart to take effect. More info

Default Value:None
Required:No

Downloaded Chimes Folder

The local folder path where downloaded chime MP3 files will be stored.

Default Value:{root}/media/sounds/temp/chime_tts/chimes/
Required:Yes

Temporary MP3 Folder

The local folder path where generated MP3 files will be stored.

Default Value:{root}/media/sounds/temp/chime_tts/
Required:Yes
Please Note

Make sure the temporary folder path is inside a media folder of your Home Assistant, otherwise the chime_tts.say action will not be able to play the generated MP3 on your media_players.


chime_tts.say_url Folder

The publicly facing folder path where MP3 files generated by the chime_tts.say_url action will be stored.

Default Value:{root}/config/www/chime_tts/
Required:Yes

MP3 Cover Art

When enabled, adds the Chime TTS logo as the cover art in generated MP3 files.

Default Value:false
Required:No