Hi dev community and u/Dunn-sn and u/Mulan-sn,
I am doing regular updates of my plugins, are the users informed when I push an updtae on InkHub ?
If not, could we have a method on the plugin API to check on InkHub and notify the user that a new version is available ?
Thank you,
Hello u/Mulan-sn ,
I love the new toolbar personalization setup, but I have experimented a strange behavior :
- On a note with Real Time recognition, I have the icon for the Transcript (normal), but then I lose the one for the layers. And when I search the settings of the Toolbar, I don't see anywhere the Layers, as if the feature was not existing anymore.
And also not available on the customization, as you can see here: (I have searched on all the other tools menu, but haven't seen it anywhere.)
- While on a note without the Real Time recognition, the icon for the Transcript doesn't exist (also normal), but the "layers" re-appears ! And on the Toolbar settings, the layers are on the Primary tools:
And see here, second line, second icon is the "layers" :
So, bug ? Or any other difference between those 2 notes that could explain the Layers to be unavailable ? I have seen only the Realtime recognition as a difference, but maybe something else.
Also I love that we can select whatever we want on the "Primary tool", even plugins, but then the items that we choose to hide are not accessible anymore at all.
Could we also choose to add some of the "Removed from Primary Tools" to the other dropdown menus ? For exemple I would love to add more the pens and the eraser to the "Page" submenu. Because today what is "removed", is not accessible anymore at all, so more plugin buttons means no more some of the native primary tools at all, and this is annoying.
Thank you very much !
Hi all,
another big update to SuperDashboard is out: v2.1.1
A configurable, always-available dashboard for Supernote e-ink devices. Its face is a draggable bubble (the house logo) that floats over everything; tap it to open the dashboard, drag it to move it (or open it from the plugin's toolbar button). You compose the dashboard yourself from modules, in 1, 2 or 3 columns, in the design and font you like. It runs fully on-device and offline: no account, no network.
Also new:
Here an overall of all the currently available modules:
GitHub (download + user guide): https://github.com/AgP42/SuperDashboard
Also (soon) available on InkHub
Runs on Chauvet 3.29.43 (Manta/Nomad) / 2.26.40 (A5 X / A6 X) and later; on older firmware use v0.22.0.
Free and made for my own daily use. If it earns a spot on your screen there's a Ko-fi link in the repo (https://ko-fi.com/agp42), but the plugin is yours either way.
Feedback and ideas are always welcome!
SuperStickyNote puts floating "post-its" over your notebooks and documents: tap the bubble, type, drag it aside. It's free, and I've just released v2.0, which is a big one — the whole Manager is redrawn and capture now works in PDFs.
Capture from a page, both ways
Text back onto the page
I have rebuilt the Manager view to be close to natives Supernote apps (Digest, To-Dos, InkHub, ...):
Settings
MyStyle/fonts are now shown in their own typeface — pick by looking, not by reading a file nameFixes that mattered
MyStyle/fonts.txt, backup/restore to .json (import merges, never overwrites)Download the .snplg from the releases page, copy it to MyStyle/ on the device, then Settings → Apps → Plugins → Select Plugin Package.
(And soon in InkHub, when the update will be validated by the Supernote team)
https://github.com/AgP42/SuperStickyNote
Free and made for my own daily use. If it earns a spot on your screen there's a Ko-fi link in the repo (https://ko-fi.com/agp42), but the plugin is yours either way.
Hi everyone,
I am developping a plugin "SuperSearch", that allow to search into every supernote OCR transcript, jump to other notes or search folders, directly from a flotting windows over your notes and pdfs. It will allow to search approximatively and use complexe search pattern.
I am under development and I am having a dilemma. I wonder with path to go, so I wanted to ask the potential futur users : YOU 😄
Choice 1 : Local only, no wi-fi, no account, totally free.
Choice 2 : Use AI to have real good transcript
I would propose to use MistralAI only, their OCR4 engine is one of the best of the market, they respect GDPR and their servers are in EU. Also costwise very cheap and privacy respected (at least it is their promise)
Looking forward reading your view,
thank you !
SuperStickyNote is a free plugin that floats little sticky notes over your notebooks and documents — a ✚ bubble, up to 8 draggable cards, keyboard editing, labels, search, export/backup. Made by a Supernote user, for Supernote users.
v1.0.0 is rebuilt for the new Chauvet 3.29.43 (Manta/Nomad) / 2.26.40 (A5 X / A6 X) firmware and brings two improvment I'm pretty happy with hen you create a new StickyNote from the Lasso (Lasso → "Add to StickyNote") :
A build for one firmware version won't run on the other (you'll see "package not compatible" or nothing happens), so grab the one that matches your device.
Download + install: https://github.com/AgP42/SuperStickyNote/releases/latest (copy the .snplg to MyStyle/, then Settings → Apps → Plugins → Add Plugin)
Docs / demos: https://github.com/AgP42/SuperStickyNote
It's free; if it earns a spot on your screen there's a ko-fi in the repo. Feedback and bug reports very welcome 🙏
Hi all,
Major update to my dashboard plugin (now called SuperDashboard) with a build ready for the newer Supernote firmware.
What it is: a draggable house bubble that floats over every screen. Tap it and you get a dashboard you build from sections:
Everything runs on-device and offline, configured through a small 3-step wizard (no JSON required).
New in v1.0.0
Updated user manual with screeshots : https://github.com/AgP42/SuperDashboard/blob/main/USER_GUIDE.md
Which build do I need?
A build for one firmware version won't run on the other (you'll see "package not compatible", or it does nothing), so grab the matching one. Both are in the repo's dist/ folder. On 3.29.43 / 2.26.40+ it asks for file access on first open so it can scan your notes for stars/keywords.
Install: copy the .snplg into MyStyle/, then on the device: Settings → Apps → Plugins → Choose Installation Package.
Repo (code, builds, demo GIF, user guide): https://github.com/AgP42/SuperDashboard
Free and open-source — a personal project for fellow Supernote users. Feedback and bug reports very welcome; a coffee is appreciated if it saves you taps every day 🙂
Hi all,
I am super glad that Supernote team took into account my bug reports on the previous firmware.
I have now ported my SuperTemplate plugin to the new plugin-preview firmware (Chauvet 3.29.43 Manta/Nomad, 2.26.40 A5X/A6X, sn-plugin-lib 0.1.65).
What is SuperTemplate ? One finger double-tap turns your handwritten page title into a native Supernote heading + stamps date/time, on ready-made templates.
Full user manual and screenshots : https://github.com/AgP42/SuperTemplate/blob/main/docs/USER_MANUAL.md
New in v2.0.4:
Two releases now: → https://github.com/AgP42/SuperTemplate/releases
Please let me know if any bug or improvment suggestion !
SuperFun : little games for your Supernote 🎮
What does a Supernote plugin dev do to procrastinate? Build a whole games plugin, of course!
So here's SuperFun: a tiny launcher that drops five calm, paper-friendly games onto your e-ink slab. Pure black & white, finger-first, 100% offline: no accounts, no ads, no tracking, no internet. Just you, some breaks, and a tablet that occasionally beats you at its own game...
So far:
Every game has a little "Rules" card with a worked example.
The nerdy bits I'm weirdly proud of
Screenshots
Get it
Which game next?
What would you actually play on e-ink? 2048, sliding puzzle, Mastermind, Reversi, word search…? Comment below this post or a GitHub issue, I take requests (= I still have boring meetings ahead, don't tell my boss...).
Free and open-source. Coffee jar if it rescues your meetings: https://ko-fi.com/agp42 ☕
Have (Super)Fun !
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
Good to know
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
✍️ Lasso → sticky (OCR)
📝 Better editing
🔤 Fonts & size
Latest .snplg + full guide on GitHub (link above).
Hello,
I have subscripted to the Pay-as-you-go API billing and I have already spend more than my credit, how is it possible ?
I have also this:
Does this mean that I have anyway 10€ per month of free API credit ? (I have no other subscription by Mistral). So if I spend no more than 10€/month, it before free ?
When I check the subscription options:
It is said that "Pro" have 3x more API usage, but 3x more of what ? I am using only the API, does the Pro subscription can bring me any credit or more brandwith ?
If someone could clarify how this work,
Thank you !
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:
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.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,
Hi!
I'm building an e-ink plugin that transcribes handwritten pages with mistral-ocr-latest. I use the word-level confidence scores for two things: underlining "unsure words" for manual correction, and as the signal to escalate hard pages to a vision model. Since the Batch API is half price, I route bulk transcriptions through it and I noticed the confidence scores never come back on that path.
It is a bug, a misuse from my side or a non-documented limitation ?
Repro: the exact same request body through both paths:
{
"model": "mistral-ocr-latest",
"document": { "type": "image_url", "image_url": "data:image/png;base64,..." },
"table_format": "markdown",
"confidence_scores_granularity": "word"
}
And the results I get:
- Synchronous POST /v1/ocr → each page includes confidence_scores.word_confidence_scores (in my test: 25 scored words). ✅
- Batch (same body as the body of a JSONL line, endpoint: "/v1/ocr", job completes fine, status_code: 200) → the page object contains blocks, dimensions, footer, header, hyperlinks, images, index, markdown, tables ; but no confidence_scores key at all.
The markdown is byte-identical to the sync response, so it's clearly the same model; only the confidence data is dropped.
The batch processing docs list /v1/ocr as a supported endpoint and don't mention any response differences, and the OCR model card doesn't either, so I can't tell if this is intended.
Questions:
Is dropping confidence_scores_granularity in batch expected behavior, or a bug?
If intended, could it be documented on the batch page? (It silently changes downstream behavior: my vision-escalation heuristic reads "0 scored words" as "escalate", so batch PDFs escalate every page.)
Any chance of parity on the roadmap, or a recommended workaround short of re-running pages synchronously at full price?
Happy to share the full request/response pair or open a proper support ticket if that's more useful.
Thanks!
Hi all!
After a week of development (and two firmware bug reports along the way 😅), here's my second public Supernote plugin.
I took inspiration from SuperFlow (https://github.com/gorlix/SuperFlow) for the concept of actions linked to specific areas ; and DateTimeStamp for adding the datetime with the keyword (https://github.com/taoist22/sn-datetime), thanks to u/Gorlix02 and u/tao22
What it does: SuperTemplate ships a note template with a title box and a datetime slot. Write your page title by hand, then double-tap the S logo printed on the template with your finger, and the plugin:
100% on-device: no cloud, no network, no account.
So far I have only 1 template because this is the one I am using everyday, feel free to propose more templates and I can integrate them into the plugin with the actions associated.
Demo : we start with a simple handwritten text on the header box, and no datetime (the rest of the page can be handwritten too, no influence) :
Run without the OCR : add a heading format and the datetime:
Run with OCR + datetime (if already exist on a note, it is not replaced:
Download & manual: https://github.com/AgP42/SuperTemplate (MIT, .snplg in the releases — tested on A5X gen 1 and Manta)
Known issue — please read: while the plugin runs you'll see the page flash several times, and old lasso-copied content may briefly reappear. That's the firmware bug I reported here — the note app spontaneously pastes its lasso buffer during any plugin lasso operation. Ratta has reproduced it and a fix is in the works; meanwhile the plugin detects and removes the ghost content automatically (the extra flashing is that cleanup doing its job). The plugin also works around the plugin-storage stacking bug by cleaning its own old versions at startup.
Feedback, bugs and ideas welcome — issues are open on GitHub.
---
UPDATE (v0.10.0): you can now pick the heading style with your pen! ✍️
This was suggested in the comments right here — thanks u/Lorestan00 and it's now live: underline your handwritten title before the double-tap and the plugin applies the style you mapped to that gesture; double-underline maps to another one. No markup = your default style.
The mapping (any of the 4 native heading renderings per gesture) is configurable in the settings, the underline stroke is automatically excluded from the OCR text, and it works in both handwriting and OCR modes.
Detection is deliberately conservative for reliability: v1 recognizes single and double underlines only — the two gestures that can be detected robustly from stroke geometry. More markup types may come later if this proves solid in the wild.
Download: https://github.com/AgP42/SuperTemplate/releases/tag/v0.10.0
(screenshots below: underlined → gray style white text, double-underlined → gray style black text, no underline : black style ; and the same working in OCR mode)
Hi all, and particularly the Supernote dev team and u/Mulan-sn,
I found another PluginHost/firmware bug, this time in the lasso pipeline.
if the user has lasso-copied something (copy buffer loaded), any plugin that creates a programmatic lasso (PluginCommAPI.lassoElements() → e.g. setLassoTitle()) triggers a phantom paste: the firmware inserts the copied strokes into the page during the plugin's lasso lifecycle. The user never asked for a paste.
Repro (100% reliable on my A5X):
lassoElements(rect) and converts it with setLassoTitle({style}).Notes:
lassoElements() and the end of the pipeline, and they are NOT part of the lasso snapshot (both getLassoElementTypeCounts reads report the same count).setLassoTitle() succeeds, setLassoBoxState(2) always fails with code 904: "No lasso action has been performed" : the lasso lifecycle seems to end in an inconsistent state.For the Ratta team, please:
Workaround for plugin developers (ships in my plugin, works reliably, but poor UX): snapshot the page's element numbers before your lasso work, then delete any stroke that appeared during your pipeline, new strokes can only be the phantom paste (your own insertions are text/title elements, and you type-check each candidate so user content is never at risk):
// before your lasso work:
const before = new Set((await PluginFileAPI.getElementNumList(path, page)).result ?? []);
// ... lassoElements() / setLassoTitle() / your inserts ...
// after (save first):
const after = (await PluginFileAPI.getElementNumList(path, page)).result ?? [];
const parasites = [];
for (const n of after.filter(n => !before.has(n))) {
const el = (await PluginFileAPI.getElement(path, page, n))?.result;
if (el?.type === 0) parasites.push(n); // strokes only — never your own title/text
}
if (parasites.length) {
await PluginFileAPI.deleteElements(path, page, parasites);
await PluginCommAPI.reloadFile();
}
Setup: Supernote A5X (gen 1), firmware Chauvet 2.26.39, sn-plugin-lib 0.1.43.
Happy to share full logs, the census instrumentation, or a minimal repro plugin.
Thanks!
Hi all and particularily Supernote dev team and u/Mulan-sn,
I have found a bug on the Plugin core :
Every plugin install/update writes a new copy of the plugin's files and keeps all the previous ones, so a plugin's storage grows without bound.
This isn't a dev-only edge case: Ratta's own official Sticker plugin reads 46 MB on my rarely-updated A5X but 327 MB on my regularly-updated Manta, same plugin, same version, just more updates, look:
My own ~7 MB plugin hit 298 MB after ~19 reinstalls. Remove doesn't reclaim the space either.
What's happening:
Each plugin is installed at:
`/data/user/0/com.ratta.supernote.pluginhost/files/plugins/<pluginID>/`
and every install adds a fresh, versioned set without deleting the old one:
```
app_<timestamp>.npk (~6 MB, bundle + native)
app_<timestamp>_libs/ (extracted .so)
oat/<arch>/app_<timestamp>.{odex,vdex,art} (ART AOT output, ~10 MB)
```
These `app_<ts>.*` + `oat/` artifacts stack up per version, so the folder only ever grows. On my A5X, `.../files/plugins/` totalled 485 MB across all plugins.
Why this matters for everyone (not just devs): official plugins auto-update over time, so a normal user's Sticker/other plugins silently balloon — 327 MB in my case — and there's no user-facing way to reclaim it (Remove doesn't).
For the Ratta/Supernote team — please:
On **update/reinstall**, delete the previous version's `app_<ts>.npk` / `_libs` / `oat` artifacts.
On **Remove**, fully wipe `.../files/plugins/<pluginID>/` so space is actually reclaimed.
Optionally show the real per-plugin footprint (or a "clear plugin cache" action) in Settings → Apps → Plugins.
Workaround for plugin developers (your own plugins only)
A plugin's native module runs **inside the PluginHost process** (same UID), so it can delete files in its own install dir. On load, keep the newest `app_<timestamp>` (the running version) and delete everything older:
```java
u/ReactMethod
public void cleanupOldVersions(String dirPath, Promise promise) { // dirPath = PluginManager.getPluginDirPath()
File dir = new File(dirPath);
File[] files = dir.listFiles();
long maxTs = -1;
for (File f : files)
if (f.getName().startsWith("app_") && f.getName().endsWith(".npk"))
maxTs = Math.max(maxTs, leadingDigits(f.getName().substring(4)));
String keep = Long.toString(maxTs);
long freed = 0;
for (File f : files) // old app_<ts>.npk / _libs
if (f.getName().startsWith("app_") && !f.getName().contains(keep))
freed += deleteRecursively(f);
File oat = new File(dir, "oat"); // old compiled artifacts
if (oat.isDirectory()) freed += cleanOatExcept(oat, keep);
WritableMap m = Arguments.createMap();
m.putDouble("freed", freed); m.putString("kept", keep);
promise.resolve(m);
}
```
```js
// index.js — run once at load
const dir = await PluginManager.getPluginDirPath();
const r = await YourNative.cleanupOldVersions(dir);
console.log(`freed ${(r.freed/1048576).toFixed(1)}MB, kept ${r.kept}`);
```
Only files whose timestamp ≠ the newest are deleted, so the running version is never touched. This dropped my plugin from ~298 MB back to ~15 MB.
But the real fix has to be in PluginHost : the workaround only helps plugins that add this code, and it can't help official plugins like Sticker on regular users' devices.
Happy to share full source, a size-probe, or logs to help triage.
Thanks!
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.
Updated guide with screenshots: USER_GUIDE. Feedback very welcome — thanks to everyone who tried it! 🙏
Hello, I have received my AIpaper recently and still searching to define my workflow.
I have analyzed the differences between "Notes" and "Meetings", everything in Meetings is also available in "Notes", while Notes also have extra features (the "Marker and Plan", Images, the organization by folder and the PDF).
Did I missed something on "Meetings" that have any added value that I cannot get with Notes ?
If not, why having 2 different concepts and why less features for Meetings ?
Thanks,
Hi everyone,
I feel very stupid to have to ask that, I have even read the user manual before and did a search on this community : how to do a simple stupid copy/paste of handwritten content ?
I lasso to copy or cut, and after ???
I have tried : 1 tap on the screen, long press the screen, double tap the screen, I have searched every single menu...
What's the trick ?
(I have the last sw version : v3.14.5)
Thanks...
