r/koreader

Image 1 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 2 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 3 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 4 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 5 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 6 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 7 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 8 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 9 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing
Image 10 — Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing

Ink Away 4.0.0: handwrite on any EPUB, MOBI, PDF or comic in KOReader, and your notes move with the words when you change the font size. Plus layers for drawing

Hey everyone,

Ink Away 4.0.0 is out, and yet again it’s the biggest update so far!

3.3.0 turned Ink Away into a notebook app; 4.0.0 takes the pen into your books and gives your drawings layers.

You can now write, highlight, draw shapes and drop pictures right onto the pages of any book KOReader opens: EPUB, MOBI, FB2, PDF, DjVu and comics. On a reflowing book the ink follows its words when you change the font size. Drawings can now be drawn in layers, so you can sketch, ink and colour each on their own. On top of that there’s a notebook for every book, pen pressure, a whole new set of pens (including a watercolor that blends and a smudge that mixes colours like paint), dark mode, paper colours, a guide and updates from inside Ink Away.

For anyone new to Ink Away: it’s a drawing and note-taking plugin for KOReader. You can sketch with your finger or stylus, keep handwritten and typed notes in notebooks organized a lot like OneNote, annotate PDFs and export everything to PDF or PNG.

Write on your books

Swipe down the right edge and the page you’re reading becomes your canvas. It’s also in the Tools tab, under Ink Away → Annotate the book.

  • Every tool works on the page: pen, highlighter, eraser, shapes, text, pictures and the lasso. Shapes and pictures can go right over the text, so you can circle a word or put an illustration next to the passage it belongs to.
  • It works on any book KOReader opens: EPUB, MOBI, FB2, PDF, DjVu, CBZ and the rest.
  • Ink follows the text. On a reflowing book every stroke is anchored to the words it was written beside. When you change the font size, the margins or the orientation, your notes move with their words. On PDFs and comics the ink keeps its place on the page and follows the zoom.
  • Smart highlighter. A highlighter stroke over text becomes KOReader’s own highlight, in the pen’s colour, and shows up in your highlights list like any other. Wobbly strokes and ones that run into the margin still snap to the words. Over empty space it stays ink.
  • Erasing over a book cuts strokes where you rub, like a real eraser. “Erase whole strokes” brings back the old one-swipe eraser.
  • The toolbar can sit on any side of the screen. It has its own page turn buttons and folds away when you want the whole page.
  • Your annotations live next to the book’s own KOReader data. They follow the book when you move or rename it, and KOReader’s Reset leaves them alone. Deleting the book, or “Delete all annotations on this book”, sends them to Ink Away’s trash for 30 days.
  • Ink Away sets up the book gestures for you, but only where your gesture manager has nothing on them yet. If your right edge is taken (by warmth on a Kobo, say), you get two-finger diagonal swipes instead, and a notice tells you which ones you got.

Book notes

Swipe up the right edge for the book’s own notebook.

  • It opens in a window over the page, so you can still see what you’re reading around it.
  • Every chapter gets its own page, titled with the chapter’s name and kept in the book’s order, so the notebook’s contents end up matching the book. Opening the notes takes you straight to the chapter you’re in.
  • Fullscreen turns the window into the full app, on the same page. A tap outside the window closes it, saved.
  • Each book’s notebook lives in your library, in a “Book notes” folder. Outside a book, the same swipe opens Ink Away.

Layers

Drawings can now be drawn in layers, up to five. They’re off until you want them: File -> Layers turns them on, and what you’ve drawn so far becomes the first layer.

  • A small strip at the right, shown only while layers are on, adds a layer and picks the one you draw on.
  • Tap the layer you’re on for its menu: show or hide, rename, move up or down, merge down or delete. Layers are numbered by their place, so they stay 1, 2, 3 after a merge.
  • Colour under your line art. A stroke on a lower layer stays under the layers above it, even while you’re drawing it.
  • The eraser, the lasso and the paint bucket only touch the layer you’re on, and the eraser shows the layers underneath as it goes.
  • Merge a layer into the one under it, or turn layers off to merge them all into one drawing. Hidden layers stay out of exports.
  • No layer is kept as an image of its own, so drawing on layers is as fast as on a plain page and barely uses more memory.

