morealm-reader

项目概述

墨境 MoRealm 是一款现代化的 Android 电子书阅读器，基于 Jetpack Compose 与 Material 3 构建，兼容 Legado 3.x 书源格式。它支持 EPUB、TXT、PDF、MOBI、AZW3、CBZ、CBR 等多种格式，自研 Canvas 排版引擎保证长章节滚动顺滑，并提供 5 种翻页动画与 6 套内置主题。听书、同步与标签管理也一并备齐，采用 GPL-3.0 与商业双许可。

用现代 Android 技术栈重做阅读器，同时兼容你已有的 Legado 书源。

主要功能

• 多格式支持：EPUB、TXT、PDF、MOBI、AZW3、CBZ、CBR
• 自研排版：段落级 LazyColumn 瀑布流引擎，长章节顺滑滚动，按章节预排版
• 翻页动画：平移、覆盖、仿真、上下滚动、无动画共 5 种
• 精细排版：字体、字号、行距、段距、页边距、繁简转换与自定义 CSS
• 多引擎听书：Edge TTS、系统 TTS、OpenAI 与自定义 API 可切换，带 MediaStyle 通知与倒计时
• 书源与搜索：兼容 Legado 书源，CSS/XPath/JSONPath/Regex 四模式规则引擎，CheckSource 一键检测
• 同步与备份：WebDAV 备份恢复与进度同步，本地 ZIP 备份与历史版本恢复
• 主题外观：6 套内置主题、自定义主题、全局背景图与日夜双背景
• 多标签归类：多对多标签系统、15 个内置题材标签与 5 层评分瀑布自动归类

适用人群

• 使用 Legado 书源看书的 Android 用户
• 追求现代 Compose 界面与流畅排版的读者
• 需要在多设备间同步阅读进度的用户
• 喜欢整理书库、给书打标签的书虫

快速上手

1. 从 Releases 下载最新 APK 并安装
2. 从社区获取 .json 书源，在「我的 → 书源管理 → 从 JSON 导入」中导入并启用
3. 回书架点击右上「+ → 网络搜索」，输入关键词找书
4. 在阅读页调整排版、主题与翻页动画，打开听书选择引擎
5. 在设置中配置 WebDAV，启用备份与进度同步

核心优势

• 现代技术栈：Jetpack Compose、Material 3 与 Hilt 带来统一流畅的界面
• 书源兼容：直接使用 Legado 3.x 书源，搬迁时可一次性接管书源与书籍
• 听书多引擎：内置 Edge TTS 与多种远端引擎，通知栏可直接控制
• 自动归类：评分瀑布与题材标签让书库自动整整齐齐

系统要求

项目	要求
操作系统	Android 8.0（API 26）及以上
构建环境	JDK 17、Gradle 8.x（项目自带 wrapper）
网络	TTS、书源搜索与 WebDAV 同步需要联网

注意事项

• 本项目采用双许可：开源使用遵循 GPL-3.0，商业使用需另行获取许可
• TTS 与部分书源解析仍在打磨阶段，远端引擎稳定性受网络环境影响
• 如果某个书源在 Legado 能用、在 MoRealm 不能用，可提 issue 并附上书源 JSON
• 项目不提供内容，需自行准备合法书源