Kokoro Android system TTS driver

A system text-to-speech engine (TextToSpeechService) for Android that speaks through

a Kokoro server, so any app that can read text aloud can use it.

It is not a plain HTTP client. Kokoro's hard limit is 510 phoneme tokens, and because

that counts the length of the IPA phoneme string rather than characters, a character

budget cannot enforce it: a 42-character Chinese sentence is 545 tokens, while English

prose of the same length is about 42. Text is therefore split on the device by a cost

model fitted to real Kokoro G2P output, and every split is verified lossless - the

same words, in the same order.

What it does:

* Splits text on the device, sized by estimated phoneme tokens rather than characters

* Trims the silence Kokoro pads around every chunk (50 ms before, 360 ms after)

* Inserts pauses at chunk joins, or none at all if the app you listen with already

adds its own

* Starts speaking after a deliberately small first chunk, so turning a page begins in

about a second instead of six

* Fetches the next chunk while the current one is still playing

* Fetches the voice list from the server, so every voice it offers is selectable

Requires a Kokoro server that you run yourself. Any OpenAI-compatible

/v1/audio/speech endpoint works; this was developed and measured against

Kokoro-FastAPI. The endpoint is configurable, so nothing is tied to one host, and

the app sends nothing anywhere except to the server you point it at.

Both http:// and https:// endpoints work, so a server behind a reverse proxy with a

certificate can be reached over TLS. The default is plain http:// because the usual

case is a Kokoro server on your own network.

No ads, no tracking, no accounts, no network access beyond your own server.