Skip to content

Text To Speech Notification

Jump to bottom
Adam Keenan edited this page May 16, 2026 · 2 revisions

Text to Speech Action

The Text to Speech action synthesizes spoken audio from a text message and plays it through your speakers. Two sources are supported: Eleven Labs (high-quality, requires an API key) and a legacy TTS service.

📷 Screenshot needed: The TTS action panel with Eleven Labs selected as the source, showing the voice picker dropdown and volume slider

📷 Screenshot needed: The TTS action panel with Legacy selected as the source, showing the voice dropdown and rate field

Fields

Source

Selects the TTS engine.

  • Eleven Labs — high-quality neural voice synthesis. Requires an API key configured in the Watchdog plugin settings. Audio is cached locally so repeated identical messages play from cache instantly without using additional API quota.
  • Legacy — uses a built-in TTS service that requires no API key. Lower audio quality.

Message

The text to synthesize and speak. Supports capture group substitution with $1, $2, etc.

Example: $1 is ready to harvest — speaks the captured crop name dynamically.

Voice (Eleven Labs)

Select a voice from your Eleven Labs account. The dropdown is populated from your available voices after the API key is configured.

Voice (Legacy)

Select a voice from the built-in options: George, Alice, and others from the available set.

Volume

A value from 0 to 10 controlling playback volume.

Rate (Legacy only)

Speech rate multiplier. Higher values speak faster.

Eleven Labs Setup

  1. Create an account at elevenlabs.io and generate an API key here.
  2. When creating the API key, make sure it has Text to Speech: Access and Voices: Read permissions.
  3. Open the Watchdog plugin settings (gear icon in the RuneLite plugin list).
  4. Paste your API key into the Eleven Labs API Key field.
  5. Return to your TTS action panel — the voice picker will now show your available voices.

Caching: synthesized audio files are cached in ~/.runelite/cache/watchdog/. If a message changes, a new file is generated. The cache is not automatically purged; you can clear it manually by deleting the folder or specific file. You can also delete the associated file from the alert panel.

Notes

  • TTS is played locally in your client only; other players do not hear it.
  • For very short alert messages (e.g. "Patch ready!"), TTS adds a human-readable spoken cue that is easy to recognize without looking at the screen.
  • If Eleven Labs fails (network error, quota exceeded), the action silently fails. The Legacy source is a reliable fallback.

Getting Started

Alert Types

Action Types

Clone this wiki locally