KOReader 完整指南：10 分钟把老 Kindle 和 Kobo 变成全能墨水屏阅读器-开发者社区

KOReader 完整指南：10 分钟把老 Kindle 和 Kobo 变成全能墨水屏阅读器

【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader

你的 Kindle 装了个 EPUB 就提示格式不支持？你的 Kobo 翻一页要等半秒以上？还是那本扫描版 PDF 在墨水屏上放大看全是锯齿？如果你的设备也中了上面任何一条，先别急着淘汰它——KOReader 是一个专为墨水屏优化的开源文档阅读器，支持 PDF、DjVu、EPUB、FB2、MOBI、DOC 等固定页和可重排格式，能在 Kindle、Kobo、PocketBook、Cervantes、reMarkable、安卓和 Linux 上直接运行。下面按你实际会遇到的问题，一个一个讲。

为什么原厂阅读器那么拉胯，KOReader 又比它快在哪

先说结论：在部分老设备上，实测 KOReader 的翻页延迟不到原厂阅读软件的一半。README 里白纸黑字写着这个测量结果，这不是感觉，是测出来的。

差距主要来自两处。第一是为墨水屏专门重写的界面：没有过渡动画、菜单分页加载、文字对比度和字距都可以单独调。第二是排版引擎更完整，可重排格式（EPUB、FB2、TXT 这些）在 KOReader 里能任意设置四周边距、行距、段距和外部字体，还内置多语言连字符词典，英文段落不会莫名其妙出现大片空白。

顺带一提，扫描版 PDF/DjVu 也能用内置的 K2pdfopt 库重新排版成流式文本，双栏论文可以指定阅读方向。这一条基本是老墨水屏设备"从不能用到能用"的分水岭。

Kobo、Kindle、安卓：不同设备装法各是什么

KOReader 的安装逻辑是"放进去就能用"，不用刷系统。

Kobo：USB 连上电脑，把 KOReader 的压缩包整个解压拷到设备根目录，弹出后等几分钟再重启，桌面就会出现入口。
Kindle：需要先完成越狱，然后通过 Launchpad 或 KUAL 启动，这也是老 Kindle 还能焕发第二春的原因。
安卓：直接装 APK，手机平板都能用。
Linux 桌面：解压后运行platform/common/koreader.sh脚本就能在电脑上先跑起来试玩。

装完之后它的数据（设置、历史、进度）都放在设备的.koreader目录里，settings子目录放全局配置，docsettings子目录按书存各自的排版和进度——想备份或者多设备手动对齐，拷这两个目录就够。

第一次打开：3 分钟调出顺手的排版和翻页

装好先别看书，花三分钟做两件事。

第一，调排版。阅读时点顶部菜单，逐项设置边距、行距、段距、字号和字体；支持加载外部字体文件，字体加载逻辑也允许你指定字体目录。中文用户还能单独微调标点挤压规则，让段首段尾不再"缩进去一大截"。

第二，习惯触摸翻页。KOReader 默认把屏幕切成了几个固定区域：上下边缘是菜单，左右是前后翻页，四个角是快捷操作区，长什么样看这张官方示意图：

想改分区或加双指手势，手势检测模块和 gestures 插件都可以自定义：双指单击呼出目录、两指滑动调前光，把高频操作压进肌肉记忆。

查词零打断：本地词典加在线兜底怎么配

读外文书最折磨人的是"查词→回书→再查"来回横跳。KOReader 的解法是长按选中单词，释义直接在原文上方弹出，看完关掉，眼睛基本不离行。

三层来源按优先级兜底：

本地词典：读词典模块就能看懂它的机制——挂上 StarDict 格式的词典文件（.ifo/.idx/.dict）即可离线查询，中英、英英、日韩词库都能挂，还能给不同词库设优先级，同一本书内高优先级的结果排前面。
在线入口：释义窗口下藏着 Wikipedia、Google Translate 等来源，本地查不到就自动换。
生词沉淀：配合 vocabbuilder 插件，查过的词自动进生词本，读完一本书就攒出一本复习材料。

扫描版 PDF 走不通这条路？配合 OCR 能力对文字区域做识别后，扫描书也能搜索和高亮。

书多了找不动：文件浏览器的三个隐藏用法

书一到几百本，找书比读书还费劲。KOReader 的文件管理器源码在这里，界面朴素但三招很实用：

进度可视化：每本书的封面下直接显示读到哪了，列表里一眼扫到"16% of 24 pages"这种信息，不用点进去。
历史与位置记忆：filemanagerhistory 模块记录你最近看过的文件和目录，打开文件管理器默认回到上次离开的位置，不用一层层目录翻回去。
在线书库直连：opds 插件里添加自己的 OPDS 源，就能在设备上直接浏览局域网 Calibre 书库并无线拉书；calibre 插件还能顺手抓元数据补全封面和简介。

用久了才需要的东西：统计、导出和跨设备同步

基础操作熟练之后，plugins/ 目录下几十个插件才是折腾空间，挑三个回报最高的：

statistics：记录每日阅读时长、连续天数，还能画日历热力图，适合想养成习惯的人。
exporter：把划线和批注一键导出成 Markdown，读书笔记整理效率翻倍。
kosync：进度跨设备同步，手机上读到一半，回家 Kobo 无缝接着读；网络不佳时未传的进度进队列自动补传。

再往上就是极客玩法了：SSH 服务、终端插件、自动关灯、阅读计时……每个插件一个独立目录，删了就是卸载，互不影响。

遇到问题先查这三处

PDF 显示一团糟：别换文件，先试阅读菜单里的重排（K2pdfopt），双栏内容记得开双栏阅读方向。

词典查不到词：确认 .ifo/.idx/.dict 三个文件在同一目录且命名一致，再检查设置里是否勾选启用；在线词典则先确认 Wi-Fi 连着。

设置改乱了不敢动：升级前把.koreader目录整个拷一份出来，尤其是settings和docsettings两个子目录，出任何迁移意外都能回滚。

现在就去装上试一本

KOReader 的下限是"五分钟装好、立刻变快变好用"，上限是你愿意折腾多深。建议第一步就选一本之前"读不下去"的书（格式刁钻的更好），按上面的步骤装好，对比一下原厂体验。

如果你是开发者，拉一份源码看看也很有意思：

git clone https://gitcode.com/GitHub_Trending/ko/koreader

根目录的 Makefile 和构建文档已经把流程封装好了，l10n 目录里躺着二十多个语言的翻译文件——修 bug、补文档、加翻译，任何一条都能成为你给这个项目的第一块砖。

祝阅读愉快 📖

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

KOReader 完整指南：10 分钟把老 Kindle 和 Kobo 变成全能墨水屏阅读器