Skip to content

joopdo/polly_tts

Repository files navigation

Polly TTS - Amazon Polly Text-to-Speech for Home Assistant

hacs_badge

A Home Assistant custom integration for Amazon Polly TTS that supports the modern tts.speak service.

Features

  • ✅ Modern tts.speak service support (not just legacy tts.xxx_say)
  • ✅ Config flow setup via UI (no YAML needed)
  • ✅ All Amazon Polly voices supported
  • ✅ Neural, Standard, Generative, and Long-form engines
  • ✅ Multiple output formats (MP3, OGG, PCM)
  • ✅ Configurable sample rates

Installation

HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Click on "Integrations"
  3. Click the three dots in the top right corner
  4. Select "Custom repositories"
  5. Add https://github.com/joopdo/polly_tts with category "Integration"
  6. Click "Install"
  7. Restart Home Assistant

Manual Installation

  1. Download the polly_tts folder from this repository
  2. Copy it to config/custom_components/polly_tts
  3. Restart Home Assistant

Configuration

  1. Go to SettingsDevices & Services
  2. Click + Add Integration
  3. Search for "Polly TTS"
  4. Enter your AWS credentials:
    • AWS Access Key ID
    • AWS Secret Access Key
    • AWS Region (e.g., eu-west-1)
  5. Select your preferred voice and settings

AWS Setup

  1. Create an AWS account at aws.amazon.com
  2. Go to IAM and create a new user with programmatic access
  3. Attach the AmazonPollyReadOnlyAccess policy
  4. Save the Access Key ID and Secret Access Key

Usage

Basic usage with tts.speak

action: tts.speak
target:
  entity_id: tts.polly_lotte
data:
  media_player_entity_id: media_player.living_room_speaker
  message: "Hello, this is a test!"

## Credits

    Original Amazon Polly integration by @jschlyter
    Modern TTS Entity implementation by @joopdo
    Largely vibe-coded with Claude Opus 4 🤖

Schermafdruk van 2026-02-21 21-59-54 Schermafdruk van 2026-02-21 22-00-28

About

An Amazon Polly speak TTS for Homeassistant.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages