✨【Tinker】開源Koreader安裝與各種plugins、patches
繼上篇開箱Kobo ClaraColour後，這篇來講開源閱讀器Koreader與各種好用plugin的安裝過程！下面同時會說明Kobo與Android系統兩者的安裝過程，因為我手上兩種e-ink閱讀器都有，因為體驗後發現好用，乾脆全都裝上Koreader。
What's Koreader? Why Koreader?
Koreader是一個能在Linux（含Kindle與Kobo）, Mac, Android環境上運行的開源閱讀器，設計上專注於提供好的e-ink閱讀體驗，可以讀取PDF, DjVu, CBT, CBZ, EPUB, FB2, Mobi, DOC, RTF, HTML, CHM, TXT, 甚至部分ZIP檔案。也因為使用社群廣大，有許多神人編寫了各種Wikipedia, Calibre, 各大AI API, Syncthing, Readest, 各式UI等套件，而且更新穩定，有bug也多會迅速修復。
過去幾年的我都是用Google Play Books來閱讀，它在雲端同步、書架UI、重點筆記上都很優秀，還能整理成word檔讓Gemini做更多事，唯一的缺點就是只能在網頁瀏覽器與Android、iOS上運行，另外也要看Google臉色（我所有的epub、pdf檔案都不是在Google平台內買的） ，這次趁此機會轉換到開源選項上也好。
如何在Kobo上安裝Koreader？
安裝上我用了已經整理好的 Kobo Essentials封包，並跟著YouTube教學走，記得要改Kobo裝置裡的`/.kobo/Kobo/Kobo eReader.conf`。NickelMenu對Kobo系統來說是必需的，不然不會有能開啟Koreader的選項出現。
影片內的步驟完成後，這個步驟很重要！按畫面上方選單，選取最右邊的三條線選項>更新（Update） >檢查更新（Check for updates），以免之後發生新加入的plugin不合舊版本Koreader的情形。
如何在Android上安裝Koreader？
直接在Koreader的github頁面上沿著Android安裝教學找到releases頁面。我這裡是選擇下載koreader-android-arm-<version>.apk，丟進Android裝置安裝就行。
安裝Simple UI
原生的Koreader UI並不方便操作，社群上因此有許多UI選項，自己觀察最多人用的是Simple UI與Project Title UI，兩者都不錯，但我喜歡Simple UI的書架狀態列在下方，所以我這邊是選擇裝Simple UI套件。想試試Project Title UI可以去右邊releases頁面下載來玩玩看，它的書架頁面和閱讀進度條做地挺好看的，能用的patches也是頗多。
首先進到Simple UI的github頁面，找到右邊的releases，到Assets中下載最新的simpleui.koplugin.zip檔，解壓縮後裡面有2個資料夾，我們只需要名稱為`simpleui.koplugin`的資料夾，先把它存放在自己記得的位置，然後用實體USB線將Kobo裝置連上電腦。這邊建議退出上個步驟安裝好的Koreader後用Kobo原生的方式連接裝置，不知為何自我安裝syncthing之後就沒辦法用Koreader內建的連接方式接上，但Kobo原生的總是沒出過問題。
接著進到Kobo內的`\.adds\koreader\plugins`資料夾內，裡面會有許多原生的plugin資料夾，別管它們，直接把剛剛的simpleui.koplugin資料夾丟進去。之後有什麼Koreader plugin想安裝，也是都丟到這個資料夾內。
Android系統也是差不多，只是資料夾的位置變成`.\koreader\plugins`，一樣之後有什麼新plugin就丟這裡面。
安裝 Freedict 英>中辭典
Koreader本身有字典庫能使用，但自己的經驗是那些字典除了 英>英辭典 外都很爛（能在 上方選項>放大鏡>設定>字典設定>下載字典 中找到）。我個人是去 Freedict的頁面，往下拉到StarDict: Common Choice for Most Devices中選擇Chinese，找到 English - Chinese, version 2025.11.23 with 26660 headwords 下載來用，載下來解壓縮後丟到Kobo的`.adds\koreader\data\dict`或Android的`.\koreader\data\dict`內就好。
安裝AI assistant套件
 |
