
KOReader 新手向指南三步装好电纸书阅读器把扫描 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 是一款为电纸书屏幕优化的开源电纸书阅读器支持 PDF、DjVu、EPUB 等多种格式能跑在 Kindle、Kobo、PocketBook、reMarkable 等电纸书设备上。它适合两类人想把手头的电纸书折腾出更多玩法的读者和被扫描版 PDF 小字号折磨到读不下去的人。下载哪个包先核对型号与固件下载之前先花一分钟做适配确认。依据在 frontend/device/ 目录每个子目录就是一个受支持的平台包括 android、kindle、kobo、pocketbook、remarkable你的型号能在对应子目录里找到适配代码基本就稳了。make/ 目录下的编译目标文件kindle.mk、kobov4.mk、pocketbook.mk 等也能帮你确认官方为哪些具体机型做过构建。Kindle 用户还要核对两点旧固件与新固件对应不同的构建目标下载发行包时别拿错带物理键盘的旧款机型默认按键行为见 frontend/device/kindle/event_map_keyboard.lua。提醒一句包拿错不只是白装。比如给 v4 代 Kobo 放上 v5 的包KOReader 启动就会闪退只能回头重新下载。三步装到设备上拿包、拷贝、启动安装流程各平台是统一的不用逐台记忆拿包下载对应平台的发行包或克隆源码仓库地址https://gitcode.com/GitHub_Trending/ko/koreader自行构建。把该平台的启动文件复制到设备约定目录Kobo 一般放 /mnt/usKindle 放 /usr 或设备根目录以你下载包的说明为准。在设备上运行入口脚本启动 KOReaderKobo 用户通常会在系统桌面多出一个 KOReader 启动项。下表列出各平台的入口文件与放置位置下单核对和启动失败排查都靠它平台入口文件所在位置Kindle含 PW、Oasiskoreader.shplatform/kindle/Kobo区分 v4/v5 代koreader.shplatform/kobo/PocketBookkoreader.appplatform/pocketbook/reMarkablekoreader.sh systemd 服务platform/remarkable/Android直接安装 APKplatform/android/Linux / 桌面桌面包或本机模拟器platform/linux/成功判据很简单屏幕出现 KOReader 界面而不是回到系统菜单就说明跑起来了。Android 直接装 APKLinux 用发行包里的桌面版开发者还可以按 doc/Building.md 搭一个本机模拟器。首次进入界面KOReader 会生成一份内置快速入门由 frontend/ui/quickstart.lua 驱动触摸区、快捷键、手势都有说明照着点即可。默认触摸布局点屏幕中央下一页点最左侧竖条上一页最上边弹出顶部菜单最下边是状态栏与底部菜单四个角还有独立的角落点按区。这个布局对电纸书很友好不用找按钮手指落在哪、动作就在哪。带键盘的设备还有一套按键快捷项翻页、跳目录都能按自己的习惯改。扫描 PDF 字小打开 PDF 重排就能解决扫描文档的 PDF 字小得把设备怼到脸上才看得清大概是电纸书用户最头疼的一档事。KOReader 内置 K2pdfopt 引擎重排链路分三步识别文档版式 → 提取文字 → 按你选的字号重新排版成流动文本。打开重排后原本一页只能看几行的扫描件会变成字号可调、行距可调的普通书本文本还能顺手加上连字符断行阅读体验接近原生 EPUB。配套选项值得一起用页边距任意设置行距可以覆盖文档原值字体可以换成你拷进设备的任意字体文件字体加载由 frontend/ui/font.lua 负责排版项由 frontend/apps/reader/modules/readertypography.lua 负责。双栏、条漫这类固定版式 PDF 有专门的阅读方向选项按双页或条漫方式翻页不用硬掰。在一些较旧机型上KOReader 的翻页响应明显快于内置阅读软件所以“装第三方阅读器会不会卡”的顾虑基本可以放下。把电纸书变成工具箱高频插件一览表KOReader 的扩展全部是 Lua 插件放在 plugins/ 目录每个插件一个文件夹_meta.lua声明名称和描述main.lua是入口放进去即自动加载。开箱自带三十来个高频的有这几个插件用途目录cloudstorage挂载 Dropbox、WebDAV、FTP 云盘plugins/cloudstorage.koplugin/newsdownloader订阅并下载 RSS 源plugins/newsdownloader.koplugin/calibre无线收书、OPDS 浏览 Calibre 书库plugins/calibre.koplugin/opds浏览任意 OPDS 在线目录plugins/opds.koplugin/vocabbuilder阅读时自动收集生词plugins/vocabbuilder.koplugin/systemstat查看电池、内存等系统状态plugins/systemstat.koplugin/想自己写一个拿 plugins/hello.koplugin/ 当模板最省事它是官方留的调试小插件总共几十行——建好含_meta.lua和main.lua的文件夹在addToMainMenu里注册一个菜单项点击后弹一个 InfoMessage整个流程就通了。加载器逻辑在 frontend/pluginloader.lua。设置存哪三层字号、进度、手势修改入口改完设置想确认它落到了哪记住这三层设备级frontend/luasettings.lua 存全局设置字号、语言、翻页方式都在这层。文档级frontend/docsettings.lua 记住“这本”书的字体、进度、高亮换本书自动切回。路径层datastorage.lua 负责定位设备上的数据目录插件数据库、缓存都挂在它下面。触摸手势想改从 frontend/device/gesturedetector.lua 入手有键盘的设备在设备层按键映射里调整。想查某个行为怎么实现看 spec/unit/ 里对应的*_spec.lua单元测试测试名基本就是功能名测试就是最好的活文档。常见问题速查四个常见现象的处理办法启动即闪退、回到系统菜单— 原因拿错了代际的包 — 处理对照上表重新下载对应平台版本。设备里找不到 KOReader / 无法启动— 原因文件拷错目录 — 处理核对入口文件是否放在约定目录如 Kobo 的 /mnt/us。物理键盘按键无响应或动作不对— 原因默认映射与你的键盘不匹配 — 处理到设备层按键映射文件里核对。重排没生效— 原因文档是固定版式而非带文字层的扫描件 — 处理确认文档类型双栏、条漫文档选择对应翻页方向。装完之后先拿一本字最小的扫描版 PDF 开一次重排对比前后体验——这是 KOReader 相对内置阅读器最立竿见影的一步再从插件表里挑两个把云盘和资讯源接进来。后面若好奇某个功能的实现打开 spec/unit/ 的单元测试读一遍改源码、提补丁的路径就清晰了。【免费下载链接】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),仅供参考