[Plugin] InkSurf – a real web browser for KOReader (NetSurf engine)

prepare · 10-24-2026, 04:19 PM

InkSurf: a KOReader plugin that embeds the NetSurf engine and
drives it on the e-ink framebuffer.

What it does:
• Renders real pages (limited JavaScript via Duktape), logins, forms, images.
• Custom e-ink touch toolbar (back/forward/reload/reader/minimize/close).
• Type into the URL bar AND into in-page fields using KOReader's own keyboard —
the browser stays frozen in the background and the typed text is injected into
the focused field (existing content is loaded and replaced).
• Minimize/resume, pinch-zoom, drag-to-pan.
• Local, private reader mode (no third-party extraction service).
• Downloads to koreader/documents; .torrent handed to a built-in aria2 manager.
• azw3 → EPUB conversion; OpenVPN (any provider) with kill-switch; hosts-based
ad/tracker blocking.
• UI in English / Hungarian / German.
• Self-contained: everything lives in the plugin's own data/ folder.

Tested on: jailbroken Paperwhite, MTK / hwtcon_v2 (PW5/PW6 class), with KOReader.
Other models may need changes to the framebuffer surface.

Install: grab the zip from Releases, drop inksurf.koplugin into koreader/plugins/,
restart KOReader. The NetSurf engine is built from source via GitHub Actions
(build.sh is included). GPL-2.0-or-later; third-party components credited in the
repo.

Repo + release: https://github.com/pihokkerr/InkSurf

Not affiliated with NetSurf or KOReader.

Hag_Sub · 10-25-2026, 12:11 AM

You should rename it to inksurf.koplugin. cuz it doesn't show up in appstore

Hag_Sub · 10-25-2026, 12:11 AM

And there is a problem with sleep 0.3 it's crashing bcz of that

Hag_Sub · 10-25-2026, 12:36 AM

Doesn't work on pw3 then netsurf file ain't executable

alva · 10-25-2026, 06:39 AM

Quote:

Originally Posted by Hag_Sub

You should rename it to inksurf.koplugin. cuz it doesn't show up in appstore

or adding the topic koreader-plugin on github, that also gets it in appstore and storefront

prepare · 10-25-2026, 01:25 PM

Thanks! A few updates:
- Renamed to inksurf.koplugin already (v1.0.1) and added the koreader-plugin topic, so it should show up now.
- v1.0.2 fixes the sleep 0.3 crash on older devices
- PW3 isn't supported yet, it's a non-MTK device, so it needs a separate build, contributions welcome.

10-24-2026, 04:19 PM	#1
prepare Junior Member Posts: 5 Karma: 10 Join Date: Feb 2021 Device: PW3	[Plugin] InkSurf – a real web browser for KOReader (NetSurf engine) InkSurf: a KOReader plugin that embeds the NetSurf engine and drives it on the e-ink framebuffer. What it does: • Renders real pages (limited JavaScript via Duktape), logins, forms, images. • Custom e-ink touch toolbar (back/forward/reload/reader/minimize/close). • Type into the URL bar AND into in-page fields using KOReader's own keyboard — the browser stays frozen in the background and the typed text is injected into the focused field (existing content is loaded and replaced). • Minimize/resume, pinch-zoom, drag-to-pan. • Local, private reader mode (no third-party extraction service). • Downloads to koreader/documents; .torrent handed to a built-in aria2 manager. • azw3 → EPUB conversion; OpenVPN (any provider) with kill-switch; hosts-based ad/tracker blocking. • UI in English / Hungarian / German. • Self-contained: everything lives in the plugin's own data/ folder. Tested on: jailbroken Paperwhite, MTK / hwtcon_v2 (PW5/PW6 class), with KOReader. Other models may need changes to the framebuffer surface. Install: grab the zip from Releases, drop inksurf.koplugin into koreader/plugins/, restart KOReader. The NetSurf engine is built from source via GitHub Actions (build.sh is included). GPL-2.0-or-later; third-party components credited in the repo. Repo + release: https://github.com/pihokkerr/InkSurf Not affiliated with NetSurf or KOReader.

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Text-Based Web Browser Plugin for KOReader	omerfaruq	KOReader	8	10-18-2025 10:46 AM
Clara HD Crosscompile a web browser for the KOReader terminal	elinkser	Kobo Developer's Corner	22	03-03-2025 07:41 PM
Any web-to-epub plugin for internet browser?	bthoven	ePub	7	07-10-2011 05:14 AM
Webkit Browser (Safari's Engine) with Beta Release	Adam B.	iRex	28	02-11-2009 05:43 AM

10-25-2026, 12:11 AM	#2
Hag_Sub Doingsmth Posts: 79 Karma: 10 Join Date: Mar 2026 Device: Kindle PW3	You should rename it to inksurf.koplugin. cuz it doesn't show up in appstore

10-25-2026, 12:36 AM	#4
Hag_Sub Doingsmth Posts: 79 Karma: 10 Join Date: Mar 2026 Device: Kindle PW3	Doesn't work on pw3 then netsurf file ain't executable

10-25-2026, 01:25 PM	#6
prepare Junior Member Posts: 5 Karma: 10 Join Date: Feb 2021 Device: PW3	Thanks! A few updates: - Renamed to inksurf.koplugin already (v1.0.1) and added the koreader-plugin topic, so it should show up now. - v1.0.2 fixes the sleep 0.3 crash on older devices - PW3 isn't supported yet, it's a non-MTK device, so it needs a separate build, contributions welcome.