TroubleshootingFix: TTS Not Playing in OpenCode

Fix: TTS Not Playing in OpenCode

Symptom: TTS is enabled but no audio plays when the AI responds.

Common Causes

⚠ TTS is disabled

Type /tts-on in the session to enable TTS. It is enabled by default, but may have been toggled off.

⚠ No audio output device

Check your system audio output. Run speaker-test (Linux) or check Sound settings (macOS). Ensure volume is up.

⚠ PulseAudio/PipeWire not running (Linux)

Check with pactl info. Start with pulseaudio --start or systemctl --user start pipewire.

⚠ edge-tts not installed

Edge-tts is bundled with the plugin. Verify with which edge-tts or check plugin logs.

⚠ First-time voice download failing

Edge-tts downloads voice data on first use. Ensure internet access. Subsequent uses work offline.

Fallback

TTS is optional. Continue using /ptt with text responses. The walkie-talkie feature works without TTS.

Still having trouble?

Contact support →