MA_READER_ANDROID

# MA Reader for Android

MA Reader v26, ported from macOS to a standalone Android app. Paste text, hear it read, watch the
word being spoken light up as it is spoken.

Built by Mantra Productions.

## How it is put together

The macOS original is a Python Flask server with an HTML front end. The port keeps that shape and
replaces only the Python: **the front end is the macOS one, unchanged**, served to a `WebView` by a
small local server on `127.0.0.1`. A year of interface work carries across intact, and the port is
verifiable, because the same JavaScript either works against the endpoints or it does not.

The speech engine, the Edge speech client and the word timing alignment, lives in
[MA_READER_ENGINE](https://github.com/markoboskoauroville/MA_READER_ENGINE) and is consumed here as
a git submodule. It is shared with LLL, the reader inside Talk to Type, and there are no copies of
it anywhere.

## Where it is

The app installs, opens, takes pasted text, splits it into sentences exactly as the macOS reader
does, renders it, and archives it. **It does not speak yet.** The voice client is the next step.

See [HANDOFF.md](HANDOFF.md) for the full state, the architecture decisions and what comes next.

## Building

Every push to `main` builds a signed release APK and publishes it. The two newest releases are kept.

```
git clone --recurse-submodules https://github.com/markoboskoauroville/MA_READER_ANDROID.git
./gradlew :app:assembleRelease
```