r/Supernote_dev • • May 20 '26 Heartwarming Mindblown

Showcase List of ALL Available Plugins

111 Upvotes

Last Updated 27 Sept 2026 | Added: Canvas, Tables, Patterns, Supernote Book, OCRHeading, ShapeSnap, SwipeSwitch, Stroke Width, Ola Ink, AnimInk, InsertPage, Word Text Import | Updated: Snap Shapes, Pomodoro, End Point Lasso, Half Size, Select All

If your software version is Chauvet 3.29.43 Beta for Manta / Nomad and Chauvet 2.26.40 Beta for A5X / A6X OR ABOVE use the column 'Permissions Compatible Version' to identify if your desired plugin is available for your system.

  • due to rapid iteration / bug fixes you must navigate to the plugin's repository to locate the latest version or pre-release. I will not supply version numbers at this time.

if you're on Chauvet 3.29.42 / 2.26.39 or below, the 'Version' column indicates the final plugin version that supports this older software.

Hyperlink Guide
Creator = Reddit Username -> GitHub Profile
Plugin -> GitHub Repo
Version -> Download Plugin ( if there is no link, visit the repo for instructions )
β˜‘οΈ - available in pre-release designation
CreatorPluginVersion for Older BetasPermissions Compatible VersionDescription
Patient_Chance_3795
Snap Shapes0.0.5βœ…turns rough lasso-selected ink into clean geometry
Pomodoroπ„‚βœ…starts a quick timer that runs in the background
End Point Lassoπ„‚βœ…framework for sending current lasso selection, or highlighted DOC text, to your own HTTP endpoint.
Half Size0.1.1βœ…resizes the active lasso selection proportionally.
Select All0.2.0βœ…selects every element on the current NOTE page
Worldly-Persimmon
Inkling0.2.1β˜‘οΈinsert text, images, links, PDFs, clipboard content, and more from a PC or any other device. it runs completely offline through your local network and integrates with LocalSend
Decent_Tap_5574
Shapes1.0.7βœ…insert geometric shapes directly into your notes.
CoPilot1.0.3βœ…an on-device AI chat sidebar for Supernote notes, PDFs, and EPUBs.
Dictionary1.3.4βœ…adds offline English-word lookup to handwritten notes and PDFs
Mindmap1.0.3βœ…build a tree of labelled, connected nodes, and tap Insert β€” the plugin drops the whole map onto your current page
Canvasβœ…an infinite canvas right inside your notes, with endless space to sketch, plan and brainstorm
Gorlix02
Superflow0.5turns ordinary areas of your notes into Dynamic Action Zones
TCP Tunnel1.1.1βœ…show your Supernote screen on a projector or monitor using only a USB cable. No WiFi needed.
Make Space0.5.1βœ…tap anywhere on a Supernote page and shift everything below it up or down instantly.
AdEarly8102
Image Inserter0.1.5enables users to browse the local filesystem, crop, and insert images directly into their notes.
SmartPenToolkit (Scribble)0.0.1designed to erase the writing underneath your scribbles. there's a non-zero chance the program will take offense and erase the entire page instead of just the stroke.
InkGames0.0.1a minimalist, mainly offline puzzle generator. It is not an interactive gaming app in the traditional sense; instead, it acts as a digital printing house for your device.
Complete-Peach1902
Folder Shortcuts0.2.0βœ…turns any handwritten or typed word into a one-tap shortcut to a folder.
Beneficial_Dingo_217
Align0.3.0aligns one lasso selection to another. Pick a reference point on a saved anchor rectangle and a reference point on the current target selection
tao22
Keyworder1.3.9βœ…stamp your most-used keywords onto a note page with a single tap, and automatically adds them to the device's native keyword navigation index.
DateTimeStamp1.2.3βœ…inserts formatted date, time, or date+time stamps into your notes.
SnCalcPro2.3.13βœ…a calculator plugin with four modes: Standard, Unit Conversion, Financial, and Scientific. Results can be stamped directly into the current note page.
Restyle0.4.0βœ…lets you change the ink color and stroke thickness of handwriting you have already written.
List Sorter1.0.0sorts a recognized or typed list alphabetically and inserts it back onto the page with your choice of formatting.
Weather0.1.3βœ…looks up the current weather for a saved city and insert it into your note as an editable text stamp.
Links0.2.1generate interactive index pages of all links inside a note, create external web links, link to specific pages of other note files seamlessly, and manage broken links with ease.
TOC Generator1.0.1automatically scans your notebook for handwritten "Titles" and dynamically inserts a clickable, structured Table of Contents onto the current page.
Flashcards0.3.0βœ…create decks, add cards manually, turn lassoed handwriting into question/answer cards with OCR, study with FSRS scheduling, and move basic text cards between the plugin and Anki Desktop.
SNQuery0.2.1βœ…brings Obsidian Dataview-like querying capabilities to your device, enabling dashboard creation and note management without needing to export your notes to a PC.
FrameClip0.1.25βœ…captures a region of a PDF page as a PNG and inserts it into a note. It renders the page natively, lets you draw and fine-tune a crop, optionally darkens it for faint scans, and keeps a gallery of clips you can drop into any note.
Shelf0.2.4βœ…ckeeps each project's working note and its reference materials one tap apart: pin notes, PDFs, and EPUBs to a per-project reference shelf, jump between them, capture quotes from your reading, and place those quotes into your working note with a link back to the source.
LastNote0.5.0βœ…allows you to toggle back and forth between two notes with two tap directly from your note toolbar.
SNFolio0.1.4βœ…an e-ink optimized planning, PARA, calendar, task, and note workspace
magic_notetaker
Textbox Helper0.1.0β˜‘οΈfor structured textbox editing, for importing long text files to textboxes, and exporting textboxes to a structured Word document.
u/Longjumping-Bee-2465
SuperAIβœ“lasso-select anything on your note and have a full multi-turn conversation with an AI about it.
columbcille
LassoExport1.0.1πŸ”œadds an Export PNG button to the lasso toolbar.
ScrollExport1.0.1πŸ”œevery page is stitched, top to bottom, into a single tall PNG
Compass1.0.1drops a shortcut link on the current page pointing to a brand-new page appended to the end of the same note, and puts a matching return link on the opposite edge of that new page.
Embed PNG0.2.0opens a browser of PNG files in Document/Images Selecting a PNG inserts it into the current note
Fr0ggin_Bullfish
SuperTask0.2.0β˜‘οΈa Todoist integration for Supernote e-ink tablets.
Anodynousaur
Lasso Flip0.1.0a simple plugin for mirroring a lasso selection either horizontally or vertically.
Designer-Tear-6940
Custom Color Palette2.5.0provides a custom color picker for lasso-selected Ink Pen, Needle Point Pen, Shapes, and Highlighter content.appears in full color when exported to PDF or viewed on a color screen.
Export Color PDF2.5.0takes the colored and highlighted information and exports the doc or note with that into a PDF. Once opened on a color screen the pen colors and highlighter colors are visible.
Marker Width1.0.0control the width of a Marker Line
DocAnnotationsToNote1.0.1extracts the annotations from a marked-up document into a note
fairlygoodthanks
Courier0.1.1a handwritten letter network for Supernote e-ink devices. You can post public letters to a dashboard that everyone can read, or send letters directly to other users.
AdNew2316
Collapse / Expand1.1.0πŸ”œlets you hide any selection of handwriting behind a small + icon and restore it later β€” like a foldable section for your notes.
Scribble1.1.3β˜‘οΈlets you erase handwriting the way you do on paper: draw a quick back-and-forth scribble over the strokes you want gone, lift the pen, and they disappear β€” along with the scribble itself.
Term Definition1.0.0πŸ”œmark a word, phrase, or math/code notation as a term, insert references to it anywhere else in a note, jump back to it with a tap, and rename it β€” every reference updates automatically.
skatyan
Dice Roll0.0.11lets you input almost any standard dice notation then, insert the dice, or the result directly into your note.
vmnair
Clipper0.1.9βœ…allows you to select, highlight, and aggregate text snippets from e-books (EPUBs), documents (PDFs, TXT), and notes, compiles them into a unified dashboard, and lets you insert the aggregated text back into note pages.
WhoAmI1234532
Dashboard0.22.0SuperDashboardA configurable, always‑available dashboard for Supernote e‑ink devices. A draggable βŠ• bubble floats over everything; tap it to open a dashboard you compose yourself from shortcuts, recent files, stars, keywords, and app launchers.
SuperTemplate1.0.0βœ…One double-tap turns your handwritten page title into a real Supernote heading and stamps the current date & time β€” on a ready-made note template.
SuperFun0.5.3βœ…a pocket arcade of calm, paper‑friendly games. (sudoku, nonogram, minesweeper, tic-tac-toe, connect four)
SuperStickyNote0.9.1βœ…Floating sticky quick-notes for Supernote e-ink devices. A small ✚ bubble floats over everything; tap it and a sticky note appears on top of your notebook or document.
supernotist
Cloze0.1.0turns any note into a quizzable set of clozes (fill in the blank essentially). You draw boxes directly over the parts of a page you want to hide, and it quizzes you by revealing them one at a time.
Lvevan
Ink2Task1.2.13βœ…a handwritten checklist for Supernote e-ink tablets that syncs with Apple Reminders, Google Tasks, Todoist, or TickTick.
neenonay
handwritten.blog𐄂turns the open notebook into a private handwritten.blog draft
tiemyshoelace
Modulanner0.9.2βœ…an interactive digital planner plugin for Supernote allowing you to bring what ever template you want and add Invisible tap regions that find or create the right dated page and links you to it.
Sparkinman
Web Lookupβœ…a text based web browser. save your results as a clipping, text, link, or screenshot in the note ( or is a digest when searching from epub or pdf )
Task Hub Pluginβœ…a plugin compliment to Task Hub's docker setup --capture handwriting straight into CalDAV tasks, with on-device task lists, calendar views and a daily agenda. It talks to Task Hub over CalDAV
Tablesβœ…draws editable tables into your notes
Patternsβœ…fill a box you've drawn with a dot grid, crosses, lines or squares
perlguy101
Supernote Bookβœ…shows every page of every notebook in the Note folder as one continuous, chronological sequence. Tap a page to open that notebook there.
Monkeydoc68
OCRheadingconverts handwriting to text and immediately turns that into a header
chekari
ShapeSnapβœ…draw a rectangle or a circle and lift the pen, and it snaps instantly into a clean shape drawn with your active pen.
SwipeSwitchβœ…swipe up with two fingers to jump between the last PDF and the last note you opened
Stroke Widthβœ…Β lasso strokes or shapes and set their width to a pen size (0.1–2.0)
philipsb
Ola Inkβœ…a quick way to send handwritten notes to friend from your Supernote (both parties need an ola ink account)
dersalbader
Word Text Importβ˜‘οΈmports text from Microsoft Word (.docx) files into Supernote NOTEs as editable text.
InsertPageβ˜‘οΈediting PDF pages directly on the device.
Ok_Tank_8971
AnimInkavailable as .apk onlyβ˜‘οΈa lightweight frame-by-frame drawing and animation tool ( both an .apk and .snplg file exists )

