安裝 NickelMenu、KOReader、Plato

01. 安裝 NickelMenu

先去 NickelMenu 網址下載最新檔案，檔案名稱為 KoboRoot.tgz，將閱讀器接在電腦上，接著將檔案放在閱讀器磁碟機的 ".kobo" 資料夾下，然後退出閱讀器，閱讀器應該會重開機，重開機後就安裝完畢了。

然後將閱讀器再接上電腦，閱讀器磁碟機應該會多出一個 ".adds/nm" 的資料夾（注意 ".adds" 是一個隱藏資料夾，需要在檔案總管中設定顯示隱藏檔案才能看見），裡面有一個 doc 檔案，會列出一些 NickelMenu 支援的指令，可以參考它添加指令到自己的設定檔，並將設定檔放在同層目錄下，我的習慣是命名為 config。

為了之後方便，在退出磁碟機之前，先去 Kobo 自己的設定檔最後面（.kobo/Kobo/Kobo eReader.conf），使用記事本打開它並添加下面的設定，這樣會讓 Kobo 不去掃瞄某些資料夾，避免 Kobo 把第三方軟體當做檔案，顯示在我的書籍中。

[FeatureSettings]

ExcludeSyncFolders=(\\.(?!kobo|adobe).+|([^.][^/]*/)+\\..+)

02. 安裝 KOReader

去 KOReader 網址下載檔案，檔名為 koreader-kobo-v2021.12.1.zip，解壓縮後，裡面會有一個 koreader 的資料夾，整個複製到閱讀器的 ".adds" 資料夾裡。

03. 安裝 Plato

去 Plato 網址下載檔案，檔名為 plato-0.9.24.zip，解壓縮時選擇解壓縮到 "plato-0.9.24" 資料夾，將整個資料夾複製到閱讀器的 ".adds" 資料夾裡，我的習慣會重新命名為 "plato" 資料夾。

做完步驟 2 和步驟 3 後，整個目錄結構會如下所示。

04. 設定 NickelMenu 設定檔

所謂的設定檔其實就是一個沒有副檔名的純文字檔（沒看過作者的Code，最好還是用 ASCII 或是 UTF-8 編碼較保險），我們可以直接用記事本新增編輯，只要在設定檔案中增加下面指令，就可以在首頁分別啟動 KOReader 和 Plato 了。

menu_item :main    :KOReader                 :cmd_spawn          :quiet :exec /mnt/onboard/.adds/koreader/koreader.sh
menu_item :main    :Plato                    :cmd_spawn          :quiet :exec /mnt/onboard/.adds/plato/plato.sh

config 檔案應該如下圖所示。

或者也可以去此網站，按右鍵另存新檔，並選擇所有檔案類型，此時下載下來的便會是一個沒有副檔名的 "config" 檔案，接著把它放到 ".adds/nm" 資料夾中即可。

如何移除 NickelMenu

假設閱讀器插上電腦後，其磁碟機代號為 f:，則在 f:\.adds\nm 資料夾中新增一個檔案名稱為 "uninstall" 的檔案，注意沒有任何附檔名，接著讓閱讀器重開機，在開機的過程中，NickelMenu 看到 "uninstall" 的檔案，便會自己執行反安裝的動作。

懶惰不是病，但懶下去會要人命

可能是我螢幕有設定濾藍光的緣故，每次在終端機下要看目錄名稱都很吃力，反正有 tab 可以補完我也不以為意！

今天終於受不了了，上網查了一下如何更改設定，終於可以看清楚目錄名稱了XD

add LS_COLORS in $HOME/.bashrc

export LS_COLORS=$LS_COLORS:'di=0;92:'

絕世武功隨隨便便都要練個好幾十年

一直以為要成功了，沒想到還是不如所願，難過 >_<

Warning：想要在 Kobo 上使用 Qt，要使用 QPA。

https://doc.qt.io/qt-5/qpa.html

https://github.com/librereader/qpa-einkfb

KoboFileServer 開發記錄