| 用起來的畫面會長這樣，chatbot會根據上下文去判斷該字的確切翻譯為何，會比任何辭典都準確許多。 |
有時真的會覺得以上翻譯方式都爛到不行，這時可以試試直接prompt市面上常用的免費AI chatbot模型，只是若要每次都複製、貼上非常麻煩，更何況Kobo根本也沒這個選項，這時就是 assistant.koplugin 出場的時候了，只要你有API，Claude, GPT-4, Gemini, DeepSeek, Ollama等全都能用。
安裝的部分稍嫌複雜，跟著github頁面的教學走，我這裡使用的是Gemini的免費API。一樣到github頁面右邊找到releases頁面，下載zip file後解壓縮到相對應的`/plugins`資料夾，之後這步驟比較關鍵：
進到該assistant.koplugin資料夾內，找到一個叫做`configuration.sample.lua`的檔案，用VS code或記事本開啟後，找到 provider = "openai" 這行，把它改成 provider = "gemini" ，畢竟我們接下來要用的是Gemini API；之後往下找到這段，
gemini = {
model = "gemini-2.5-flash", -- model list: https://ai.google.dev/gemini-api/docs/models , ex: gemini-2.5-pro , gemini-2.5-flash
base_url = "https://generativelanguage.googleapis.com/v1beta/models/",
api_key = "your-gemini-api-key",
...
}
接著到AI Studio頁面中找到自己的API key，把 api_key = "your-gemini-api-key" 改成那串自己的API key，並另存新檔為`configuration.lua`在同一個資料夾。
 |
