Koharia

English

简体中文

English

简体中文

Appearance

0.4.1

Koharia v0.4.1 Local Libraries, Media Import, and Reader Improvements

This release brings together the changes from v0.3.0 through v0.4.1 and is a major update focused on local reading.

Koharia can now manage comics and books directly from local folders without requiring a Komga server, and Android files can be opened or imported directly into the app. Comic and EPUB readers also gain a shared set of page-transition effects. This release additionally improves Komga progress synchronization, offline behavior, page loading, network scheduling, and overall reader stability.

Downloads

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

  • GitHub Releases: /changelogs//tag/v0.4.1
  • 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.1-release.apk

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

Local libraries and media import

  • Added local folder libraries, allowing comics and books stored on the device to be managed and read without a Komga server.

  • Multiple Android SAF folders can be added, with separate comic and book roots, directory relinking, and explicit refresh.

  • Added two organization modes:

    • Series libraries for content organized as series and chapters.
    • Individual-file libraries that scan folders recursively and open individual books or comics directly from the shelf.

  • Added scanning and reader routing for EPUB, PDF, CBZ / ZIP, CBR / RAR, 7Z, TAR, and image directories.

  • Added Android system open/share integration:

    • Open supported media directly in Koharia without importing it.
    • Import one or multiple media files into a local library.

  • Added local-library onboarding and management, shelves, filters, sorting, layout switching, metadata editing / detection, and cover extraction.

  • Individual entries show comic page progress or EPUB reading percentage, while series entries show read and total chapter counts.

  • Local-library reading progress and state are stored locally and do not depend on the Komga API.

  • Improved scanning, indexing, and progress-refresh performance for large local libraries.

  • Koharia never automatically moves, renames, or deletes the original media files.

Series and individual-file organization modes cannot be converted after a library has been created. Create a new local library if a different organization mode is needed.

Reader and page transitions

  • Added a shared set of page-transition effects for paginated comic and EPUB reading:

    • Slide
    • Cover
    • Curl
    • Vertical
    • Fade
    • Zoom
    • None

  • Comic and EPUB transition preferences are stored independently, while Webtoon and continuous EPUB modes retain their own scrolling behavior.

  • Comic curl transitions respond to the touch origin and support forward, backward, and rapidly queued page turns.

  • Optimized comic page loading, prefetching, caching, and transition scheduling to reduce stalls and redundant work.

  • Improved EPUB resource loading, pagination transitions, and Komga Readium networking.

  • Fixed long strings failing to wrap correctly in EPUB content.

  • Improved EPUB image filename handling to avoid conflicts between resources with identical names.

  • Fixed S Pen air-action paging and chapter navigation in the EPUB reader.

  • Fixed state issues caused by rapidly queued consecutive page transitions.

Komga progress, offline reading, and networking

  • Fixed incomplete reading progress on Komga shelves by aggregating read and total chapter counts from server data.

  • Grid layouts can now show reading-progress badges, while list layouts show text progress. A bookshelf setting is available to control progress display.

  • Fixed inaccurate statistics caused by relying only on locally available Komga progress data.

  • Improved coordination between Komga SSE events, manual refreshes, and reader progress uploads.

  • Reader uploads now compare remote state more conservatively to prevent stale local progress from overwriting newer server progress.

  • Improved unread resets, EPUB positions, and incremental progress refreshes.

  • Added caching for Komga progress reads to reduce repeated requests during shelf refreshes and lifecycle changes.

  • Reduced repeated local database work when loading chapter and EPUB progress for large libraries.

  • Improved cached-only and offline modes:

    • Avoid unnecessary network fallbacks.
    • Improve shelf, detail, and reader chapter filtering.
    • Recognize fully cached EPUB books correctly.
    • Preserve local read state, tags, authors, status, and sorting information while offline.

  • Improved Komga API, SSE, and network request scheduling to reduce duplicate requests and unnecessary waits.

  • Foreground reading now receives network priority over background downloads for more consistent reading on constrained or unstable connections.

Data compatibility and stability

  • Reworked the library connection architecture so Komga and local folders share a common connection-management foundation while preserving migration of existing Komga configuration.
  • Koharia backups now use the dedicated .kohariabackup format to avoid importing incompatible .tachibk backups.
  • Improved cold-start initialization and reduced unnecessary startup work.
  • Fixed and refined the splash screen and launcher icon.
  • Improved state cleanup and recovery around reader, library, and connection transitions.
  • GitHub issue templates are now bilingual.

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 EPUB, PDF, CBZ, paginated, 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

  • 修复 EPUB S Pen 悬空翻页 / Fix S Pen air-action paging in EPUB reader by @Mister-album in https://github.com/Mister-album/Koharia/pull/66
  • feat: 统一 EPUB 与漫画翻页动画 / Unify EPUB and comic page transitions by @Mister-album in https://github.com/Mister-album/Koharia/pull/67
  • 修复 EPUB 长字符串换行并优化图片命名 / Fix EPUB long-word wrapping and image naming by @Mister-album in https://github.com/Mister-album/Koharia/pull/70
  • 修复仅显示缓存的离线书架 / Fix cached-only offline shelves by @Mister-album in https://github.com/Mister-album/Koharia/pull/71
  • 实现本地书库与媒体导入 / Add local libraries and media import by @Mister-album in https://github.com/Mister-album/Koharia/pull/74
  • 修复 Komga 未读与进度同步 / Fix Komga unread and progress synchronization by @Mister-album in https://github.com/Mister-album/Koharia/pull/75
  • 优化冷启动初始化与启动页 / Optimize cold-start initialization and splash readiness by @Mister-album in https://github.com/Mister-album/Koharia/pull/76
  • perf: 优化阅读器与 Komga 网络性能 / Optimize reader and Komga network performance by @Mister-album in https://github.com/Mister-album/Koharia/pull/77
  • fix: 修复 Komga 阅读进度与统计显示 / Fix Komga progress and stats display by @Mister-album in https://github.com/Mister-album/Koharia/pull/78

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

Assets 7