开源项目zshelf常见问题解决方案

开源项目zshelf常见问题解决方案

zshelf reMarkable app: Browse and download books from Z-Library 项目地址: https://gitcode.com/gh_mirrors/zs/zshelf

1. 项目基础介绍和主要编程语言

项目介绍： zshelf 是一个为 reMarkable 设备设计的开源应用程序，它允许用户浏览并下载 Z-Library 的电子书。zshelf 作为一个网络爬虫，抓取并解析 Z-Library 的网页内容，并在设备上原生显示书籍项目。

主要编程语言： 该项目主要使用 C++ 和 JavaScript 进行开发。

2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤

问题一：如何安装 zshelf？

解决步骤：

1. 确保你的 reMarkable 设备已经安装了 toltec 包管理器。
2. 通过 SSH 连接到你的设备。
3. 运行以下命令安装 zshelf：

   opkg update
   opkg install zshelf
   

4. 对于 reMarkable 2 用户，还需要安装 rm2fb 包：

   opkg install rm2fb
   

问题二：如何配置 zshelf 以便下载书籍？

解决步骤：

1. 在浏览器中打开 Z-Library 网站，并注意到为你所在区域/国家提供的特定域名。
2. 登录你的 Z-Library 账户。
3. 打开浏览器的控制台（按 F12 键并切换到控制台标签），运行以下命令获取 cookies：

   document.cookie
   

4. 复制返回的字符串中包含 remix_userkey 和 remix_userid 的部分。
5. 通过 SSH 连接到 reMarkable 设备，并打开配置文件：

   nano /opt/etc/zshelf/config.json
   

6. 将复制的域名和 cookies 填入配置文件中的 domain 和 cookie 字段。
7. 保存并关闭配置文件。
8. 运行 zshelf 测试配置。

问题三：如何使下载的书籍在 reMarkable 应用中可见？

解决步骤：

1. 如果书籍没有自动出现在 reMarkable 应用中，尝试重启应用或重启设备。
2. zshelf 会将书籍副本保存到配置的 additionalBookLocation 位置，你可以使用其他阅读器（如 KOReader）打开，该阅读器在 toltec 中可用，并提供更好的阅读体验。
3. 安装一个应用启动器以便更容易打开 zshelf，推荐使用 oxide、draft 或 remux，这些都在 toltec 中可用。

zshelf reMarkable app: Browse and download books from Z-Library 项目地址: https://gitcode.com/gh_mirrors/zs/zshelf