New pens

  • Pen pressure: on pen readers like the Kindle Scribe and Kobos with a stylus, the line follows how hard you press. You can switch it off in Pen and input if you prefer even lines.
  • Ballpoint, Fountain and Calligraphy, the last one with its own nib angle.
  • See-through pens that blend with the page: Highlighter (the text stays black on top), Marker and Watercolor. Watercolor is also smoother and three times faster than before.
  • Smudge: drag through your ink like a finger through wet paint. It only moves ink, never the paper, pictures or text, and it mixes colours the way paint does, so yellow pushed into blue turns green.
  • A new pen case: up to 20 saved pens, each drawn at its real size. Tap + for a new pen of any kind, and hold one to move, copy or remove it. You start with seven: Fineliner, Ballpoint, Pencil, Calligraphy, Highlighter, Watercolor and Smudge.
  • A floating pen strip with your first saved pens (on by default on stylus readers), and the pen’s colour now shows under the Pen button.
  • Acrylic and Stipple have left the picker(good riddance!). Drawings that use them still show them.

Gestures and pen buttons

  • Choose what every gesture and pen button does, from one list of actions. Ink Away warns you when two would clash.
  • By default, holding the pen’s side button turns it into a highlighter, and the eraser end erases.

Dark mode and paper colours

Last time I said Ink Away should fit in with however you’ve set up your reader. This time it goes further:

  • Dark mode for the toolbars, menus and library: Light, Dark or following KOReader’s night mode. Your page and your colours are never changed.
  • Paper colours: twelve papers on colour screens (White, Cream, Sandpaper, Legal pad, Mint, Sky, Blush, Lavender, Kraft, Blueprint, Chalkboard and Black) and white or black on grey ones.
    • The ruling and grid take the paper’s shade, so they always show.
    • Black ink and text turn white on a dark paper.
    • Exports come out on the same paper.
    • Each notebook and drawing keeps its own paper.

Help, and updates from inside Ink Away

  • A guide: short cards on the things a glance doesn’t show, by topic, each with a “Show me” button.
  • A notice the first time Ink Away opens, telling you which book gestures you got.
  • Test pen and touch, in Settings: it shows how your pen, its buttons and your hand arrive, including the pressure range your pen reports. If you report a pen bug, a screenshot of this helps me a lot.
  • Check for updates: Settings → Updates shows the latest release and, kept apart from it, any newer prerelease, each with its notes. Tap Install and it downloads, checks and installs it; restart KOReader to use it.
    • Once a day, and only if Wi-Fi is already on, Ink Away looks by itself in the background, so it never turns on your Wi-Fi or slows your drawing. When there’s something new you get a short message and a dot notification on the Settings button. You can turn this off, and the daily check only tells you about prereleases if you ask it to.
    • It only reads GitHub’s public list of releases and sends nothing about your device. KOReader normally puts your device model in its web requests; Ink Away leaves it out.
    • The download is checked against GitHub’s own checksum before anything changes, and your current version is kept aside until you restart.
    • You can try a prerelease and go back to the latest release whenever you like, but never to an older version.
    • This is the first version with it, so you’ll need to install 4.0.0 by hand one last time.

Tidier and smoother

  • Settings is tidier. Pen settings live in Pen and input, every setting has one place, and Settings fits on a Paperwhite screen without scrolling.
  • See-through pens on grey e-ink refresh only what changed as you draw.
  • A quick drag on a slider no longer moves the whole menu.

