EmirErtorer/ink-away.kopluginDokumentasi

Ink Away is a drawing, notes and book annotation app for KOReader, with palm rejection and pen pressure for stylus users.

• Draw with pens of every kind, watercolor and smudge, on up to five layers.
• Take notes in notebooks of lined, grid, dotted or planner pages, with handwriting turned into text.
• Annotate any book KOReader opens, EPUB to PDF, with ink that follows its words when you change the font.
• Take your annotations with you. Export a book you have written on as a PDF with your ink, highlights and pictures where you put them and its text still searchable, as PNGs, or as an editable copy of the original PDF.

Unzip the download and copy the ink-away.koplugin folder into KOReader's plugins directory, then restart KOReader:

• Kindle: koreader/plugins/
• Kobo: .adds/koreader/plugins/
• Android: koreader/plugins/ in app storage

Open it from Top menu, Tools tab, "Ink Away (drawing canvas)". After that it can update itself: Settings, Updates.

1. To draw or take notes, swipe up the right edge in KOReader's file browser. File, New notebook gives you lined, grid or planner pages.
2. To write on a book, open it and swipe down the right edge. Write on the page, close with the X, and your ink stays with the book.
3. Tap a tool, then tap it again for its settings. The Guide button in Settings explains the rest, each card with "Show me".

If your reader already uses the right edge, use a two-finger swipe from the bottom right corner toward the top left (and from the top right toward the bottom left on a book). Every gesture can be changed in Settings, Gestures and pen buttons.

To copy part of a book page, swipe two fingers from the top left toward the bottom right, then drag to select an area. This shortcut is assigned only if it is free. You can choose another in KOReader's Settings, Taps and gestures, Gesture manager: assign Ink Away: copy part of the screen to a gesture while reading.

Swipe down the right edge and write on the page.	Change the font size and the ink moves with its words.	Layers: colour under your line art, hidden or shown from the strip.
The library: folders, notebooks and drawings, saved as you go.	Pens with pressure, watercolor that blends, smudge that mixes colours.	Lasso to move, resize, recolour, or turn writing into text.

• Pens and shapes: fineliner, fountain, calligraphy, pencil, highlighter, marker, watercolor and smudge, shapes that snap, text boxes, pictures, symmetry and a lasso.
• Notebooks: any number of pages on eighteen papers and planners, PDFs opened as notebooks, links and a contents page, a library with folders, search and a 30-day trash.
• Books: ink anchored to the words, a smart highlighter that makes KOReader's own highlights, and a notebook for each book.
• Export: PNG, PDF and editable PDF. A book comes out as a fixed PDF laid out as you read it, in your colours, with selectable text. You can also send files to a phone or computer over Wi-Fi.
• Made for e-ink: palm rejection, stylus buttons, dark mode, colour screens, light refreshes, and Ink Away in ten languages. It can also give your notebooks and drawings their own shelves on Bookshelf.

The full list, with every setting and gesture, is in docs/FEATURES.md. What changed in each version is in the changelog.

• Palm rejection needs KOReader 2026.07+.
• Other pen plugins: use Ink Away and other pen plugins (pencil.koplugin, for one) one at a time. They share KOReader's one pen hook; Ink Away hands it back when it closes. Some pen plugins, older pencil.koplugin releases among them, replace KOReader's frontend/device/input.lua with their own copy, and turning the plugin off doesn't put the original back, so the pen can act oddly in Ink Away. To fix it, update KOReader to 2026.07 or newer, or reinstall it: either puts KOReader's own input.lua back. Or download the zip of the KOReader version you have and copy its koreader/frontend/device/input.lua over the one on the reader.
• Drawings and notebooks are saved automatically in an "ink away" folder. Exports go to "ink away/exports" unless you pick another folder.

I'm a computer science and engineering graduate, and I design and test Ink Away on my Kindle Paperwhite. Its code is written with Claude Code, an AI coding assistant, with me directing every change and about 4,000 automated checks behind it. Anything I can't test there goes out as a prerelease first.

Bug reports, prerelease testing, ideas and pull requests are welcome. CONTRIBUTING.md explains how to start.

The integration API for viewer plugins such as Panels+ was designed by Kristan Laimon.

MIT (see LICENSE). PNG/JPEG use KOReader's bundled lodepng and libjpeg-turbo.