上個星期在釐清了我的需求後，覺得自己比較需要的是 Wi-Fi 傳檔的軟體，而不是 GUI App for Google Drive，故利用了幾天晚上的時間，把 Wi-Fi 傳檔的軟體開發出來，也順利的執行在 Kobo Elipsa 上。

過程中有遇到一些問題，也看了很多國外討論網站，故已經把相關資訊都獨立寫成一篇文章了。但有些是針對 KoboFileServer 的注意事項，想了想還是另寫一篇專文，之後要增添新功能時就比較方便了。

01. 觸發 Import Book，目前是用 NickelMenu 的方法，雖然已經知道掛載 SD 會重複檔案的原因，但暫時是先用 NickelMenu 的方式解決，如果想要減少此操作步驟，可能是想辦法 command line 觸發 action，就像原本呼叫 refresh.sh 的方法一樣，應該是去參考 NickelDbus，似乎在安裝完後有一支 /usr/bin/qndb 可以被呼叫做一些事，我想這樣就可以解決了，可以參考 KoboMail 專案。

02. Form 上傳時，如果超過設定的 32M 會改用 disk 暫存，在 /tmp 下，會看到有一個類似 multipart-xxxxxxxxxx 的檔案。既然是 disk 速度就會慢，故可以考慮視情況微調，以 Elipsa 來說，我覺得可以使用到 200 MB。

03. 使用 Wi-Fi 雖然很方便，但網路速度影響很大，同樣一本 70 MB 的書，從 11 min 到 38 秒都有可能，後者的數據反而是用手機傳的（手機分享網路給 device），可見我家的無線基地台有點爛。

04. 原本已經架好 cross-compiler 的環境，以為可以比照辦理呼叫 libnickel.so 來 import books，沒想到該函數有用到其他 Qt Lib，除了設定 LD_LIBRARY_PATH 外，還必須寫成 QApplication 才行。不過至少確定 x-tools 可以跑在 Windows 10 的 Linux subsytem 裡。

後來發現，如果是寫成 QApplication，會遇到無法執行的問題，會缺少 xcb 的 PLUGIN，找了一下，不論是開發環境或者是 Kobo 系統裡面都找不到相關檔案，目前暫時無解。

Warning：想要在 Kobo 上使用 Qt，要使用 QPA。

https://doc.qt.io/qt-5/qpa.html

https://github.com/librereader/qpa-einkfb

開發或使用 Kobo 第三方軟體注意事項

陸續開發了兩套軟體，碰到了一些問題，記錄一下，以供後人參考。

Note：有新發現會不定期更新。

01. 如果是不需要 GUI 的程式，可以使用 Go 並設定跨平台編譯即可。

02. 如果需要 GUI，一些軟體的做法是先把東西畫到 framebuffer，再一次更新，就不會有閃爍的問題，可以參考 KOReader plugin 或是 application 的作法，另外，寫一個活在 KOReader 裡的軟體，就可以使用 KOReader API 開發 GUI App，開發語言是 Lua。

雖然沒有很懂架構，但寄生在雲端儲存 App 裡面，開啟一個對話盒看起來沒有問題。

03. 如果是透過程式將檔案加到 device，要觸發 device 重新掃瞄檔案系統，有兩種方式：

a. 掛載一個假的 SD，並通知 sd add event to /tmp/nickel-hardware-status。

b. 利用 /tmp/nickel-hardware-status，觸發 usb plug add event，不用真的插線，但使用者需按下連接，接著 sleep 幾秒，再觸發 usb plug remove event。這樣 device 就會重新掃瞄了。

Warning：掛載 SD 方法，之後如果插拔 USB，會讓書出現 2 次，原因是我們把 /mnt/onboard 下的資料夾掛載到 /mnt/sd，但插拔 USB 時，又會去掃 /mnt/onboard，故同樣的檔案才會出現 2 次。我們可以改用 NickelMenu 內建 action 去觸發，查了一下，KoboCloud 也有這種問題，但因為它把檔案下載到 .add 目錄，故用 ExcludeSyncFolders 的方式排除。

