KOReader 电纸书阅读器实操指南Kindle、Kobo 安装、PDF 重排与插件定制全解【免费下载链接】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/koreaderKOReader 是一个面向电纸书e-ink设备的开源电子书阅读器支持 PDF、DjVu、EPUB、FB2 等十几种格式能跑在 Kindle、Kobo、PocketBook、reMarkable 上也支持 Android 和 Linux。它主要解决两个痛点扫描版 PDF 字小到看不清以及原厂阅读器功能封闭、没有插件可装。这篇按装好→用上→定制的顺序写每一步都给你验证点跑偏了随时能自查。结论先行KOReader 能帮你做什么先看结论它值不值得装一张表说清。核心能力解决的问题扫描版 PDF 重排内置 K2pdfopt 引擎扫描文档字小得必须把设备怼到脸上重排后变成字号可调、行距可调的流动文本多格式支持固定版式的 PDF、DjVu、CBT、CBZ和可重排的 EPUB、FB2、Mobi、DOC、RTF、HTML、CHM、TXT一个软件全开电纸书优化 UI无动画、分页菜单、对比度可调e-ink 刷新不闪烁在部分旧设备上翻页延迟不到内置阅读软件的一半排版定制页边距任意设、行距可覆盖文档原值、外部字体 多语言连字符断行插件系统云盘、RSS、Calibre 书库、生词本这类需求用插件补不用等官方发版多设备覆盖同一套功能在 Kindle、Kobo、PocketBook、reMarkable、Android、Linux 上跑动手前设备兼容性与发行包怎么选装之前先花 1 分钟对型号能省掉下载半天最后装不上的时间。① 平台兼容性看两处frontend/device/ 下每个子目录就是一个受支持的平台make/ 下的.mk文件是官方实际做过构建的目标。两者对得上基本就稳了。平台适配代码构建目标Kindlefrontend/device/kindle/kindle.mk新款固件、kindle-legacy.mk老固件、kindlepw2.mkKobofrontend/device/kobo/kobov4.mk、kobov5.mkPocketBookfrontend/device/pocketbook/pocketbook.mk、pocketbookhf.mkreMarkablefrontend/device/remarkable/remarkable.mkAndroidfrontend/device/android/android.mk装 APK 即可桌面 / Linuxfrontend/device/sdl/、frontend/device/generic/linux.mk、emulator.mk开发用模拟器表里查不到你的型号先别装。② 版本与发行包的对应关系里最容易拿错的是这两个Kobo 四代v4与五代v5包名相近、功能几乎一样装反的典型现象是启动即闪退、退回系统界面Kindle 老固件legacy与新款固件年代不同走不同构建目标拿错包同样起不来。拿不准就对着自己 release 包的说明和机型核对别凭感觉选。三步跑起来KOReader 安装步骤与失败自检拿对包之后三步就能把它跑起来每步都有验证点。拿到对应平台的发行包。需要自己从源码构建时git clone https://gitcode.com/GitHub_Trending/ko/koreader电纸书设备把该平台的启动文件放到约定目录Kobo 放/mnt/us根目录Kindle 按发行包说明放/usr或设备根目录。验证连数据线看设备端文件都列得出来目录结构完整。用平台脚本拉起应用。Kindle 跑 platform/kindle/ 下的koreader.shKobo 跑 platform/kobo/ 下的koreader.sh成功后 Kobo 系统桌面会多出一个 KOReader 启动项PocketBook 用platform/pocketbook/koreader.appreMarkable 是koreader.sh配 systemd 服务platform/remarkable/。验证屏幕进入 KOReader 界面而不是回系统菜单Kobo 主屏能看到启动图标——看到界面就说明跑起来了。走完首次引导。第一次启动会自动生成一份快速入门指南触摸设备讲触摸区带键盘的 Kindle 讲按键照着走完进入文件浏览器打开一本书翻一页。验证能正常翻页没有黑屏或卡死。失败自检按现象排查现象一启动就闪退、退回系统菜单 → 原因平台包拿错典型如 v4 机型装了 v5 包→ 怎么查对照上一节的构建目标表核对 release 包与机型。现象文件都拷了Kobo 桌面却没有启动项 → 原因没放在/mnt/us根目录 → 怎么查连数据线看文件位置缺哪层补哪层。现象Kindle 启动后按键没反应或行为怪异 → 原因按键映射与机型不符老键盘机有专用映射 → 怎么查对照frontend/device/kindle/event_map_keyboard.lua里的默认映射逐项核对实际按键。用起来PDF 重排与触摸导航的第一次体验为什么有人从内置阅读器换过来不回头答案就两个功能。功能一扫描版 PDF 重排。痛点扫描文档的 PDF一页放大后只能看两三行读几页眼睛就废了。怎么开打开扫描版 PDF在排版设置里启用重排。引擎是 K2pdfopt接口实现在 frontend/document/koptinterface.lua字号记在kopt_font_size设置里字号、行距、字体都在同一套排版菜单里调。体验变化原本一页两三行的扫描件变成字号可调、行距可调的普通书本文本还能加连字符断行阅读体验接近原生 EPUB。漫画、双栏这类固定版式文档可以切双页、条漫式翻页不用自己硬掰。功能二触摸分区导航。痛点电纸书没有实体键第一次上手不知道点哪。怎么开不用开——首次启动的 quickstart 就是教程由 frontend/ui/quickstart.lua 按你的设备自动生成点屏幕中央翻页点最上一条弹出顶部菜单最下边是状态栏和底部菜单四个角还有独立的角落点按区。体验变化手指落在哪就在哪不用找按钮带键盘的设备则多出一套按键快捷项翻页、跳目录都能按习惯改。想扩展插件目录约定与高频插件清单KOReader 的扩展全是 Lua 插件放进目录就加载不用编译、不用注册表。目录约定每个插件一个*.koplugin文件夹_meta.lua声明名称和描述main.lua是入口放进 plugins/ 就会被自动加载加载器在frontend/pluginloader.lua。开箱自带三十来个高频的有这些插件用途目录calibre无线收书、OPDS 浏览 Calibre 书库、查元数据plugins/calibre.koplugin/cloudstorage挂载 Dropbox、WebDAV、FTP 云盘plugins/cloudstorage.koplugin/newsdownloader订阅并下载 RSS 源plugins/newsdownloader.koplugin/opds浏览任意 OPDS 在线目录plugins/opds.koplugin/vocabbuilder阅读时自动收集生词plugins/vocabbuilder.koplugin/systemstat看电池、内存等系统状态plugins/systemstat.koplugin/自己写一个拿 plugins/hello.koplugin/ 当模板最省事总共几十行建好含_meta.lua和main.lua的目录在addToMainMenu里注册一个菜单项点击后弹个 InfoMessage整个流程就通了。注意模板开头有一行调试开关if true then return { disabled true } end去掉这行插件才会真正启用。想深挖配置存在哪、源码从哪进改源码前先记住两件事设置落在哪代码从哪进。配置分三层各管各的层文件管什么全局frontend/luasettings.lua字号、语言、翻页方式等全局默认写进数据目录的设置文件单文档frontend/docsettings.lua这本书的字体、进度、高亮存成书旁边的 sidecarmetadata.lua换本书自动切回路径datastorage.lua定位数据目录Android 上是外部存储下的koreader目录Linux 上可用KO_HOME等环境变量覆盖插件数据库、缓存都挂在它下面实现查法应用入口在顶层reader.lua设备差异都收敛在frontend/device/平台/device.lua平台行为触摸、按键、电源从这里分叉。想查某个行为到底怎么实现的去spec/unit/找对应的*_spec.lua单元测试——测试名基本就是功能名是最好的活文档。你大概率会卡住的三个问题常见故障排查下面三个坑覆盖绝大多数翻车现场。1. Kobo 装完没有启动项或启动就退回系统。原因十有八九是 v4/v5 包装反或文件没放到/mnt/us根目录。解法先对照kobov4.mk/kobov5.mk核对自己的包再连数据线确认文件就在根目录。两者都排除后仍不行再去看你下载包附带的机型说明。2. PDF 里找不到重排选项或重排不生效。原因重排只对引擎判定为可重排的文档生效纯图像扫描但无文字层、或被判为固定版式的文档走不到这一步另外 DRM 加密书和 KFX 格式完全不支持quickstart 里对 Kindle 用户专门标了这条。解法换一份带文字层的扫描 PDF或直接上 EPUB——EPUB 是官方最推荐的格式。3. 改了字体或行距只在这本书生效。原因单文档设置存在 sidecarmetadata.lua里只跟这本书走长按选项设为 DEFAULT菜单里带星标才是改全局默认且只对新打开的文档生效旧书不会被追溯修改。解法本书的偏好就本书改跨书的偏好就设为默认两者别混。现在就可以做的 3 件事验证你的安装别急着关这篇先做完这三件事再走每件都有可验证的预期结果。✅ 挑一本字最小的扫描版 PDF开启重排前后各读 5 分钟。预期结果文本变成流动排版字号能调到舒适大小每页行数从两三行变成整页。启用一个高频插件建议 calibre。预期结果主菜单多出一个新入口能列出 Calibre 书库并无线收一本书进设备。打开任意一本书读几页退出后重开。预期结果进度和字体原样保留数据目录里能找到这本书的 sidecarmetadata.lua——到这一步设置存在哪的闭环你就自己验证过了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KOReader 电纸书阅读器实操指南：Kindle、Kobo 安装、PDF 重排与插件定制全解
KOReader 电纸书阅读器实操指南Kindle、Kobo 安装、PDF 重排与插件定制全解【免费下载链接】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/koreaderKOReader 是一个面向电纸书e-ink设备的开源电子书阅读器支持 PDF、DjVu、EPUB、FB2 等十几种格式能跑在 Kindle、Kobo、PocketBook、reMarkable 上也支持 Android 和 Linux。它主要解决两个痛点扫描版 PDF 字小到看不清以及原厂阅读器功能封闭、没有插件可装。这篇按装好→用上→定制的顺序写每一步都给你验证点跑偏了随时能自查。结论先行KOReader 能帮你做什么先看结论它值不值得装一张表说清。核心能力解决的问题扫描版 PDF 重排内置 K2pdfopt 引擎扫描文档字小得必须把设备怼到脸上重排后变成字号可调、行距可调的流动文本多格式支持固定版式的 PDF、DjVu、CBT、CBZ和可重排的 EPUB、FB2、Mobi、DOC、RTF、HTML、CHM、TXT一个软件全开电纸书优化 UI无动画、分页菜单、对比度可调e-ink 刷新不闪烁在部分旧设备上翻页延迟不到内置阅读软件的一半排版定制页边距任意设、行距可覆盖文档原值、外部字体 多语言连字符断行插件系统云盘、RSS、Calibre 书库、生词本这类需求用插件补不用等官方发版多设备覆盖同一套功能在 Kindle、Kobo、PocketBook、reMarkable、Android、Linux 上跑动手前设备兼容性与发行包怎么选装之前先花 1 分钟对型号能省掉下载半天最后装不上的时间。① 平台兼容性看两处frontend/device/ 下每个子目录就是一个受支持的平台make/ 下的.mk文件是官方实际做过构建的目标。两者对得上基本就稳了。平台适配代码构建目标Kindlefrontend/device/kindle/kindle.mk新款固件、kindle-legacy.mk老固件、kindlepw2.mkKobofrontend/device/kobo/kobov4.mk、kobov5.mkPocketBookfrontend/device/pocketbook/pocketbook.mk、pocketbookhf.mkreMarkablefrontend/device/remarkable/remarkable.mkAndroidfrontend/device/android/android.mk装 APK 即可桌面 / Linuxfrontend/device/sdl/、frontend/device/generic/linux.mk、emulator.mk开发用模拟器表里查不到你的型号先别装。② 版本与发行包的对应关系里最容易拿错的是这两个Kobo 四代v4与五代v5包名相近、功能几乎一样装反的典型现象是启动即闪退、退回系统界面Kindle 老固件legacy与新款固件年代不同走不同构建目标拿错包同样起不来。拿不准就对着自己 release 包的说明和机型核对别凭感觉选。三步跑起来KOReader 安装步骤与失败自检拿对包之后三步就能把它跑起来每步都有验证点。拿到对应平台的发行包。需要自己从源码构建时git clone https://gitcode.com/GitHub_Trending/ko/koreader电纸书设备把该平台的启动文件放到约定目录Kobo 放/mnt/us根目录Kindle 按发行包说明放/usr或设备根目录。验证连数据线看设备端文件都列得出来目录结构完整。用平台脚本拉起应用。Kindle 跑 platform/kindle/ 下的koreader.shKobo 跑 platform/kobo/ 下的koreader.sh成功后 Kobo 系统桌面会多出一个 KOReader 启动项PocketBook 用platform/pocketbook/koreader.appreMarkable 是koreader.sh配 systemd 服务platform/remarkable/。验证屏幕进入 KOReader 界面而不是回系统菜单Kobo 主屏能看到启动图标——看到界面就说明跑起来了。走完首次引导。第一次启动会自动生成一份快速入门指南触摸设备讲触摸区带键盘的 Kindle 讲按键照着走完进入文件浏览器打开一本书翻一页。验证能正常翻页没有黑屏或卡死。失败自检按现象排查现象一启动就闪退、退回系统菜单 → 原因平台包拿错典型如 v4 机型装了 v5 包→ 怎么查对照上一节的构建目标表核对 release 包与机型。现象文件都拷了Kobo 桌面却没有启动项 → 原因没放在/mnt/us根目录 → 怎么查连数据线看文件位置缺哪层补哪层。现象Kindle 启动后按键没反应或行为怪异 → 原因按键映射与机型不符老键盘机有专用映射 → 怎么查对照frontend/device/kindle/event_map_keyboard.lua里的默认映射逐项核对实际按键。用起来PDF 重排与触摸导航的第一次体验为什么有人从内置阅读器换过来不回头答案就两个功能。功能一扫描版 PDF 重排。痛点扫描文档的 PDF一页放大后只能看两三行读几页眼睛就废了。怎么开打开扫描版 PDF在排版设置里启用重排。引擎是 K2pdfopt接口实现在 frontend/document/koptinterface.lua字号记在kopt_font_size设置里字号、行距、字体都在同一套排版菜单里调。体验变化原本一页两三行的扫描件变成字号可调、行距可调的普通书本文本还能加连字符断行阅读体验接近原生 EPUB。漫画、双栏这类固定版式文档可以切双页、条漫式翻页不用自己硬掰。功能二触摸分区导航。痛点电纸书没有实体键第一次上手不知道点哪。怎么开不用开——首次启动的 quickstart 就是教程由 frontend/ui/quickstart.lua 按你的设备自动生成点屏幕中央翻页点最上一条弹出顶部菜单最下边是状态栏和底部菜单四个角还有独立的角落点按区。体验变化手指落在哪就在哪不用找按钮带键盘的设备则多出一套按键快捷项翻页、跳目录都能按习惯改。想扩展插件目录约定与高频插件清单KOReader 的扩展全是 Lua 插件放进目录就加载不用编译、不用注册表。目录约定每个插件一个*.koplugin文件夹_meta.lua声明名称和描述main.lua是入口放进 plugins/ 就会被自动加载加载器在frontend/pluginloader.lua。开箱自带三十来个高频的有这些插件用途目录calibre无线收书、OPDS 浏览 Calibre 书库、查元数据plugins/calibre.koplugin/cloudstorage挂载 Dropbox、WebDAV、FTP 云盘plugins/cloudstorage.koplugin/newsdownloader订阅并下载 RSS 源plugins/newsdownloader.koplugin/opds浏览任意 OPDS 在线目录plugins/opds.koplugin/vocabbuilder阅读时自动收集生词plugins/vocabbuilder.koplugin/systemstat看电池、内存等系统状态plugins/systemstat.koplugin/自己写一个拿 plugins/hello.koplugin/ 当模板最省事总共几十行建好含_meta.lua和main.lua的目录在addToMainMenu里注册一个菜单项点击后弹个 InfoMessage整个流程就通了。注意模板开头有一行调试开关if true then return { disabled true } end去掉这行插件才会真正启用。想深挖配置存在哪、源码从哪进改源码前先记住两件事设置落在哪代码从哪进。配置分三层各管各的层文件管什么全局frontend/luasettings.lua字号、语言、翻页方式等全局默认写进数据目录的设置文件单文档frontend/docsettings.lua这本书的字体、进度、高亮存成书旁边的 sidecarmetadata.lua换本书自动切回路径datastorage.lua定位数据目录Android 上是外部存储下的koreader目录Linux 上可用KO_HOME等环境变量覆盖插件数据库、缓存都挂在它下面实现查法应用入口在顶层reader.lua设备差异都收敛在frontend/device/平台/device.lua平台行为触摸、按键、电源从这里分叉。想查某个行为到底怎么实现的去spec/unit/找对应的*_spec.lua单元测试——测试名基本就是功能名是最好的活文档。你大概率会卡住的三个问题常见故障排查下面三个坑覆盖绝大多数翻车现场。1. Kobo 装完没有启动项或启动就退回系统。原因十有八九是 v4/v5 包装反或文件没放到/mnt/us根目录。解法先对照kobov4.mk/kobov5.mk核对自己的包再连数据线确认文件就在根目录。两者都排除后仍不行再去看你下载包附带的机型说明。2. PDF 里找不到重排选项或重排不生效。原因重排只对引擎判定为可重排的文档生效纯图像扫描但无文字层、或被判为固定版式的文档走不到这一步另外 DRM 加密书和 KFX 格式完全不支持quickstart 里对 Kindle 用户专门标了这条。解法换一份带文字层的扫描 PDF或直接上 EPUB——EPUB 是官方最推荐的格式。3. 改了字体或行距只在这本书生效。原因单文档设置存在 sidecarmetadata.lua里只跟这本书走长按选项设为 DEFAULT菜单里带星标才是改全局默认且只对新打开的文档生效旧书不会被追溯修改。解法本书的偏好就本书改跨书的偏好就设为默认两者别混。现在就可以做的 3 件事验证你的安装别急着关这篇先做完这三件事再走每件都有可验证的预期结果。✅ 挑一本字最小的扫描版 PDF开启重排前后各读 5 分钟。预期结果文本变成流动排版字号能调到舒适大小每页行数从两三行变成整页。启用一个高频插件建议 calibre。预期结果主菜单多出一个新入口能列出 Calibre 书库并无线收一本书进设备。打开任意一本书读几页退出后重开。预期结果进度和字体原样保留数据目录里能找到这本书的 sidecarmetadata.lua——到这一步设置存在哪的闭环你就自己验证过了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考