Text-to-speech (TTS) in Home Assistant
tts
part of Home Assistant since 0.35
Text-to-speech (TTS) is an official Home Assistant integration for Media source and Text-to-speech.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Setup
- in configuration.yaml
- Kind
- Entity type
- Quality scale
- Internal – Part of Home Assistant itself, not rated separately.
- Installations
- 96,940 (13.5 % of the installations that share statistics)
- Categories
- Media source, Text-to-speech
- Provides
- Notifications
- Maintained by
- @home-assistant/core
- Python packages
mutagen==1.48.1
Setup
- Nothing to install: this is part of Home Assistant and available as soon as it is running.
Blueprints that use this integration
- Automation Notifications & Announcements
- Automation Doorbell - Notify Google and send camera snapshot to app – Triggers Google notifications and sends camera snapshots via app when a doorbell is pressed.
- Automation TTS on door opening with persons at home – Triggers a TTS announcement when a door opens and persons are detected at home.
- Script Announce
- Automation Door open tts.cloud_say and Piper announcer (Uses Piper Addon OR Nabu-Casa Cloud) - 2024-06-08 – Triggers TTS announcements and Piper voice using a door sensor and input boolean.
- Automation Joke generator – Generates a random joke and plays it through a media player using TTS services.
Known issues and fixes
4 open issues and 8 bug fixes in the last twelve months are recorded for Text-to-speech (TTS) in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.10.1.
Open
- open Reported problem #158150
- open Reported problem #183198
- open Reported problem #185663
- open Reported problem #184204
Fixed
- fixed in 2026.10.1 Bug fix #185193
- fixed in 2026.10.0 Bug fix #184574
- fixed in 2026.6.2 Bug fix #173290
Source: the issue tracker of Home Assistant, as of October 26, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration
