Koharia

简体中文

English

简体中文

English

Appearance

更新日志 ​

v0.5.0最新

Koharia v0.5.0：LANraragi 接入、书架缓存与阅读体验升级

本次版本新增 LANraragi 书库支持，优化 Komga 与 LANraragi 的书架缓存和进度同步，并修复连续滚动、注释点击及漫画双页缩放等阅读问题。

下载

版本信息与更新说明以 GitHub Releases 为准，请确认下载的版本为 0.5.0。

  • GitHub Releases：[下载页面](#v0.5.0)
  • 夸克网盘：[下载链接](https://pan.quark.cn/s/f80624cde564?pwd=8tbp)，提取码：8tbp
  • 百度网盘：[下载链接](https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g)，提取码：6s2g

如果不确定应该下载哪个 APK，请使用普通通用版本：

Koharia-v0.5.0-release.apk

同时提供 FOSS 通用版本和不同 CPU 架构的普通版 APK。FOSS 版不包含遥测组件，使用独立应用标识，可与普通版共存，不能直接覆盖普通版。

同渠道、同签名版本可直接覆盖升级，无需卸载或清除应用数据。

LANraragi 书库

  • 新增内置 LANraragi 连接，支持添加和切换多个服务器。
  • 支持 Archive 独立作品、Tankoubon 合集和 Category 分类；合集详情显示其中的多个 Archive，分类保留在书架顶部。
  • Archive 默认可直接进入漫画阅读器，也可选择先打开详情与逐页网格预览，再从指定页面开始阅读。
  • 支持搜索、标签与阅读状态筛选、排序，以及手动下载后离线阅读。
  • 缓存书库元数据，离线时仍可浏览和搜索；正文需要另行下载，元数据缓存不代表作品已下载。
  • 按 Archive 同步阅读进度，离线阅读记录可在恢复连接后补传；需要服务器开启进度记录并提供相应权限。
  • “标记未读”仅重置本地状态，不清零服务器进度。
  • 统一连接编辑、顶部导航与筛选样式，改善首次进入书库、空库刷新及部分作品首图加载体验。

书架缓存与启动体验

  • Komga 与 LANraragi 书架优先读取本地缓存，已有缓存时，启动和返回书架不再等待网络刷新。
  • 缓存缺失时获取书架数据；后续通过手动刷新或服务器更新事件更新内容。
  • 刷新失败时保留已有缓存，减少网络波动导致的空白书架。
  • 区分有效空库与尚未建立缓存的状态，改善首次加载和失败重试。
  • 不同连接的缓存保持隔离，阅读进度同步独立运行。
  • 优化大书库元数据缓存的读取与处理，减少内存占用。

阅读进度同步

  • 修复部分 Komga 漫画阅读进度未能正常上传的问题。
  • 改善上传失败后的补传处理，待同步记录可在应用重新启动后继续处理。
  • 按连接隔离同步任务，减少切换服务器时的状态串用。
  • 保持书籍阅读位置与设备相关视觉页数的区分，避免排版变化影响云端进度。

漫画阅读

  • 双页阅读新增“保存合并页”，可将当前两页合并保存为一张图片。
  • 修复双页模式下两张图片缩放不同步的问题，改善共同缩放与平移体验。
  • 修复“适应宽度”配合仿真翻页时，动画结束后画面出现缩放跳变的问题。
  • 增加滑动翻页控制，支持按阅读习惯关闭左右滑动翻页。

EPUB 与连续滚动

  • 修复连续滚动时，斜向滑动可能误触发横向跳章的问题。
  • 修复短章节或扉页未能及时衔接后续内容，导致上下滑动无反应的问题。
  • 修复点击嵌入章节的文字或空白区域后，阅读位置可能跳到书籍底部的问题。
  • 修复连续滚动中部分注释点击无反应的问题，改善同章、跨章及图标注释的处理。
  • 保留图片预览、章节链接与文本选择，减少重复创建章节页面造成的位置扰动。
  • 改善阅读器返回操作及章节切换后的状态恢复。

稳定性

  • 修复部分作品元数据编辑页在状态恢复时的崩溃。
  • 改善异常处理，避免错误提示过程中再次触发异常。
  • 加强异常 EPUB 内容校验和部分页面导出处理。
  • 补充书架缓存、阅读进度、连续滚动及仿真翻页相关回归测试。

交流与问题反馈

Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)**，还原加入交流使用体验、功能建议和常见问题。

可稳定复现的问题欢迎提交至 [GitHub Issues](https://github.com/Mister-album/Koharia/issues)。

反馈时请尽量提供复现步骤、Android 版本与设备型号、Koharia 版本、书库类型及阅读模式。涉及书籍时，请注明文件格式；涉及 PDF 时，请注明使用原版还是重排阅读。

截图、录屏和日志有助于定位问题，请隐藏账号、密码和访问令牌等私人信息。

感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。

This release adds LANraragi support, improves shelf caching and progress synchronization for Komga and LANraragi, and fixes issues with continuous scrolling, footnotes, and double-page comic zoom.

GitHub Releases is the authoritative source for release information. Make sure the downloaded version is 0.5.0.

  • GitHub Releases: [Download page](https://github.com/Mister-album/Koharia/releases/tag/v0.5.0)
  • Quark Drive: [Download link](https://pan.quark.cn/s/f80624cde564?pwd=8tbp), access code: 8tbp
  • Baidu Netdisk: [Download link](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.5.0-release.apk

A universal FOSS build and architecture-specific regular APKs are also available. The FOSS build contains no telemetry components and installs as a separate app. It can coexist with the regular build but cannot replace it.

You can update an existing installation without uninstalling or clearing app data, provided you use the same distribution signed with the same key.

LANraragi libraries

  • Added LANraragi connections, with support for adding and switching between multiple servers.
  • Supports individual Archives, Tankoubon collections, and Categories. Collection details list their Archive members, and Categories appear at the top of the shelf.
  • Archives can open directly in the comic reader or show a details page with page thumbnails, allowing you to start reading from a selected page.
  • Supports search, tag and reading-status filters, sorting, and offline reading of downloaded content.
  • Library metadata is cached for offline browsing and search. Pages must be downloaded separately to read offline.
  • Synchronizes reading progress per Archive and uploads pending offline progress after reconnecting. Progress tracking must be enabled on the server, with the necessary permissions.
  • Marking an entry unread resets its local state without clearing server progress.
  • Updated connection settings, navigation, and filters for a consistent appearance. Improved initial library loading, refreshes of empty libraries, and first-page loading for some titles.

Shelf caching and startup

  • Komga and LANraragi shelves display cached content immediately, without waiting for a network refresh when starting the app or returning to the shelf.
  • Shelf data is fetched when no cache is available. Manual refreshes and server update events retrieve subsequent changes.
  • Failed refreshes retain cached content, reducing blank shelves during network interruptions.
  • Improved initial loading and retries by distinguishing an empty library from a library that has not yet been cached.
  • Each connection has its own cache, while reading progress synchronizes independently.
  • Improved metadata cache handling to reduce memory use with large libraries.

Reading-progress synchronization

  • Fixed cases where Komga comic progress failed to upload.
  • Improved upload retries so pending progress updates can resume after restarting the app.
  • Kept synchronization tasks separate for each connection to prevent progress from being mixed between servers.
  • Kept book positions independent of device-specific page counts so layout changes do not affect cloud progress.

Comic reading

  • Added “Save merged pages” to save both pages of the current spread as a single image.
  • Fixed inconsistent zoom between images in double-page mode and improved synchronized zooming and panning.
  • Fixed images changing size at the end of simulated page-turn animations when using fit-to-width.
  • Added an option to disable horizontal swipe page turns.

EPUB and continuous scrolling

  • Fixed diagonal swipes accidentally changing chapters while scrolling vertically.
  • Fixed unresponsive scrolling when short chapters or title pages failed to connect to the following content.
  • Fixed taps on text or blank areas in embedded chapters unexpectedly jumping to the bottom of the book.
  • Fixed footnotes not opening in continuous scrolling, including references within the same chapter, across chapters, and through icons.
  • Reduced reading-position shifts caused by rebuilding chapter content while preserving image previews, chapter links, and text selection.
  • Improved back navigation and reading-state restoration after chapter changes.

Stability

  • Fixed crashes when restoring some metadata editing screens.
  • Improved error handling to prevent further exceptions while displaying an error.
  • Improved validation of invalid EPUB files and handling of some page exports.
  • Added regression tests for shelf caching, progress synchronization, continuous scrolling, and simulated page turns.

Community and feedback

Join the [Komga Discord server](https://discord.gg/komga-678794935368941569) and visit the Koharia channel to share your experience, suggest features, and get help.

Please report reproducible issues through [GitHub Issues](https://github.com/Mister-album/Koharia/issues).

Include reproduction steps, your Android version and device model, Koharia version, library type, and reading mode. For books, specify the file format; for PDFs, specify whether you are using original-page or reflow mode.

Screenshots, recordings, and logs help us investigate. Remove account details, passwords, and access tokens before sharing them.

Thank you to everyone who tests the app, reports issues, and helps improve Koharia.

文件校验 / File verification

所有 APK 的 SHA-256 摘要见发行附件 SHA256SUMS.txt。

SHA-256 digests for all APKs are available in the attached SHA256SUMS.txt.

完整变更 / Full changelog: https://github.com/Mister-album/Koharia/compare/v0.4.5...v0.5.0

v0.4.5

Koharia v0.4.5：PDF 重排、本地书库管理与阅读体验升级

本次版本新增 PDF 可重排阅读，重新整理本地书库的创建、管理与导入流程，并带来全局无动画模式。本次重新打包还修复了升级后无法启动、漫画拆分页跳页，以及超宽半页需要额外操作才能翻页的问题。

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载的版本为 0.4.5。

本次 0.4.5 为重新打包的修复版，对应提交 [f0507b8fd](https://github.com/Mister-album/Koharia/commit/f0507b8fd)。如果已经安装过较早的 0.4.5，请下载本次修复包覆盖安装，无需卸载或清除应用数据。

中国大陆用户可使用上述网盘下载。由于新旧安装包均显示 0.4.5，请同时核对文件的 SHA-256 与本次 GitHub 发行附件中的 SHA256SUMS.txt，确保取得重新打包后的版本。

如果不确定应该下载哪个 APK，请使用普通通用版本：

Koharia-v0.4.5-release.apk

本次同时提供 FOSS 通用版本及不同 CPU 架构的普通版 APK。普通用户通常无需选择架构专用版本。

升级与启动修复

  • 修复从 0.4.2 升级，或安装较早的 0.4.5 发行包后，应用在启动阶段立即崩溃、无法进入主界面的问题。
  • 补全后台任务数据库初始化所需的构造函数保留规则；普通版与 FOSS 版均包含此修复。
  • 已验证普通版从官方 0.4.2 覆盖升级及实机保留数据启动，并验证 FOSS 版全新安装启动。

PDF 可重排阅读

  • 新增基于 PDFium 的结构化提取，将适合重排的 PDF 内容交给现有 Readium 书籍阅读器显示，支持调整字号和阅读排版，同时保留原版 PDF 阅读入口。
  • 改进正文、标题、基础文字样式及插图的重建；支持可识别的注音、上下标、同页脚注和批注，减少将带注释内容整页转换成图片造成的阅读割裂。
  • 根据所属书库类型选择默认阅读方式：书籍库中的 PDF 优先尝试重排，漫画库中的 PDF 默认使用原版页面阅读；仍可手动切换。
  • 首次打开采用分段准备，优先显示阅读位置附近的内容，其余部分在后台继续处理，减少等待整本转换的时间。
  • 自动重排不再弹出前台进度提示，准备期间保持书籍阅读器界面；阅读进度先显示百分比，完整内容与分页准备完成后再更新准确页数。
  • 复用已生成的重排缓存，改善中途退出后的恢复；后台处理失败时提供重试和原版阅读入口，避免一直停留在准备状态。

**适用范围：**重排主要面向具有可靠文字层的普通横排 PDF，目前不提供 OCR。复杂多栏、竖排、公式及部分图文混排仍可能保留原页或局部图片；跨页脚注等复杂关系尚不能完整恢复，需要精确保留版式时请使用原版 PDF 阅读。

远程 PDF 首次重排仍需取得原文件。PDF 重排模式的阅读位置保存在本地，暂未接入 Komga 原 PDF 的云端进度同步。

本地书库与文件管理

  • 创建本地连接时，可选择启用漫画库、书籍库或两者，并分别选择系列库或单文件库；组织方式的详细说明移至独立引导页。
  • 首个本地连接会在应用引导中选择的数据目录下，为启用的书库创建对应文件夹并添加目录关联；配置完成后立即执行一次扫描。
  • 改为以书库为中心管理目录：在书库编辑页统一调整名称及所含目录，清楚显示漫画／书籍类型和固定的组织方式。
  • 书架默认直接读取扫描缓存，重新进入页面不再反复扫描本地文件；需要发现外部文件变化时，可手动下拉刷新，减少重复文件访问。
  • 修复首次启动时先显示空书架再进入引导，以及本地书架加载期间短暂显示“书库为空”的问题。
  • 长按和多选菜单新增删除文件、移动书库、标记为已读及标记为未读。移动书库用于调整条目的书库归属；删除文件会在确认后移除对应的本地原文件。

媒体导入与图片合并

  • 调整导入页面，按“书库 → 目录 → 系列”的顺序选择目标，并使可修改的选择项更醒目。
  • 优化“已有系列／新建系列”的切换及搜索体验，修复取消搜索后已选系列丢失的问题。
  • 普通文件导入按钮保留在书架顶部，便于直接访问。
  • 修复已授予目录权限，却仍提示“没有可写且支持全部所选文件的目标位置”的问题。
  • 普通导入会筛选支持的书籍和漫画文件，不再将散图作为书籍导入；已有图片目录的扫描和阅读能力保持可用。
  • 新增“图片合并为漫画”：可选择多张图片、预览并调整页序，生成 CBZ 后导入漫画库。合并保留原始图片数据，不重新压缩，也不删除原图。

漫画拆分页与缩放

  • 修复拆分双页时，预加载相邻图片会抢走当前阅读位置、跳过另一半页的问题。右向左阅读时保持“当前图右半 → 左半 → 下一张图右半”的顺序，左向右阅读同样适用。相关反馈：[#82](https://github.com/Mister-album/Koharia/issues/82)。
  • 拖动或翻页过程中完成的拆分会等待操作结束后再更新页面列表；章节预加载刷新保留已拆半页，减少重复拆分和页面重建。
  • 手动拆分与自动单页模式下，两个半页默认完整适应屏幕，避免超宽半页再次被自动放大，导致翻页操作先被用于横向平移。
  • 用户主动放大后，仍可拖动图像，并遵循“图片放大时先平移再翻页”设置；缩回适应大小后恢复直接切换半页。
  • 半页的适应屏幕策略仅在显示拆分结果时生效，不修改已保存的全局缩放设置，未拆分页继续沿用原有设置。

阅读体验与稳定性

  • 新增全局“无动画模式”，减少应用内非必要动态效果；同时提供可选的主要页面切换闪烁设置，便于墨水屏用户调整使用体验。
  • 修复 TXT／MOBI 等文字格式的字号换算，默认基准为 16 sp，正确结合屏幕密度、系统字体缩放及阅读器倍率显示。
  • 修复部分 MOBI、PRC、AZW、AZW3 文件正文截断，以及 KF8 辅助内容混入正文的问题。
  • 优化 EPUB／PDF 重排阅读中的首屏翻页、图片页切换与预加载，减少翻页等待和滑动后重复播放动画的情况。
  • 改善 EPUB 独立图片页导航，修复目录抽屉抢占翻页手势，以及部分目录末项无法正常进入下一册的问题。
  • 修复 GIF／动画 WebP 在漫画分页器中无法正常缩放和平移，以及快速拖动进度条时可能触发的崩溃。
  • 修复漫画自动布局随屏幕旋转切换时阅读位置偏移的问题。
  • 加强 PDF 页面和 EPUB 阅读会话的释放处理，并改善部分设备上的动态配色兼容性。

交流与问题反馈

中文用户可以加入 Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)，交流使用体验、功能建议和常见问题。

可稳定复现的问题欢迎提交至 GitHub Issues。

反馈时请尽量提供复现步骤、Android 版本与设备型号、Koharia 版本、书库类型、文件格式和阅读模式。涉及 PDF 时，请注明使用的是原版还是重排阅读；涉及本地库时，请注明系列库或单文件库，以及目录的大致组织方式。

如方便，也请附上截图、录屏或崩溃日志，并隐藏账号、访问令牌等私人信息。

感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。

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

v0.4.2

Koharia v0.4.2：本地格式扩展、双页阅读与兼容性优化

本次版本进一步完善本地书库的格式支持与刷新安全性，优化漫画双页阅读、PDF 渲染和页面预取，并修复书架状态恢复及旧版 Komga 的兼容问题。

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载的版本为 0.4.2。

  • GitHub Releases：/changelogs//tag/v0.4.2
  • 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp 提取码：8tbp
  • 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g 提取码：6s2g

中国大陆用户推荐优先使用夸克网盘或百度网盘下载。

如果不确定应该下载哪个 APK，请使用普通通用版本：

Koharia-v0.4.2-release.apk

本次同时提供 FOSS 通用版本及不同 CPU 架构的 APK。普通用户通常无需选择架构专用版本。

本地格式与文档阅读

  • 新增 TXT 完整阅读链路，支持常见编码识别、分页阅读、本地扫描、导入、临时打开与阅读设置。
  • 新增 MOBI、PRC、AZW、AZW3 实验性支持，可解析 PalmDOC / KF8 文本及基础元数据；暂不支持 DRM、复杂布局和内嵌图片。
  • 新增 DJVU、DJV 页面阅读，使用 MIT 许可的 djvu-rs WASM 解码 JB2 / IW44 内容，并通过 Android WebView 的 WebAssembly 运行时渲染；当前构建不使用 Chicory。
  • 统一扩展名、MIME 类型和文件特征识别，并将新增格式接入本地索引、导入、下载与阅读入口。
  • 改进 TXT / MOBI 排版更新速度、默认字号与阅读进度显示，新格式书籍在书架上统一显示百分比进度。
  • 完善书架封面复用，减少重复进入书架时重新获取封面的情况。
  • 修复本地库下拉刷新时，目录暂时不可访问可能导致现有条目全部消失的问题；不完整扫描现在会保留已有索引并提示检查目录权限。
  • 优化 PDF 原生渲染与 Komga 页面预取，降低大页面阅读时的内存和网络压力。

漫画双页阅读

  • 修复合并双页时页面闪过、跳页并持续循环的问题，稳定页面配对和位置恢复。
  • 自动双页模式现在会结合设备屏幕比例、方向与页面宽高判断单页或双页布局。
  • 优化横屏和平板双页显示，移除页面之间的黑色中缝，实现连续拼接。
  • 强化漫画阅读器退出和异常诊断，减少状态残留导致的崩溃与错误恢复。

书架状态与 Komga 兼容

  • 从作品或其他页面返回时恢复原先选择的书库、筛选结果与停留位置，不再跳回第一个“全部”书架。
  • 区分应用内切换屏幕与退出应用：切换屏幕时保留临时筛选，未启用持久化筛选时不会在重新启动应用后错误恢复上次状态。
  • 兼容缺少 Client Settings 排序接口的旧版 Komga（包括 1.14.1）：无法读取服务器 WebUI 排序时仍正常显示账号可访问的书库。
  • 更新中英文 README，补充本地库工作流、支持格式、阅读引擎和限制说明。

交流与问题反馈

中文用户可以加入 Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)，交流使用体验、功能建议以及常见问题。

如果遇到可以稳定复现的问题，也欢迎通过 GitHub Issues 反馈：

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

反馈 Bug 时请尽量附上：

  • 问题的完整复现步骤，以及预期结果与实际结果。
  • Android 版本和设备型号。
  • Koharia 版本，以及使用的是 Komga 书库还是本地书库。
  • 涉及的文件格式和阅读模式，例如 TXT、MOBI、DJVU、PDF、CBZ、分页、双页或连续滚动。
  • 如果使用 Komga，请提供 Komga 版本，以及问题是否发生在在线、离线或仅显示缓存模式。
  • 截图、录屏或 Koharia 生成的崩溃日志。
  • 本地书库相关问题请说明使用的是系列库还是单文件库，以及大致的目录组织方式。

提交日志、截图或配置时，请注意隐藏服务器地址、账号、访问令牌以及其他私人信息。

感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。

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: #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

v0.4.1

Koharia v0.4.1：本地书库、媒体导入与阅读体验升级

本次版本汇总了 v0.3.0 至 v0.4.1 的更新，是一次以本地阅读体验为重点的较大升级。

Koharia 现在可以直接管理本地文件夹中的漫画与书籍，并支持从 Android 系统直接打开或导入媒体文件；漫画与 EPUB 阅读器也加入了统一的多种翻页效果。同时，本版本集中优化了 Komga 阅读进度同步、离线缓存、页面加载和网络调度，并修复了一批 EPUB、启动和阅读器稳定性问题。

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载的版本为 0.4.1。

  • GitHub Releases：/changelogs//tag/v0.4.1
  • 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp 提取码：8tbp
  • 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g 提取码：6s2g

中国大陆用户推荐优先使用夸克网盘或百度网盘下载。

如果不确定应该下载哪个 APK，请使用普通通用版本：

Koharia-v0.4.1-release.apk

本次同时提供 FOSS 通用版本及不同 CPU 架构的 APK。普通用户通常无需选择架构专用版本。

本地书库与媒体导入

  • 新增本地文件夹书库，无需 Komga 服务器即可直接管理和阅读设备中的漫画与书籍。

  • 支持添加多个 Android SAF 文件夹，并可分别管理漫画与书籍目录、重新关联目录或手动刷新。

  • 新增 系列库 与 单文件库 两种组织方式：

    • 系列库适合按照作品 / 章节目录组织的内容。
    • 单文件库会递归扫描目录，可直接从书架打开单个漫画或书籍文件。

  • 支持扫描和阅读 EPUB、PDF、CBZ / ZIP、CBR / RAR、7Z、TAR 以及图片目录。

  • 新增 Android 系统级媒体入口，可从文件管理器或其他应用中：

    • 直接使用 Koharia 打开并阅读文件
    • 将一个或多个媒体文件导入本地书库

  • 新增本地书库创建与管理界面，支持书架、筛选、排序、布局切换、元数据编辑 / 识别和封面提取。

  • 单文件条目可直接显示漫画页码进度或 EPUB 阅读百分比；系列条目显示已读章节数与总章节数。

  • 本地书库的阅读进度和状态保存在本地，不依赖 Komga API。

  • 优化大型本地书库的扫描、索引以及阅读进度刷新性能。

  • Koharia 不会自动移动、重命名或删除用户的原始媒体文件。

系列库与单文件库的组织模式在创建后固定，如需更换组织方式，请重新创建本地书库。

阅读器与翻页体验

  • 为漫画与 EPUB 分页阅读加入统一的翻页效果，可选择：

    • 平移
    • 覆盖
    • 仿真翻页
    • 上下翻页
    • 淡入
    • 缩放
    • 无动画

  • 漫画与 EPUB 可分别保存翻页效果设置；Webtoon 和 EPUB 连续滚动继续使用各自的滚动行为。

  • 漫画仿真翻页支持根据触摸位置改变翻页方向和角度，并改进连续快速翻页时的任务调度。

  • 优化漫画页面加载、预取、页面缓存和翻页调度，减少等待、重复加载和快速翻页造成的卡顿。

  • 优化 EPUB 资源加载、分页切换以及 Komga Readium 网络访问。

  • 修复 EPUB 中超长字符串无法正确换行的问题。

  • 优化 EPUB 图片文件命名，避免不同资源使用相同文件名时发生冲突。

  • 修复 EPUB 阅读器中的 S Pen 悬空翻页与章节导航。

  • 修复连续快速翻页时可能出现的状态异常。

Komga、阅读进度与离线体验

  • 修复 Komga 书架中阅读进度显示不完整的问题，改为结合服务器数据统计已读章节数与总章节数。

  • 网格布局现在可以显示阅读进度角标，列表布局显示文字进度，并新增书架阅读进度显示开关。

  • 修复统计页面仅依赖本地数据而导致 Komga 阅读统计不准确的问题。

  • 改进 Komga SSE、手动刷新和阅读器进度上传之间的同步与并发协调。

  • 阅读器上传进度前会更谨慎地比较服务器状态，防止较旧的本地阅读进度覆盖服务器上的较新进度。

  • 完善漫画未读重置、EPUB 阅读位置以及单本增量进度刷新。

  • 优化 Komga 阅读进度读取缓存，减少书架刷新和生命周期变化造成的重复请求。

  • 优化本地章节与 EPUB 阅读进度查询，大型书库下减少重复数据库访问。

  • 改进 仅显示缓存 / 离线模式：

    • 避免不必要的网络回退。
    • 完善书架、作品详情和阅读器章节筛选。
    • 正确识别完整缓存的 EPUB。
    • 离线状态下可继续使用本地阅读状态、标签、作者、状态和排序信息。

  • 优化 Komga API、SSE 和网络请求调度，减少重复请求和无效等待。

  • 阅读器处于前台时会优先保证阅读请求，降低后台下载与页面加载争抢网络资源造成的影响。

数据兼容与稳定性

  • 重构书库连接架构，将 Komga 与本地文件夹统一到新的连接管理体系，并保留现有 Komga 配置的升级兼容。
  • Koharia 备份使用专用的 .kohariabackup 格式，避免误导入不兼容的 .tachibk 备份。
  • 优化冷启动初始化流程，减少启动阶段不必要的阻塞。
  • 修复并调整启动页与桌面应用图标显示。
  • 改进阅读器、书架和连接切换过程中的状态清理与异常恢复。
  • 问题反馈模板现已同时提供中文与英文说明。

交流与问题反馈

中文用户可以加入 Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)，交流使用体验、功能建议以及常见问题。

如果遇到可以稳定复现的问题，也欢迎通过 GitHub Issues 反馈：

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

反馈 Bug 时请尽量附上：

  • 问题的完整复现步骤，以及预期结果与实际结果。
  • Android 版本和设备型号。
  • Koharia 版本，以及使用的是 Komga 书库还是本地书库。
  • 涉及的文件格式和阅读模式，例如 EPUB、PDF、CBZ、分页或连续滚动。
  • 如果使用 Komga，请提供 Komga 版本，以及问题是否发生在在线、离线或仅显示缓存模式。
  • 截图、录屏或 Koharia 生成的崩溃日志。
  • 本地书库相关问题请说明使用的是系列库还是单文件库，以及大致的目录组织方式。

提交日志、截图或配置时，请注意隐藏服务器地址、账号、访问令牌以及其他私人信息。

感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。

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: #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

v0.3.0

Koharia v0.3.0

本次版本重点扩展 EPUB 字体、注释和排版能力，加入漫画双页阅读，提升 Komga 搜索、书架与服务器管理体验，并全面优化应用更新下载、非标准 EPUB 兼容和运行稳定性。

EPUB 字体与排版

  • 新增统一字体选择器，支持内置字体、Android 系统字体和本地导入字体。
  • 支持导入 TTF、OTF、TTC 和 OTC 字体，并按字体家族折叠归组。
  • 字体选择页面支持名称搜索、字体系列展开、本地字体导入和删除。
  • 支持常规、粗体、斜体、字体集合和可变字体信息。
  • 修复部分中文字体名称乱码，兼容常见 Macintosh 中日韩编码及异常字体名称记录。
  • 本地字体通过应用私有字体库加载，不会上传到服务器。
  • 新增起始、左、右和两端对齐；两端对齐时支持英文断词。
  • 对齐方式会同步应用于分页、连续滚动和分页扫描，不再错误复用旧分页缓存。
  • 修复左右对齐下首行缩进失效或方向错误的问题。
  • 根据 EPUB 目录锚点保持章节分页边界，避免章节标题前残留上一章内容。
  • 优化作品详情中的出版社、语言、年龄分级和册数换行，长文本不再挤出屏幕。

EPUB 注释与兼容性

  • 点击正文注释标记后，可在当前阅读页打开紧凑、可滚动的注释弹窗。
  • 支持标准 epub:type="noteref"、无障碍角色，以及多看等常见非标准脚注格式。
  • 注释弹窗会使用当前阅读背景和正文设置字号，不需要离开当前阅读位置。
  • 优化文字、图片和 SVG 注释标记的大小、上标位置与点击范围。
  • 分页和连续滚动模式均支持注释交互。
  • 增加常见非标准 XHTML 修复，兼容无值属性等可能导致严格解析失败的内容。
  • 将段落缩进、图片颜色和兼容策略并入首帧准备流程，减少翻页后的排版变化。
  • 修复本地 EPUB 打开时阅读进度被临时分页位置错误覆盖的问题。
  • 修复资源末尾进度同步可能被 Komga 拒绝的问题。
  • 改进 EPUB 预取异常隔离，单个资源错误不再影响整个阅读会话。

EPUB 图片颜色

  • 新增默认开启的“反色时保持图片原色”设置。
  • 设置可在全局阅读设置和 EPUB 阅读器快捷设置中同步调整。
  • 支持分页、连续滚动、普通图片、picture 和 SVG 内容。
  • 修复翻页时图片先被反色、随后才恢复原色的闪烁。
  • 关闭该设置后，可让图片跟随阅读页面一起反色。

漫画双页阅读

  • 横向分页阅读器新增单页、双页、自动单页和自动双页布局。
  • 可识别横向跨页、动画页、异常比例页面和尺寸不兼容的相邻页面。
  • 自动决定页面应拆分、配对或独占显示。
  • 支持双页偏移和左右位置交换，适配不同装订与阅读方向。
  • 优化双页加载优先级及完整图片合成。
  • 超大图片或内存压力较高时，会回退到双分块视图，避免整图合成导致内存不足。
  • 长按操作仍会正确命中双页中的原始页面。
  • 修复双页模式下本地进度与 Komga 远端进度被错误判断为冲突的问题。
  • 新增“保存阅读页面的设置修改”开关，可选择仅在当前会话使用设置，或持久保存为默认值。
  • 重新整理漫画阅读设置的顺序和布局。

Komga 搜索

  • 默认搜索范围改为“全部”，同时搜索书籍和系列。
  • 书籍与系列搜索结果会交错展示，并保留各自的分页状态。
  • 搜索栏新增范围切换，可单独选择全部、书籍或系列。
  • 支持作者、标签、阅读状态、书库和单行本等公共筛选。
  • 优先使用 Komga 1.19+ 的新搜索接口，旧服务器会自动回退兼容接口。
  • 改进半角、全角括号和方括号处理，降低特殊字符导致整次搜索失败的概率。
  • 搜索状态下会隐藏无关工具栏按钮，并可通过返回箭头退出搜索。

书架、服务器与章节显示

  • 修复书架筛选在切换书库后丢失的问题。
  • 服务器“显示书库”范围现在会真正限制书架可见内容，而不再只是影响“全部”筛选。
  • 默认仍显示服务器中的全部书库。
  • 优化服务器删除操作：左滑显示紧凑删除按钮，点击后再次确认。
  • 服务器地址会自动清理首尾空格和末尾斜杠，避免 URL 拼接异常。
  • 新增“隐藏缺失章节提示符”设置。
  • 新增“显示文件大小”设置。
  • 文件大小恢复为跟随章节名称并使用括号显示，减少列表第二行的信息拥挤。
  • 优化网格模式中的阅读进度和已读角标。
  • 精简服务器、文件大小和阅读进度同步相关设置文案。

更新与下载稳定性

  • 更新元数据和 APK 下载优先使用 download.koharia.org，GitHub 作为备用来源。
  • 更新说明会根据系统语言自动选择中文或英文；其他语言统一显示英文说明。
  • 手动检查更新时始终打开更新页面；没有新版本时会显示当前版本公告，并明确提示暂无更新。
  • APK 下载支持 .part 临时文件和断点续传。
  • 增加下载源自动回退、指数退避重试和可重试错误分类。
  • 下载完成后会校验文件大小、SHA-256、应用包名和签名证书。
  • 修复重复触发更新下载时多个任务同时写入同一临时文件的问题。
  • 新增 FOSS 通用 APK、各架构 APK 和 SHA256SUMS.txt 校验文件。
  • 正式 Release 发布后会自动触发 Koharia 官网更新。

稳定性与崩溃修复

  • 章节磁盘缓存的外部目录不可用时，会自动回退到应用内部临时缓存目录。
  • 缓存容量会根据实际使用目录计算，内部回退缓存也会正确参与统计和清理。
  • 修复外部缓存目录被删除、无法创建或临时不可用时可能导致的启动崩溃。
  • 应用更新后会刷新桌面小组件，重建可能过期的 PendingIntent。
  • 移除当前小组件不需要的 Glance 跳板 Activity，避免旧 PendingIntent 触发崩溃。
  • 网络调试日志会隐藏认证信息、API Key 和 Cookie Header。

初次使用与品牌体验

  • 没有配置服务器时，书架不再显示加载错误，而是引导用户添加服务器。
  • 初始用户引导中新增“添加服务器”入口，可直接进入服务器配置页面。
  • 应用内官网、文档和支持链接统一更新为 koharia.org。
  • 更新 Koharia 应用图标、主题单色图标和启动页视觉。
  • 新图标进一步区分 Koharia 与 Komga 官方项目的品牌形象，减少将本应用误认为 Komga 官方客户端的情况。
  • Koharia 是面向 Komga 的独立 Android 阅读器，并非 Komga 官方客户端。
  • 优化自适应图标安全区、缩放比例和垂直对齐，避免启动页裁切或视觉偏移。
  • 更新 Android Studio 项目图标、README Logo 和中英文界面截图。

社区与问题反馈

交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)

如果遇到崩溃、白屏、排版异常、字体加载失败、注释无法打开、进度错误、双页显示异常或更新下载失败，也欢迎通过 GitHub Issues 反馈：

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

反馈时请尽量附上：

  • 问题复现步骤
  • Android 版本和设备型号
  • 应用截图或录屏
  • 应用生成的崩溃日志
  • 涉及的文件类型、阅读模式和 Komga 版本
  • 字体问题所使用的字体格式及字体名称

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载文件的版本为 0.3.0。

中国大陆用户推荐优先使用夸克网盘或百度网盘下载，通常比直接连接 GitHub 更稳定。

如果应用内更新下载失败，可以从网盘下载新版本的普通通用 APK，并直接覆盖安装现有正式版。使用相同签名的正式版本覆盖安装不会清除已有应用数据。

如果不确定应下载哪个 APK，请使用：

Koharia-v0.3.0-release.apk

本次同时提供不包含遥测组件的 FOSS 通用版本。FOSS 版使用独立应用标识，可与普通版同时安装，不能直接覆盖普通版。

Koharia v0.3.0

This release expands EPUB fonts, footnotes, and layout controls, adds double-page comic reading, improves Komga search and library management, and strengthens update delivery, malformed EPUB compatibility, and runtime stability.

EPUB fonts and layout

  • Add a unified font picker for built-in, Android system, and imported local fonts.
  • Support TTF, OTF, TTC, and OTC imports grouped by font family.
  • Add font search, family expansion, local font import, and deletion.
  • Support regular, bold, italic, collection, and variable-font metadata.
  • Fix mojibake in some Chinese font names, including common Macintosh CJK encodings and malformed name records.
  • Store imported fonts in the app-private font library without uploading them.
  • Add Start, Left, Right, and Justify alignment, with English hyphenation for justified text.
  • Apply alignment consistently to paginated reading, continuous scrolling, and pagination scanning.
  • Fix first-line indentation under physical left and right alignment.
  • Preserve chapter boundaries using EPUB navigation anchors so previous-chapter content does not appear before a chapter heading.
  • Allow publisher, language, age-rating, and volume metadata to wrap on narrow screens.

EPUB footnotes and compatibility

  • Open a compact, scrollable popup when a note reference is tapped.
  • Support standard epub:type="noteref", accessibility roles, and common non-standard footnote formats such as Duokan.
  • Match popup colors and text size to the active reader settings without leaving the current reading position.
  • Refine text, image, and SVG note-marker sizing, superscript placement, and touch targets.
  • Support footnotes in both paginated and continuous-scroll modes.
  • Repair common malformed XHTML, including valueless attributes that can fail strict parsing.
  • Move paragraph indentation, image-color handling, and compatibility policies into first-frame document preparation.
  • Prevent provisional pagination positions from overwriting restored progress when opening a local EPUB.
  • Align resource-end progress with Komga server positions to avoid rejected synchronization.
  • Isolate EPUB prefetch failures so an individual resource error does not terminate the reading session.

EPUB image colors

  • Add a default-enabled “Preserve image colors when inverted” setting.
  • Share the setting between global reader preferences and EPUB quick settings.
  • Cover paginated and continuous-scroll content, including regular images, picture, and SVG.
  • Fix page-turn flashes where images appeared inverted before returning to their original colors.
  • Disable the setting when images should follow full-page inversion.

Double-page comic reading

  • Add single-page, double-page, automatic single-page, and automatic double-page layouts to the horizontal pager.
  • Detect spreads, animated pages, unusual aspect ratios, and incompatible neighboring pages.
  • Split, pair, or isolate pages based on their content.
  • Support shifted pairing and left/right position inversion for different binding directions.
  • Improve double-page loading priority and full-resolution composition.
  • Fall back to dual tiled views for oversized images or high memory pressure.
  • Keep long-press actions mapped to the correct original source page.
  • Fix false local and Komga progress conflicts in double-page mode.
  • Add an option to keep reader-setting changes for the current session only or persist them as defaults.
  • Reorganize comic reader settings for a clearer layout.

Komga search

  • Make “All” the default search scope and search books and series together.
  • Interleave book and series results while preserving independent pagination.
  • Add a search-scope selector for All, Books, or Series.
  • Support shared author, tag, reading-state, library, and one-shot filters.
  • Prefer Komga 1.19+ search endpoints and automatically fall back for older servers.
  • Normalize half-width and full-width brackets to reduce failed searches caused by special characters.
  • Hide unrelated toolbar actions while searching and provide a clear back action.

Library, server, and chapter display

  • Preserve shelf filters when switching libraries.
  • Make the server-level “Show libraries” scope actually restrict shelf contents instead of only affecting the All filter.
  • Keep all server libraries visible by default.
  • Replace the oversized server swipe action with a compact delete button followed by confirmation.
  • Normalize surrounding whitespace and trailing slashes in server addresses.
  • Add a “Hide missing chapter indicators” setting.
  • Add a “Show file size” setting.
  • Display file sizes next to chapter titles in parentheses to keep list metadata readable.
  • Refine reading-progress and read-state badges in grid layouts.
  • Simplify server, file-size, and progress-sync setting descriptions.

Update reliability

  • Prefer download.koharia.org for release metadata and APK downloads, with GitHub as a fallback.
  • Select Chinese or English release notes from the system language; every non-Chinese language uses English.
  • Always open the update screen for manual checks. When no update is available, show the current release announcement with a clear up-to-date message.
  • Support resumable .part downloads.
  • Add source fallback, exponential backoff, and retryable-versus-terminal error handling.
  • Verify APK size, SHA-256, package name, and signing certificates before installation.
  • Prevent replaced update workers from writing the same partial file concurrently.
  • Add universal FOSS, per-ABI APKs, and an attached SHA256SUMS.txt.
  • Trigger a Koharia website rebuild after publishing a GitHub Release.

Stability and crash fixes

  • Fall back to an internal temporary directory when the external chapter disk cache is unavailable.
  • Calculate cache capacity from the directory actually in use and include the fallback directory in cache accounting.
  • Prevent startup crashes when the external cache directory is deleted, cannot be recreated, or becomes temporarily unavailable.
  • Refresh home-screen widgets after an application update to rebuild stale PendingIntents.
  • Remove the unused Glance trampoline activity that could be launched by incomplete legacy PendingIntents.
  • Redact authentication, API key, and cookie headers from verbose network logs.

Onboarding and branding

  • Replace the shelf error with server-setup guidance when no server is configured.
  • Add an “Add server” action to the initial onboarding flow.
  • Update website, documentation, and support links to koharia.org.
  • Refresh the Koharia launcher, themed monochrome icon, and splash-screen branding.
  • The new branding further distinguishes Koharia from the original Komga project and reduces confusion with an official Komga client.
  • Koharia is an independent Android reader built for Komga and is not an official Komga application.
  • Correct adaptive-icon safe zones, scaling, and vertical alignment.
  • Update the Android Studio project icon, README logo, and localized screenshots.

Community and feedback

Join the Komga Discord server and visit the Koharia channel.

Report crashes, blank screens, layout problems, font-loading failures, inaccessible footnotes, incorrect progress, double-page layout issues, or update failures through GitHub Issues:

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

When reporting an issue, please include:

  • Reproduction steps
  • Android version and device model
  • Screenshots or screen recordings
  • Crash logs generated by the app
  • Relevant file type, reader mode, and Komga version
  • Font format and font name for font-related issues

Downloads

GitHub Releases is the authoritative source for release information. Make sure the downloaded build reports version 0.3.0.

Users in mainland China are encouraged to use Quark Drive or Baidu Netdisk for more reliable downloads.

If the in-app update download fails, download the regular universal APK from either drive and install it over the existing regular release. Installing an update signed with the same key preserves existing app data.

If you are unsure which APK to download, use:

Koharia-v0.3.0-release.apk

A universal FOSS build without telemetry components is also available. It uses a separate application ID, can be installed alongside the regular build, and cannot directly replace it.

What's Changed

  • 扩展 Komga 搜索范围与容错 / Expand Komga search scope and resilience by @Mister-album in https://github.com/Mister-album/Koharia/pull/50
  • 修复 EPUB 图片反色与翻页闪烁 / Fix EPUB image inversion and page-turn flicker by @Mister-album in https://github.com/Mister-album/Koharia/pull/53
  • 修复 EPUB 非标准内容兼容与进度稳定性 / Fix EPUB compatibility and progress stability by @Mister-album in https://github.com/Mister-album/Koharia/pull/55
  • 清理不可达的即将推出功能与无效风险通知 / Remove unreachable upcoming feature and ineffective risk warnings by @Mister-album in https://github.com/Mister-album/Koharia/pull/56
  • 优化 EPUB 文本对齐与作品元数据换行 / Improve EPUB text alignment and metadata wrapping by @Mister-album in https://github.com/Mister-album/Koharia/pull/57
  • 支持 EPUB 注释弹窗与非标准脚注兼容 / Add EPUB footnote popups and compatibility by @Mister-album in https://github.com/Mister-album/Koharia/pull/58
  • 支持 EPUB 本地与系统字体 / Add local and system EPUB fonts by @Mister-album in https://github.com/Mister-album/Koharia/pull/59
  • 替换并修正 Koharia 应用图标 / Replace and fix the Koharia app icon by @Mister-album in https://github.com/Mister-album/Koharia/pull/60
  • 修复章节缓存与小组件更新崩溃 / Fix chapter cache and widget update crashes by @Mister-album in https://github.com/Mister-album/Koharia/pull/61
  • 优化应用更新下载稳定性 / Improve app update download reliability by @Mister-album in https://github.com/Mister-album/Koharia/pull/62
  • 优化书架范围、服务器管理与章节显示 / Improve shelf scope, server management, and chapter display by @Mister-album in https://github.com/Mister-album/Koharia/pull/63
  • 漫画双页阅读与会话设置 / Comic double-page reading and session settings by @Mister-album in https://github.com/Mister-album/Koharia/pull/64

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

文件校验 / File verification

所有 APK 的 SHA-256 摘要均包含在附件 SHA256SUMS.txt 中。

SHA-256 digests for every APK are available in the attached SHA256SUMS.txt.

v0.2.3

Koharia v0.2.3

本次版本重点优化了 EPUB 连续阅读、正文图片交互、图片型 EPUB 路由，以及书库筛选和作品详情页的显示体验。

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载文件的版本为 0.2.3。

EPUB 阅读体验

  • 连续滚动模式现在可以自然衔接相邻内部章节，到达章节末尾后可直接继续向下阅读。
  • 连续阅读仅保留当前章节附近的内容，在保持进度、书签和 Komga 同步的同时降低长篇书籍的内存占用。
  • 优化平板排版宽度，减少正文两侧过多留白，更充分利用大屏阅读区域。
  • 优化章节标题、右对齐署名和图片段落的首行缩进，避免结构性内容被错误缩进。
  • 出版商样式默认开启；已有用户明确保存的设置不会被覆盖。
  • 优化亮度、字号和背景颜色快捷设置的布局，中英文界面下更加紧凑稳定。

EPUB 图片预览与操作

  • 正文图片现在支持单击全屏预览和长按操作。
  • 全屏预览支持双击缩放、双指缩放、拖动，以及点击图片切换顶部控件。
  • 长按图片可执行预览、保存、分享和复制到剪贴板。
  • 支持普通图片、picture、独立 SVG，以及 href / xlink:href 引用的 SVG 图片。
  • 保存和分享会保留图片原始格式、扩展名和字节内容。
  • 连续滚动模式中的图片也能正确定位和加载。
  • 链接图片仍保留原有跳转行为，不会被普通单击预览拦截。
  • 优化 EPUB 与漫画图片操作面板的样式和按钮辨识度。

图片型 EPUB 自动选择阅读器

  • 根据 Komga 媒体信息自动区分普通可重排 EPUB 和图片页 EPUB。
  • 图片型、扫描型 EPUB 默认使用漫画分页阅读器打开。
  • 普通 EPUB 继续使用 Readium 阅读器。
  • 旧章节会在首次联网打开时自动补齐分类信息，不需要数据库迁移。
  • 离线且无法确定类型时会优先使用 EPUB 阅读器，避免错误路由。

书库筛选

  • 漫画书架和书籍书架现在分别保存筛选状态，互不干扰。
  • 修复从作品详情返回、刷新书架或重启应用后筛选条件丢失的问题。
  • 修复启动阶段服务器筛选信息尚未加载时，已保存的媒体库选择被临时状态覆盖的问题。
  • 根据系列、阅读列表和单本文件动态显示适用的筛选项。
  • 优化阅读状态、单本文件、作者角色等筛选文案和分组。
  • 只有配置多个服务器时才显示服务器切换按钮。

作品详情页

  • 显示模式拥有独立的顶部切换按钮，不再放在筛选菜单内。
  • 支持松散网格、紧凑网格、纯封面和列表四种章节显示模式。
  • 网格模式可显示阅读百分比和已读勾选角标。
  • 漫画网格进度统一显示为百分比，列表模式继续显示已读页数。
  • 新增全局“显示阅读进度与已读状态”设置。
  • 详情页中的显示开关只对当前页面临时生效，只有选择“设为默认”时才会写入全局设置。
  • 优化进度文字阴影、已读角标、封面明暗和角标圆角效果。
  • 修复网格模式下顶部封面背景无法铺满屏幕左右边缘的问题。
  • 作品简介默认收起，折叠预览由 3 行增加到 4 行。
  • 顶部按钮调整为“显示模式 → 筛选 → 下载 → 更多”。

社区与问题反馈

可加入 Komga Discord，前往其中的 Koharia 子频道交流使用体验和反馈问题。

如果遇到崩溃、白屏、排版异常、图片无法操作、进度错误或阅读器选择错误，也欢迎通过 GitHub Issues 反馈：

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

反馈时请尽量附上：

  • 问题复现步骤
  • Android 版本和设备型号
  • 应用截图或录屏
  • 应用生成的崩溃日志
  • 涉及的文件类型、阅读模式和 Komga 媒体信息

交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)

Koharia v0.2.3

This release improves EPUB continuous reading, in-content image interaction, image-based EPUB routing, library filters, and manga detail presentation.

Downloads

Release information on GitHub Releases is authoritative. Make sure the downloaded build reports version 0.2.3.

  • GitHub Releases: https://github.com/Mister-album/Koharia/releases/latest
  • Quark Drive: add the 0.2.3 link after upload
  • Baidu Netdisk: add the 0.2.3 link after upload

EPUB reading

  • Continuous scrolling now flows naturally into adjacent internal chapters.
  • Nearby resources are retained while distant chapters are released to limit memory use in long books.
  • Progress persistence, bookmarks, navigation, and Komga synchronization continue to work across chapter boundaries.
  • Tablet layouts use more of the available reading width.
  • Paragraph indentation no longer incorrectly affects headings, signatures, or image-only paragraphs.
  • Publisher styles are enabled by default without overriding an existing explicit preference.
  • Brightness, font-size, and background controls now have a clearer and more stable layout.

EPUB image interaction

  • Tap EPUB images to open a fullscreen preview.
  • Long-press images to preview, save, share, or copy them to the clipboard.
  • The viewer supports double-tap zoom, pinch zoom, and panning.
  • Supports regular images, picture, standalone SVG images, and SVG href / xlink:href references.
  • Save and share operations preserve the original image format and bytes.
  • Images inside continuous-scroll chapters are resolved against the correct EPUB resource.
  • Linked images keep their original navigation behavior.
  • EPUB and comic image action panels now use clearer and more consistent styling.

Image-based EPUB routing

  • Komga metadata is used to distinguish reflowable EPUB books from image-based or scanned EPUB files.
  • Image-based EPUB files open in the comic page reader.
  • Regular EPUB books continue to use the Readium reader.
  • Existing chapter metadata is completed automatically on the first online open.
  • When offline classification is unavailable, Koharia falls back conservatively to the EPUB reader.

Library filters

  • Comic and book shelves now persist their filter state independently.
  • Filters survive detail-page navigation, shelf refreshes, and app restarts.
  • Persisted library selections are no longer overwritten while server metadata is still loading.
  • Filter groups adapt to series, read lists, and one-shot books.
  • Server switching is shown only when multiple server profiles exist.

Manga details

  • Display mode now has a dedicated toolbar action instead of being placed in the filter menu.
  • Added comfortable grid, compact grid, cover-only, and list modes.
  • Grid layouts show reading percentages and read checkmarks.
  • Comic grid progress is displayed as a percentage, while list mode retains page-count text.
  • Added a global preference for progress and read-state indicators.
  • Detail-screen changes remain temporary until “Set as default” is selected.
  • Refined progress shadows, read badges, cover dimming, and corner styling.
  • Fixed the cover backdrop not reaching both screen edges in grid mode.
  • Descriptions are collapsed by default and now show four preview lines.
  • Toolbar actions are ordered as “Display mode → Filter → Download → More.”

Community and feedback

Join the Komga Discord server and visit the Koharia channel.

Report crashes, blank screens, layout problems, image interaction failures, incorrect progress, or reader-routing issues through GitHub Issues:

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

贡献者

  • @Mister-album profile picture
Mister-album

v0.2.2

Koharia v0.2.2

本次版本重点升级了 EPUB 书籍阅读器，并对漫画加载、书架管理、离线缓存、下载目录和旧版本升级兼容进行了优化。

下载

国内用户可优先选择夸克网盘或百度网盘下载。版本信息与更新说明以 GitHub Releases 为准。

  • GitHub Releases：/changelogs//latest
  • 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp
    提取码：8tbp
  • 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g
    提取码：6s2g

EPUB 书籍阅读器重点更新

  • 新增基于 Readium 的原生 EPUB 阅读器，为书籍提供独立于漫画的阅读体验。
  • 支持分页、连续滚动、从左到右和从右到左等阅读方式。
  • 新增目录、书签、全文搜索、章节切换、进度拖动和音量键翻页。
  • 支持调整字号、字体、行距、段落间距、页边距、首行缩进和阅读区域。
  • 支持自定义背景颜色、亮度、出版商样式以及屏幕刘海区域显示。
  • 优化阅读进度恢复与服务器进度同步，减少错误跳转和重复提示。
  • 新增当前页、总页数和视觉分页缓存；排版变化后会重新计算页面信息。
  • 优化 EPUB 首屏加载、书籍缓存和按需资源读取，减少重复网络请求。
  • 修复横竖屏切换、行距调整、出版商样式、文字方向和页面背景等问题。
  • 优化 EPUB 下载、离线打开和缓存管理。

其他重点更新

  • 优化漫画首屏加载，优先请求当前页面并双向预载相邻页面。
  • 优化漫画快速翻页、页面缓存和网络较慢时的阅读体验。
  • 书架可按服务器媒体库划分为“漫画”和“书籍”，也可以继续合并显示。
  • 完善多服务器管理、服务器重命名、删除和重新添加流程。
  • 优化下载目录结构，并兼容旧版本已经下载的内容。
  • 区分手动下载、书籍缓存和漫画页面缓存，避免缓存状态与下载状态混淆。
  • 完善旧版本数据库和单服务器配置迁移，提高直接升级的兼容性。
  • 更新应用内帮助文档、隐私政策和中英文网站链接。

已知风险与问题反馈

v0.2.2 包含大量 EPUB 阅读器功能和底层加载流程调整。不同书籍排版、设备、Android WebView 版本和服务器环境之间可能仍存在一些 Bug。

如果遇到崩溃、白屏、排版异常、进度错误、加载缓慢或其他问题，欢迎通过 GitHub Issues 反馈：

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

提交问题时请尽量附上：

  • 问题复现步骤
  • Android 版本和设备型号
  • 应用截图或录屏
  • 应用生成的崩溃日志
  • 涉及的文件类型和阅读模式

交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)

升级异常处理

如果覆盖安装后出现无法启动、数据库迁移失败或旧设置冲突，可以在确认阅读进度已经同步、重要数据已经备份后：

  1. 卸载旧版本 Koharia。
  2. 下载并直接安装 v0.2.2 新版本。
  3. 重新添加服务器并恢复必要设置。

注意：卸载应用通常会清除本地设置、未同步的阅读进度及其他仅保存在 App 内的数据，请在操作前完成备份或同步。

Koharia v0.2.2

This release focuses on a major upgrade to the EPUB book reader, along with improvements to comic loading, library management, offline caching, download directories, and compatibility when upgrading from older versions.

Downloads

  • GitHub Releases: https://github.com/Mister-album/Koharia/releases/latest
  • 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

EPUB reader highlights

  • Added a native Readium-based EPUB reader with a dedicated book-reading experience.
  • Added paged and continuous scrolling modes with multiple reading directions.
  • Added table of contents, bookmarks, full-text search, chapter navigation, progress seeking, and volume-key page turning.
  • Added controls for font size, font family, line height, paragraph spacing, margins, first-line indentation, and the reading area.
  • Added custom background colors, brightness control, publisher styles, and display cutout support.
  • Improved local position restoration and server progress synchronization.
  • Added visual page counts and pagination caching, with recalculation after layout changes.
  • Improved first-screen loading, book caching, and on-demand resource access.
  • Fixed issues involving orientation changes, line spacing, publisher styles, writing direction, and reader backgrounds.
  • Improved EPUB downloads, offline opening, and cache management.

Other highlights

  • Improved comic startup by prioritizing the current page and prefetching nearby pages in both directions.
  • Improved rapid page turning, page caching, and reading on slower connections.
  • Added optional Comics and Books library sections based on server library classification.
  • Improved multiple-server management, renaming, removal, and re-adding behavior.
  • Simplified download directories while preserving compatibility with existing downloads.
  • Separated manual downloads, book cache, and comic page cache.
  • Improved database and legacy single-server migrations for safer upgrades.
  • Updated in-app documentation, privacy, and localized website links.

Known risks and feedback

Koharia v0.2.2 contains extensive EPUB reader features and underlying loading changes. Some bugs may still occur with particular book layouts, devices, Android WebView versions, or server environments.

If you encounter crashes, blank screens, layout problems, incorrect progress, slow loading, or other issues, please report them through GitHub Issues:

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

When possible, include:

  • Steps to reproduce the problem
  • Your Android version and device model
  • Screenshots or screen recordings
  • Crash logs generated by the app
  • The affected file type and reading mode

Troubleshooting upgrades

If an in-place update causes startup failures, migration errors, or conflicts with older settings, first make sure important progress is synchronized or backed up. You can then:

  1. Uninstall the previous version of Koharia.
  2. Download and install Koharia v0.2.2 as a fresh installation.
  3. Add your servers again and restore any required settings.

Uninstalling the app normally removes local settings, unsynchronized reading progress, and other app-only data. Back up or synchronize important data before proceeding.

贡献者

  • @Mister-album profile picture
Mister-album

v0.1.8

此版本围绕 Komga 多服务器使用场景进行了较大幅度增强，新增服务器管理、共用下载目录下的跨服务器下载复用，并继续优化书架、章节显示、元数据展示、离线缓存与阅读进度同步体验。

新增与增强

  • 新增 Komga 多服务器管理，可添加、编辑、删除并快速切换服务器。
  • 新增本地配置模式，可选择共用配置或按服务器分别保存配置。
  • 新增下载目录模式，可选择按服务器分目录或使用共用下载目录。
  • 在共用下载目录模式下支持跨服务器复用已下载文件，减少同一文件在不同服务器之间重复下载。
  • 新增 Komga 共享下载索引，用于记录远端书籍与本地文件的匹配关系。
  • 下载、重命名、删除流程会同步维护共享下载索引，提高共用目录模式下的一致性。
  • 预留删除服务器时联动清理下载文件的底层能力；当前默认仍保留下载文件，避免误删高价值内容。
  • 在漫画详情页集成更多 Komga 元数据展示。
  • 新增章节封面显示模式与默认章节标题显示设置。
  • 优化书架显示模式、列数设置、筛选入口、排序与重置行为。

修复与改进

  • 修复 Komga 阅读进度同步问题，避免后台同步使用过期漫画数据。
  • 优化离线缓存与断网阅读行为，减少服务器不可用时的阅读失败。
  • 将本地缓存迁移到应用存储，并增加缓存清理控制。
  • 优化 Komga 元数据缓存与服务器错误时的回退行为。
  • 修复应用更新下载通知进度与安装权限引导问题。
  • 优化多服务器删除流程，删除服务器时会按配置模式清理对应本地配置，默认不删除下载文件。
  • 修复共用目录模式下旧下载目录兼容问题，已有 Komga (ALL) 等旧目录仍可被识别。
  • 修复共享索引路径更新与删除边界问题，降低重命名或删除时产生脏索引的风险。

其他

  • 移除部分 Mihon 遗留迁移功能及不适合 Komga 专属客户端方向的设置。
  • 升级 Gradle Wrapper 至 9.6.1。
  • 增加 PR Agent 与 CI 相关配置，改进后续开发与审查流程。

预览

| 多服务器管理 | 服务器设置 | 书架与详情优化 |

贡献者

  • @Mister-album profile picture
Mister-album

0.1.6

此版本主要修复离线阅读与离线缓存队列相关问题，并进一步提升断网场景下的稳定性与使用体验。

修复与改进

  • 修复断网时无法正常阅读已下载或已缓存内容的问题
  • 修复已下载 PDF 的本地离线阅读问题
  • 优化离线缓存未命中时的错误处理，不再直接显示 504 错误
  • 完善离线缓存队列的单项开始、暂停与取消控制
  • 修复应用重启后缓存进度显示异常及恢复不正确的问题
  • 优化下载进度刷新与状态同步逻辑，减少界面闪烁
  • 调整缓存队列相关界面交互与提示文案
  • 修复应用内更新下载通知不显示进度的问题
  • 修复应用更新下载进度与安装权限引导

贡献者

  • @Mister-album profile picture
Mister-album

0.1.5

新增

  • 新增 Komga 服务器配置即时生效能力，修改服务器设置后无需重启 App。
  • 新增漫画详情页标签搜索支持，可从漫画标签直接跳转到对应 Komga 标签筛选结果。
  • 新增标签搜索状态显示，顶部搜索栏会显示当前正在搜索的标签。
  • 新增阅读器垂直章节导航相关体验优化。
  • 新增漫画与章节 memo 数据持久化支持，覆盖数据库、备份恢复、Source 模型与本地源映射。
  • 新增 Komga 标签搜索相关 debug 日志，方便后续通过 logcat 排查筛选与导航问题。

修改

  • 优化 Komga 服务器设置、请求 headers、网络 client、浏览缓存、下载与同步配置的刷新逻辑。
  • 优化 Komga 书架刷新、排序、布局刷新与筛选状态恢复。
  • 优化 Komga 原始文件下载流程，改进断点续传、下载恢复、进度追踪与网络状态处理。
  • 优化 Komga 阅读进度与历史同步逻辑。
  • 优化阅读器章节切换、AppBar、过渡页与相关设置项。
  • 优化支持页、即将更新页、迁移相关页面以及部分界面文案。
  • 更新 README 与 AGENTS 工作说明。
  • 调整 GitHub workflow、发布配置与项目品牌资源。
  • 更新 Nord 配色的 outlineVariant。
  • 优化 Shizuku receiver 安全处理与扩展仓库相关逻辑。

修复

  • 修复修改 Komga 服务器配置后必须重启 App 才能生效的问题。
  • 修复漫画详情页点击标签搜索时结果为空的问题。
  • 修复标签搜索虽然可触发但实际仍显示作品名搜索结果的问题。
  • 修复标签搜索时顶部未显示当前 tag 的问题。
  • 修复 GitHub logo 被覆盖回 Mihon logo 的问题。
  • 修复 Spotless 检查失败的格式问题。
  • 修复下载进度字段命名与 Komga DTO 格式问题，保持功能行为不变。
  • 修复下载时额外弹出加入书架提示的问题。

贡献者

  • @Mister-album profile picture
Mister-album

v0.1.1

v0.1.1 Preview

修复 Komga 书架刷新与排序问题

本次预览版本主要修复并优化了 Komga 书架页面的刷新与排序体验。

  • 修复重新进入书库标签页或重新选择书库标签页时，Komga 书架不会自动刷新的问题。
  • 新增下拉刷新功能，并加入可见的拖拽反馈，刷新操作更加直观。
  • Komga 书库排序现在会按照服务器 Web UI 中的排序设置显示，使客户端与服务端的书库顺序保持一致。

贡献者

  • @Mister-album profile picture
Mister-album

v0.1.0

Koharia v0.1.0 Preview

这是 Koharia 的第一个公开预览版本。

Koharia 是一个面向 Komga 服务器内容浏览与阅读的独立第三方 Android 阅读器，基于 Mihon 项目衍生而来，并针对连接 Komga 服务器后的书架浏览、章节阅读与离线访问场景进行了适配。

注意：Koharia 是独立第三方项目，与 Mihon 项目或 Komga 项目不存在隶属、背书或官方维护关系。文中提及 Mihon 与 Komga 仅用于说明项目来源与兼容场景。

主要内容

  • 基于 Mihon 代码库创建 Koharia 项目分支。
  • 调整应用名称、项目标识与相关品牌内容。
  • 面向 Komga 服务器内容浏览与阅读流程进行适配。
  • 保留继承自 Mihon 的 Android 阅读器基础体验。
  • 支持在已配置的 Komga 服务器中浏览书架内容。
  • 支持阅读 Komga 提供的受支持书籍与章节。
  • 支持为离线使用缓存内容。
  • 在服务器与文件格式支持时，可直接下载原始文件。
  • 当原始文件不适合当前阅读路径时，保留页面缓存下载方式，以维持阅读器自动下载兼容性。
  • 保留底层应用现有的追踪器集成能力。

系统要求

  • Android 8.0 或更高版本。
  • 需要可访问的 Komga 服务器。
  • 可访问的内容取决于所连接 Komga 服务器及其管理员授予的权限。

构建说明

本版本可通过 Android Studio 打开项目，或使用 Gradle 在本地构建。

推荐验证命令：

./gradlew.bat :app:compileDebugKotlin

已知说明

  • 当前版本仍处于早期预览阶段，功能与交互可能继续调整。
  • Koharia 不托管、不提供任何漫画或书籍内容。
  • 本项目主要面向 Komga 使用场景，并不代表 Mihon 或 Komga 的官方客户端。
  • 若你再分发 Koharia 或创建自己的衍生版本，请保留许可证与署名说明，并避免将修改版本表述为 Mihon 或 Komga 的官方发布版本。

致谢

Koharia 建立在 Javier Tomas 为 Mihon 最初完成的工作，以及后续 Mihon 项目贡献者持续投入的基础之上。感谢所有上游项目贡献者与继续改进这一衍生版本的贡献者。

许可证

本项目基于 Apache License 2.0 授权。请参阅仓库中的 LICENSE 与 NOTICE 文件了解完整许可与署名信息。

下载

请在本页面下方的 Assets 中下载 APK 文件并手动安装。

贡献者

  • @Mister-album profile picture
Mister-album