如何在 reMarkable 上安装 KOReader 并用 button-listen 服务自动启动
【免费下载链接】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
这篇文章解决的任务是：在 reMarkable 平板上完成 KOReader 的解压安装，并通过 KOReader 自带的button-listensystemd 服务实现开机自启——之后在默认界面（xochitl）长按中间按钮 3 秒以上即可启动 KOReader。以下内容依据仓库中 platform/remarkable/README.md 及随包提供的 button-listen.service、koreader.service、koreader.sh 整理，适用于仓库文档描述的 xochitl 默认界面环境；reMarkable Paper Pro（aarch64）的手动安装步骤见文末说明。
获取设备 IP 与 root 密码
安装通过 SSH/SCP 完成，先要拿到设备地址和登录凭据：
- 连接 Wi-Fi 后，进入 reMarkable 的Settings → About，然后向下滚动到右侧的 GPLv3 compliance 区域查看 IP 地址和 root 密码。注意要用手指拖拽滚动，翻页按钮翻不动这一段。
- 如果没连 Wi-Fi，也可以用 USB 线连接电脑后走 USB 网络，文档说明同样适用。
上传并解压安装包
在电脑上依次执行（<koreader-package>.zip替换为你的 KOReader 发行包文件名，<your-remarkable>替换为上一步查到的 IP 地址）：
scp <koreader-package>.zip root@<your-remarkable>: ssh root@<your-remarkable> unzip <koreader-package>.zip- 第一条命令把发行包拷贝到 reMarkable 的 root 主目录；
- 第二条登录设备 shell；
- 第三条在设备上解压，生成
koreader/目录，后续命令都在该目录下执行。
启用 button-listen 自启动服务
在设备 shell 中、koreader/目录下执行：
cp -v koreader/*.service /etc/systemd/system/ systemctl enable --now button-listen- 第一条把发行包里的全部
.service单元复制到 systemd 单元目录，包括button-listen.service和koreader.service； - 第二条启用并立即启动
button-listen服务。
对应单元文件 button-listen.service 的内容：ExecStart=/home/root/koreader/button-listen，Restart=on-failure（失败时自动重启），After=home.mount，由multi-user.target拉起跑，即开机自启。它的行为是监听按钮事件，在 xochitl 默认界面中中间按钮被按住 3 秒及以上时启动 KOReader。
启用服务后，长按中间按钮 3 秒验证：KOReader 应当启动。启动过程由 koreader.sh 驱动：脚本会先把自身复制到/tmp/koreader.sh再重新执行（用于检测脚本更新后需要整体重启），随后检查ota/update.tar.xz是否有待应用的更新，再运行./reader.lua；退出时会用fbdepth恢复原来的 framebuffer 位深与旋转。
退出 KOReader 回到默认界面的路径：从屏幕顶部下滑，选择右上角图标，依次选择 Exit、Exit。
可选：用 koreader.service 代替 button-listen
如果你打算用别的 launcher 而不是 button-listen，README 给出的替代方式：安装时执行一次
cp -v koreader/koreader.service /etc/systemd/system/之后启动 KOReader 的命令是systemctl start koreader。对应单元 koreader.service 直接执行/home/root/koreader/koreader.sh，并且Conflicts=xochitl.service、OnFailure=xochitl.service——KOReader 运行时与默认界面互斥，KOReader 异常退出会触发回落到 xochitl。
限制与更新注意事项
- 部分 reMarkable 系统更新会清掉新增的 systemd 单元，发生这种情况时需要重新执行上面两条安装命令（
cp与systemctl enable --now button-listen）。 - KOReader 自身 OTA 更新（
koreader.sh中的ko_update_check）在应用更新前会systemctl stop button-listen，更新完成后重新systemctl start button-listen，因此在线更新流程会临时接管该服务，无需手动干预。 - reMarkable Paper Pro（aarch64）：仓库内 platform/remarkable/README_aarch64.md 未包含手动安装的具体命令，仅指向项目 wiki 中 "Manual installation on remarkable Paper Pro" 一节；本仓库文档不提供该平台的可执行步骤，请以 wiki 对应条目为准。
【免费下载链接】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），仅供参考
