原文链接:https://mp.weixin.qq.com/s/rKLIueqFTP0e8QcS-flUXg
墨境 MoRealm:一款集现代化设计、强大书源与极致阅读体验于一身的 Android 开源阅读器
在电子书阅读器领域,Legado(开源阅读)凭借强大的书源系统一直占据着独特地位。而今天要介绍的 墨境 MoRealm,正是一款站在巨人肩膀上、用 Jetpack Compose 全面重写的现代化 Android 电子书阅读器。
🎯 它是什么?
墨境 MoRealm 是一款完全兼容 Legado 书源的 Android 电子书阅读器。与传统的“换皮”不同,它从底层 UI 到渲染引擎全部重写——基于 Google 官方推荐的 Jetpack Compose 框架构建,拥有现代化的 Material 3 设计语言,同时完整继承了 Legado 强大的书源生态。
一句话概括:Legado 的灵魂,现代 Android 的躯体。
✨ 核心亮点
1. 全格式通吃,阅读零门槛
支持 EPUB、TXT、PDF、MOBI、AZW3、CBZ、CBR 等主流电子书格式,几乎涵盖了所有你可能遇到的电子书类型。本地书籍直接导入,无需任何转换。
2. 自研 Canvas 排版引擎,顺滑阅读体验
墨境最值得称道的技术突破之一,是其自研的 Canvas 排版引擎。采用段落级 LazyColumn 瀑布流渲染策略,即便遇到超长章节也能保持丝滑滚动,彻底告别传统阅读器在大章节下的卡顿问题。
排版控制方面同样细腻入微:字体、字号、行距、段距、页边距全部可调,支持繁简一键转换,还可自定义 CSS 随心定制页面样式。
3. 5 种翻页动画 + 5 套阅读预设
阅读器提供了平移、覆盖、仿真、上下滚动、无动画共 5 种翻页效果,满足不同用户的阅读习惯。同时内置纸质、护眼、海蓝、暖黄、墨白 5 套色彩主题,自动适配日夜模式,无论白天强光还是夜间暗光都能找到最舒适的阅读方案。
4. 物理键翻页,支持蓝牙翻页器
墨境 MoRealm 支持音量键翻页、蓝牙翻页器,甚至耳机按键——全键位覆盖。躺着看书时只需按一下音量键就能翻页,让阅读体验更加沉浸。
5. 5 色高亮系统,跨设备云端同步
选词后可直接高亮标记,支持 5 种不同颜色区分阅读重点。所有高亮记录都会存入数据库并持久化,配合 WebDAV 同步功能,可在不同设备间无缝恢复阅读进度和笔记。
🔊 TTS 听书:不止是“读书”
墨境的 TTS(文字转语音)功能也是一大亮点:
- 多引擎可切换:Edge TTS(流式合成 + 本地 LRU 缓存)、系统 TTS、OpenAI 语音、自定义 API,想用哪个用哪个
- MediaStyle 通知栏控制:直接在通知栏显示书名、章节、封面,并提供上一段、暂停、下一段、倒计时等控制按钮
- +10 分钟倒计时:通知栏直接续费睡眠模式,睡前听书再也不用爬起来操作手机
- 更多 TTS 能力正在持续打磨中
📚 书源与搜索:继承 Legado 生态
墨境 MoRealm 最大的杀手锏在于完全兼容 Legado 3.x 的书源格式:
- 4 种规则引擎:CSS / XPath / JSONPath / Regex 全面覆盖,解析能力与 Legado 一致
- 灵活的书源管理:支持分组 chip(不分组、分组名、域名、类型),状态持久化,下次打开自动保留
- 一键检测(CheckSource):勾选书源后实时检测有效性,失败原因持久化显示
- 后台自动刷新书架:并发拉取所有 WEB 书目录,新章节以红色「N 新」角标醒目提示
- 搜索元信息:结果卡片展示最新章节数、字数、分类,搜索历史自动记录
从 Legado 迁移到墨境也非常简单:我的 → 书源管理 → 右上 + → 从 JSON 导入,支持直接粘贴或从链接导入。
☁️ 同步与备份:数据永不丢失
- WebDAV 全套支持:备份、恢复、进度同步、自动调度,接口设计参考 Legado,兼容性极佳
- 本地 ZIP 备份:可勾选导出类别(书籍、书源、进度、主题、阅读样式等)
- 多设备防覆盖:备份文件名自动带设备名后缀,避免冲突
- 历史版本恢复:云端列出所有 backup_*.zip 文件,可按时间点任意恢复
- DB 升级前自动备份:避免新版本崩溃导致数据丢失
🎨 主题与外观:颜值即正义
- 6 套内置主题:墨境、纸上、赛博朋克、森林、深夜、墨水屏,风格各异
- 自定义主题支持:完整的 ThemeEntity 结构,支持导入导出 Legado 主题包
- 全局背景图:4 个 Tab 共享,可单独调节透明度和模糊度
- 日夜双背景图:阅读器可分别配置日间和夜间背景
🏷️ 多标签与自动归类
墨境内置了一套完整的书籍分类系统:
- 多对多标签体系:book_tags + tag_definitions 词表(v17 schema)
- 15 个内置题材标签:修真、玄幻、都市、言情等,关键词可编辑
- 5 层评分瀑布:用户关键词 → 元数据 → 简介 → 标题 → 来源/格式,自动识别书籍题材
- 自动建文件夹:某一题材累计 ≥3 本时自动创建带 emoji 的文件夹。用户手动创建的文件夹永久不会被自动归类引擎改动
🔧 更多实用功能
- Legado 一键搬家:书源、书籍、进度、主题一次性全面接管
- 章节缓存导出 TXT:含书名、作者、简介、净化后正文,方便离线保存
- 检查更新:自动拉取 GitHub Releases,比对版本后弹窗展示 release notes
- 侧滑返回:全 App 一致的手势操作
- 可配置选区菜单:按钮顺序和显示项均可自定义
🛠️ 技术栈:现代 Android 开发的典范
墨境 MoRealm 的技术选型代表了当前 Android 开发的最新趋势:
| 层次 | 技术选型 |
|---|---|
| UI | Jetpack Compose · Material 3 · Compose Navigation |
| 状态管理 | StateFlow / SharedFlow · Hilt DI |
| 数据层 | Room · DataStore · Coil 图片缓存 |
| 网络 | OkHttp(自签证书容错)· QuickJS · Jsoup |
| TTS | Media3 ExoPlayer · Edge TTS WSS · MediaCodec 流式解码 |
| 排版 | 自研 Canvas 渲染(CanvasRenderer / LazyScrollRenderer / SimulationReadView) |
| 异步 | Kotlin Coroutines + Mutex 单飞 |
| CI/CD | GitHub Actions(CI 测试 + LICENSE 校验 + tag 触发自动发版) |
项目要求 Android 8.0 (API 26) 及以上,代码以 Kotlin 为主(占比约 89.4%),结构清晰、模块分明,非常适合对 Android 开发感兴趣的同学学习研究。
📄 许可证与获取方式
墨境 MoRealm 采用双许可模式:
- 开源使用(GPL-3.0):个人、学习、开源项目可免费使用,但衍生作品需以同等条款开源
- 商业使用:需获取商业许可,适用于闭源分发、商业产品集成等场景
下载最新版 APK:👉 GitHub Releases
使用指南:docs/user-guide.md
更新日志:CHANGELOG.md
🙏 致谢
墨境 MoRealm 站在巨人的肩膀上,离不开以下优秀项目的支持:
- Legado — 书源生态、规则引擎设计、备份格式参考
- Microsoft Edge TTS — 远程语音合成
- Material 3 — 视觉系统
- Jsoup / QuickJS / OkHttp — 解析与网络
📸 界面实拍






