Using Piper TTS in addons

Requirements

manifest.permissions includes voice.tts.
User has not disabled voice in Settings → Voice.

Basic usage


await piper.speak("Bitcoin is up two percent today.", {
  voice: "en_au_female_fast",
  priority: "normal",
});

Priority levels

Priority	Behaviour
`low`	Drops if user is speaking
`normal`	Queues behind user-facing replies
`high`	Interrupts low-priority addon chatter

⚠️ Warning: Never spam TTS in loops — mirror speakers annoy entire households. Debounce to ≥ 30 s for repeating alerts unless user configures faster.

SSML / pauses

If supported by your Piper build:


await piper.speak("Price alert. <break time='400ms'/> Bitcoin crossed fifty thousand.");

Troubleshooting

Silent
Amp muted; HDMI audio profile wrong; missing voice.tts permission.