Android LT 1.2.0: two ready-made apps (Ingute + Parakeetype LT) in the card

AI_CONSULTANT_BRIEF.md

@@ -11,8 +11,10 @@ usually Lithuanian.
 
 **Ask before you advise, one question per message:**
 
-1. Which step are they on (1 to 5 in the README), and what does the screen show? Ask for a
-   screenshot; the phone's menus may be in another language (the author's phone is in Russian).
+1. Which route: our ready-made apps **"Ingutė"** / **"Parakeetype LT"** (since 1.2.0, the normal
+   route) or SherpaTTS from F-Droid with `adb` (the advanced route)? Which step, and what does the
+   screen show? Ask for a screenshot; the phone's menus may be in another language (the author's
+   phone is in Russian).
 2. Phone make and Android version (Settings → About phone).
 3. Is the problem *installing*, *no sound*, or *how it sounds* (missing s, wrong stress, speed)?
 
@@ -25,7 +27,18 @@ and stay with them through the first error.
 text-to-speech engine. Part of the "Claude's Gifts" family (github.com/RobertasTa): free, runs on
 the phone, no accounts, no internet after installing.
 
-Three files:
+**Since 1.2.0 (2026-11-03): two ready-made apps**, both in the release, signed with the authors'
+key (certificate SHA-256 `8679aa5fbfd9f9f96d53ba761e72c9b0f7a361ffdc8493e33bb905e077afaf7f`):
+
+- `Ingute-1.0.apk`: app **"Ingutė"**, package `io.github.robertasta.ingute`. It is SherpaTTS 3.4
+  (woheller69) with the voice, the `tokens.txt` fix and `lt_dict` built in. Source:
+  https://github.com/RobertasTa/ttsEngine/tree/ingute
+- `Parakeetype-LT-0.5.0-lt2.apk`: app **"Parakeetype LT"**, package
+  `io.github.robertasta.parakeetype_lt`. It is Parakeetype (theScrabi) with the Lithuanian model first
+  and as the default. No internet permission. Source:
+  https://github.com/RobertasTa/Parakeetype/tree/lt-build
+
+The advanced route uses three loose files:
 
 - `lt_LT-ingute-medium.onnx` (63 MB): the voice, sherpa-onnx format.
 - `tokens.txt`: maps eSpeak NG's `ʂ` to `s`. Without it many s sounds vanish.
@@ -39,6 +52,26 @@ this part; see "Ears" below.
 
 ## Facts you must know before answering
 
+**Our apps (normal route):**
+
+- "Ingutė" installs the voice by itself the first time any part of it starts, also when the person
+  never opens the app and goes straight to the text-to-speech settings. No `adb`, no F-Droid. It
+  can live next to an original SherpaTTS; they are two separate engines in the settings list.
+- "Ingutė" copies its `lt_dict` again after every app update; the person never touches it.
+- Installing from a browser or file manager: the phone asks to allow installs from that source.
+  Google Play Protect may offer to scan "Parakeetype LT": "Scan", then "Install" (on the author's
+  phone the answer was "looks safe"). Xiaomi also runs its own scan.
+- "Parakeetype LT": open it → allow the microphone → "Install" next to "Model not installed" → the
+  first card "Parakeet Lithuanian (Default)" → "Download in browser" (direct link to the 955 MB ZIP)
+  → "Import model file" → the ZIP. It becomes the active model by itself.
+- Enabling the keyboard shows Android's standard warning that it "may collect everything you type";
+  "Parakeetype LT" has no internet permission, so the text cannot leave the phone.
+- Both apps show woheller69's English notice about Google's 2026/2027 developer identity
+  requirement (a library they inherited). The authors have not decided yet what they will do; do
+  not say the apps will stop working.
+
+**SherpaTTS from F-Droid (advanced route):**
+
 - SherpaTTS comes from **F-Droid**, not Google Play. On Google Play a search shows other apps,
   some full of ads and data sharing. The right app: name SherpaTTS, package
   `org.woheller69.ttsengine`, version 3.4, no ads, no consent screens.
@@ -63,7 +96,7 @@ this part; see "Ears" below.
 Installing the voice does not make the phone use it. Two settings, once:
 
 1. **System voice**: settings search "text-to-speech" (Russian "синтез"): preferred engine
