Skip to content

Instantly share code, notes, and snippets.

@Bubbu0129
Last active July 18, 2024 10:35
Show Gist options
  • Save Bubbu0129/92db9ad73ff32408cc41edaef1bbe130 to your computer and use it in GitHub Desktop.
Save Bubbu0129/92db9ad73ff32408cc41edaef1bbe130 to your computer and use it in GitHub Desktop.
Kobo 上手配置教程 Kobo Setup Walkthrough

Kobo 电纸书上手配置教程

“登录”

根据Kobo官网帮助页面 Help,Kobo Store 服务暂不支持中国大陆地区。同时,中国大陆地区也无法访问Kobo官网 Kobo.com,无法注册或登录Kobo账户。没有登录Kobo账户的电纸书缺少了许多功能,如固件更新与书籍同步等。所幸设备的SQLite数据库没有进行加密,插入一个键值对便能够启用这些功能。

假定设备处于出厂设置的状态(可以通过恢复出厂设置达到):

  1. 选择 "I don't have a WIFI network",

  2. 将设备通过USB数据线连接至电脑,在电纸书上弹出的对话框中选择“Connect”,

  3. 安装相应平台的SQLite工具(SQLite Download Page),

  4. 进入设备根目录,执行

    sqlite3 .kobo/KoboReader.sqlite
  5. 在 SQLite Shell 中,执行

    INSERT INTO user(UserID,UserKey) VALUES('1','');
    
  6. 执行

    .exit
    

    退出 Shell,

  7. 弹出设备,

  8. 重启设备(关机&开机)。

此时设备下方应出现"Discovery"一栏。在"More - Settings - Account"中应显示Kobo账户已登录,但用户名为空。

安装阅读器

Kobo 电纸书自带的 Nickel 阅读器,但功能单一,性能较差。幸运的是,Kobo始终没有阻断第三方阅读器的安装,如 KOReaderPlato

KOReader 是一个开源的电纸书阅读器,功能全面,支持基于Linux系统的设备,包括Kobo电纸书;PlatoKOReader 类似,但更专注于 PDF、DJVU 等文档的阅读。

以下内容参考 KOReader wiki 中的 Installation on Kobo devices

  1. 在配置文件.kobo/Kobo/Kobo eReader.conf中,

    [FeatureSettings]
    ...
    ExcludeSyncFolders=\\.(?!kobo|adobe).*?
    ...

    防止设备将程序文件作为书籍加载。

  2. 将设备通过USB数据线连接至电脑,在电纸书上弹出的对话框中选择“Connect”,

  3. MobileRead Post "Attached Files"中下载 KFMon 安装包(KFMon-v<version>.zip),

  4. KOReader Releases 中下载适用Kobo电纸书的安装包(koreader-kobo-v<date>.zip),

  5. Plato Releases 中下载安装包(plato-<version>.zip),

  6. 将 KFMon 安装包解压至设备根目录,

  7. 将 KOReader 安装包解压至.adds

  8. 将 Plato 安装包解压至.adds/plato(新建文件夹),

  9. 弹出设备。

设备将自动重启,之后点击"KOReader" / "Plato"即可运行程序。

配置图书馆

Calibre-Web 是一个可自托管的服务程序,基于 Calibre 的数据库电子图书馆。Calibre-Web 集成了Kobo商店的功能,通过替换设备的Kobo商店API端点,设备在同步时将请求 Calibre-Web,响应后同步服务端的书目。由于设备也会调用API的其他端点,服务端将代理这些请求,所以请确保服务器能够访问Kobo商店API。

以下内容参考 Calibre-Web wiki 中的 Kobo Integration

  1. 服务端安装 Calibre-Web,参考Installation

  2. 开启 Kobo sync 功能,并勾选"Proxy unknown requests to Kobo Store",注意正确设置"Server External Port"为外部端口。

  3. 在"Profile - Kobo Sync Token"下创建 token,记录下Auth URL

  4. 将设备通过USB数据线连接至电脑,在电纸书上弹出的对话框中选择“Connect”,

  5. 在配置文件.kobo/Kobo/Kobo eReader.conf中,

    [OneStoreServices]
    ...
    api_endpoint=<Auth URL>
    ...
  6. 弹出设备,

  7. 重启设备(关机&开机),

  8. 尝试同步。

由于“登录”操作时插入了空的UserIDUserKey值,同步时将显示Sync Failed,但设备仍将同步书目并检查固件更新。片刻后,"Books"一栏应出现服务端的书目。

@zxcvcxz112
Copy link

我按照你的方法无法同步书籍,当我的kobo连接外网时,calibre-web日志可以看到接收到kobo的请求,只是无法成功下载书籍,然而当我的kobo连接国内网络时,在calibre-web上都看不到响应。后来我尝试连接外网登录正常的账号,可以正常接收书籍并同步,说明不是calibre-web的问题,是否kobo只能连接外网才能进行同步,如果国内网络也能同步,能不能告诉我详细的配置,我好找到原因,谢谢

@Bubbu0129
Copy link
Author

Bubbu0129 commented Jul 18, 2024 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment