Skip to content

Ferrous v1.3.2

Choose a tag to compare

@github-actions github-actions released this 10 Nov 22:42
· 24 commits to main since this release

Which APK should I install?

File Architecture Target Devices Notes
ferrous-v1.3.2-arm64-v8a.apk arm64-v8a Modern phones and tablets Recommended (most devices)
ferrous-v1.3.2-armeabi-v7a.apk armeabi-v7a Older 32-bit Android phones Devices from 2016 or earlier / 32-bit
ferrous-v1.3.2-x86_64.apk x86_64 Emulators and ChromeOS PC emulators (BlueStacks, LDPlayer)

Note: If you are unsure which build your device requires, choose arm64-v8a.


Verify Checksums (SHA-256)

Verify your download against SHA256SUMS.txt using sha256sum -c SHA256SUMS.txt:

File SHA-256 Hash
ferrous-v1.3.2-arm64-v8a.apk 5f4364061b51e9a144fa71d922748ac03379bc3bdb761ba97842fce0f105f96a
ferrous-v1.3.2-armeabi-v7a.apk be6d930be347fdb9c3f3d3335d4c788e4084e8665227a3e81af7985c4d78f80a
ferrous-v1.3.2-x86_64.apk 58f9e8e2b7973f240f4ac2b482e29a414e997e4c3dd3bf42d0c3e129219074b4

Changelog

HTML Paragraph Defragmentation & Reader Typography

  • HTML Paragraph Defragmenter: Implemented HtmlDefragmenter to scan and stitch together artificially split paragraphs in converted EPUB and MOBI files while preserving formatting, styling, and navigation anchors.
  • Soft-Hyphen Stripping & Whitespace Normalization: Stripped rogue soft-hyphens (\u00AD) and condensed redundant whitespace and tabs across text nodes when hyphenation is disabled.
  • Hyphenation Default Update: Switched default hyphenation setting in ReaderThemeConfig from true to false for cleaner baseline typography across reflowable reader views.
  • Chapter Controller Integration: Integrated DOM defragmentation into EpubChapterController, MobiChapterController, and HyphenationHelper pipeline prior to sentence tokenization and indentation tagging.

CBZ & Comic Reader Adaptive Canvas

  • Multi-Stop Edge Color Profiles: Extracted 8-stop horizontal and vertical edge gradients (topProfile, bottomProfile) from raw RGBA buffers to support split-tone, dual-colored, and graphic border pages without letterbox banding.
  • Manga White-Paper Detection: Added heuristic monochrome paper classification to preserve clean off-white margins and eliminate harsh dark letterboxing during manga reading.
  • 3-Depth Band Sampling & Clustering: Implemented 3-depth sampling bands (3px, 7px, 12px) with exact-sum clustering to eliminate scanner crop borders, panel margins, and screentone noise while accurately sampling full-bleed artwork.
  • Dynamic Gutter Separator Bridge: Added intelligent canvas bridging in continuous and webtoon reading modes, matching background colors across page boundaries and preventing dark gutter flashing between light pages.
  • Nearby Page Color Pre-warming: Expanded notifyCornerColorsAvailable notification radius to ±3 adjacent pages, pre-warming background gradients ahead of user scroll gestures.

MOBI Reader Architecture & Metadata

  • Byte-Exact Chapter Slicing via NCX Targets: Refactored Rust MOBI engine to slice raw document bytes directly using NCX table of contents byte offsets (filepos) with safe UTF-8 boundary snapping and target deduplication.
  • Front Matter & Title Page Extraction: Added automatic front matter boundary detection to extract cover and title pages located prior to the first chapter target.
  • Dynamic Image Path Normalization: Converted MOBI recindex image references directly to local filesystem URIs (file://) with automatic format fallback detection (.jpg / .png).
  • Metadata Extraction in Library Scanner: Integrated getMobiTitle and getMobiAuthor FFI bindings into storage scanning to automatically extract real MOBI and AZW titles and authors.

Reader Navigation & Anchor Resolution

  • In-Book Footnote & Anchor Navigation: Implemented anchor target mapping (#anchor and file-prefixed fragments) across EPUB and MOBI chapter controllers.
  • Interactive Link Tapping: Wired link handlers across paged and continuous reader modes to smoothly jump to anchor positions, chapters, and footnotes without corrupting reading state.
  • EPUB Fallback Parser Anchors: Added anchor collection and source file tracking to the EPUB fallback parser.