Chime TTS for Home Assistant
repository·main·Indexed 43 days ago
https://github.com/nimroddolev/chime_ttsA Home Assistant integration that eliminates latency between notification chimes and Text-To-Speech (TTS) audio by merging them into a single local audio file. It provides a notify platform and specific actions including chime_tts.say, chime_tts.say_url, chime_tts.replay, and chime_tts.clear_cache.
What's inside Chime TTS
- Chime TTS is a Home Assistant integration designed to eliminate latency between notification chimes and Text-To-Speech (TTS) audio. Instead of using separate playback actions which cause lag due to cloud generation and processing, Chime TTS locally combines the chime and the TTS audio into a single, seamless audio file on your Home Assistant device before playback.
Use the Chime TTS Notify Platform
mainChime TTS implements a Home Assistant notify platform named
chime_tts.This allows you to create reusable notification profiles. You can define these profiles either:
- Via the Sidebar Panel: Use the Chime TTS management interface in the Home Assistant sidebar to create and manage profiles.
- Via YAML: Define notification profiles directly in your Home Assistant configuration for use in automations and scripts.
Quick Start with Chime TTS
mainTo set up Chime TTS, follow these steps:
- Installation: Install the integration via HACS (Home Assistant Community Store) or through a manual installation.
- Add the Integration: Add Chime TTS to your Home Assistant instance via the Integrations menu.
- Additional Requirements: Ensure you have a TTS platform (like Google Translate TTS, Nabu Casa, etc.) configured in Home Assistant and check for any player-specific requirements for your media players.
After installation, you can manage defaults, chimes, and logs via the Chime TTS sidebar panel in Home Assistant or through the Settings button on the integration page.
Add custom chimes to Chime TTS
mainTo include your own custom audio files as chimes, you must place them in the designated custom chimes folder. Detailed instructions on the folder structure and service configuration can be found in the official documentation.
Refer to the Custom Chimes documentation for specific setup steps.
Use Chime TTS Actions in Automations and Scripts
mainChime TTS provides four primary actions that you can call within Home Assistant automations or scripts:
chime_tts.say: Generates and plays combined audio (chimes + TTS) on one or more media players.chime_tts.say_url: Generates the combined audio file and returns a public URL or media-source identifier without triggering playback.chime_tts.replay: Repeats the most recent Chime TTS playback request.chime_tts.clear_cache: Removes all generated audio files from the local cache.
Detailed parameter documentation for these actions can be found in the official documentation.