Android and Boox (please test!)

  • On a Boox, Ink Away now asks the screen for its fast refresh mode while you draw.
  • On Android readers whose pen KOReader still reports as a finger (before KOReader 2026.08), the pen draws again instead of scrolling the page. A tip explains slow drawing on readers that need a setting changed.
  • I still don’t have a Boox or an Android pen reader to try this on. If you do, please tell me how drawing feels, and mention your device and Android version.

Pen pressure testers needed

If you have a Kindle Scribe or a Kobo with a stylus, please try the fountain and calligraphy pens and tell me how the pressure feels. Too light, too heavy, slow to react? A screenshot of Test pen and touch with your comment would be perfect.

For developers

  • The code passes luacheck, and about 4,000 automated checks run on every push, many of them on KOReader’s real drawing, zip and network code.
  • There’s a changelog in the repo now, covering every version since the first.

Download: Ink Away 4.0.0 on GitHub

It’s also available through the KOReader AppStore/Storefront plugins.

As always, thanks to everyone who tested, commented and sent videos, screenshots and bug reports. A lot of this release came straight from your feedback.

If you run into anything, let me know and I’ll take a look right away. Hope you enjoy it!

PS: Last time I said we’d take on Procreate with layers and new brushes. Both made it into this one.

u/Sorcerer_-_Supreme — 5 days ago
▲ 3 r/koreader+1 crossposts

Koreader on adroid

Hi guys! I recently got a Samsung Tab A11 for reading manga, koreader, etc. However, no matter how I try, I am unable to connect to calibre. The only way is through content server but I would have to download the books 1 by 1..

Hopefully you guys have some fixes! 🙏🏻

reddit.com
u/Xeryl999 — 3 days ago
▲ 176 r/koreader

Bookshelf v5.4 - 'shelf of shelves' and themes per shelf

Another bookshelf update ...

https://github.com/AndyHazz/bookshelf.koplugin

The two biggest changes this week are probably a new shelf source 'shelf of shelves', and the ability to have a different theme per shelf. The videos attached to this post show how they work probably better than words could ...

Shelf of shelves - Basically you can now build up a custom shelf from multiple shelves, with different sources/filters etc. You can even nest them to get shelves of shelves of shelves of shelves.

Themes per shelf - you can now set a separate theme per shelf. This does require a bit of effort to create theme packs as that's currently the only way to bundle wallpaper/ornaments/planks and colours together as a theme.

The simplest version of a theme pack is just a bunch of ornaments in a subfolder of your ornaments directory. So, koreader/settings/bookshelf/ornaments/theme-a/pickle.png and koreader/settings/bookshelf/ornaments/theme-b/toaster.png will let you set a shelf with 'theme-a' on one shelf to show your pickle, and another shelf with 'theme-b' that shows your toaster. Put a 'theme/wallpaper.png' inside each theme folder to get a wallpaper background to follow the theme.

Ready made packs in the bookshelf ko-fi shop (https://ko-fi.com/andyhazz) if you want see some examples and support the work I'm doing with bookshelf - including a new 'Macabre' pack, with an extra gothic stone shelf plank and a selection of public domain framed artwork for your horror themed shelf. Also includes a few new candelabrum to help you read at night.

Each shelf gets it own ornament sequence now - so you don't see the same ornaments on the start of each shelf (if you're using spine mode on more than one shelf).

A few other smaller highlights:

  • Picking a face out book from a spine shelf now turns towards you in 3d
  • Settings > Panel shading has two new options: Blur wallpaper behind panels, and Panel behind Covers shelves for the same solid panel list view has - these options can both help with busy wallpapers
  • Custom text below covers: Settings > Cover display > Cover captions > Custom… lets you write the line with bookends style tokens, e.g. %book_pct to show percentage read below the cover.

Lots more in the release notes. Including some larger behind the scenes changes to support other plugins being able to provide their own shelf source (developed in collaboration with the maintainer of kokomga).

u/AndyHazz — 5 days ago

Hardcover Sync 2.0 — Wow, that's a lot!

