Home
Softono

Hass Edge Tts

Open source Python
482
Stars
79
Forks
17
Issues
10
Watchers
3 months
Last Commit

 About Hass Edge Tts

🗣️ Microsoft Edge TTS for Home Assistant, no need for app_key

Platforms

Web Self-hosted

Languages

Python

Links

Need Help Installing Hass Edge Tts?

We provide expert installation service for this software. Our team will install, configure, and secure Hass Edge Tts on your server. plans start at just $30.

Hass Edge Tts

View on GitHub

Microsoft Edge TTS for Home Assistant

This component is based on the TTS service of Microsoft Edge browser, no need to apply for app_key.

Install

Install repository

Download and copy custom_components/edge_tts folder to custom_components folder in your HomeAssistant config folder

# Auto install via terminal shell
wget -O - https://hacs.vip/get | DOMAIN=edge_tts REPO_PATH=hasscc/hass-edge-tts ARCHIVE_TAG=main bash -

Config

[UI: config - integrations - add integration - Microsoft Edge TTS ]

Add Integration

add integration
add integration
config option
config option
entity
entity
call service
call service

Supported languages

Using

Options

style / styledegree / role / contour are no longer supported (#8).

Basic example

action: tts.speak
target:
  entity_id: tts.edge_tts
data:
  media_player_entity_id: media_player.your_player_entity_id
  message: Hello
  language: zh-CN-XiaoyiNeural # Language or voice (Optional)

Full example

action: tts.speak
target:
  entity_id: tts.edge_tts
data:
  media_player_entity_id: media_player.your_player_entity_id
  message: 吃葡萄不吐葡萄皮,不吃葡萄倒吐葡萄皮
  language: zh-CN
  cache: true
  options:
    voice: zh-CN-XiaoyiNeural
    rate: +0%
    volume: +10%

More examples

curl -X POST -H "Authorization: Bearer <ACCESS TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"engine_id": "tts.edge_tts", "message": "欢迎回家", "language": "zh-CN-XiaoyiNeural", "cache": true, "options": {"volume": "+10%"}}' \
     http://homeassistant.local:8123/api/tts_get_url
curl -o hello.mp3 'http://homeassistant.local:8123/api/tts_proxy/edge?rate=+20%&message=hello&token=<tts_token>'

The tts_token can be found in the tts entity attributes.

Links