04. Kobo 只有在退出 USB 或是使用內建瀏覽器下載檔案時會觸發重新掃瞄檔案系統，也可以直接對 database 動手腳，我還看過有用 database trigger 的，但後者比較難，相容性也不好。

05. 英文網站常會看到 Nickel 這個單字，就是指 Kobo 的系統。

06. 以前的 Kobo 不會對隱藏目錄建立索引，但從版本 4.17 開始會處理隱藏目錄，故有用到 Kobo 支援格式檔案的第三方軟體的檔案就會被顯示在我的書籍中，當利用排除方式處理後，Kobo 會把不再索引的檔案砍掉，這會造成第三方軟體因為缺少檔案而無法啟動，故需要重新安裝軟體。

[FeatureSettings]

ExcludeSyncFolders=(\\.(?!kobo|adobe).+|([^.][^/]*/)+\\..+)

07. Kobo 設定檔在某些不知名情況下會被重設，故偶爾會造成系統異常，如果有看到似乎是重新設置系統的畫面，可以考慮直接關機，重開機後也許就不需重設帳號。

/mnt/onboard/.kobo/Kobo/Kobo eReader.conf

08. Kobo 不支援需要密碼的 PDF 檔案，故重新掃瞄檔案系統看不到檔案是正常的。

09. 下面這套軟體似乎是用 Qt 寫 App，也有提到跨平台編譯？

https://github.com/Rain92/UltimateMangaReader

10. Send to Kobo app，該 app 會自動收信到 device。 

https://github.com/clisboa/KoboMail

11. NickelDBus 是一個使用 Linux D-Bus（軟體訊息匯流排）協定的工具，可以觸發它去做一些事，比如重新掃瞄檔案系統，設定 Wi-Fi 等，以 Qt 和 C++ 開發。

https://github.com/shermp/NickelDBus

12. NickelMenu 底層的原理，稍微 trace 一下，應該就是透過 NickelHook 去呼叫 libnickel.so 裡面的函數，來達到相關功能。也就是 Linux 的 dlopen and dlsym（使用動態連結函式庫的 c function），其實作可詳 NickelHook / nh.c，故要在 Golang 使用，可能只能走 cgo 模式了。

Warning：沒那麼簡單，libnickel 有用到 Qt Lib，以 import book 來說，還要寫成 QApplication 才能呼叫成功，但我最後還是沒試成功。

https://github.com/tylpk1216/kobofileserver/blob/main/cmd/ctool/refresh.cpp

Warning：想要在 Kobo 上使用 Qt，要使用 QPA。

https://doc.qt.io/qt-5/qpa.html

https://github.com/librereader/qpa-einkfb

13. Cross-Compile C code.

a. git clone https://github.com/koreader/koxtoolchain

b. ./toxtoolchain/gen-tc.sh kobo

c. The tool is in /home/xxx/x-tools/arm-kobo-linux-gnueabihf

d. Before you compile your code, set up your env.

export PATH=/home/xxx/x-tools/arm-kobo-linux-gnueabihf/bin:$PATH

source /home/xxx/koxtoolchain/refs/x-compile.sh kobo env

e. Use arm-kobo-linux-gnueabihf-gcc to build your code.

f. 執行時如果需要外部動態函式庫，可以在編譯時指定路徑給 gcc，"-Wl" 是告知 gcc 後面 "-rpath" 是給 linker 用的，"," 代表空白好讓 linker 知道。

-Wl,-rpath,/usr/local/Kobo -Wl,-rpath,/usr/local/Qt-5.2.1-arm/lib

14. 如果要 compile Qt，可以用 NickelTC，高手已經把環境包好。

15. 判斷機器型號的方式，開啟 /mnt/onboard/.kobo/version，檢查最後 3 碼即可，比如說 387 就是 Elipsa，可以看 plato.sh 裡面的判斷方式。

大概就是這些吧 ...

手裡拿著一把槌子，看什麼都覺得是釘子

寫程式的時候很容易掉到思考陷阱中！

