English | 日本語
This custom integration provides Japanese TTS services using VOICEVOX in Home Assistant.
Note
To use VOICEVOX TTS, you need a server running VOICEVOX Engine.
VOICEVOX Engine App (formerly Add-on) is also available and can be used.
When using VOICEVOX TTS, please be sure to read VOICEVOX's Terms of Use and each character's Terms of Use.
Note
I have confirmed that the Japanese TTS engine AivisSpeech Engine, which is compatible with the VOICEVOX API, can also be used without any problems.
If you want to use it with AivisSpeech Engine, please enter the host and port of the server running the AivisSpeech Engine when setting up the VOICEVOX TTS integration.
Requires Home Assistant 2025.6.0 or later.
If you are using HACS (Home Assistant Community Store), click the button below or search for VOICEVOX TTS in HACS and install.
Tip
Currently this custom integration is in the default repository, so you can install it without adding a repository.
Click the button above or open HACS from the sidebar, and click ... in the upper right corner, then open Custom repositories.
Once the custom repository page opens, add a repository by entering the following
- Repository:
https://github.com/taikun114/VOICEVOX-TTS-for-Home-Assistant - Type:
Integration
Once you have added the repository, VOICEVOX TTS will appear in the list, and you can install it from there.
Download the latest release and extract the ZIP file.
After extracting, copy the custom_components/voicevox_tts folder to your Home Assistant's config/custom_components/. Then restart Home Assistant.
VOICEVOX TTS can be setup through the UI.
- Go to
Settings→Devices and servicesin Home Assistant. - Click
Add Integrationand search forVOICEVOX TTS. - Enter the host and port of the server running the VOICEVOX Engine and click
Submit.
- Choose the voice you want to use for VOICEVOX TTS and default settings and click
Submit.
This completes the setup.
From the options, you can change the voice you want to use for VOICEVOX TTS.
- Go to
Settings→Devices and servicesin Home Assistant. - Search for
VOICEVOX TTSand click on it. - Click
Configure. - Choose the voice you want to use for VOICEVOX TTS and default settings and click
Submit.
This completes the changing options.
Note
If the old voice is used after changing the voice (the changed voice is not used), a previously created cache may be in use.
You need to change the text or clear the TTS cache (run the tts.clear_cache action).
The Host and Port configured initially can be changed from reconfigure.
- Go to
Settings→Devices and servicesin Home Assistant. - Search for
VOICEVOX TTSand click on it. - Click
...at the right ofConfigureand clickReconfigure. - Enter the host and port of the server running the VOICEVOX Engine and click
Submit.
This completes the changing setup.
You can play any text from the Media page of the Home Assistant.
-
Open the
Mediapage. -
Go to
Text-to-speech→VOICEVOX TTS(or integration entry name). -
Enter the text you want to play in the
Messagefield, and clickSAY.
Tip
When playing the text, click Web browser in the lower right corner to change the playback device and then click SAY to play the text in your favorite media player.
You can use the tts.speak action to play any text in your favorite media player. Of course, you can also integrate it into automation and have it play the text.
Available options are as follows:
speaker: Enter the ID of the voice to use. The ID can be found in the voice list of the VOICEVOX TTS integration settings.volume: Enter the volume of the voice.1is the default volume. Entering too large a volume may cause sound cracking or damage to your audio device.pitch: Enter the pitch of the voice.0is the default pitch. Entering a value smaller than-0.15or larger than0.15may result in strange audio output.speed: Enter the playback speed of the voice.1is the default speed.
If you configure for use with the Home Assistant's voice assistant “Assist”, you can hear the response from Assist using the VOICEVOX TTS.
- Go to
Settings→Voice Assistantin the Home Assistant. - Click on the voice assistant you want to use VOICEVOX TTS with to open the settings window.
- Change the
Text-to-speechto the one for VOICEVOX TTS and clickUpdate.
Note
If you cannot select VOICEVOX TTS in the Text-to-speech section, please make sure that the Language in the Configuration is set to Japanese or English.
VOICEVOX TTS is only available in Japanese and English, so if it is in another language, you will not be able to select it.






