Koharia

English

简体中文

English

简体中文

Appearance

0.4.5 Latest

Koharia v0.4.5: PDF Reflow, Local Library Management, and Reader Improvements

This release adds reflowable PDF reading, reorganizes local library setup and media import, and introduces a global no-animation mode. This rebuilt version also fixes startup failures after updating, skipped comic half-pages, and extra navigation steps on very wide split pages.

Downloads

GitHub Releases remains the authoritative source for release information. Make sure the downloaded build reports version 0.4.5.

This is a rebuilt 0.4.5 with fixes, based on commit [f0507b8fd](https://github.com/Mister-album/Koharia/commit/f0507b8fd). If you installed an earlier 0.4.5 package, install this updated package over it; uninstalling or clearing app data is not required.

Both packages report version 0.4.5. When downloading from a mirror, also compare the file's SHA-256 against SHA256SUMS.txt attached to this GitHub release to identify the rebuilt package.

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

Koharia-v0.4.5-release.apk

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

Update and startup fixes

  • Fixed an immediate startup crash that could prevent the app from opening after upgrading from 0.4.2 or installing an earlier 0.4.5 release package.
  • Preserved the constructor required to initialize the background-task database. The fix is included in both regular and FOSS builds.
  • Verified upgrading the regular build from the official 0.4.2 release, startup with existing data on a physical device, and a fresh FOSS installation.

Reflowable PDF reading

  • Added PDFium-based structured extraction to display suitable PDF content in the existing Readium book reader, with adjustable typography and layout. Original PDF page reading remains available.
  • Improved reconstruction of paragraphs, headings, basic text styles, and illustrations. Recognizable ruby annotations, superscripts, subscripts, same-page footnotes, and comments can remain interactive or styled text, reducing full-page image fallbacks.
  • PDF reader selection now follows the containing library: book libraries try reflow by default, while comic libraries use original page reading. Manual switching remains available.
  • First-time preparation prioritizes a small section around the reading position, then continues in the background, reducing the wait for a complete conversion.
  • Automatic reflow no longer opens a foreground progress dialog or temporarily switches to the comic reader. Progress initially appears as a percentage; accurate page counts become available after content preparation and pagination finish.
  • Reuses prepared content when reopening a book. Background failures now offer retry and original-PDF options instead of leaving preparation pending indefinitely.

Scope: Reflow primarily targets ordinary horizontal layouts with a reliable text layer. OCR is not included. Complex columns, vertical text, formulas, and some mixed layouts may retain original-page or regional images. Cross-page footnotes and other complex relationships are not fully reconstructed; use original PDF reading when exact layout preservation matters.

Remote PDFs still require the original file before first-time reflow. Reading positions in PDF reflow mode are stored locally; synchronization with Komga’s original PDF progress is not yet implemented.

Local libraries and file management

  • Local connection setup now lets you enable comic libraries, book libraries, or both, and choose series or individual-file organization for each. Detailed explanations are available on a separate guide page.
  • The first local connection creates folders for enabled library types under the app’s selected data directory, attaches them to the libraries, and performs an initial scan after setup.
  • Directory management is now organized around libraries. Edit a library’s name and included directories in one place, with its content type and fixed organization mode clearly displayed.
  • Opening a local bookshelf now reads the cached index without repeatedly scanning files. Pull to refresh when you want to discover external file changes, reducing repeated storage access.
  • Fixed the empty bookshelf appearing before first-run onboarding and the brief empty-state message while a local shelf was loading.
  • Added file deletion, moving items between libraries, and marking items read or unread to long-press and multi-selection menus. Moving changes library membership; confirmed file deletion removes the corresponding local originals.

Media import and image-to-comic creation

  • Reorganized import into “library → directory → series,” with clearer controls for changing each selection.
  • Improved the existing/new series selector and search behavior, including a fix for losing the selected series after canceling a search.
  • Kept the regular file import button directly accessible in the bookshelf toolbar.
  • Fixed valid directory permissions being rejected with a message that no writable destination supported all selected files.
  • Regular import now filters supported book and comic files and excludes loose images. Existing image-folder scanning and reading remain available.
  • Added “Merge images into a comic”: select multiple images, preview and reorder them, then import the generated CBZ into a comic library. Original image data is preserved without recompression, and source images are not deleted.

Comic page splitting and zoom

  • Fixed adjacent-page prefetching moving the reader away from the current half-page and skipping the other half. Right-to-left reading now preserves “current image right half → left half → next image right half,” with the equivalent order for left-to-right reading. Related report: [#82](https://github.com/Mister-album/Koharia/issues/82).
  • Splits completed during a drag or page transition wait until the interaction ends before updating the page list. Chapter prefetch updates retain existing half-pages, reducing repeated splitting and page reconstruction.
  • In manual split and automatic single-page modes, both halves initially fit within the screen. Very wide half-pages are no longer automatically enlarged again, avoiding extra horizontal panning steps during normal page turns.
  • After zooming in manually, images remain draggable and navigation still follows the “pan before turning when zoomed” setting. Returning to the fitted size restores direct half-page navigation.
  • This display policy applies only to split results. Saved global scaling preferences remain unchanged, and unsplit pages continue using their existing settings.

Reader experience and stability

  • Added a global no-animation mode to reduce unnecessary motion throughout the app, plus optional flashing on major screen changes for users adjusting their e-ink reading experience.
  • Corrected font-size conversion for TXT, MOBI, and related text formats. The default baseline is 16 sp, with screen density, system font scaling, and reader scaling applied correctly.
  • Fixed truncated text in some MOBI, PRC, AZW, and AZW3 files, and prevented KF8 auxiliary content from appearing in the main text.
  • Improved initial page turns, image-page transitions, and preloading in EPUB and reflowed PDF reading, reducing delays and duplicate animations after swipes.
  • Improved standalone EPUB image-page navigation, fixed the closed table-of-contents drawer intercepting page-turn gestures, and corrected navigation from certain final TOC entries to the next book.
  • Fixed zooming and panning for GIF and animated WebP pages in the comic pager, and a possible crash when rapidly dragging the progress slider.
  • Fixed reading-position shifts when automatic comic layouts change after screen rotation.
  • Hardened PDF page and EPUB session cleanup, and improved dynamic-color compatibility on affected devices.

Community and feedback

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

Please report reproducible bugs through GitHub Issues.

Include reproduction steps, Android version and device model, Koharia version, library type, file format, and reading mode. For PDF issues, specify original or reflowed reading. For local-library issues, specify series or individual-file organization and describe the folder structure.

Screenshots, recordings, and crash logs are helpful. Please redact account details, access tokens, and other private information before sharing.

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

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

Assets 7