u/WhoAmI1234532

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:

• Sudoku: fresh grids generated on the device, guaranteed unique solution. Handwritten-style answers, pencil notes, a "check" and a "give me one" hint.
• Nonogram (Picross): reveal the hidden picture from the number clues. Weirdly meditative.
• Minesweeper: the classic. First tap is always safe (I'm not a monster). Flag mode included.
• Tic-Tac-Toe: you're O, the Supernote is X, and on Hard it is literally unbeatable. Draw or lose, those are your options. Sorry.
• Connect Four: drop four in a row against an actual thinking opponent (alpha-beta search, not a random potato).

Every game has a little "Rules" card with a worked example.

The nerdy bits I'm weirdly proud of

• Puzzles generated on-device (except Nonogram) → effectively endless.
• Sudoku, Nonogram Minisweeper grids can be saved and survive closing the plugin.
• Built for e-ink: high contrast, big tap targets, zero animation, board never jumps.

Screenshots

https://preview.redd.it/k8o8vx9c45kh1.png?width=1920&format=png&auto=webp&s=7270d68cb45e5b76b73bf41e163293b1c5467564

https://preview.redd.it/g62nkoqg45kh1.png?width=1920&format=png&auto=webp&s=d5c4d2a0bb42ceedb9d75e7720cebca7536721e6

https://preview.redd.it/2rd26xpo45kh1.png?width=1920&format=png&auto=webp&s=36be3e8239a1345500a65d9a8a5301dea49a6409

https://preview.redd.it/ogqdyd2hb5kh1.png?width=1920&format=png&auto=webp&s=e5f129d040124472f3522c1245f14bde4e87f96c

https://preview.redd.it/u06p1dps45kh1.png?width=1920&format=png&auto=webp&s=cdd9ae8911912d718ed55f51bf7bce7f0d9fe6e8

Get it

• Download the .snplg: https://github.com/AgP42/SuperFun/releases/latest
• Drop it in MyStyle/ → Settings → Apps → Plugins → Add Plugin → SuperFun.
• Source: https://github.com/AgP42/SuperFun

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...

SuperStickyNote Plugin

https://preview.redd.it/ohogas9ulljh1.png?width=1920&format=png&auto=webp&s=37472f77c312752a25e8b3421f061d79d73d1489

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!

• 📖 Guide: https://github.com/AgP42/SuperStickyNote/blob/main/USER_GUIDE.md
• ⬇️ Download: https://github.com/AgP42/SuperStickyNote/releases/latest
• 💻 Source: https://github.com/AgP42/SuperStickyNote
• ☕ Support: https://ko-fi.com/agp42

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).

SuperStickyNote v0.9.0

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:

https://preview.redd.it/4fjc2njxmtgh1.png?width=2158&format=png&auto=webp&s=15625e2f7e95fb25d9d0fbdc2fce31fb19e29325

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:

https://preview.redd.it/m4dhrb1qntgh1.png?width=2454&format=png&auto=webp&s=6d6a8d864a8ee04b775341f2a09e6f4cccc4410f

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:

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,

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:

1. Is dropping confidence_scores_granularity in batch expected behavior, or a bug?

2. 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.)

3. 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:

• stamps the current date & time (4 formats × 5 languages, configurable size),
• (option) adds an invisible date keyword so the page is findable via Supernote's search (and by other keyword-aware plugins),
• turns your handwritten title into a native heading — visible in the note's table of contents. Either keeping your handwriting (the 4 native styles), or replacing it with typed text via on-device OCR (font & size configurable).

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) :

https://preview.redd.it/m43wfti4tnbh1.png?width=1920&format=png&auto=webp&s=59936966a1408f3c69222d3b60138835ddf1c5a9

Run without the OCR : add a heading format and the datetime:

https://preview.redd.it/jlaizxt6tnbh1.png?width=1920&format=png&auto=webp&s=1a94acb259041b6c6df87ed2e2c90cc18932391d

Run with OCR + datetime (if already exist on a note, it is not replaced:

https://preview.redd.it/35ibypu8tnbh1.png?width=1920&format=png&auto=webp&s=cb46fb28943464c6237aa454830b0b982e6fb6d8

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)

https://preview.redd.it/jrh7v0g3kybh1.png?width=1920&format=png&auto=webp&s=2029cc71c7c3b3ab8b8085ee4c38fc5c0056bbc5

https://preview.redd.it/v9k3xzf3kybh1.png?width=1920&format=png&auto=webp&s=1900dbbb5cec34ba71851c02a9f816ef65360417

https://preview.redd.it/v9rof0g3kybh1.png?width=1920&format=png&auto=webp&s=f1b5ca25f7683c8208a66da07ec2edf54ff34cd9

https://preview.redd.it/shrawlo6kybh1.png?width=1920&format=png&auto=webp&s=36b0912d15815a0a1fa70996c25b872c29a80724

https://preview.redd.it/7gpbrlo6kybh1.png?width=1920&format=png&auto=webp&s=d4cb3b5c9223859ff97769fc086343caded60e2b

https://preview.redd.it/j3yocmo6kybh1.png?width=1920&format=png&auto=webp&s=0a84dbb3762e4f445dadb34e0eef4074a81cbff4

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):

1. Handwrite anything on a note page, lasso-select it, tap Copy.
2. Trigger any plugin that does a programmatic lasso — mine selects a zone with lassoElements(rect) and converts it with setLassoTitle({style}).
3. The copied strokes reappear inside the plugin's lasso zone. With my plugin the pasted strokes then get styled as a heading but the paste itself is firmware-side.

Notes:

• "Clear clipboard" does NOT help : the lasso copy buffer is separate from the text clipboard and apparently survives until something consumes it.
• A finger double-tap alone does NOT paste (tested ×10) : the trigger really is the programmatic lasso lifecycle.
• Proof it happens mid-pipeline: I log a full-page element census before/after. Before: 16 strokes. After: 24 strokes + my title + my text box : the copied strokes (+8) appear between lassoElements() and the end of the pipeline, and they are NOT part of the lasso snapshot (both getLassoElementTypeCounts reads report the same count).
• Possibly related: after 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:

1. Don't dispatch a pending lasso-paste when a lasso selection is created or released programmatically by a plugin.
2. Or expose an API to query/clear the lasso copy buffer so plugins can protect themselves cleanly.

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:

https://preview.redd.it/zcjfm2sv2fbh1.png?width=1404&format=png&auto=webp&s=dd3e20ae3f00bbd20ac99605a1e556adce0bb213

https://preview.redd.it/56txm36x2fbh1.png?width=1920&format=png&auto=webp&s=22bcbb2b20749bb80b1102cc8688eee91a56ad28

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:

1. On **update/reinstall**, delete the previous version's `app_<ts>.npk` / `_libs` / `oat` artifacts.

2. On **Remove**, fully wipe `.../files/plugins/<pluginID>/` so space is actually reclaimed.

3. 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…

https://preview.redd.it/j5g9q9kq5dbh1.png?width=1920&format=png&auto=webp&s=af4fb1e7f63f19cb879797dd8f0471916187a224

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:

https://preview.redd.it/jeehqw2i6obh1.png?width=944&format=png&auto=webp&s=cff30a3c55321700398a38d85875ed2f23f5ae18

- "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...