Skip to content

tts-server-proxy v0.6.0 — "Speech engine problem" fixed for good

Choose a tag to compare

@manu69x manu69x released this 05 Nov 20:10
· 2 commits to main since this release

The reliability release. It fixes the intermittent "Speech engine problem" reported by TTS clients (launchers, e-book readers) after the engine has been idle for a while — requests vanished without a trace even though the server was healthy.

What was happening

The TTS engine service was only ever bound, never started. On Android 12+, a background bind cannot call startForeground(), so the "engine ready" notification was never posted (33 days of uptime: numPostedByApp=0). Whenever the system killed the idle process, clients re-bound to a fresh cached process that could end up frozen — onSynthesizeText() was never invoked and the client showed "Speech engine problem".

What's new in v0.6.0

  • Foreground service started from boot — a BOOT_COMPLETED receiver calls startForegroundService(); boot-started foreground services are exempt from the background-launch restrictions. Verified on Android 16 (nubia ROM): after a reboot, with no app opened, the service runs with isForeground=true, types=mediaPlayback, and the persistent "engine ready" notification exists.
  • START_STICKY — after any process kill the system restarts the service; system-initiated restarts are also exempt from the restrictions.
  • Self-healing — opening the app re-promotes the service to foreground (always allowed from a visible activity).
  • Retry on HTTP 5xx (3 attempts, 2 s apart) — recovers from engines that crash on their first spawn after a cold wake (e.g. a Vulkan rig waking from S5). True timeouts are deliberately not retried, to avoid duplicating slow synthesis.
  • New permission: RECEIVE_BOOT_COMPLETED. On first launch Android still asks for the battery-optimization exemption — keep it allowed.

Upgrade notes

If a client app was bound to the old engine, re-select the TTS engine once after updating (one-time artifact of app updates, not a bug).

Files

APK: apk/tts-server-proxy-v0.6.0.apk in the repo (direct link).
Docs: Compatible TTS servers — ready-made Windows/Linux servers that speak the same OpenAI-style API (Chatterbox TTS Server, Kokoro-FastAPI, AllTalk TTS V2, Qwen3-TTS on Linux).