Koharia

English

简体中文

English

简体中文

Appearance

0.4.2 Latest

Koharia v0.4.2: Local Formats, Double-Page Reading, and Compatibility

This release expands local-library format support and refresh safety, improves comic double-page reading, PDF rendering, and page prefetching, and fixes bookshelf state restoration and compatibility with older Komga servers.

Downloads

GitHub Releases remains the authoritative source for release information. Make sure the installed build reports version 0.4.2.

  • GitHub Releases: /changelogs//tag/v0.4.2
  • Quark Drive: https://pan.quark.cn/s/f80624cde564?pwd=8tbp Access code: 8tbp
  • Baidu Netdisk: https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g Access code: 6s2g

If you are unsure which APK to download, use the regular universal build:

Koharia-v0.4.2-release.apk

A universal FOSS build and architecture-specific APKs are also provided. Most users do not need an architecture-specific build.

Local formats and document reading

  • Added the complete TXT reading flow, including common encoding detection, pagination, local scanning, import, temporary opening, and book reader settings.
  • Added experimental MOBI, PRC, AZW, and AZW3 support for PalmDOC / KF8 text and basic metadata. DRM, complex layouts, and embedded images are not supported.
  • Added DJVU and DJV page reading with the MIT-licensed djvu-rs WASM decoder for JB2 / IW44 content, rendered through the WebAssembly runtime provided by Android WebView. Chicory is not used by the current build.
  • Unified extension, MIME type, and file-signature detection, and connected the new formats to local indexing, import, download, and reader entry points.
  • Improved TXT / MOBI layout update latency, default font sizing, and reading progress. New local book formats now show percentage progress on the shelf.
  • Improved shelf cover reuse to avoid fetching the same covers again whenever the shelf is reopened.
  • Fixed a local-library pull-to-refresh issue where temporarily inaccessible directories could remove every existing entry. Incomplete scans now preserve the current index and ask the user to check directory access.
  • Optimized native PDF rendering and Komga page prefetching to reduce memory and network pressure on large pages.

Comic double-page reading

  • Fixed repeated flashing and page skipping when combining pages into double-page spreads by stabilizing page pairing and position restoration.
  • Automatic double-page mode now considers the device screen ratio, orientation, and page dimensions when choosing single- or double-page layout.
  • Improved landscape and tablet spreads by removing the black center gap and joining both pages seamlessly.
  • Hardened comic reader exit handling and crash diagnostics to reduce stale-state failures and improve recovery.

Bookshelf state and Komga compatibility

  • Returning from a title or another screen now restores the selected library, filter results, and scroll position instead of jumping to the first All shelf.
  • App-internal screen changes and full app exits are handled separately: temporary filters remain while switching screens, but are not incorrectly restored after an app restart unless persistent filtering is enabled.
  • Added compatibility with older Komga versions that do not provide the Client Settings ordering endpoint, including 1.14.1. Accessible libraries remain visible when WebUI ordering cannot be loaded.
  • Updated the Chinese and English READMEs with local-library workflows, supported formats, reader engines, and documented limitations.

Community and feedback

Join the Komga Discord server and visit the Koharia channel for discussion, usage questions, and general feedback:

https://discord.gg/komga-678794935368941569

For reproducible bugs, please report them through GitHub Issues:

https://github.com/Mister-album/Koharia/issues

When reporting an issue, please include as much of the following information as possible:

  • Complete reproduction steps, including the expected and actual behavior.
  • Android version and device model.
  • Koharia version and whether the issue occurs with a Komga or local library.
  • Affected file format and reading mode, such as TXT, MOBI, DJVU, PDF, CBZ, paginated, dual-page, or continuous scrolling.
  • For Komga issues, the Komga version and whether the problem occurs online, offline, or in cached-only mode.
  • Screenshots, screen recordings, or crash logs generated by Koharia.
  • For local-library issues, whether the library uses series or individual-file mode and a general description of the folder structure.

Please redact server addresses, account information, access tokens, and other private information before sharing logs, screenshots, or configuration details.

Thank you to everyone testing Koharia, reporting issues, and helping improve the project.

What's Changed

Full Changelog: https://github.com/Mister-album/Koharia/compare/v0.4.1...v0.4.2

Assets 7