Tired of KOReader splitting your webtoon panels? I made a fix.

QQRush · 09-29-2026, 04:54 AM

Hi everyone!
I read a lot of vertical webtoons on KOReader(on e-ink device), but there was one thing that always bothered me: normal scrolling doesn't care where a panel actually ends.
This often results in characters, dialogue bubbles, or entire scenes being awkwardly split between two screen views.
So I started working on a plugin to solve this problem: Smart Webtoon Scroll.
Instead of simply moving down by a fixed amount, the plugin analyzes the webtoon and tries to find natural visual boundaries, adjusting each scroll so panels and dialogue remain together whenever possible.
The video shows the exact same webtoon running side by side:

LEFT — Standard KOReader
RIGHT — Smart Webtoon Scroll
Some of the features currently included:
Panel-aware smart scrolling
Detection of both white and black separators
Avoids splitting panels/dialogue when possible
Special handling for very tall panels
Classic, Continuous and AUTO modes
Continuation across images/files
Adaptive white/black side background
Page preloading for smoother navigation
Configurable preload amount
Keeping the plugin lightweight has also been one of the main goals. KOReader runs on many e-ink devices with limited CPU and memory, so throughout development we tried to keep the code and image analysis as simple and efficient as possible, avoiding unnecessary processing and features that could make reading feel slower.
The goal is not to turn KOReader into a completely different reader, but to keep the normal KOReader experience while making vertical webtoons/manhwa more comfortable to read — without unnecessarily weighing KOReader down.
I also want to be transparent about the development process: I developed this plugin with a lot of help from ChatGPT, especially for coding, debugging, analyzing edge cases and turning my ideas and testing feedback into working Lua code.
There was a lot of back-and-forth testing involved: change something, load it on KOReader, find a webtoon that breaks it, figure out why, change it again... 😄
So while the idea, testing and direction came from my own experience using KOReader, AI assistance played an important role in building and refining the plugin.
It's open source and I'm still improving it. Feedback is very welcome — and if you have a particularly weird webtoon that manages to break the detection algorithm, I'd genuinely like to see it!
GitHub:
QQRush / smart-webtoon-scroll.koplugin
Hope it's useful to other KOReader/webtoon readers!

Jellby · 10-01-2026, 03:53 PM

Is it only for "webtoons", or would it also work for regular comic books? Say a vertical comic book page, with the reader in landscape orientation, and fit-to-width... A page would take a couple of scroll downs. Would the plugin try to avoid splitting panels here?

QQRush · 10-01-2026, 04:34 PM

Hi, it's designed specifically for webtoons, using it for comic books is not the best. But wanting to add a comics mode is not complicated.

Jellby · 10-02-2026, 03:49 PM

Just for reference, I already mentioned it here: https://www.mobileread.com/forums/sh...2&postcount=11

QQRush · 10-11-2026, 09:52 AM

Quote:

Originally Posted by Jellby

Just for reference, I already mentioned it here: https://www.mobileread.com/forums/sh...2&postcount=11

Hi Jellby!

Your comment and the two example images you shared actually inspired a new project! 😄

I've been working on **Smart Comics Scroll**, a new KOReader plugin partly based on my previous **Smart Webtoon Scroll**, but designed specifically for traditional comics and manga in landscape mode.

Instead of navigating panel by panel, the plugin displays comics at full width and tries to detect the spaces between rows of panels, so page turns happen at more natural positions without unnecessarily splitting panels.

It also includes automatic whitespace trimming and a feature that can slightly scale down the content when this allows a complete panel row to fit on screen.

**GitHub:**
https://github.com/QQRush/smart-comics-scroll.koplugin

**Video demonstration:**
https://youtu.be/EC0JDg7Stds

I've also credited your original comment and illustrations in the README, since they were the inspiration for this project.

It's still an early beta, but it's already working quite well in my tests.

I'd really love to hear what you think, especially since your suggestion started the whole thing!

Thanks again for the inspiration! 😊

Jellby · Today, 01:36 PM

Thanks a lot. It may be a while until I try it, since I don't actually read comics on KOReader much, and that only on the ReMarkable... so I'll need to also figure out how to upgrade/install plugins there, which may not be trivial.

Jellby · Today, 01:43 PM

Is the sample image on the repository AI-generated? Or does the plugin change the shape of the panels? The panels in the "original page" are not rectangular, but they are in both the "before" and "after" views. The "after" view also shows the 3rd and 4th panels merged in a single row. That looks more like the botching publishers would do when translating or doing new editions, not what I'd expect from a reading tool.

