Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > KOReader

Notices

Reply
 
Thread Tools Search this Thread
Old Today, 07:25 AM   #1
sas-web
Junior Member
sas-web began at the beginning.
 
Posts: 1
Karma: 10
Join Date: Nov 2026
Device: inkpad X
[Plugin] Suwayomi: read manga on the fly from your server, like a fancy new e-reader

Hi all,

I got tired of downloading manga chapters one by one on my PC and copying them to my e-reader. I read manga with Mihon on my phone, so I wanted the same thing on my PocketBook. Some newer e-readers run Android and can simply install Mihon, but mine doesn't.

So I asked Claude for alternatives and found out I could run my own server, Suwayomi, which does what Mihon does but as a server. From there I vibe-coded (with Claude Code) a KOReader plugin that pulls the manga from my local Suwayomi server automatically: you open your library on the e-reader, tap a series, and the next chapters are fetched in the background while you read.

The nice part is that the e-reader stays light. Suwayomi does the heavy work (sources, downloads, image processing) and the plugin only receives ready-made CBZ files and opens them in KOReader's own reader. I use it on a PocketBook InkPad X, which is not a powerful device (dual-core 1 GHz CPU, 1 GB of RAM), and it works there.

Here is how the library looks on my InkPad X (real photo, page 2 of 5):
Click image for larger version

Name:	photo_mosaique_mobileread.jpg
Views:	6
Size:	69.4 KB
ID:	227474

What it does
  • Library as a cover mosaic (or a list), with Suwayomi's categories as tabs and a badge with the number of unread chapters
  • Series screen with a big Resume button that goes straight to the right chapter and page
  • Chapter chaining: turn the page after the last page and the next chapter opens; go back from page 1 and you land on the last page of the previous one; after the last chapter you are brought back to the library
  • Prefetching: the next chapters (6 by default) are downloaded in the background, old ones are deleted, so storage stays small
  • Progress sync: the page reached and the "read" state are sent to Suwayomi (kept on the device while offline, sent when the Wi-Fi is on)
  • If Suwayomi has not downloaded a chapter yet, the plugin asks the server to download it, shows how far it is, and opens it when ready
  • Long press a chapter to mark it read/unread or set it as your last read chapter; gesture actions; English and French interface

Requirements and honest notes
  • A Suwayomi server reachable from the e-reader (developed against v2.4.2366)
  • Developed and used on a PocketBook InkPad X with KOReader v2026.07.2, against a real server. Also checked in the KOReader emulator against a fake server, plus unit tests. Not tried on other devices yet. Feedback is welcome, here or as GitHub issues. No promises, but I'll gladly have a look if you like the project. Since it is vibe-coded, expect some rough edges
  • Optional separate add-on to reach your server away from home through WireGuard (userspace, no root needed; the wireproxy binary is not included, the README explains where to get it)

Download and source
License: AGPL-3.0, like KOReader. The reader module is adapted from Rakuyomi's MangaReader.lua (credited in the README), thanks to its authors. It is an independent project: it provides no content, it only talks to the Suwayomi server you run.

I'm sharing it here in the hope that it serves someone else and brings you joy.
sas-web is online now   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[Plugin] APIKOmic Reader: plugin to search, read and download manga & comics iv0_ KOReader 0 11-06-2026 05:01 PM
Introducing Banana Manga Reader! A browser based manga reading app DragoonGT Kobo Reader 9 11-07-2024 08:25 PM
[Content Server Reader] Read Aloud issue nqk Server 6 08-05-2021 03:20 AM
Calibre server 3.0 - Cant read books on web reader eridani Calibre 2 06-16-2017 04:27 PM
Content Server on the fly conversion option? eugener Calibre 1 03-18-2012 05:40 AM


All times are GMT -4. The time now is 01:19 PM.


MobileRead.com is a privately owned, operated and funded community.