Skip to content

Ferrous v1.3.3

Choose a tag to compare

@github-actions github-actions released this 11 Nov 15:27
· 26 commits to main since this release

Which APK should I install?

File Architecture Target Devices Notes
ferrous-v1.3.3-arm64-v8a.apk arm64-v8a Modern phones and tablets Recommended (most devices)
ferrous-v1.3.3-armeabi-v7a.apk armeabi-v7a Older 32-bit Android phones Devices from 2016 or earlier / 32-bit
ferrous-v1.3.3-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.3-arm64-v8a.apk 001e797147c0a5ae5bdc01cfa4c4b1b8c62a98562a3dca2f5a9aa219198cfcee
ferrous-v1.3.3-armeabi-v7a.apk d594c7d4105bca3b1e349f4716abc9ef968c89cc2a150dc360c6bf5428f71aab
ferrous-v1.3.3-x86_64.apk 6077f8972c4a791920a01c2392bb0fda6fbfb3dba7a1844d9228cd3ba49ff4e7

Changelog

CBR / RAR Comic Extraction & Robustness

  • 3-Tier RAR Member Resolution: Replaced fragile name lookups with 3-tier index-based matching (find_member_sanitized, find_member, and path-normalized fallback with pre-computed targets) in Rust cbz and covers modules.
  • Index-Based Archive Decompression: Transitioned entry access from by_name to by_index for CBR files, eliminating decompression failures on non-standard entry paths and separator encodings.
  • Archive Extraction Error Pipeline: Introduced ArchiveExtractionException and granular error tracking in CbzCacheController to surface specific failure causes (corrupted data, password protection, unsupported compression) in CbzPageImage.
  • Fault-Tolerant Pre-Warming: Protected comic reader initialization by catching individual neighbor pre-warm failures without crashing the entire viewer.

Reading Progress & Library Filters

  • Accurate Section-Based Progress: Updated Book.progress calculation to distinguish section-based reflowable formats (EPUB, MOBI, AZW, AZW3) from fixed-page documents, resolving reading progress discrepancies on early chapters.
  • In-Progress Filter Precision: Added isInProgress helper to accurately identify books that have been started but not finished, refining the "Continue Reading" shelf logic.

Typography & Paragraph Defragmentation

  • Contextual Mojibake & Replacement Character Healing: Implemented healReplacementCharacters in HtmlDefragmenter to intelligently heal Unicode replacement characters (\uFFFD), substitute control chars (\u001A), and raw mojibake (�) into authentic curly apostrophes, smart quotation marks, and em-dashes across contractions, possessives, elisions, and speech boundaries.
  • Cross-Tag Element Boundary Healing: Added _healElementBoundaryNodes to repair replacement characters and smart punctuation split across inline markup boundaries (e.g., <em> and <strong> tags).
  • Harmonized Search & TTS Normalization: Integrated typographic replacement healing into normalizePlainText to preserve character offset alignment for search and clean TTS pronunciation.
  • Rust MOBI CP-1252 Decoder Refinement: Updated decode_mobi_text to route undefined CP-1252 bytes (0x81, 0x8D, 0x8F, 0x90, 0x9D) as \u{FFFD} instead of literal ?, enabling downstream contextual typographic healing in Dart.
  • Advanced Defragmentation Regex: Expanded HtmlDefragmenter with specialized heuristics for parenthetical citations, capitalized continuation phrases, attribution em-dashes, and trailing punctuation (ellipses, colons, em-dashes, commas).
  • Proactive Soft-Hyphen Cleanup: Unconditionally stripped soft-hyphens (\u00AD, &shy;) during text tree traversal in HyphenationHelper to prevent rendering artifacts and broken hyphenation line breaks in Flutter's text engine.
  • Experimental Hyphenation Setting: Tagged the reader hyphenation toggle with an experimental notice in the layout settings sheet.