Inkling

Send/receive anything between your Supernote and other devices — with or without LocalSend.

Inkling is an open-source Supernote plugin that lets you insert text, images, links, PDFs, clipboard content, and more into your Supernote from a PC or any other device. It runs completely offline, communicating only through your local network. This project has no commercial plans.

It integrates with LocalSend, a free, open-source cross-platform file sharing app, but offers more than just that.

Features

Beyond LocalSend

• Lasso Send — Select text, images, screenshots, or links on your Supernote and send them to other devices via LocalSend
• Doc-Screenshots-to-Note — Very useful for Long Screenshot or multiple screenshots
• Layer Management — Use the pen as a temporary lasso to select elements without switching tools. Adjust layer order for the current layer or lasso-selected elements

What you can receive via LocalSend

• Doc Links — Inserted as tappable links
• Images — Including doc screenshots
• Text — With paragraph mode (preserves line breaks) and no-space mode (strips whitespace, useful for CJK text)
• Clipboard — Basically what you've been selecting: writing, painting and textbox. It's 2026 and there's still no official clipboard on any e-ink device.

Users Guide

Entry to the plugin

There are two entries in the note toolbar:

• LocalSend: this will turn on (filled circle) and off (not filled circle) the LocalSend server on the supernote device.
• Inkling: this will show or hide the inkling overlay toolbar

The Inkling Overlay Toolbar:

General: use tap to interact, as pen will also write on the note; use finger to move the overlay toolbar on the screen, move it to the right border to hide it except for a small tab, and pull from right side to make it fully visible again.

Left side buttons:

Image: insert an image (either from file system, or from ???) Document Screenshot: simple tab inserts the next queued screenshot if defined or brings up option to snip a new screenshot brings up a photo icon. Long press opens a dialog with the whole queue of screenshots. Text: activating this (together with active LocalSend) will allow inserting text from another device via localSend. It will appear on the current page. Link: opens a file browser. Selecting a file will insert a link to that file in the current note Audio: very unclear was this does: brings up window with buttons AI, St, SI, Co, needs something to be lassoed, that will be recognized and sent to AI ???

Right Side Buttons

1-4: these are four clipboards, tapping while having something selected will put the selection into that clipboard. Otherwise tapping will insert that clipboard in the middle of the current note. A filled clipboard will show with black background. Long pressing a number to clear the current clipboard content.

Arrow up and Arrow down: shift layer of currently lassoed elements up or down a layer

Dokument Icon: will allow you to define an area that will be then clipped (taking maximum boundary as rectangle) and insert it into a new page and create forward and back links.

Further icon (half hidden for me):

Snipping Screenshots:

documentation to be done

About LocalSend

LocalSend is a free, open-source app for securely sharing files between nearby devices without needing the internet. Available on Windows, macOS, Linux, Android, and iOS.

I've been developing this for a while since it's been incredibly useful for my own workflow, but I wasn't planning to share it until it was more polished. Now I realize it's ready enough for a public release — and I'd love to invite developers to collaborate.

One area where I'd especially appreciate help: image display filter algorithms. Dithering is the current go-to, but it doesn't always look great on e-ink. If you have ideas for better pre-rendering or quantization approaches, I'm all ears.

Future plans

• Local re-typesetting engine for epub, mobi, azw3, md, txt, and pdf with better e-ink rendering quality on Supernote
• Integration with CherryStudio / RikkaHub / ChatWise / SillyTavern directly on your Supernote

Claude Skill

This repo also includes a Claude skill for AI-assisted Supernote plugin development, based on official documentation and changelogs (release 0.2.0).

What is this?

A skill for Claude Code / Claude.ai / other platforms that supports a similar skill format. It provides:

• Supernote plugin architecture overview
• Core API quick reference (sync file paths, coordinates, gotchas)
• Type definitions (AIDL interfaces, callback enums)
• Build and debug workflow

How to use it

This is a "skill" that teaches Claude (an AI assistant) about Supernote plugin development.

Easiest way - Claude.ai (web/desktop):

1. Go to claude.ai and sign up (free tier works)
2. Go to Settings → Capabilities and turn on "Code execution"(1)
3. Download this repository as a ZIP file
4. Go to Customize → Skills, click "+", then "Upload a skill"(1)
5. Upload the ZIP file
6. Start a chat and ask: "Help me create a Supernote plugin that..."

For developers - Claude Code (terminal):

1. Install Claude Code: curl -fsSL https://claude.ai/install.sh | bash(2)
2. Put supernote-plugin-dev.md in ~/.claude/skills/(3)
3. Run claude in your project folder
4. Ask about Supernote plugin development

Claude will automatically reference this documentation when helping you code.

Disclaimer

This plugin is not official. It's a personal tool I built for my own Supernote plugin projects, shared in case others find it useful.

License

MIT – do whatever you want with it.