💬 写在最后
墨境 MoRealm 是一款真正意义上的“现代 Android 阅读器”——用 Jetpack Compose 重构 UI,用自研引擎优化阅读体验,同时完整继承 Legado 丰富的书源生态。无论你是寻找一个日常使用的阅读 App 的普通用户,还是对 Android 开发、书源解析技术感兴趣的学习者,墨境 MoRealm 都值得一试。
项目还在积极迭代中,部分功能(尤其 TTS 和部分书源解析)仍在打磨阶段,欢迎在 GitHub Issues 中提出反馈和建议。
GitHub 项目地址:https://github.com/keys-cherish/morealm-reader
Original link: https://mp.weixin.qq.com/s/rKLIueqFTP0e8QcS-flUXg
MoRealm: An Android open-source reader that combines modern design, powerful book sources, and an ultimate reading experience
In the field of ebook readers, Legado (Open-source Reading) has always held a unique position with its powerful book source system. Today, I want to introduce MoRealm, a modernized Android ebook reader that has been completely rewritten using Jetpack Compose while standing on the shoulders of giants.
🎯 What is it?
MoRealm is an Android ebook reader that is fully compatible with Legado book sources. Unlike traditional "skin changes," it has been completely rewritten from the bottom-up UI to the rendering engine — built on Google's recommended Jetpack Compose framework and featuring the modern Material 3 design language, while fully inheriting the powerful ecosystem of Legado book sources.
One sentence summary: The soul of Legado, the body of modern Android.
✨ Core Highlights
1. Supports all formats, zero barriers to reading
Supports mainstream ebook formats including EPUB, TXT, PDF, MOBI, AZW3, CBZ, CBR, and more — essentially covering every ebook type you might encounter. Local books can be imported directly without any conversion.
2. Self-developed canvas rendering engine for a smooth reading experience
One of MoRealm's most notable technical breakthroughs is its self-developed canvas rendering engine. Using a paragraph-level LazyColumn waterfall flow rendering strategy, it ensures smooth scrolling even with ultra-long chapters, completely eliminating the lag that traditional readers suffer from with large chapters.
Layout control is equally precise: Font, font size, line spacing, paragraph spacing, and page margins are all adjustable; it supports one-click switching between simplified and traditional Chinese; and allows for custom CSS styling of pages.
3. 5 page-turning animations + 5 reading presets
The reader offers 5 page-turning effects — translation, overlay, simulation, vertical scroll, and no animation — to suit different reading habits. It also includes 5 color themes: paper, eye protection, sea blue, warm yellow, and ink white, which automatically adapt to day and night modes for optimal comfort in any lighting condition.
4. Physical button page turning, supports Bluetooth turners
MoRealm supports volume button page turning, Bluetooth page turners, and even earphone buttons — full key coverage. When reading in bed, you can turn the page with a single press of the volume button, making the experience more immersive.
5. 5-color highlight system with cross-device cloud sync
After selecting text, you can directly highlight it in 5 distinct colors to mark reading priorities. All highlights are stored in the database and are persistent; combined with WebDAV synchronization, they can be seamlessly restored across devices along with reading progress.
🔊 TTS listening: More than just "reading"
MoRealm's TTS (text-to-speech) function is another significant highlight:
Multi-engine switching: Supports Edge TTS (streaming synthesis + local LRU cache), system TTS, OpenAI voice, and custom API — use whichever you prefer
MediaStyle notification control: Directly displays book name, chapter, and cover in the notification bar, providing controls for previous segment, pause, next segment, and countdown
+10-minute countdown: Easily extend the sleep timer directly from the notification bar, so you don't have to get up to adjust settings before bed
Further TTS enhancements are continuously under development
📚 Book sources and search: Inheriting the Legado ecosystem
MoRealm's biggest trump card is its full compatibility with Legado 3.x book source formats:
4 rule engines: CSS/XPath/JSONPath/Regex are all supported, providing parsing power identical to that of Legado
Flexible source management: Supports grouping chips (ungrouped, group name, domain, type) with state persistence to retain your organization preferences between sessions
One-click source checking: Select book sources to check validity in real time; failure reasons are logged for troubleshooting
Background automatic bookshelf refresh: Concurrently fetches the catalogs of all web books; new chapters are clearly marked with a red "N" for quick identification
Search metadata: Displays the number of latest chapters, total word count, and classification in the results card; search history is automatically recorded
Migration from Legado to MoRealm is simple: go to My → Book Source Management → + → Import from JSON, then paste or import via URL
☁️ Sync and backup: Never lose your data
Full support for WebDAV: For backup, recovery, progress synchronization, and automated scheduling — the interface design references Legado for excellent compatibility
Local ZIP backup: Selectively export categories (books, sources, progress, themes, reading styles, etc.)
Multi-device protection: Backup filenames include device suffixes to prevent conflicts when syncing
Historical version restore: Cloud storage lists all backup_*.zip files, allowing you to restore to any specific point in time
Automatic pre-upgrade backup: Ensures data is not lost if a new version causes issues
🎨 Themes and appearance: Beauty is key
6 built-in themes: MoRealm, Paper, Cyberpunk, Forest, Midnight, and E-Ink — each with its own distinct style
Custom theme support: Full ThemeEntity structure allows for importing/exporting Legado theme packages
Global background image: Shared across 4 tabs with independent transparency and blur adjustments
Day/night dual background images: The reader supports separate background images for day and night modes
🏷️ Multi-tags and automatic classification
MoRealm features a comprehensive book classification system:
Many-to-many tag system: Utilizes book_tags and tag_definitions dictionaries (v17 schema)
15 built-in genre tags: Including cultivation, fantasy, urban, romance, etc., with editable keywords
5-level rating waterfall: Automatically identifies book genres based on user keywords, metadata, synopsis, title, and source/format
Automatic folder creation: When more than 2 books are accumulated under a genre, an emoji-named folder is created. Manually created folders are never altered by the auto-classification engine
🔧 More useful features
Legado one-click migration: Move sources, books, progress, and themes all at once
Chapter cache export to TXT: Includes title, author, synopsis, and clean text for offline preservation
Check for updates: Automatically fetches GitHub Releases and displays release notes if a new version is available
Swipe-to-back gesture: Consistent across the entire app for intuitive navigation
Configurable selection menu: Customize the order and display of menu buttons
🛠️ Tech stack: The model for modern Android development
MoRealm's technology choices reflect the latest trends in Android development:
Requires Android 8.0 (API 26) or higher
Written primarily in Kotlin (~89.4% of the codebase), with a clear and modular structure
Utilizes Jetpack for state management and lifecycle handling
Leverages Gradle for build automation
Ideal for those looking to learn modern Android development practices
📄 License and acquisition
MoRealm adopts a dual-license model:
Open-source use (GPL-3.0): Free for personal, educational, and open-source projects; derivative works must also be open-sourced under the same terms
Commercial use: Requires obtaining a commercial license, suitable for closed-source distribution or integration into commercial products
Download the latest APK: 👉 GitHub Releases
User guide: docs/user-guide.md
Changelog: CHANGELOG.md
🙏 Acknowledgments
MoRealm stands on the shoulders of giants, relying on the following excellent projects:
Legado — For the source ecosystem, rule engine design, and backup format reference
The NVIDIA Ising-Calibration-1.5 vision-language model was fine-tuned from Gemma 4. It specializes in interpreting calibration experiment figures used in superconducting quantum computing, such as Rabi oscillations, Ramsey fringes, T1 decay curves, spectroscopy data, and GMM readout calibration.









💬 Final thoughts