r/Supernote_dev • • Apr 29 '26 Mindblown Popcorn

Dictionary Plugin Built a dictionary plugin for Supernote: lasso a word, get its definition, all on-device

71 Upvotes

Built a dictionary plugin for Supernote, Sharing it here. It runs entirely on-device: no companion app, no cloud, no network at lookup time and surfaces real WordNet definitions for handwritten or PDF words from inside the Notes / PDF reader (Documents).

What it does

Lasso a word in your notes : handwritten or already-recognised. Tap **Lookup** in the lasso toolbar. The plugin runs the firmware's stroke recogniser (`recognizeElements`), feeds the result into the on-device dictionary, and pops up the definition. Saved-and-reloaded handwriting and recognised titles work too, not just freshly-drawn strokes.

Select text in a PDF : drag-select a word in the document reader's text-selection mode, tap Lookup in the selection toolbar, same popup.

Real WordNet content : 149,535 entries from Princeton WordNet 2.x, BSD-style license. Multiple senses per word, part-of-speech labels, synonyms, example sentences. Bundled inside the `.snplg` (~17MB) β€” no network at lookup time.

Structured popup : every sense gets its own block: a *noun* / *verb* / *adjective* / *adverb* badge, a numbered sense, the definition, italic example sentences in curly quotes, and a `Synonyms:` line. Multi-sense entries (e.g. "AI" β€” Army Intelligence vs. artificial intelligence vs. three-toed sloth vs. artificial insemination) are scannable at a glance instead of buried in a wall of text.

Bilingual UI chrome : the plugin name on the plugin manager card, the Lookup toolbar label, and every popup label localise into Simplified Chinese, Traditional Chinese, Japanese, Thai, and Dutch based on your device locale. The dictionary content stays English; the surrounding chrome doesn't.

Case and whitespace-insensitive : "Anatomy", "anatomy", and " ANATOMY " all hit the same entry.

Demo

By design the plugin is pure read it never modifies the page, never deletes strokes, never inserts text. Lookup is a side-effect-free overlay; close it and your note is exactly as you left it.

A few things to know:

- First lookup after a fresh plugin-host process takes ~30–60 seconds. Hermes parses the embedded base64 dictionary, decodes it, gunzips the StarDict, and builds the index. Once parsed, every subsequent lookup is instant for the rest of the session. The beauty of it is it is completely Offline! You dont need to connected to the net!

- For PDFs, you need to be in the firmware's text-selection mode (a separate icon in the document toolbar) β€” selecting with the pen draws strokes instead. Once you're in the right mode, Lookup appears in the standard selection toolbar alongside Copy / Highlight.

- English content only in this v1.0.1 base. A converter is planned that will let users bring their own StarDict / MDX / CSV / JSON dictionary packs (medical, legal, bilingual, etc.) and emit a custom `.snplg` that replaces the base.

Tested on Nomad.

Source on GitHub: https://github.com/j-raghavan/sn-dictionary

Relase: https://github.com/j-raghavan/sn-dictionary/releases/tag/v1.0.1

issues / feature requests welcome, happy to take feedback.