昨天想要測試在 Windows 下抓螢幕及模擬滑鼠點擊動作，雖然我 10 幾年前都是用 Win32 API 搞定，但時代在進步，既然多會了幾種語言，就是想要使用這幾年常用的語言來達到我的需求。

我的目標就是想要快速的實作出來，故才會掉入思考陷阱。

一開始就覺得 Node.js 應該有一堆套件可用，但在編譯時遇到問題，單看錯誤訊息也不是一下可以解決的事。

接著使用 Golang，也是遇到編譯問題，看來不管是 Node.js 還是 Golang，底層還是呼叫 Win32 API，故才會有這些編譯的問題（謎之音，那一開始用 C 不就好了，搞不好只要 15 分鐘）？還好作者有提示使用的 C Compiler，安裝了作者使用的 Compiler 後馬上就搞定。順便一提，這兩個功能我一開始是分兩次搜尋，其實最後一套就可以搞定這 2 個需求。

https://github.com/go-vgo/robotgo

花了約 2 個小時完成概念，行數只有 86 行，大部份的時間都在找套件及解決編譯問題。雖然有達到我想要做的事，但好不好用那又是另外一個故事了XD

直到今早我才想到，我的目標是想要快速實作出來，為什麼要捨近求遠，一開始直接去抄我以前寫的 C code 不就搞定？

另外則是執著在想要使用 Node.js 和 Golang，明明我以前也用過 AutoIt 來解決一些 MIS 工作的痛點，但我昨天就是沒有想到該語言。

我想，寫程式前如果多想一點，應該可以少走很多冤枉路XD

世界上不存在完美的電子紙閱讀器，因為看書的人就是小眾市場

從以前對每台新出的電子書閱讀器都抱有滿腔的期待，到現在變成只是淡淡的喔了一聲，絲毫不以為意！原因無他，那就是不可能有一台完美的電子書閱讀器，因為看書的人就是那麼少！廠商不太可能為了這種沒賺錢的生意，花費心血設計一台 90 分的電子書閱讀器（是的你沒看錯，我不覺得現在的閱讀器有到 90 分的程度，但這是以一台什麼事都可以做的閱讀器的基準來評分），如果想要走精品路線，我也懷疑有多少人願意買單？

每個人對完美的閱讀器標準不同，我也降低了我的標準，故我希望擁有 3 種不同形式的閱讀器，來滿足我的個人需求：

01. 一台國產的電子紙閱讀器手機。

我希望是一台國產或是不要偷傳封包的機器，畢竟我真的是要當手機使用，轉帳什麼的對手機來說是家常便飯，故安全性很重要。另外效能也不能太差，故處理器至少要是聯發科等級，如果能是高通當然是更好，至於電量可以撐過一天即可。

海信 A5 雖然效能 OK，但因為不知名封包，故我也無法當手機使用。

02. 一台 6 吋的可上網電子書閱讀器（4：3 比例的螢幕，非手機狹長形的）。

6 吋是最適合手拿的尺寸，也是最適合看流式 EPUB 的尺寸，想要簡單看個 PTT，FB 或是其他網路文章也不會很吃力。

其實 1 和 2 的需求其實很像，重點就在安全性和效能。

03. 一台 10 吋的可上網電子書閱讀器。

10 吋加上裁邊功能，這樣 PDF 也可以擁有更好的閱讀體驗，看固定版面 EPUB 也還可以。某些時候上網用大螢幕還是比較方便。

----------------

因為我上網只是要查資料，故有沒有彩色我也沒有很介意。但就算已經分成 3 台電子書閱讀器了，我目前也找不到一台可以達到 90 分的閱讀器。

如果再把需求限縮，目前我覺得可以達到 90 分的電子書閱讀器只有 2 台：

6 吋看流式 EPUB - Kindle Paperwhite 3

10 吋看 PDF - Kobo Elipsa + 第三方軟體

前後買過 10 台機器的我，還得加上降低標準，這樣也才 2 台達到我的需求，你說無不無奈？