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 cancelling the chime_tts.say or chime_tts.say_url action calls.

Default Value:60
Required:Yes
tip

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


TTS Audio Generation Timeout

The duration (in seconds) to wait before canceling a TTS audio generation attempt.

Default Value:30
Required:No

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

Fallback TTS Platform

The TTS platform to retry generating TTS audio if the specified/default platform failed.

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 duration (in milliseconds) to fade out the now playing audio before an announcement, and then fade it back in after the announcement is completed.

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

Default Value:500
Required:No

Delay Before Removing Temporary Files

The delay duaration after chime_tts.say playback is completed (in milliseconds), before removing the generated temporary audio file.

Default Value:None
Required:No

Custom Chimes Folder

The local folder path containing custom audio files. Please read here for more information.

Default Value:None
Required:No
Restart Requierd

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


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