Troubleshooting › Fix: TTS Not Playing in OpenCode
Symptom: TTS is enabled but no audio plays when the AI responds.
⚠ 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.
TTS is optional. Continue using /ptt with text responses. The walkie-talkie feature works without TTS.
Still having trouble?
Contact support →