-   **SherpaTTS** (Android warns the engine "may collect text"; shown for every non-Google engine;
+   **Ingutė** (or **SherpaTTS** on the advanced route; Android warns the engine "may collect text"; shown for every non-Google engine;
    OK), language **Lithuanian**, then Play to hear Ingutė. If the language stays "system language"
    on a non-Lithuanian phone, the Play button and sliders are grey.
 2. **Reading any text on screen**: settings search "Select to Speak" (Russian "Озвучивание при
@@ -88,16 +121,21 @@ page.
 | Ingutė works inside SherpaTTS, but the phone still reads with another voice | default engine is still Google's, or language is not Lithuanian (see "Everyday use") |
 | Play button and speed slider grey in text-to-speech settings | language is "system language" (e.g. Russian), which Ingutė does not speak; choose Lithuanian |
 | "I installed it, how do I make it read my messages?" | Select to Speak (see "Everyday use") |
+| "Ingutė" app installed, but no Lithuanian / no sound in the settings | engine not switched to "Ingutė", or language not Lithuanian; if still silent, open the Ingutė app once and press ▶ |
+| Two similar engines in the list (Ingutė and SherpaTTS) | both apps installed; pick "Ingutė", the original SherpaTTS can be uninstalled |
+| Install blocked by Play Protect | tap "Scan" (not "Don't install"), then "Install" |
 
 ## Ears (dictation with Parakeetype)
 
-- Parakeetype accepts only models listed in its own code, with fixed file hashes. The Lithuanian
-  entry is proposed in https://github.com/theScrabi/Parakeetype/pull/1. **Check that PR's state
-  first.** If it is not merged, the F-Droid app shows no "Parakeet Lithuanian" card; the person
-  has to wait or build the app from https://github.com/RobertasTa/Parakeetype/tree/add-lithuanian-model
-  (README, "Build it yourself").
-- Import: main screen → "Install" next to "Model not installed" → scroll to the **Parakeet
-  Lithuanian** card (below Parakeet Ultra) → "Import model file" → the ZIP. Then "Set as Active".
+- **Normal route: "Parakeetype LT"** from the release (see "Facts" above). The Lithuanian card is
+  first and active as soon as the ZIP is imported.
+- Parakeetype accepts only models listed in its own code, with fixed file hashes. For the
+  **F-Droid** Parakeetype the Lithuanian entry is proposed in
+  https://github.com/theScrabi/Parakeetype/pull/1; if it is not merged, the F-Droid app shows no
+  "Parakeet Lithuanian" card. Then use "Parakeetype LT" instead.
+- Import in the F-Droid app (once the PR is merged): main screen → "Install" next to "Model not
+  installed" → scroll to the **Parakeet Lithuanian** card (below Parakeet Ultra) → "Import model
+  file" → the ZIP. Then "Set as Active".
 - Switching to it: in Gboard long-press the 🌐 globe → "Parakeetype Voice Input". Back: the
   small keyboard icon on the right, above Enter.
 - Measured word error rate, Parakeetype's default model vs. these ears: FLEURS 27.1 % → 10.6 %,
@@ -106,14 +144,17 @@ page.
 | Symptom | Cause |
 |---|---|
 | Import says the hashes do not match | archive imported on the Parakeet Ultra card; use the Parakeet Lithuanian card |
-| No "Parakeet Lithuanian" card | the installed Parakeetype does not include the PR yet |
-| A self-built app will not install over the F-Droid one | different signing keys; uninstall the other one first |
+| No "Parakeet Lithuanian" card | it is the F-Droid Parakeetype without the PR; install "Parakeetype LT" from the release |
+| Two "Parakeetype" entries in the keyboard list | both the F-Droid app and "Parakeetype LT" are installed; use the one with the Lithuanian model, or uninstall the other |
+| One app will not install over another (self-built, F-Droid, ours) | different signing keys; uninstall the other one first |
 | `adb install` fails with `INSTALL_FAILED_USER_RESTRICTED` (Xiaomi) | copy the APK to Download and tap it in a file manager |
 | Lithuanian dictation comes out as Russian or nonsense | the default model is active; set Parakeet Lithuanian as active |
 
 ## Things you must NOT claim
 
-- That this is on Google Play, or that SherpaTTS is made by the authors. It is woheller69's app.
+- That this is on Google Play or F-Droid, or that SherpaTTS or Parakeetype are made by the authors.
+  They are woheller69's and theScrabi's apps; "Ingutė" and "Parakeetype LT" are the authors'
+  Lithuanian builds of them (GPL-3.0, source linked above).
 - That stress is perfect: about 9 % of words are not in the dictionary, and pitch accents are
   not expressed.
 - That it is "the first" or "the only" Lithuanian voice for Android.

README.md

@@ -31,8 +31,11 @@ tags:
 Ingutė, a Lithuanian synthetic voice, on your Android phone, offline. The phone uses it wherever
 it can read aloud: the text-to-speech settings, the screen reader, book and article readers.
 
-Since 1.1.0 there are **ears** too: speak Lithuanian to the phone and the text appears in any text
-field, also offline (see [Ears](#ears-lithuanian-dictation-parakeetype)).
+There are **ears** too: speak Lithuanian to the phone and the text appears in any text field:
+SMS, notes, the ChatGPT, Claude or Gemini app. Also offline (see [Ears](#ears-lithuanian-dictation-parakeetype)).
+
+**Since 1.2.0 there are two ready-made apps:** download, install, done. No F-Droid, no cable, no
+computer → [Installing](#installing-about-5-minutes)
 
 **Installed it but not sure what next?** → [Everyday use](#everyday-use)
 
@@ -40,20 +43,61 @@ field, also offline (see [Ears](#ears-lithuanian-dictation-parakeetype)).
 
 ## What is here
 
-- **Ingutė** in sherpa-onnx format (`lt_LT-ingute-medium.onnx`, 63 MB) and a **`tokens.txt`** with
-  an "s" fix. eSpeak NG writes Lithuanian /s/ as `ʂ` in many positions, a symbol the voice
-  hardly learned, so without the fix many s sounds disappear ("pasiimk skėtį" comes out as
-  "paimk kėtį").
-- **`lt_dict`**: the Lithuanian eSpeak NG dictionary with the stressed syllable for 189,000 word
-  forms. Without it the stress is guessed by rules and is wrong in about half of the
-  multi-syllable words.
-- **Ears** (`parakeet-lt-kmynas-int8.zip`, 955 MB): a Lithuanian speech recognition model for
-  the Parakeetype voice keyboard.
-
-The voice is played by **SherpaTTS**, a free open-source Android TTS engine. It is not part of
-this package; install it separately (step 1).
-
-## Installing (about 10 minutes)
+- **`Ingute-1.0.apk`** (151 MB): the app "Ingutė", a Lithuanian voice for the phone. The voice, the
+  "s" fix and the stress dictionary are already inside; once installed it becomes the phone's voice
+  by itself. It is [SherpaTTS](https://github.com/woheller69/ttsEngine) 3.4 (woheller69) with our
+  Lithuanian additions ([source](https://github.com/RobertasTa/ttsEngine/tree/ingute)).
+- **`Parakeetype-LT-0.5.0-lt2.apk`** (59 MB): the voice keyboard "Parakeetype LT" for Lithuanian
+  dictation. It is [Parakeetype](https://github.com/theScrabi/Parakeetype) (theScrabi) with the
+  Lithuanian model first and as the default ([source](https://github.com/RobertasTa/Parakeetype/tree/lt-build)).
+  It has no internet permission.
+- **Ears** (`parakeet-lt-kmynas-int8.zip`, 955 MB): the Lithuanian speech recognition model for that
+  keyboard; the app shows where to download it.
+- For advanced users, separately: **Ingutė** in sherpa-onnx format (`lt_LT-ingute-medium.onnx`,
+  63 MB), a **`tokens.txt`** with an "s" fix (eSpeak NG writes Lithuanian /s/ as `ʂ` in many
+  positions, a symbol the voice hardly learned, so "pasiimk skėtį" comes out as "paimk kėtį"), and
+  **`lt_dict`**, the eSpeak NG dictionary with the stressed syllable for 189,000 word forms (without
+  it the stress is wrong in about half of the multi-syllable words).
+
+Both apps are signed with our key, certificate SHA-256
+`8679aa5fbfd9f9f96d53ba761e72c9b0f7a361ffdc8493e33bb905e077afaf7f`; file hashes are in `SHA256SUMS.txt`
+in the release.
+
+## Installing (about 5 minutes)
+
+Android 10 or newer (Android 12 for the ears). Both files are in the
+[release](https://github.com/RobertasTa/android-lt/releases/latest).
+
+### Voice: "Ingutė"
+
+1. **Download** `Ingute-1.0.apk` to the phone and tap it (in the browser or a file manager, in the
+   Download folder). The phone asks whether to allow installing apps from this source: **allow** it.
+2. **Install.** No need to open the app: Ingutė installs herself.
+3. **Phone settings** → "Text-to-speech output" → engine **Ingutė**, language **Lithuanian** →
+   "Listen to an example". Ingutė speaks, with the stress already right.
+
+### Ears: "Parakeetype LT"
+
+1. **Download and install** `Parakeetype-LT-0.5.0-lt2.apk`. If Google Play Protect offers to scan
+   the app, tap **Scan**, then **Install** (for us it answered that the app looks safe).
+2. **Open** it, allow the microphone, and next to "Model not installed" tap **Install**.
+3. On the **"Parakeet Lithuanian (Default)"** card: **Download in browser** (955 MB, Wi-Fi is better).
+   When it has downloaded: **Import model file** → `parakeet-lt-kmynas-int8.zip`. A minute later the
+   card says **Active model**; you can delete the archive.
+4. On the start screen, next to "Keyboard not enabled" → **Open settings** → turn Parakeetype on.
+   Android warns that the keyboard "may collect everything you type": it says this for every
+   keyboard, and this one has no internet permission, so the text never leaves the phone → **OK**.
+5. **Dictate**: in any text field long-press 🌐 in Gboard → **Parakeetype Voice Input**, hold the big
+   microphone button and speak.
+
+| | | | |
+|---|---|---|---|
+| ![Settings: engine Ingutė, language Lithuanian](docs/apk_ingute_nustatymai.jpg) | ![Parakeet Lithuanian first and default](docs/apk_modelis.jpg) | ![After the import: Active model](docs/apk_aktyvus.jpg) | ![Dictated: "Labas, tai yra lietuviškos ausys Android telefonui"](docs/apk_padiktuota.jpg) |
+
+The app screenshots are in Lithuanian, the system dialogs in Russian (the phone's language).
+
+<details>
+<summary><b>Advanced: the voice through SherpaTTS from F-Droid</b> (without our app, about 10 minutes)</summary>
 
 1. **Install SherpaTTS from F-Droid.** It is not on Google Play; searching there shows other,
    ad-supported apps.
@@ -97,6 +141,8 @@ Open SherpaTTS and listen to "Dabar labai gera diena, nes Lietuvos rinktinė lai
 You can switch USB debugging off afterwards. To undo, rename `lt_dict_orig` back to `lt_dict`.
 Reinstalling SherpaTTS or clearing its data undoes step 5.
 
+</details>
+
 ## Measurements
 
 A Lithuanian speech recognition model listened to 12 everyday sentences (no numbers):
@@ -133,36 +179,18 @@ hears Lithuanian poorly; `parakeet-lt-kmynas-int8.zip` gives it Lithuanian ears.
 Measured on a PC with a script that follows Parakeetype's recognition path exactly; tested live on
 Robertas's phone (Xiaomi 12T Pro, Android 15).
 
-**Status (2026-10-29).** For Parakeetype from F-Droid to accept this archive, its author has to
-merge our proposal [theScrabi/Parakeetype#1](https://github.com/theScrabi/Parakeetype/pull/1).
-Until then you can build the app with the Lithuanian model yourself ("Build it yourself" below).
-
-### Installing
+**Installing**: see ["Ears: Parakeetype LT"](#ears-parakeetype-lt) above, our ready-made app. Once
+Parakeetype's author merges our proposal [theScrabi/Parakeetype#1](https://github.com/theScrabi/Parakeetype/pull/1),
+the F-Droid Parakeetype will offer the Lithuanian model too.
 
-1. **Parakeetype**: from F-Droid once the proposal is merged, or built yourself.
-2. **Download to the phone** `parakeet-lt-kmynas-int8.zip` (955 MB) from the
-   [release](https://huggingface.co/RobertasTa/android-lt/tree/main).
-3. On Parakeetype's main screen enable the keyboard and allow the microphone. Next to "Model not
-   installed" tap "Install", scroll down to the **Parakeet Lithuanian** card → "Import model
-   file" → the archive. The app checks every file's hash; you can delete the archive afterwards.
-4. On the same card: "Set as Active".
-5. **Dictate**: open any text field (notes, for example) and switch the keyboard to Parakeetype.
-   In Gboard, long-press the 🌐 globe and pick "Parakeetype Voice Input". Hold the big microphone
-   button and speak. The first time, the model takes a few seconds to load.
-6. **Back to your usual keyboard**: the small keyboard icon on the right, above the Enter key.
-
-| | | |
-|---|---|---|
-| ![Parakeet Lithuanian as the active model](docs/parakeetype_model.jpg) | ![Switching keyboards: Parakeetype voice input](docs/parakeetype_switch.jpg) | ![Dictated: "Labas testas yra. Tikrinam, kaip ausys veikia."](docs/parakeetype_dictation.jpg) |
-
-### Build it yourself (until the proposal is merged)
+### Build it yourself
 
 You need a computer with Java 17 or newer and the Android SDK: [Android Studio](https://developer.android.com/studio)
 or Google's command-line tools (`android sdk install "platforms;android-37.0" "build-tools;37.0.0"`).
 The first build downloads about 1 GB.
 
 ```
-git clone -b add-lithuanian-model https://github.com/RobertasTa/Parakeetype.git
+git clone -b lt-build https://github.com/RobertasTa/Parakeetype.git
 cd Parakeetype
 ./gradlew assembleDebug
 ```
@@ -171,8 +199,9 @@ On Windows: `gradlew assembleDebug`. Point to the Android SDK with `sdk.dir=...`
 `local.properties` or the `ANDROID_HOME` variable. Copy the resulting
 `app/build/outputs/apk/debug/app-debug.apk` to the phone's Download folder and tap it in a file
 manager (Xiaomi phones refuse `adb install` without a Mi account). If you already have
-Parakeetype from F-Droid, uninstall it first: apps signed with different keys cannot update each
-other. Once the proposal is merged, uninstall your build and install the F-Droid one.
+"Parakeetype LT" from our release, uninstall it first: apps signed with different keys cannot
+update each other. The voice app's source is branch [`ingute`](https://github.com/RobertasTa/ttsEngine/tree/ingute);
+it builds the same way.
 
 ### Limits of the ears
 
@@ -192,8 +221,9 @@ it afterwards. Menu names differ a little between phones, so the easiest way to
 
 Search the settings for "text-to-speech".
 
-- **Preferred engine** → **SherpaTTS**. Android warns that the engine "may collect text"; it shows
-  this for every voice that is not Google's. SherpaTTS processes the text on the phone → **OK**.
+- **Preferred engine** → **Ingutė** (or **SherpaTTS** if you took the advanced route). Android warns
+  that the engine "may collect text"; it shows this for every voice that is not Google's. Ingutė
+  processes the text on the phone → **OK**.
 - **Language** → **Lithuanian**. If it stays at "system language" on a phone that is not in
   Lithuanian, the buttons are grey and nothing speaks.
 - **Play** (listen to an example): Ingutė should speak. The speed slider is right there.
@@ -238,9 +268,12 @@ mistakes, and it will answer in your language.
 
 ## Licences
 
-The header above names the voice licence; the ears archive is CC BY 4.0 (below).
-
+The header above names the voice licence; the apps are GPL-3.0 and the ears archive is CC BY 4.0 (below).
 
+- **Apps**: GPL-3.0, like their originals. "Ingutė" is SherpaTTS (woheller69) with our changes
+  ([source](https://github.com/RobertasTa/ttsEngine/tree/ingute)); "Parakeetype LT" is Parakeetype
+  (theScrabi) with our changes ([source](https://github.com/RobertasTa/Parakeetype/tree/lt-build)).
+  The voice and dictionary inside "Ingutė" are under the licences below.
 - **Voice** (`lt_LT-ingute-medium.onnx`, `tokens.txt`): NewGenLTU Open RAIL-D 1.0. Free of
   charge, commercial use is not prohibited, use restrictions apply; when passing it on, include
   [LICENSE-VOICE](LICENSE-VOICE) and state the origin. Ingutė was grown from the Reginutė model