I'm still ironing out the kinks in this release, but I was so excited that I thought I'd share what's coming to Hardcover Sync! If you want to try it, you need to opt in to beta updates! Please give me feedback!

  1. A Stunning UI overhaul. Based off Mudita Mindful Design, optimized for a great UX on B&W e-ink displays.
  2. A Hardcover client, with offline support. View all your shelves (Currently Reading, Want to Read, DNF), as well as custom lists, not to mention goals and reading statistics, all completely offline. A new offline backend means more data is saved for offline view, and it uses up to 95% less data
  3. Supports Vibes, Hardcover's Recommendation engine. A similar to this book carousel in every book details page, and in your library tab you can see all your vibes list. Each vibe can be tuned to recommend certain types of books.
  4. Bookshelf Integration. Make any status shelf or list into a custom shelf in Bookshelf. (Wow, that's a mouthful, but hopefully you get what I mean)
  5. Download new books directly. If you find a new book you want to try, Z-Library, Anna's Archive, and Kindle Fetch integration makes downloading it a breeze.
u/ChananyaMinster — 4 days ago

unknown logo

can someone explain to me what is this logo about and how do I turn it off? somehow it annoys me for some reason

u/ericwan69 — 5 days ago

Update: Character Tracker – Family Tree, Timeline, Module Customization, Visual Update, Convenience and Bug Fixes

Hello! It is the first update of this plugin. there are many new features!

  • Family Tree
    • You can now make a family tree, and visually see how characters are related to one another.
    • You can link 2 families together and also map relationships.
      • press and hold on one character to see their exact relations with others.
    • Relationship/Friendship Tree
      • You can also separately map a friend group and relationships between friends.
  • Timeline
    • You can now log events in the book as well. Any important or plot turning events? Now you're able to select the text, and add that point into the timeline! Additionally, you're able to add your own notes to the timeline for any commentary or thoughts.
    • There are 2 modes, timeline view and list view.
  • Module Customization
    • I know people probably will probably not use all of the possible options to describe characters and its a pretty busy menu, so now you can both change the location of the modules but also hide unused ones.
  • Convenience Fixes
    • Thank you to u/HatOtherwise1103 for mentioning this
      • When names were selected, it would only take the first word of the selection because of how I made it before when I didn't add access through the dictionary (and thus has to highlight an unrelated word to be able to highlight through selections) and when i finally added access I never removed this. So now it should select every word when turning selections into characters.
    • Thank you to u/cocoreysa and u/Sad-Bobcat-6313 for this suggestion
      • Now you can add selections of the text to specific sections like abilities and appearance, etc. and you can also take notes on the highlights as well
      • To highlight, select text, select "character" and select "add selection as topic highlight.." pick the topic and character to allot this too.
      • to take notes of highlights, go to a character, press topics, press the topic the highlight is in and then choose which quote you wanted to take notes on!
  • Small Visual Overhaul
    • I have reduced the section headers from taking up 3 rows to now 1 to make it easier to see more information, and to make it look a bit nicer.
  • Families, Compendium & Places
    • For the first version i was very much focused on the characters list but i have now spruced up the families, Compendium and places to be better than lackluster.
  • Photos/Shot button
    • The ability to take photos of your timelines and family trees without UI interference
  • Bug Fix
    • Thank you to u/falfalfal1997 for reporting this
      • I mostly left the Import and Export functions untouched from the original fork and discovered (and was told) that the import function caused koreader to crash, so that is fixed now !

Thanks to everyone's feedback and suggestions, I hope you enjoy this!

https://github.com/seilesi/charactertracker.koplugin/releases/tag/v2.1.0

u/Loose_Cranberry_491 — 4 days ago
▲ 18 r/koreader+2 crossposts

Free2 remote working with KOReader on PocketBook Verse Pro color (fix: firmware update + volume key mapping)

I got a Free2 remote working with KOReader on my PocketBook Verse Pro. Sharing the steps in case it helps someone else.

The problem

In the native PocketBook reader, the Free2 connected but disconnected after ~3 pages, and then skipped 2-3 pages on the next press.

In KOReader it showed up as a connected HID device in the Bluetooth settings, but KOReader received no input at all.

The fix

Update the Free2 firmware to version F2-462clj. I connected the remote to a PC and used the manufacturer’s desktop app to update it: https://hanlinyue.com.cn/1768540873343

Remap the buttons in the desktop app so they send Volume Up and Volume Down instead of the default keys. This is what makes the remote visible to KOReader.

Tell KOReader what those keys mean. Create the file koreader/settings/event_map.lua with:

return

{

[103] = "LPgBack",

[105] = "LPgBack",

[104] = "LPgBack",

[114] = "LPgBack",

[165] = "LPgBack",

-- înainte

[106] = "LPgFwd",

[108] = "LPgFwd",

[109] = "LPgFwd",

[115] = "LPgFwd",

[163] = "LPgFwd",

[57] = "LPgFwd",

[28] = "LPgFwd",

}

Restart KOReader completely, connect the remote, and the buttons turn pages.

Notes

115 and 114 are the Linux key codes for Volume Up and Volume Down. The same trick works for other cheap Bluetooth page turners (I used the same file for an AB Shutter 3), you only need to know which key code the remote sends.

I haven’t tested whether the native PocketBook reader behaves better after the firmware update, so the page skipping there may still be a firmware issue on PocketBook’s side.

Swap the two codes if you want the buttons reversed.

PS : the app is in Chinese but I can change it to English

Hope this saves someone a few hours!

u/Dear_Storage7405 — 5 days ago

About mini e-Readers and the smallest that runs KOReader

In this video I talk about mini e-Readers and micro e-Readers like XTEINK X4, X3, viwoods AiPaper Reader, Bigme Hibreak, Onyx Boox Palma, Seeed Sticky and more. I also show the smallest e-Reader that can run KOReader.

youtu.be
u/stefansvartling — 5 days ago

Will the new amazon page turner work with koreader? What about kobo remote? Can it be used with jailbroken kindle?

reddit.com
u/froz1436 — 4 days ago
▲ 35 r/koreader+1 crossposts

My new koreader remote

I like reading with my kindle mounted above my head, and I wanted to be able to flip the page, and add highlights and notes without reaching for it. So I built an iPhone app and KOReader plugin that gives me full control. I love it so much.

u/Purple-Feather-1239 — 8 days ago
▲ 30 r/koreader+1 crossposts

My Simple UI setup for Spooky Season

I just finished tweaking my Simple UI for Halloween and I couldn't be happier with it.

Yeah, I know having the Cover Deck on the second page is a bit redundant, but I couldn't decide between that and Currently Reading, so I kept both.

Plugins: Just good ol' Simple UI.

Fonts:

General UI (Labels, Title, etc.): Vampire Zone;

Clock: Spooky Monster;

Author: Coraline's Cat.

Icons:https://www.svgrepo.com/collection/halloween-8/

u/Virtual_Explorer2468 — 9 days ago
▲ 115 r/koreader

Bookshelf homescreen

been playing around with making my bookshelf homescreen look cool

i’m wondering if anyone knows of any patches or extra plugins that give you a wider variety of icons and stuff to choose from to mark finished books, favourites, folders, and stuff?

not rly a fan of the simple just bookmark with a check for finished books and heart for favourites. (i know there are other alternatives but i don’t like those either)

u/AnEnthusiasticLoser — 14 days ago
▲ 4 r/koreader+1 crossposts

Audible plugin for KOrader for book completion sync?

Hello. Many of my "read" books over the last 16 years have been Audible audiobooks, but I also have them on my KLC for reading if I so choose.

However, considering these have been "read", is there any way to sync Audible's stats with my epubs, either in KOReader, ZenOS or Bookshelf? How about Calibre as a last resort, since einuse that to sync my books to my device?

reddit.com
u/Jkoiou — 11 days ago