| 點箭頭指到的那個連結，就會跳出屬於你的API key。 |
接著是script的部分，總不能只有安裝好套件，每次使用時還得自己key入prompt吧？那多麻煩？打開這個script文檔，右鍵Save page as儲存為`assi.sh`（檔名完全不用動），存在Koreader的根部資料夾內（Kobo的`.adds\koreader\`或Android的`.\koreader\`）。
最後到裝置上開啟Koreader，點進 上方選項>交叉板手>第2頁>更多工具>終端機模擬器>開啟終端機工作階段（未執行） ，用鍵盤輸入`sh assi.sh`後按enter，就會執行剛才右鍵儲存的那個script文檔；接著按畫面右方的X，選擇退出，選擇最右上角的三條線選單>離開>重新啟動Koreader，這樣AI assistant套件就安裝完成啦！以後在有連網的情況下，選取文字後只要按"字典（AI）"，Gemini就會幫你對照前後文、給予適當的翻譯。
✨安裝Readest.koplugin
一個閱讀器最重要的功能之一就是能夠同步每個裝置的閱讀進度、書籤、重點與筆記等。Koreader上有不少套件能做到這點，我自己就有試過內建的ProgressSync、AnnotationSync、Syncthing與Readest，各有優缺點。
- ProgressSync：Koreader內建的功能，可以直接在Koreader的伺服器上申請帳號密碼，也可以自己架local伺服器（例如晚點會介紹的Koinsight套件），藉此同步各裝置的「閱讀進度」。對，只有閱讀進度而已，重點、筆記等要靠其他套件。
- AnnotationSync：不少人推薦的「書籤、重點、筆記」同步用套件，理論上配合上面的ProgressSync能達到整體同步。但是它的安裝非常麻煩，一般是透過在Dropbox運行app（比較項API key）後，讓json檔存取在Dropbox內。有興趣的可以參考github頁面上的這個教學。
- Syncthing：一個不透過中央化伺服器、點對點（P2P）加密同步的好用開源工具，能運行在後台，主動讓裝置之間互相對話、不限大小的傳輸文件。像我的作法是建立一個資料夾，這個資料夾內的所有檔案在各裝置之間恆久保持同步，只要其中一個裝置上的資料夾內檔案有變動，就會呼叫其他有ID連結的裝置，並把"更動的部分"傳輸過去。但它有個大缺點：有時還搞不清楚版本誰先誰後、就用舊檔案蓋過新檔案了，雖然有14天內紀錄與還原功能，但就是沒想像中那麼方便。
接下來就是我目前用到最好用的Readest套件啦。Readest本身是一個開源的多平台epub與pdf閱讀器，免費版的有500Mb的雲端儲存空間與限次數的AI翻譯等，有訂閱方案、也可以選擇一次付款終生有效的方案。一般來說，如果一個裝置裡有一本書、另一個裝置沒有是沒辦法透過Readest同步閱讀進度、筆記等的（可以push記錄，但pull不下來），因此需上傳書籍、佔用雲端空間，但如果是 "閱讀器之間有完全相同的檔案（連metadata都相同，metadata可以透過之後會提到的Calibre編輯）" 的話，似乎就可以在不將書本上傳到雲端的情況下同步一切進度，至少我是成功這麼做了。用了一週，目前觀察到的缺點只有有時重點同步後會附帶一個空的筆記紀錄。
首先，在PC上安裝Readest app，之後透過app申請一組Readest帳號，之後在其他裝置上會用到；接著到Readest github頁面右邊的releases中找到最新的Readest-version.koplugin.zip檔案，解壓縮後裡面就有熟悉的.koplugin檔案，把它放進裝置內的`\.adds\koreader\plugins`或`\koreader\plugins`資料夾內就完成了。
使用上，進到Koreader的上方選單>交叉板手>第2頁>Readest Sync>登入Readest帳號，之後就能透過這裡的選項同步書籍的一切啦！
安裝Koreader patches
KOReader 的功能擴充主要分為兩類：增加新功能的 Plugins，以及修改既有行為的 Patches。
以下以VeeBui分享的patches為例，她的補丁包含了修改書頁頂部顯示條、編輯劃重點選單。這裡將針對我個人安裝的 Highlight Suite 部分進行示範，講解具體的安裝步驟。若想了解 patches 的運作原理，建議閱讀 Koreader 官方網站的基礎教學。
首先，我建議把整個github repo先下載下來解壓縮。
之後，照著步驟做：
- 在裝置內的`/koreader`資料夾下，創建一個`patches`資料夾。這個資料夾會用來存放各種patch的lua檔案。
- 將剛剛解壓縮檔案中的`/Highlight Suite/CustomHighlightColours/Patches/Vee's Colours/2-customise-highlight-colors.lua`放入`/koreader/patches`資料夾中。
- 將剛剛解壓縮檔案中的`/Highlight Suite/CustomSelectTextMenu/Patches/Vee's Set-up/2-custom-select-text-menu.lua`放入`/koreader/patches`資料夾中。
- 將剛剛解壓縮檔案中的`/Highlight Suite/IconColourMenu/Patches/Vee's Set-up/2-icon-name-colour-menu.lua`放入`/koreader/patches`資料夾中。
- 在裝置內的`/koreader`資料夾下，創建一個`icons`資料夾（Android版本已有，不用特別建立），在`icons`資料夾下創建一個`colours`資料夾。
- 將剛剛解壓縮檔案中的`/Highlight Suite/IconColourMenu/Pre-made Icons/Vee's Hand-drawn Icons/Lighten`內的所有圖片放入`/koreader/icons/colours`資料夾中。
以上最基本的設置就完成啦！之後如果有想更動顏色、圖案、文字等，進到相對應的lua檔中就可以更改，裡面指示都還蠻仔細的。
補充：我也很推SeriousHornet的書庫UI與qewer33快捷設定，安裝方式與上面差不多，該丟`/icons`的、該丟`/patches`的別搞混就好。
Kobo特有：透明背景休眠畫面（screensaver）
到目前為止，Koreader在Android系統上都完勝Kobo的封閉Linux系統，但Android上的Koreader有一點做不到：透明背景的png休眠畫面。因為Android系統上設置的關係，將背景是透明的png設為休眠畫面只會使透明的部分被填成白色，而Kobo上的Koreader可以將背景填白的程序關掉。
過程很簡單，首先將想當成休眠畫面的圖片裝在一個資料夾內，之後可以選擇只用單張圖片或是在整個資料夾內隨機或照順序顯示為休眠畫面。圖片可以在Readerbackdrop.com上找尋。
接著進到Kobo的Koreader內，點擊上方選單>齒輪>休眠畫面>休眠畫面訊息，將"新增自訂訊息至休眠畫面"關掉，這樣才不會有文字浮在休眠畫面上；
接著到上方選單>齒輪>休眠畫面>桌布，這裡可以選擇"在休眠畫面顯示自訂圖片或書籍封面"或"在休眠畫面顯示資料夾隨機圖片"；
選擇完後不要退出，下面的"邊框填充、旋轉與適配"點進去，選擇"無填充"，否則透明的背景會被填充；
最後還是先不退出，到"自訂圖片"內，選擇先前放入休眠畫面圖片的資料夾或檔案，這樣就完成了。
optional: Syncthing套件
PC上安裝Syncthing，可以參考這邊的YouTube教學，建議完成後在真正開始同步前，趁資料還在PC上比較方便整理，先整頓好所有的圖書（像我會分genre、作者、系列等）。
下一步就是各自在Kobo與Android系統上安裝Syncthing。
Kobo上我使用koreader-syncthing套件（注意它只支援Kindle與Kobo裝置），安裝很簡單，把解壓縮後的`syncthing.koplugin`資料夾放進相對應的`plugin`資料夾內就好，但相比Android這個syncthing套件的UI並不好用，but it gets the job done so what else can I complain? 😅 操作上與YouTube教學內的類似，先在PC上加入Kobo遠端裝置，到Kobo的首頁上（syncthing選單不會出現在電子書頁面上）連上Wifi後，開啟上方選單>交叉板手>Syncthing>Pending接受連結；再來，在PC上新增要同步的資料夾，點擊編輯加入Kobo裝置，同樣回到Kobo的上方選單>交叉板手>Syncthing>Pending接受連結，這次要選擇在地想要放這些同步資料的位置，接下來等待資料慢慢傳進Kobo裝置內，接著建議就不要太去動Kobo上的Syncthing套件了，任何有更動的進度都會在使用Koreader時自動同步。前幾天有亂按導致整個sync亂掉、Koreader頻繁當機最後只能把Kobo回歸原廠設定全部重新來一遍的經驗，萬幸當下閱讀進度已經透過Syncthing同步到PC與其他Android裝置上了。
Android上要安裝Syncthing就更簡單了，UI還更像PC的簡單易懂，也更穩定。進到syncthing-android的github頁面後，找到右側的releases下載apk，回到裝置上給予權限、安裝後開啟，左側選單有個「網頁GUI」的選項，點開後基本上就與PC上的操作一樣了。
使用Syncthing一週下來，有一點建議要稍微注意：不要同時在2個裝置上更動檔案，Syncthing的編碼會不知道該取哪一個版本，容易發生版本衝突，在閱讀上就是不要同時拿2個裝置看同一本書。聽起來挺蠢的，但實際上我就有因為作筆記時還是能希望看到原上下文而這樣幹過 😅
✨當遇到版本衝突時，不用太擔心，解決辦法是：
1. 到各個裝置的Syncthing頁面，先將資料夾同步暫停。Kobo的部分沒辦法主動暫停，我的做法是直接先關掉Wifi。
2. 先找到各裝置中有最正確版本的那個裝置。
3. 將造成衝突的資料移動到同步資料夾外。
4. 開啟各裝置的Syncthing同步，程序上最新的改動為「資料被刪除（其實只是被移動）」 ，同步每個裝置都刪除該資料。
5. 等確認每一個裝置都顯示「最新（Up to date）」 後，將剛剛的資料移回同步資料夾內，就會push到各個裝置啦。
optional: Koinsight套件
基於以上理由，我並不推薦Koinsight plugin，但也許哪天它會變得更好用，就先把連結放在這裡了。
✨Bonus: 閱讀英文推薦Calibre套件 Ebook Metaguider (intellireading)
曾經有段時間，自己上傳書籍到電子書是透過一個開源軟體叫Calibre，它可以讓同一個網域內的裝置不透過實體線傳輸各種形式的ebook檔案，也能很方便的整理書籍的metadata（像是作者、系列、封面、引進Goodreads.com的書籍敘述等），是個很好用的圖書館工具。
近期開始自己上傳書籍變成靠Syncthing，但整理書籍資訊還是會靠Calibre，這裡順便推薦一個能幫助英文速讀的工具 Ebook Metaguider (intellireading) by Hugo Batista。其實它不應該命名為Metaguider，那是另一種幫助閱讀的指向工具，這種將單字的一半文字粗體化、幫助迅速抓到文字開頭與結尾位置的方式一般被稱作 bionic reading，我自己覺得能減少不專注時眼花、跳行的機率。
安裝方式是進到Calibre上方的Preferences>Advanced>Plugins，在Search for plugin內搜尋"ebook metaguider"就會出現了。
安裝完成後，Calibre的上方選單就會多出Metaguide選項。
在書架上選取想要更動的書籍之後，按下Metaguide選項，會跳出詢問視窗blah blah blah, do you want to continue? 選擇Yes就會更動了。也不用擔心原本沒有更動的epub檔不見，沒特別動設定的話，之後輸出後會留有原先的.original_epub檔。
以上就是自己目前有在用的開源閱讀軟體與套件，留下紀錄方便未來出問題時回溯用。未來有使用新的好用套件也會更新、分享。
留言
張貼留言