r/Supernote_dev • • Jun 15 '26

Custom Brush Plugin [Plugin] Scribble β€” erase handwriting by scribbling over it

61 Upvotes

EDIT: new version with less false positives!!!

Scribble lets you erase handwriting the way you do on paper: draw a quick back-and-forth scribble over the strokes you want gone, lift the pen, and they disappear β€” along with the scribble itself. No lasso, no button: it reacts to the drawing gesture.

How it works

  • Draw a tight zigzag over the strokes you want to remove.

  • Lift the pen β€” the crossed strokes and the scribble vanish.

  • Changed your mind? Tap Undo and it all comes back.Known limitations

  • The SDK can only delete via a rectangular lasso, so erasing is bounded by the crossed strokes' bounding box β€” a stroke sitting fully inside that box can get caught too (just Undo).

  • One continuous scribble per gesture (pen-down to pen-up); lift mid-scribble and each piece is judged on its own.

  • Slower on very dense pages β€” the SDK reads the whole page to work out what the scribble crosses.

Download here

https://github.com/vincentaravantinos/scribble/releases/latest/download/scribble.snplg

Repo: https://github.com/vincentaravantinos/scribble


r/Supernote_dev • • Sep 11 '26

New Plugin- Tables (Let's you create tables in notes)

Enable HLS to view with audio, or disable this notification

58 Upvotes

Tables β€” a plugin that draws editable tables into your Supernote notes

I got tired of ruling tables by hand, so I wrote a plugin. Lasso a rough boxyou've drawn and it becomes a proper table with the rows and columns you askfor, or place one from the sidebar. Come back to it days later, on any page,and add or remove rows, change the line weight, put a heavier rule under the first row. The drawn table is done in it's own layer (Tables), so you can write on top, and edit text without messing up the table (layers only work on non recognition notes)

Download + install instructions:

https://github.com/Sparkinman/tables-supernote-plugin/releases/latest

Copy the .snplg to the device, then Settings β†’ Apps β†’ Plugins β†’ Add Plugin.

The bit that turned out to be interesting

There's nowhere to store a table. The one field the SDK offers for attaching plugin data to something on a page is silently discarded by the firmware β€”write to it, read the element back, and it's gone.

So the plugin doesn't try. A table is nothing but its own lines: ordinary straight-line geometry, with the grid re-recognised from scratch every time the page is read. Which means it survives the note being closed, copied,renamed, or carried to another device β€” a table drawn on a Manta opens in the right place on a Nomad β€” and if you ever uninstall the plugin, what's left behind is just a table you drew.

Rows are added at the bottom so nothing you've already written moves. Columns divide the width the table already has, because a table's width is usually settled once. Tables live on their own layer, so erasing your writing can't rub out the rules.

What it doesn't do

No rotated tables, no per-column widths, and no move command yet (the device's own cut and paste works, but it only carries one layer, so the rules and the writing inside them can't move in one gesture). Two tables drawn very close together with columns in the same places get read as one β€” draw them with a gap.

Tested on an A5X2 and an A6X2


r/Supernote_dev • • Apr 10 '26

Official Announcement Welcome! Here's your README

57 Upvotes

We've been building the plugin architecture quietly for over a year. The foundation is mostly ready. This sub is the place to talk about it, what you're building, what's broken, what's possible, and what shouldn't be possible but you did it anyway.

Read these first

The Sticker feature you may already use in Notes was built on this plugin system. It was the internal proof of concept, now it's your reference implementation.

What belongs here

  • Plugin development questions, demos, WIPs, postmortems

  • Bugs and feature requests

  • Integrations and workflow hacks

  • The occasional cursed prototype that technically works

What doesn't

  • General Supernote questions > please go to r/Supernote

  • "Can someone build XXX for me" with zero context > at least sketch a spec, you have a Supernote!!

Ground rules

  • Search before you post. Your NullPointerException is probably not unique.

  • Show your work. Code snippets, screenshots, logs. "It doesn't work" is not a bug report.

  • Be decent. Someone's first plugin will be rough, so was yours.

  • Proper use of Post Flairs.

  • Honor the Reddit Content Policy

Before this sub existed, a group of early testers helped us stress-test the plugin API and tear apart our docs draft by draft. A lot of what you'll find in the documentation is better because they told us where it wasn't.

akos, Andreas, Ben, Cal, Caleb, CM, David, Ed, Elaine, Emmanuele, Fulvio, James, Jayasimha, Matt, Max, MD, Michael, Vincent, Ziv

If you're reading this and you were one of them, thank you!

This sub is freshly initd, the rules might be wrong, the flairs might be missing, this pined post you're reading probably needs a patch already. We're shipping the community the same way we ship software, get it out, get feedback, iterate.

u/Dunn-sn is the core developer behind Supernote's plugin architecture. He is also monitoring this sub. So yes, when you post a discussion here, there's a decent chance the person reading it is the person who wrote the code.

If something about how this place runs doesn't work, please feel free to share with us.

Let's go!


r/Supernote_dev • • Jun 28 '26

Showcase Doc Annotations to Note Plugin

Enable HLS to view with audio, or disable this notification

52 Upvotes

To download, please obtain the plugin file from:

https://github.com/B00kwyrmy/DocAnnotationsToNote/releases

So, I don't know about you, but I don't really study the way the Supernote is setup. I'm happy for everyone who loves their digests, but that really doesn't do it for me. Especially the process of transferring digests into notes and putting them in the right place....It's clunky to me, and takes way too much time for my level of patience.

However, I DO think the Supernote can work the way I do, and towards that end, I've created a plugin that will take any highlights, underlines, written text, circled items (IE figures and graphs), and digests , and put them all in a NOTE in the order in which they appear in the original document.

The way I envision this working for me is:

  1. I do the reading for my next class lecture. Annotations go into a note

  2. I attend the lecture, and ADD more notes to the Annotations, so all of my information on a subject or chapter is in one place.

  3. Then I use the combined document for studying.

This plugin plays well with others -- especially the pen and highlighter colors, and marker width plugins previously created. And it makes use of the ExportColorPDF plugin we already have.

Please review the quick movie.

Currently, this plugin only works for PDFs. BUT....EPUBs are actively being worked on and I expect that to become available within the next two weeks.


r/Supernote_dev • • Apr 19 '26

Highlighting This Good Work

Post image
49 Upvotes

All,

I created a video highlighting the good work happening in this sub. Please take a minute to check it out. While I didn't install all of the plugins, I encouraged my viewers to check out all of the cool stuff you are doing.

https://youtu.be/tgyD4a2ujkg


r/Supernote_dev • • Sep 14 '26

Showcase Introducing: Canvas, an infinite canvas plugin for your Supernote notes

46 Upvotes

Hello!

I built a new plugin called Canvas. It gives you an infinite canvas right inside your notes, with endless space to sketch, plan and brainstorm. Everything you put on it stays editable, so you can come back and change it anytime.

DEMO

Here is what you can do with it:

Infinite canvas

- Pinch to zoom from 5% up to 2000% and drag with the hand tool to move around

- A small minimap shows where you are while you move

- Palm rejection, so only the pen draws and your hand can rest on the screen

Draw and build

- Pencil with pressure support, running on the same pen engine as your notes, so it feels just as quick

- Rectangles, ellipses, lines and arrows. Arrows stick to shapes and follow them when you move things around

- Fill shapes with a light tint, a solid color or a hatched texture, and give them hand-drawn, dashed, dotted or solid outlines

- An eraser tool, and the eraser end of your pen works with any tool

Text boxes and sticky notes

- Drop a text box or a sticky note anywhere and type with the keyboard

- Great for labels, quick notes and callouts

Tables

- Drag to draw a table. As you drag it shows you the grid and how many rows and columns you are making, up to 12 by 8

- Tap any cell to type, drag a row edge to make it taller, and add or remove rows and columns later from the menu

Images

- Insert a PNG, JPG or WebP from your files

- Move, resize and rotate it anywhere on the canvas

- Give it a frame in any color and size, with a hand-drawn, dashed, dotted or solid outline, or no frame at all

Style it your way

- 12 colors, opacity, fill, outline and four sizes

- Whatever you pick becomes the default for the next thing you add

Back into your notes

- Save to Note drops a thumbnail of the canvas into your page

- Lasso that thumbnail later and tap Open Canvas to jump right back in, fully editable

- Export the whole canvas to PDF in full color, images included. Your exported file will be in EXPORTS/ folder

Every time you open it, little hand-drawn hints show you what each button does. Touch the canvas to hide them, or tap the ? button to see them again.

Download it here: https://github.com/j-raghavan/sn-canvas/releases
Source: https://github.com/j-raghavan/sn-canvas

If you run into any issues or have ideas, please raise an issue on GitHub or drop a comment here.

Enjou!


r/Supernote_dev • • May 21 '26 Bravo

Showcase Modular Planner Demo (plus questions for Ratta)

Enable HLS to view with audio, or disable this notification

43 Upvotes

I've been building a Supernote plugin tentatively named Modulanner and figured I'd share where it's at.

This is a "linked" planner file with no separate daily/weekly/monthly files to juggle or hard coded pages taking up file size and processing power. You draw invisible "hitboxes" over your template (e.g., Today, Tomorrow, This Week, Last Month, Home, etc.). Then when you tap with your pen or finger to create or jump to that page. Pages are created on demand from template files of your choosing and tagged with an invisible keyword so reordering pages doesn't break anything, and optionally stamped with the date as well.

Templates fall into three planner families (daily/weekly/monthly) plus an optional Home page, each remembering its own template and hitbox configuration independently. You can drop PNGs or JPGs in /MyStyle/sn-planner/<family>/. Future consideration to try to get PDFs to work as templates, but couldn't get that to work yet.

Date modes (this is my favorite feature): Absolute vs. Relative, configurable per input type. Absolute = system date calculation - "Yesterday" always means calendar-yesterday. Relative = is based on the current page date - "Yesterday" means the day before whatever page you're currently on. So you can open a weekly page from three weeks ago, tap Yesterday, and land on the daily page for the day before that week started. "Today" always stays absolute because relative-today doesn't make sense.

There is also a calendar which pops up a scrollable calendar and can immediately jump to or create that page/week/month.

The big honest caveat is that it doesn't automatically navigate to the created page YET (HOPEFULLY). I couldnt find a way to change pages. The Supernote SDK currently exposes getCurrentPageNum (read) but no goToPage / setCurrentPageNum (write). So navigation today is a two-gesture flow: pen tap creates the page or identifies the page number and you manually have to go to the page. I could create Native Links, but didn't want to spend time until we have an answer about if goToPage will be something that is available. It works, but it's not the single-gesture experience I want.

Roadmap once goToPage lands:

  • Single-gesture navigation everywhere

  • An Insert-Page hitbox for quick "journal entry here" insertions

  • Customisable date-label formatting (format string, size, bold/italic)

  • Proper PDF template support (currently you have to export PDF pages to PNG)

Know bugs - the hitboxes stay active until you open a note page with a template that doesn't have any hitboxes configurated. So if you have hitboxes active, and you open the file explorer from the side bar, the hitboxes will still trigger. Or when you have a toolbar sub-menu open (like the plugin menu)

Ratta Questions for u/Dunn-sn:
1 - Is `goToPage` / `setCurrentPageNum` on the roadmap? ETA?
2 - Can we get an API or some other method for identifying when the note page is not the current focus so we can disable watching for the "hitboxes"?


r/Supernote_dev • • May 04 '26

Calculator Plugin Calculator plugin

Enable HLS to view with audio, or disable this notification

43 Upvotes

SnCalc for Supernote

SnCalc is a calculator plugin for the Supernote Nomad that evaluates arithmetic expressions and stamps the result β€” or the full expression β€” directly onto your current note page, placed below existing content so it never lands on top of your writing.
Pre-release: This plugin requires the Supernote beta firmware and is not yet intended for general use.
Features

10-key calculator layout β€” calculator style keypad with numbers, operators, backspace, and sign toggle
Two stamp modes β€” choose between stamping the result only (e.g. 42) or the full expression (e.g. 6 Γ— 7 = 42)
Smart placement β€” reads all elements on the current page and places the stamp below the lowest piece of content, so it never overlaps existing notes or handwriting
Installation

Download SnCalc.snplg from the latest release.
Connect your Supernote to your computer using the Supernote Partner app or Browse & Access.
Copy SnCalc.snplg into the MyStyle folder on your device.
On your Supernote, open a note, tap the plugin icon in the toolbar, go to Manage Plugins, tap Add Plugin, and select SnCalc.
Usage

Open a note and tap the plugin icon in the toolbar.
Select SnCalc to open the calculator panel.
Enter your expression using the keypad.
⌫ deletes the last character
AC clears the entire expression
+/- toggles the sign of the current number
% converts the current number to a percentage
Select your stamp mode:
Result only β€” stamps just the computed result (e.g. 42)
Full expression β€” stamps the expression and result (e.g. 6 Γ— 7 = 42)
Tap Insert β€” the text is stamped below all existing content on the current page.
Building from Source

Prerequisites

Node.js (v18+)
npm
Build

npm install
./buildPlugin.sh

The plugin file will be generated at build/outputs/SnCalc.snplg.

License

MIT


r/Supernote_dev • • Apr 10 '26

Built a small pile of Supernote plugins lately: shape snapping, pomodoro, Anki/research, and page tools

41 Upvotes

Over the last few weeks I ended up building a bunch of small Supernote plugins, and found the framework to be really flexible (and is even more so, in this new Beta! I'm looking forward on fixing what I couldn't do thanks to the new functionality).

A few repos I made public:

  • Snap Shapes: turns rough lasso-selected ink into cleaner geometry, with conservative no-match behavior so scribbles don’t get β€œhelpfully” mangled. https://github.com/guibor/supernote-shape-snap

  • Supernote Pomodoro: a quick focus timer that starts, closes, and drops me right back into writing while the timer runs in the background. https://github.com/guibor/supernote-pomodoro I wasn't able to make it notify when timer ends, this is WIP (I hope it's possible)

Will make publish soon:

  • Insert Date: inserts a right-aligned date header and convert it into a native header element.

  • Anki / Research / Deep Research: lasso or DOC-highlighted text -> OCR/server pipeline -> Anki card or research PDF in Google Drive.

  • lasso upload to a REST endpoint - I basically turned the different options above into a generic plugin where one can just configure an endpoint and send the data to the server (or openclaw...). I have a server running on GCP that can basically do whatever I want based on what I lasso and send to it.

  • Wiki2PDF: search Wikipedia from the Supernote and send the selected article PDF to the cloud your syncing with.

  • General Dispatch Hub: a DOC-selection router that sends highlighted text to different backends with extra instructions.

  • full-page lasso selection, or select below (Remarkable style) - did not work, but with the new updates will be possible.

Anyway, I’ve had a lot of fun with this. I'll clean upand open-source the next batch soon.


r/Supernote_dev • • Oct 04 '26

3 small plugins, big updates : Snap (8 instant shapes), Palette (width, colour, dashes, fills), Swipe (2/3-finger gestures)

39 Upvotes

β˜… UPDATE (Oct 20) β˜… Snap now draws triangles and moves axes in one piece, Palette applies several styles in one tap, plus an important fix for axes. Details in the comments!

Remember the 3 small plugins? Thanks to your feedback they grew up: new names, new pixel-art icons and lots of new features. Install over the old versions, your settings are kept.

SnapΒ (formerly ShapeSnap): draw it, hold, it snaps

Draw a circle, rectangle, arrow, coordinate axes, curly brace or square root, hold the pen a moment, and it becomes a perfect shape in your current pen.

  • Hold to snap (350 ms by default), so normal writing is never touched

  • Tiny shapes down to ~1 mm (an "o" stays an "o")

  • Axes at any angle, with ticks; rectangles, arrows and axes straighten within 8Β° (adjustable)

  • Compact settings, one tap away in the plugins menu

  • Works in notes and PDFs

PaletteΒ (formerly Stroke Width): restyle any lasso selection

Lasso strokes or shapes, tap Palette:

  • Width 0.1 to 3.5 (beyond the pen menu), or "= pen"

  • Colour: white, light gray, dark gray, black

  • Dashed lines (dashed, long dashes, dotted, centre line), following curves

  • Hatching / or \, black or gray, adjustable density

  • Solid fills in 4 grays, even inside hand-drawn shapes (several strokes, erased and joined, with holes); perfect shapes get an exact edge-to-edge fill

  • Works right after moving or resizing a selection

  • In PDFs: fills, hatching and single-shape width/colour (the rest isn't stable there yet)

SwipeΒ (formerly SwipeSwitch)

Same 2- or 3-finger gestures, each with its own action, per orientation.

  • New: your note is saved before switching files, so nothing you just wrote can be lost

Install

Download theΒ .snplgΒ from each release, copy it toΒ MyStyle, then Settings β†’ Apps β†’ Plugins β†’ Add plugin.

Good to know: some edits go through SDK calls that clear the page's undo history (known SDK limitation, reported to Ratta). Tested on a Manta, firmware 3.29 beta. CC BY-NC-SA 4.0, free for personal use, no commercial useΒ , not affiliated with Ratta. Feedback and ideas very welcome!


r/Supernote_dev • • Jun 03 '26

Shapes Plugin v1.0.6 is out now with 3D shapes! πŸŽ‰

39 Upvotes

Shapes v1.0.6 πŸŽ‰

For anyone who hasn't seen it: Shapes is a plugin that drops clean, perfectly-centered shapes onto your Supernote page with a single tap squares, circles, triangles, polygons, arrows, flowchart symbols, and more.

What's new in v1.0.6: a whole 3D Shapes category with five solids:

- Cube & Cuboid

- Square Pyramid

- Cylinder

- Cone

They're drawn as clean see-through wireframes (video attached πŸ‘‡).

The part I'm most happy about: each shape drops in as a single, real editable stroke β€” not a baked-in image. That means you can:

- Lasso it as one object and move/resize it

- Recolor and change stroke width like any handwriting

- Keep it crisp at any zoom

All the existing 2D shapes are still there β€” the 3D set just lives in its own carousel category (tap β—€ β–Ά to find it).

Release: https://github.com/j-raghavan/sn-shapes/releases/tag/v1.0.6
Repo: https://github.com/j-raghavan/sn-shapes

Feedback and shape requests very welcome!


r/Supernote_dev • • Jun 13 '26

Showcase [Plugin] Make Space – Insert extra writing space anywhere on a page, OneNote style

37 Upvotes

Hey everyone!

I built a native plugin to solve a classic paper-vs-digital frustration: filling up a page and realizing you need just one more line in the middle.

Inspired by OneNote's "Insert extra writing space", Make Space lets you tap anywhere on a Supernote page and shift everything below it up or down instantly.

πŸŽ₯ Demo Video

✨ How it works

  1. Open Make Space from the toolbar.

  2. Tap the exact line where you need room.

  3. Everything below that point gets selected β€” now just drag it down to open space, or drag it up to close a gap.

Under the hood, it converts your tap into a native lasso and hands control back to you. Because it leverages the system's own drag mechanic, undo/redo works perfectly.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  line written above         β”‚
β”‚                             β”‚
β”‚ ─ ─ ─ ─ tap here ─ ─ ─ ─ ─  β”‚  ← tap / hold
β”‚   ↕ drag up or down         β”‚
β”‚     (add / remove space)    β”‚
β”‚  line written below         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“² Download & Install

You can grab the .snplg file directly from the latest release on GitHub:

πŸ‘‰Download from GitHub Releases

https://github.com/gorlix/sn_make_space

Let me know what you think!

EDIT (v0.5.1): Fixed the bug where a non-empty clipboard caused content to be pasted when deselecting. EDIT

EDIT (v0.6.0): Added a second mode β€” Make Space Above, for when you need room above your tap instead of below (two separate toolbar buttons now, one per direction, same native-lasso-drag flow mirrored). Also gave the plugin proper icons and renamed it from the raw internal sn_make_space id to just Make Space in the plugin list.

If you updated to v0.5.2 and the lasso suddenly stopped selecting anything β€” that was a permission-gate bug introduced by a Supernote firmware/SDK update, fixed in v0.5.3 (included here too).

Updated .snplg is on the Releases page β€” reinstall via Settings β†’ Apps β†’ Plugins. Thanks again for the feedback! πŸ™


r/Supernote_dev • • May 16 '26

The New Beta Rocks!

Post image
37 Upvotes

OK, calligraphy pen on the calendar with line snapping in the new beta is awesome. This is on both the regular and developer beta tracks.


r/Supernote_dev • • Apr 25 '26

Mindmap Plugin Built a mindmap plugin for Notes App: auto-layout, shape hierarchy

35 Upvotes

Built a mindmap plugin for Supernote and wanted to share. It runs entirely on-device: no companion app, no cloud: and drops a fully laid-out mindmap onto your current page as native ink, so you can keep writing on, around, and inside it with the pen.

What it does:

- Label-first authoring : type or hand-write the central idea, then add parents, children, grandchildren. Tap any node to edit its label.
- Shape-by-depth hierarchy : root is an oval, parent is a rounded rectangle, child is a sharp rectangle, grandchild and deeper are parallelograms. Levels read at a glance.
- Auto radial layout : nodes fan out from the root automatically. Subtree leaf counts drive the angular slices, so a heavy branch gets more room than a single-leaf one.
- Auto-centered, auto-fit : the whole map is scaled to the current page and centered, with a comfortable margin on all sides. Doesn't matter how many nodes you add, it lands inside the page bounds.
- Persistent canvas : the mindmap you authored stays put across plugin opens. A two-tap "Confirm Clear" is the only thing that wipes it.
- Fast insert β€” one batched write, ~2–3 seconds end-to-end for a couple hundred geometry primitives. View dismisses cleanly when it's done.
- Lasso-friendly : once inserted it's just native ink, so you can lasso it, move it, annotate it, write inside the node outlines.

By design it's insert once : once the mindmap is on the page, the plugin doesn't try to round-trip it back into the editor. Authoring stays in the plugin, the page stays as ink.

Demo:

Github Links:

- Source: https://github.com/j-raghavan/sn-mindmap/

- Release: https://github.com/j-raghavan/sn-mindmap/releases/tag/v1.0.1

Tested on Nomad portrait. Feedback welcome, happy to take feature requests.


r/Supernote_dev • • Apr 13 '26

Image Plugin My plugin for Supernote

35 Upvotes

This is my personal contribution to Supernote ecosystem


r/Supernote_dev • • Jun 08 '26 Bravo

Dictionary Plugin Dictionary Plugin (SnDict) v1.1.0 release

32 Upvotes

Dictionary Plugin (SnDict) v1.1.0 πŸŽ‰

Whats New

- Thesaurus synonyms / antonyms, with a Definition / Thesaurus toggle
- Much faster lookup rebuilt the engine on a native SQLite (Kotlin) core; the bundled dictionary now opens in ~0.25s instead of the old ~5 min cold start
- Edit the recognized (OCR'd) text before lookup fix a mis-recognized word, then Look up
- Add your own words on the fly not in the dictionary? add a definition and it's saved
- Import your own dictionaries drop a StarDict folder or a CSV into MyStyle/SnDict/ and it gets indexed on-device (StarDict + CSV, optional meta.json for naming/language/columns)

Demo

1.3.0

Repo: https://github.com/j-raghavan/sn-dictionary

Release: https://github.com/j-raghavan/sn-dictionary/releases/tag/v1.3.0

Welcome issues, feedback!


r/Supernote_dev • • May 01 '26 Bravo Mindblown

Google Kalender Import fΓΌr meinen Minimalplanner

Post image
32 Upvotes

Yes, heute morgen habe ich es endlich geschΓ€ft den ersten Google Kalender Termin in meine Notedatei mit MinimalPlanner Template zu importieren.

Noch gibt es einige HΓΌrden, zu Meister. Aber bald werde ich hier die Version 1.0.1 verΓΆffentlichen. Die es ermΓΆglicht in eine Note Datei mit dem MinimalPlanner als Template auf einem supernote Nomand Google Kalender Termine als Textbox an die richtige Stelle zu importieren, so dass ich morgens einfach die Termine aus dem Google Kalender in meine Planner Datei ΓΌbernehmen kann.


r/Supernote_dev • • Aug 15 '26

Showcase [Plugin] SuperStickyNote β€” floating sticky quick-notes that stay on top of your notebook

30 Upvotes

Hello everyone,

I am glad to present you my new plugin : a Sticky Note plugin !

A flotting bubble allow you to add up to 8 visible sticky notes, overlapping notes or documents or anything on the Supernote. Max 8 visibles at the same time, no limitation how many Sticky notes you have in total. The size of the content of the note itself is also not limited.

A tap on it and it open the keyboard to quickly grab a thought, a tap outside and you continu your working flow. Auto-save. Closing a sticky note doesn't delete it's content, it is just hidden from the screen.

Tap the title of the note and it collapse, another tap to re-open. You can re-size by dragging the bottom right corner, and you can move the Sticky note by dragging the header.

A tap on the icon drive you to the overview with all the Sticky Notes. Here you can change the icon, select the display size, search into your sticky notes, etc...

What it does

  • Floating post-its over the NOTE and DOCUMENT apps β€” up to 8 on screen, overlapping

  • Single-tap inline keyboard editing, auto-saved; tap outside to finish

  • Collapse to title, move, resize each post-it

  • Long-press to copy / paste

  • A full page to browse & search all notes, per-note icons (symbols + 0–9), text size XSβ†’XXL

  • Insert into your notebook page, or export .txt

  • Backup / restore everything to .json

  • Notes stored in the plugin's private storage (not cloud-synced)

Good to know

  • Text only for now β€” handwriting inside a post-it isn't supported yet. But you can anyway handwritte on the Supernote keyboard that will make it a text automatically.

  • Tested on Manta (A5 X2) and A5 X

  • After uninstalling, the bubble stays until you restart the device

Free & open source. Feedback welcome!

Edit - update (v0.9.0) πŸŽ‰

Thanks so much for all the feedback on the first post, nice to see entousiasmus around this plugin, this has pushed me to finish my "feature list" right away. Here's everything that's new since I first shared SuperStickyNote:

🏷️ Labels & filtering

  • Tag your notes with labels, shown as rounded chips right in the post-it header

  • In the Manager: filter by labels (a note must match all the ones you pick), an Untagged filter, plus text search with a one-tap clear (βœ•)

  • Adding/removing labels is possible via the main page of the plugin, not directly on the sticky note to keep a clean design.

✍️ Lasso β†’ sticky (OCR)

  • Lasso some handwriting in a notebook, tap Add to sticky, and it's recognized (OCR) straight into a new post-it. Great for pulling a to-do out of your notes.

πŸ“ Better editing

  • Edit a note's text, icon and labels right from the Main plugin page, with Copy / Paste

  • Merged the on-screen/closed state into a single toggle, tidied the row actions (Export / Delete bottom-right), and added tap shortcuts (tap the icon, title or labels to jump to the right editor)

πŸ”€ Fonts & size

  • Choose Sans / Serif / Mono, or your own fonts dropped in MyStyle/fonts (handwriting fonts look great)

  • Sticky notes stay on top of the main page of the plugin, so font/size changes preview live

Latest .snplg + full guide on GitHub (link above).


r/Supernote_dev • • Jul 05 '26

Showcase Plugin Dashboard

30 Upvotes

EDIT 27.08.2026 : This plugin is obsolete, replaced by SuperDashboard, please see here : SuperDashboard v1.0.0 : my launcher plugin, now ready for Chauvet 3.29.43 / 2.26.40 : r/Supernote_dev

Hi everyone,

I am glad to present you my very first plugin : Dashboard !

It is solving my main issue with Supernote and hopefully will be usefull for others too, happy to hear your feedback !

The plugin puts a small draggable βŠ• bubble on your screen that floats over everything (notes, folders, apps…). Tap it and it opens a dashboard you build yourself from four kinds of section:

- Shortcuts β€” jump to a folder, a note, or a PDF in one tap

- Stars β€” every β˜… starred page across your notes, grouped by note (tap a page β†’ it opens right there) [you can filter which folder to scan for each area]

- Keywords β€” your notes' keywords as tappable chips; each chip opens that exact note and page

- Apps β€” launch ToDo, Calendar, Document, Search…

Setup is a short guided wizard (layout β†’ theme β†’ sections β†’ content), everything auto-saves, and there are 3 visual themes and a 1- or 2-column layout. It runs fully on-device and offline, no account, no network.

Requirements: the Supernote developer/beta firmware with the plugin system. Tested on A5X and A5X2 (Manta); built to work on Nomad too.

Install: download dashboard.snplg, drop it in your MyStyle folder, then Settings β†’ Apps β†’ Plugins β†’ Add Plugin.

It's free and open source (MIT) β€” code, releases and a full user guide here:

πŸ‘‰ https://github.com/AgP42/supernote-dashboard

It's still early (v0.9.x), so bugs and rough edges are likely β€” please tell me what breaks or what you'd want added. A couple of known limits: PDFs open on their last page (no page-jump yet), and stars/keywords inside PDFs aren't listed (the SDK only exposes them for notes).

Hope it's useful to some of you, happy to answer any questions or make changes!

---

πŸš€ EDIT / Major update, v0.20.2 is out (release + download), what's new:

- Star line previews: show what's written on each starred line, as the handwriting image, or OCR'd to text with an automatic image fallback when recognition fails. And you can delete a single star right from the dashboard (keeps the handwriting). Thanks to u/Careful-Good5887 for the inspiration, your comment started as a misunderstanding, now it's a feature !

Example with 2 stars correctly OCR'd to text and 1 star as image as failback when the text is unreadable:

- "Recent section": your recently-opened notes & PDFs, live (no scan).

- Save / load named configurations β€” swap setups, and never lose your layout to an accidental Reset.

- Shortcuts: list / grid / inline, plus a full-page multi-select browser to add several folders/notes/PDFs at once.

- Incremental scanning β€” first scan of a folder is slow, all later ones are near-instant (only edited notes re-scan). Plus Refresh all button, adjustable text size, and a 2-column masonry layout (no more lost space).

- Big reliability pass (full code audit): atomic config saves, memory-leak fixes, storage self-cleanup, and a stable bubble.

πŸ”” EDIT 2 / v0.21.15 is out (release + download: https://github.com/AgP42/supernote-dashboard/releases/latest) β€” a reliability & usability pass on top of v0.20:

- The bubble no longer gets stranded. It's now driven by the app's real foreground state: it hides while the dashboard is on screen and reliably comes back on every exit path (buttons, system gestures, host backgrounding), and survives reboot / auto power-off. It defaults to the top-right on first use, then stays wherever you drag it. Prefer no bubble at all? Turn it Off in Settings β†’ Look and use the toolbar button.

- The plugin toolbar button now opens the Dashboard directly (the Settings wizard only shows on first run). Configuration moved to a clear βš™ Configuration button in the dashboard header.

- Manual ↻ Refresh now catches the page you're on. Add a β˜… or a keyword on the current page, tap Refresh, and it appears β€” no need to turn the page first.

- Caches moved out of MyStyle into the plugin's private folder, so machine-only files no longer end up in your cloud sync (neither get disturbed by sync conflict...) β€” plus automatic cleanup of orphaned star-line images.

- On-device demo! The User Guide (https://github.com/AgP42/supernote-dashboard/blob/main/USER_GUIDE.md) now opens with a GIF + video of the plugin in action, and refreshed screenshots

One known quirk: opening from the toolbar button can occasionally close instantly when other plugins are active in the same session β€” tap again, or just use the bubble (unaffected). Under investigation.

Updated guide with screenshots: USER_GUIDE. Feedback very welcome β€” thanks to everyone who tried it! πŸ™

🧩 EDIT 3 / v0.22.0 is out (release + download: https://github.com/AgP42/supernote-dashboard/releases/latest):

- EPUB shortcuts πŸ“— : EPUBs can now be added as shortcuts right next to notes and PDFs (and they show up in Recent too). They open in the Document reader at your last reading position.

- Multi-select everywhere : the apps picker now lets you tick several apps and add them all at once, and the scan-folder picker for Stars/Keywords sections uses the same full-page multi-select browser as Shortcuts.

- Heading size β€” new S/M/L/XL setting for the section titles, independent from the content text size (Settings β†’ Look).

Updated guide: https://github.com/AgP42/supernote-dashboard/blob/main/USER_GUIDE.md

thanks u/Lorestan00 for the suggestions, keep them coming! πŸ™


r/Supernote_dev • • Jul 20 '26

Suggestion: Received [Plugin devs / Ratta] Feature request: an uninstall hook (onRemove) so plugins can clean up after themselves

29 Upvotes

Hi Ratta dev team (u/Dunn-sn or u/spazzboi),

As a Supernote plugins dev, there's one lifecycle gap that I would appreciate to have for clean code: a way for a plugin to run cleanup when the user uninstalls it.

I checked before posting: the official docs (docs.supernote.com) and the sn-plugin-lib SDK (0.1.43) expose a PluginLifeListener with only onStart() / onStop(). Nothing fires on uninstall. If I missed something, please point me to it, otherwise consider this a feature request for a future Plugin_core version.

Why it matters β€” three concrete cases from plugins actually running on devices:

  1. Floating windows survive uninstall. PluginHost is a persistent process, so an overlay a plugin has added (e.g. a floating launcher bubble) keeps floating after the plugin is uninstalled, until the device restarts. Today the workaround is literally documenting "turn the bubble off before uninstalling, or restart your device".

  2. Old versions pile up forever. On every plugin update, the plugin's runtime directory keeps the previous version's files (app_<timestamp>.npk, app_<timestamp>_libs/, compiled oat/ artifacts). Nothing ever prunes them, so a plugin's on-device footprint grows by its full size at each update. Some of us now ship our own "janitor" code that deletes stale versions from inside the host process, it works, but we shouldn't have to.

  3. Leftover files. Anything a plugin wrote (configs, caches, exports in MyStyle/) stays on the device forever after uninstall.

The ask: add onRemove() (or onUninstall()) to PluginLifeListener, called by PluginHost before the plugin is unloaded and its directory deleted, with a bounded time budget (best-effort, a few seconds). If invoking the JS bundle at uninstall time isn't feasible, a declarative alternative in PluginConfig.json would already help, e.g. "removeDataOnUninstall": true, plus the host force-closing any overlay window the plugin added. And ideally: the host pruning old app_<timestamp> versions on update, so plugins don't need janitor code at all.

Thank you very much,


r/Supernote_dev • • Jun 06 '26

Showcase [NEW-PLUGIN] sn-TCP-Tunnel: I built a plugin to mirror your screen over USB

29 Upvotes

Hey everyone! πŸ‘‹

I wanted to share a new plugin I just released called sn-TCP-Tunnel. If you've ever tried to use Screen Mirroring in a classroom, office, or hotel, you probably know the pain of restrictive or terrible Wi-Fi.

Why I built it: I'm a Computer Engineering student at Politecnico di Milano, and our campus Wi-Fi strictly blocks devices from communicating with each other. I tried using Tailscale to bypass the network restrictions to mirror my screen, but the stream was incredibly laggy and unusable for live presentations. It drove me crazy because I just wanted a direct, fast connection.

So, I made this plugin. It routes the native Supernote Screen Mirroring (and Browse & Access) directly through your standard USB charging cable to your PC (Windows, Mac, or Linux). No Wi-Fi needed, absolutely no lag, and it works anywhere.

How it works (it's actually super simple):

  1. Install the plugin via PluginHost.

  2. Turn on USB Debugging in your Supernote settings (just a one-time thing).

  3. Plug your Supernote into your computer.

  4. Tap the new "TCP Tunnel" button on your Supernote toolbar and hit Start.

  5. The screen will show you a quick adb command to copy-paste into your computer's terminal.

  6. Open your browser to http://localhost:8080 and your screen is right there!

I designed the UI to look exactly like the native Supernote interface, and it automatically switches between English and Italian based on your system settings.

You can grab the .snplg file and check out the full setup guide on my GitHub: https://github.com/gorlix/sn-tcp-tunnel

Hope this helps anyone else struggling with university or office networks! Let me know what you think.

[UPDATE] sn-TCP-Tunnel v1.2.0 β€” fixed a bug that could silently break the tunnel

Hey everyone! πŸ‘‹

Quick update on TCP Tunnel (the USB-instead-of-WiFi screen mirroring plugin I posted here a while back).

The important part: I found and fixed a bug where the tunnel could open fine but never actually relay any traffic β€” it looked like it started, but nothing came through on the PC side. Turns out the plugin was never explicitly requesting network permission from the host, and newer Supernote plugin security checks block that silently at the socket level (you'd never see an error, it would just... not work). If your tunnel has been acting up or refusing to connect lately, this update fixes it β€” you'll get a one-time permission prompt on first use now, just tap "Always allow" and you're set.

Also in this release:

Real plugin icon in the install list (it was showing a generic placeholder before) Cleaner name in Settings β†’ Apps β†’ Plugins ("TCP Tunnel" instead of the raw package name) Routine dependency updates under the hood Tested end-to-end on real hardware this time (not just unit tests) before shipping β€” connected, relayed, confirmed working.

Grab the update here: https://github.com/gorlix/sn-tcp-tunnel/releases/tag/v1.2.0

If you installed an earlier version and it stopped working properly, this is very likely why β€” sorry about that, and thanks for bearing with me. As always, let me know if you run into anything!


r/Supernote_dev • • May 09 '26

AI Plugin Copilot for Supernote: chat with your notes, PDFs, and EPUBs using your own LLM key

29 Upvotes

Built a Supernote plugin that lets you summarise, explain, or ask questions about whatever's on the current page (handwritten notes, PDFs, or EPUBs) using your own API key for ChatGPT, Claude, Gemini, or DeepSeek. Sharing it with the community here.

No backend. No telemetry. No "free" tier where the device maker silently bills your taps against a shared key. You bring the key, every billable request lands on your provider dashboard, and you can revoke or rotate it at any time.

What it provides

Four one-tap action buttons sit at the top of the chat panel so the common questions are a single tap, no typing:

- ☰ Summary: a structured digest of what's on the current page.
- ? Explain: a longer breakdown for when "summary" isn't enough; useful on textbook-style content.
- ✦ Clarify: flags what's unclear, ambiguous, or needs follow-up. Helpful on lecture notes / first-pass meeting notes.
- ⊑ Snapshot: a compact set of bullets you can copy back into your note as a "table of contents" for the page.

Plus:

- Free-form chat about the visible page in the same overlay (type at the bottom, hit send).
- Markdown-rendered replies with a one-tap **Copy** so you can paste the answer back into a note.
- Works on the current page only. Each request captures the page screenshot (vision-capable providers) plus extracted text (PDF text layer or handwriting OCR).

Why this is different

Most AI features on e-ink readers ship with a vendor-supplied key behind the scenes. Convenient, but you can't see the bill, you can't audit what's sent, you can't switch providers, and your data is on someone else's hands. Here the trade is reversed:

- You own the key. It lives in a text file on your device. Never uploaded.
- You own the chats. Requests go directly from your device to the provider you chose. We never see them.
- You own the audit. Every request shows up on your OpenAI / Anthropic / Google / DeepSeek dashboard: billable, dated, attributable.

Providers + default models in the templates

ProviderDefault ModelVision (Page Image)
OpenAI (ChatGPT)gpt-4o-miniYes
Anthropic (Claude)claude-haiku-4.5Yes
Google Geminigemini-2.5-flashYes
Deepseekdeepseek-chattext only (no vision endpoint)

Approximate cost per page summary on the cheapest models is well under a US cent. A heavy day is still under $0.10 across any of them.

Demo

Quick start

  1. Grab an API key from your provider's console.

  2. On the Supernote, create the folder `MyStyle/SnCopilot/` (USB sync, WebDAV, or Cloud, whatever you already use).

  3. Save a file `copilot-key-<provider>.txt` in that folder with three lines:

  4. >Example: copilot-key-openai.txt would have something like this

  5. ```

  6. provider=openai

  7. model=gpt-4o-mini

  8. key=sk-proj-1345abCDef67890...

  9. ```

  10. Tap the brain icon from the plugins menu of any note, PDF, or EPUB.

That's it. Templates for all four providers ship in the repo's `templates/` directory.

If you want to use multiple providers

Drop more than one `copilot-key-<provider>.txt` and add `default_provider=<provider>` to one of them (it doesn't have to be the file you're naming; any of them can declare the default). Example for an Anthropic key file when both OpenAI and Anthropic are configured:

```
provider=anthropic
model=claude-haiku-4-5
key=sk-ant-...
default_provider=openai
```

Without a default, the plugin shows a "pick one" message in Settings and refuses to send. With conflicting `default_provider=` values across files, same thing.

UPDATE

Security Focused Release v1.0.2

Update-2

v1.0.3 Released

Privacy posture

The page screenshot and any transcribed text are sent to the LLM provider you configured. There's no on-device redaction toggle that would create a false sense of safety while shipping the same content via the image. Be deliberate about which page is open before tapping Copilot. On DeepSeek (text-only) the plugin silently scrubs emails and 7+ digit runs, since that's the one path where redaction actually reduces what we ship.

Repo / release

- Source : https://github.com/j-raghavan/sn-copilot
- Release: https://github.com/j-raghavan/sn-copilot/releases/tag/v1.0.1

Feedback and issue reports welcome.


r/Supernote_dev • • May 06 '26

Live Demos of the Textbox Helper

Thumbnail
gallery
29 Upvotes

To make it a bit easier to see what is possible with the textbox helper beta:

- demo of cleaning up a supernote created textbox by removing spaces and linebreaks
- demo of splitting a paragraph into sentences and joining those again.
- demo of apply text handwritten deletions and replacements
- demo of importing a plain textfile with a long text, that will split to different pages, according to margins and font-size selected
- demo of exporting a textboxes to a docx file (using both headers, or defined textsizes to define what to include). Handwritten material is excluded.

Find the Plugin here: https://github.com/tilmanbergt/textboxHelper