09-29-2026, 04:54 AM	#1
QQRush Junior Member Posts: 5 Karma: 10 Join Date: Apr 2024 Device: Kobo clara colour / kobo libra 2 / book palma 2 pro / XTEINK X3+X4+X4P	Tired of KOReader splitting your webtoon panels? I made a fix. Hi everyone! I read a lot of vertical webtoons on KOReader(on e-ink device), but there was one thing that always bothered me: normal scrolling doesn't care where a panel actually ends. This often results in characters, dialogue bubbles, or entire scenes being awkwardly split between two screen views. So I started working on a plugin to solve this problem: Smart Webtoon Scroll. Instead of simply moving down by a fixed amount, the plugin analyzes the webtoon and tries to find natural visual boundaries, adjusting each scroll so panels and dialogue remain together whenever possible. The video shows the exact same webtoon running side by side: LEFT — Standard KOReader RIGHT — Smart Webtoon Scroll Some of the features currently included: Panel-aware smart scrolling Detection of both white and black separators Avoids splitting panels/dialogue when possible Special handling for very tall panels Classic, Continuous and AUTO modes Continuation across images/files Adaptive white/black side background Page preloading for smoother navigation Configurable preload amount Keeping the plugin lightweight has also been one of the main goals. KOReader runs on many e-ink devices with limited CPU and memory, so throughout development we tried to keep the code and image analysis as simple and efficient as possible, avoiding unnecessary processing and features that could make reading feel slower. The goal is not to turn KOReader into a completely different reader, but to keep the normal KOReader experience while making vertical webtoons/manhwa more comfortable to read — without unnecessarily weighing KOReader down. I also want to be transparent about the development process: I developed this plugin with a lot of help from ChatGPT, especially for coding, debugging, analyzing edge cases and turning my ideas and testing feedback into working Lua code. There was a lot of back-and-forth testing involved: change something, load it on KOReader, find a webtoon that breaks it, figure out why, change it again... 😄 So while the idea, testing and direction came from my own experience using KOReader, AI assistance played an important role in building and refining the plugin. It's open source and I'm still improving it. Feedback is very welcome — and if you have a particularly weird webtoon that manages to break the detection algorithm, I'd genuinely like to see it! GitHub: QQRush / smart-webtoon-scroll.koplugin Hope it's useful to other KOReader/webtoon readers!

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
How to Fix WiFi Connection Issue in KOReader on Kobo Libra Colour?	DRGocia	KOReader	2	08-09-2026 12:39 PM
Libra Colour How to Fix WiFi Connection Issue in KOReader on Kobo Libra Colour?	DRGocia	Kobo Reader	3	02-14-2025 02:50 AM
Does KOReader fix the Inkpad 4's contrast issues?	dinosm	PocketBook	5	11-14-2024 04:46 AM

10-01-2026, 03:53 PM	#2
Jellby frumious Bandersnatch Posts: 7,604 Karma: 22000001 Join Date: Jan 2008 Location: Spaniard in Germany Device: Cybook Orizon, Kobo Aura	Is it only for "webtoons", or would it also work for regular comic books? Say a vertical comic book page, with the reader in landscape orientation, and fit-to-width... A page would take a couple of scroll downs. Would the plugin try to avoid splitting panels here?

10-01-2026, 04:34 PM	#3
QQRush Junior Member Posts: 5 Karma: 10 Join Date: Apr 2024 Device: Kobo clara colour / kobo libra 2 / book palma 2 pro / XTEINK X3+X4+X4P	Hi, it's designed specifically for webtoons, using it for comic books is not the best. But wanting to add a comics mode is not complicated.

10-02-2026, 03:49 PM	#4
Jellby frumious Bandersnatch Posts: 7,604 Karma: 22000001 Join Date: Jan 2008 Location: Spaniard in Germany Device: Cybook Orizon, Kobo Aura	Just for reference, I already mentioned it here: https://www.mobileread.com/forums/sh...2&postcount=11

Today, 01:36 PM	#6
Jellby frumious Bandersnatch Posts: 7,604 Karma: 22000001 Join Date: Jan 2008 Location: Spaniard in Germany Device: Cybook Orizon, Kobo Aura	Thanks a lot. It may be a while until I try it, since I don't actually read comics on KOReader much, and that only on the ReMarkable... so I'll need to also figure out how to upgrade/install plugins there, which may not be trivial.

Today, 01:43 PM	#7
Jellby frumious Bandersnatch Posts: 7,604 Karma: 22000001 Join Date: Jan 2008 Location: Spaniard in Germany Device: Cybook Orizon, Kobo Aura	Is the sample image on the repository AI-generated? Or does the plugin change the shape of the panels? The panels in the "original page" are not rectangular, but they are in both the "before" and "after" views. The "after" view also shows the 3rd and 4th panels merged in a single row. That looks more like the botching publishers would do when translating or doing new editions, not what I'd expect from a reading tool.