Skip to content

Usugami 1.5.2

Choose a tag to compare

@github-actions github-actions released this 05 Nov 18:08
· 181 commits to main since this release

Added

  • Usugami's own F-Droid repository: add nathank.me/usugami to
    F-Droid, Droid-ify or Neo Store to get Usugami (with the open-source text recognition of Usugami
    OCR) and Usugami Lite with automatic updates. It serves exactly the APKs published here, signed
    with the same key.

Fixed

  • Redact PDF: Find text now also finds text in link and email addresses (also when written with
    escapes, like Jos%C3%A9), in the files links and buttons open, and in form fields' hidden values,
    names, tooltips, choices and default values, even in fields no page shows, and takes it out of the
    file.
  • Redact PDF: Find text now finds Hebrew and Arabic text typed as you would write it.
  • Split PDF no longer leaves blank pages where a page's picture is a JPEG 2000 image, and
    Redact PDF and Delete pages see that such pages draw those images.
  • A PDF nested too deeply, in its contents or its pages (a damaged or crafted file), is refused as
    unreadable when it is added instead of closing Usugami.
  • Flatten PDF: fields it can't draw stay fillable even when another field's widget doesn't say
    which page it is on.
  • Compress PDF leaves spot-color, CMYK and Lab JPEG images as they are instead of changing their
    colors.
  • Delete pages, Reorganize PDF and Merge PDF no longer hang on a PDF whose bookmarks
    loop, and can be cancelled there.
  • Photos taken while other images are still being added are no longer lost when Android closes
    Usugami in the background.
  • Images still being added when Android closes Usugami are no longer lost without a word: Usugami
    says to share or add them again.
  • Edit PDF: resizing text or a drawing by its handle no longer makes it jump bigger as the drag
    starts, or refuse to shrink.
  • EPUB to PDF: books whose first page is a picture other than the cover open on their cover, and
    the cover is no longer added again at the end.
  • EPUB to PDF: in right-to-left books, text set to align right or left stays on that side, and
    list bullets and indents are on the right.
  • Word to PDF: Arabic, Hebrew, Hindi and other complex-script text gets the size, bold and
    italic Word gives it.
  • Cancelling a ZIP file saved over an existing file, or running out of space while saving it,
    leaves that file as it was.
  • A name ending in ".pdf." no longer saves as "Name.pdf.pdf".
  • Usugami's F-Droid repository shows Usugami's icon instead of a QR code, and Usugami Lite is no
    longer listed under OCR.

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:

6d3300cc4952837cae70241d6dcf85f44acbb7adec3476886df591777c2985a2  Usugami.apk
94e121b07f0b7fd94452145a61242b06f15bbb344bb270c71ebd696191fad718  Usugami-lite.apk
8b06be1930f1236ac134cc3c17356169191a4873d103fa5d07f815a922920677  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.