Skip to content

Usugami 1.5.1

Choose a tag to compare

@github-actions github-actions released this 04 Nov 19:04
· 206 commits to main since this release

Changed

  • Usugami Lite is an app of its own (package io.github.nath_goa.usugami.lite), so it can be
    listed on F-Droid and installs next to Usugami. Had Lite 1.5.0? The new Lite installs as a separate
    app: save anything you need from the old one (listed as "Usugami"), then uninstall it.
  • Getting ready for F-Droid: Usugami (with the open-source text recognition of Usugami OCR) and
    Usugami Lite build reproducibly, so F-Droid can offer exactly the APKs published here, signed with
    the same key, and you can switch between F-Droid, GitHub and Obtainium without reinstalling.
  • Usugami OCR's text-recognition library comes out byte for byte the same wherever it is built, and
    is 17 KB smaller.

Which file should I download?

File Size Pick it if… Text recognition (OCR)
Usugami.apk (recommended) 3.1 MB You're not sure. Works on most phones. Runs through Google Play services. The first time you use it, Play services downloads the text-recognition model (one for English, French and Spanish, one for Hindi), which needs internet then.
Usugami-lite.apk 2.8 MB You don't need text recognition, and want the smallest app with no Google code at all. None.
Usugami-ocr.apk 14.1 MB Your phone has no Google Play services, or you want text recognition with no network use at all. ARM phones (virtually all phones). Open source and built into the app (PaddleOCR's models, run by ncnn). Works without internet, ever.

Every other tool works offline in all three, and Usugami itself has no internet permission. In
Usugami.apk, text recognition uses Google's ML Kit, which runs on your phone but is closed source;
Usugami Lite and Usugami OCR contain no Google code. The rest of Usugami is GPL-3.0-or-later. All
three files are signed with the same key. Usugami and Usugami OCR are the same app: install one over
the other to switch. Usugami Lite is an app of its own (package name io.github.nath_goa.usugami.lite)
that installs next to them.

Had Usugami Lite 1.5.0? It was still the same app as Usugami, so Usugami-lite.apk now installs as a
new app, "Usugami Lite", next to it. Save any PDFs you need from the old one, then uninstall it (it
is called "Usugami"). In Obtainium, remove the old Usugami Lite and
add it again.

Had Usugami Offline? It is now Usugami OCR: install Usugami-ocr.apk over it, and your files and
settings are kept. In Obtainium, change its APK filter to ^Usugami-ocr\.apk$.

Needs Android 8.0 or newer. New to installing APKs? Follow the
step-by-step guide.

Verify your download (optional)

  • Package name: io.github.nath_goa.usugami (Usugami and Usugami OCR) or
    io.github.nath_goa.usugami.lite (Usugami Lite)
  • Signing certificate SHA-256: 6F:4F:23:AD:E0:3E:63:6A:7C:C3:68:16:89:44:D0:CC:FC:81:32:EF:34:C5:0B:C5:A4:6B:0C:A4:CB:BD:F4:ED

On a phone with Android 9 or newer, paste the package name and the certificate into
AppVerifier. On a computer:

sha256sum -c --ignore-missing SHA256SUMS.txt
apksigner verify --print-certs Usugami.apk
gh attestation verify Usugami.apk --repo Nath-Goa/usugami

SHA256SUMS.txt:

d48eb6870f5fbaa020001aca16702f448df751f115e86ab2850790831278041c  Usugami.apk
36b34080029416b16d0e433aa812fe9ba218c71420e162717e55924e18355652  Usugami-lite.apk
57a4b22d49f0435b7e2f49955094a78810db069a6b45f4b5855826b282b913c7  Usugami-ocr.apk

The mapping zip file is only for developers: it holds the R8 mapping files that turn stack
traces in crash reports back into readable code. You don't need it to install Usugami.