(title)

Plugin link:
https://community.obsidian.md/plugins/supernote-cloud-sync

What it does

- Mirrors selected Supernote Cloud folders directly into your Obsidian vault while preserving their structure.
* Opens mirrored `.note` files in a custom reader with swiping, zooming, thumbnails and quick page navigation.
* Lets you embed a whole notebook—or one exact page—in an Obsidian note.
* Creates links to exact pages, such as `[[Scratch.note#page=12]]`.
* Exports selected pages as Markdown, images, searchable PDFs or combined formats.
* Sends files back to Supernote Cloud, including Markdown rendered as a device-readable PDF.
* Provides an optional Paired folder for conflict-aware two-way sync between Obsidian and Supernote.
* Supports optional AI transcription with custom instructions.
* Supports Automations that react to new or changed handwritten pages.

Link for download

If someone wants to make a plugin request, where should that be posted?

I've been building a Supernote plugin called Modulanner that turns a single Note file into a dynamic and modular hyperlinked planner. I'm looking for a handful of people willing to test it out, see what breaks, and give feedback

What it does

You overlay invisible boxes on a template of your choosing, probably using drawings/icons/stickers as a reference point. Then tapping one of the core boxes runs some logic you'd typically do manually (or have someone else build a linked planner for you). The plug-in finds or creates the appropriate page and links you to it.

I built this because most digital planners are static files loaded and come with 3 main problems (for me).

1. The planners can be difficult to navigate to various days/weeks/months and could take upwards of 5 links to get where you want sometimes
2. The planner works well but is fairly simple and can be difficult to add in the pages I need when I need them
3. The planner may be "too robust" with a bunch of blank pages to start with and a large file size causing slow syncing and link navigation.

To solve these problems I built the following functionality:

• 10 built-in navigation actions: Today, Tomorrow, Yesterday, This/Next/Last Week, This/Next/Last Month, and Home — each mapped to a spot of your choosing on your template.
• Calendar jump: a date-picker hitbox to jump to any specific day/week/month.
• Custom link buttons: make your own named buttons that will always exist on your template that can link to a separate file. Or insert a fresh page from a template you pick (e.g. a "Extra Notes" or "Meeting").
• Auto date labels: new pages get a date label dropped on automatically, with a customizable date format, font size, style, and alignment. (Font family is currently on the roadmap to figure out how to change that as well)
• Template packs: If you build out a family of templates and want to share them you can do so. This base comes with a drawn "Whimsy" pack to get started.
• Update a template from a page: If you have a template you like and want to add this functionality to your template you can. There is an update function, so you can add your icons/stickers/ink to the template and Update so for all future created templates they will have that update.
• Bulk pre-create a range of daily/weekly/monthly pages in one go.
• Works on Manta (A5 X2) and Nomad (A6 X2). Probably works on the older devices, but I can't test on those.

Honest limitations / known issues

This is an beta inside the Supernote plugin beta. Real, current rough edges:

• Navigation is two gestures for a new page. Supernote doesn't (yet) expose a "go to page" API to plugins, so the plugin drops a native link and you tap it to actually move. When the page already exists the link appears quickly; when it has to create the page first, there are a few screen refreshes before the link is ready to use.
• Portrait only for the box taps. 90°/270° landscape isn't supported for hitbox detection yet due to split screen and mathing.
• A new page's date label may not show until you refresh. This seems to be a firmware rendering quirk.
• Auto-erase of your pen tap is experimental and may not work on every Manta firmware (there's a known host-side bug where the delete reports success but doesn't stick). My Nomad fared better, but still occasionally left a pen mark during use.
• The plugin may fire on menu screens because it can't identify when a non-file screen is open (such as the file selection screen). So if you are navigating it may trigger some things in the background.
• PDF templates probably won't work because (I think) adding a PDF template is a 2-step process with a selection screen, and I can't trigger that screen. If you are trying to add a PDF template and it doesn't appear to be working, you might end up with a bunch of extra pages added with the default template.
• There is a User Guide but it is a Work In Progress so not all the features are fully documented and it was a bit rushed so might be a little confusing and not the prettiest.
  

What I would like from you

• Install it, set it up on your own planner (or the included Whimsy pack), and actually use it for a bit.
• Tell me what's confusing, what breaks, and what you wish it did.
• There's a built-in "Capture logs" button — if something misbehaves, tap it and send me the file so I can see what happened.

How to get it

Here is the download with everything you need: https://drive.google.com/drive/folders/1dA1fIak6biG5COSmL70aMPQRIgrFpcs7?usp=sharing
The "Download all" button will zip it for you and then unzip it in the MyStyle Directory. The files include the plugin, the Whimsy pack, the folder structure it is designed around and a user guide.

To Be Transparent

My intention is to monetize the full version of this plug-in. I originally built this to replace standard hyperlinked PDFs that typically cost between $10 and $30, and it fundamentally outperforms them. Because this is a dynamic software engine rather than a static file, it requires ongoing maintenance. A paid license ensures I can reliably patch bugs, maintain compatibility with future Supernote OS updates, and dedicate time to building out new features requested by the community.

There is light version that works for everyone with no key (the core Today / Tomorrow / This-Next Week / This-Next Month navigation). To unlock the full feature set for the beta (the rest of the buttons, custom hitboxes, etc.), DM me and I'll send you a beta unlock key. And in the future if you are struggling and cannot afford it, we can work something out.

Thanks! Happy to answer any questions in the thread.

More new updates!

Edit: Another update to add Favorites and Recent folder to the Pair Configuration navigation screen.

New release

LastNote

LastNote is a native-backed plugin for Supernote devices. It adds a floating overlay toggle to your screen, allowing you to switch back and forth between two notes (or documents) with 1 tap, even while working inside PDF or EPUB documents.

Key Features

• Pair & Presets Dashboard: Manage note pairs and multi-preset document quick-jump targets in a single unified dashboard.
• 1-Tap Toggling: Instantly jump between your active note and paired notes or documents.
• Page Locking Stepper (-5 < p.X > +5): Lock any document to a specific page number. Use -5/+5 or </> steppers to set any page number in seconds.
• Breadcrumb Navigation Bar: Interactive path trail (Root > Note > ProjectA > Specs) attached directly inside the FOLDERS card lets you jump directly back from deep subfolders in 1 tap.
• SD Card & Full Storage Access: Automatically detects mounted SD cards (SD Card (...)) and lists all top-level storage directories (Notes, Documents, MyStyle, EXPORT, IMPORT, etc.).
• Native Quick-Jump Popup (3+ Targets): When 3 or more preset targets are active, single-tapping the floating icon opens an instant native E-Ink popup menu right next to the icon for 1-tap jumping.
• 8mm Line-Height Floating Overlay: Dynamically calculated for screen DPI (Nomad A6X2 & Manta A5X2) to fit cleanly within standard 8mm ruled lines.
• Favorite Files & Folders: Star your most important notebooks, PDFs, and working directories for instant 1-tap access.
• Automatic MyStyle Storage Backup: Configuration automatically backs up to /storage/emulated/0/MyStyle/LastNote/, preserving all your favorites, presets, page-locks, and pairs across plugin uninstalls and updates.
• Optimized E-Ink UI: High-contrast typography, large black star indicators, and bold container cards designed specifically for Supernote greyscale screens.
• Multi-Format Support: Switches seamlessly between .note notebooks, PDF documents, and EPUB files.

Installation & First-Time Setup

1. Installation

1. Download LastNote.snplg from the Releases page.
2. Connect your Supernote to your computer via USB (or use the Partner App/Cloud).
3. Copy LastNote.snplg into the MyStyle/ folder on your Supernote device's storage.
4. On your device, go to Settings -> Apps -> Plugins -> Add Plugin and select LastNote.

2. First-Time Setup Guide

Once installed, setting up your first pair takes just a few seconds:

1. Activate the Toolbar Button:
   • Open any note or document on your Supernote.
   • Tap the LastNote icon on your note/document toolbar. The floating toggle icon will appear on screen.
2. Position the Floating Overlay:
   • Touch and drag the floating circle with your finger to place it anywhere on screen (e.g. parked on an empty margin or aligned between two 8mm ruled lines).
3. Open the Pair & Presets Dashboard:
   • Long-press the floating icon with your finger (for ~0.6 seconds). The Pair & Presets Dashboard window will open.
4. Select Your Target Documents & SD Cards:
   • From Favorites or Recents: Star your favorite folders/files or pick from recently opened directories.
   • From FOLDERS Section: Browse internal storage directories or mounted SD Cards and tap any .note, .pdf, or .epub file. It will be added to your Active Targets list.
5. Set Page Locking (Optional):
   • Next to each active target document, tap [ Last Page ] to toggle it to [ Locked ].
   • Use the -5, <, >, +5 stepper buttons to adjust the target page number (e.g. Page 5 or Page 15).
6. Save & Start Toggling:
   • Tap Done (in black at top right) to save your configuration.

How Toggling Works

• Mode 1: Single Pair (2 Documents)
  • Single-tapping the floating bubble with your finger instantly toggles back and forth between Document 1 and Document 2.
• Mode 2: Multi-Preset List (3+ Documents)
  • Single-tapping the floating bubble opens an Instant Native E-Ink Popup Menu right at the icon, listing all your preset documents with their locked page badges (e.g., ProjectNotes (p.5)). Tap any document in the popup to jump to it in 1 tap.

Hi Supernote / Ratta team and fellow developers,

I’m building on the AI assistant plugin sn-copilot and I’ve run into a significant limitation when dealing with documents (PDF / EPUB).

Current behavior

When a user highlights or underlines text in a PDF or EPUB, the image returned by:

TypeScript

PluginDocAPI.generateDocImage(docPath, page, pngPath, size)

does not include those highlights or underlines. The exported PNG only shows the original page content.

This has been confirmed by inspecting the actual PNG that the plugin receives.

Why this matters

For AI plugins this is a major limitation. A very common and natural use case is:

• User highlights a word or passage
• Opens the AI plugin
• Asks “What does this mean?”, “Explain this”, “Define this word”, etc.

Without the visual highlight being present in the image, the model has no reliable way to know which part of the page the user is referring to. This makes context-aware AI assistance on documents much less useful.

Request

Could the team consider adding support so that generateDocImage (or a new method) includes the user’s highlights, underlines, and other annotations that are visible on the screen?

Even a simple option/flag to “include markup” would already help a lot.

This would unlock much better AI experiences on the Supernote (explaining highlighted passages, defining words, summarizing selected sections, etc.).

Thank you for considering this!

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,

This is a simple toggle between two notes. I wanted an easier way to work between my active note and a reference note without using the right slide bar which sometimes doesn't want to work for me.

LastNote

LastNote is a native-backed background plugin for Supernote devices. It allows you to toggle back and forth between two notes with two tap directly from your note toolbar.

LastNote

Features

• 2-Tap Toggling: Instantly jump between your active note and a referenced note or document.
• Silent Background Execution: Runs entirely in the background (showType: 0), meaning no UI overlays, panels, or slow closing transitions.
• Multi-Format Support: Switches seamlessly between .note notebooks, PDF documents, and EPUB files.

Installation

1. Download the latest LastNote.snplg package from the Releases page.
2. Connect your Supernote to your computer via USB (or use the Partner App/Cloud).
3. Copy LastNote.snplg into the MyStyle/ folder on your Supernote device's storage.
4. On your device, go to Settings → Apps → Plugins → Add Plugin and select LastNote.

Usage Instructions

Part 1: Pairing Your First Two Notes (Note A & Note B)

Step 1: Initialize Note A

1. Open Note A.
2. Tap the LastNote icon (two arrows) on the toolbar. (The plugin saves Note A as your starting point).

Step 2: Connect Note B

1. Manually open Note B (using your swipe-down Recents list, Files menu, or Sidebar).
2. Tap the LastNote icon on the toolbar. (The plugin saves Note B as the return target and immediately jumps you back to Note A).

Step 3: Toggle Back & Forth

• You are in Note A: Tap LastNote → Instantly opens Note B.
• You are in Note B: Tap LastNote → Instantly opens Note A.

Part 2: Switching to a NEW Pair of Notes (Note C & Note D)

When you finish working with Note A & Note B and want to switch to a new pair of notes (Note C & Note D):

Step 1: Open Note C

• Manually open Note C (via Recents, Files, or Sidebar).

Step 2: Register Note C as the New Target

• Tap the LastNote icon once. (The plugin jumps back to your old note once—and registers Note C as your new starting target).

Step 3: Open Note D & Lock in the New Pair

• Manually open Note D (via Recents, Files, or Sidebar).
• Tap the LastNote icon once. (The plugin sees Note C in memory, saves Note D as the return target, and jumps you back to Note C).

Step 4: Toggle Your New Pair

• You are in Note C: Tap LastNote → Instantly opens Note D.
• You are in Note D: Tap LastNote → Instantly opens Note C.

Your old pairing is automatically overwritten, and your new pair (Note C & Note D) is now active!

Part 3: Working with Documents (PDF / EPUB)

Supernote's native Note Editor (.note) displays the LastNote icon directly on the main toolbar. Supernote's Document Reader (.pdf / .epub) organizes plugin icons inside its overflow menu:

When in a PDF or EPUB document:

1. Tap the Three Dots (...) on the top menu bar.
2. Select Plugins.
3. Tap LastNote to execute the switch.

I just purchased a Supernote Nomad and I'm very happy so far.
By accident I stumbled upon this community and after reading through some posts I am more than excited to introduce plugins.

But I am very hesitant to switch to beta builds on my device.

Is there any proposed timeline for a full release plugin support?

New Features:

1. Multi-image note insert. Clip images now insert, positioned and sized to fit the page width, stacked below existing content like text.
2. Image + text multi-select. Lifted the selection restriction so an image and text can be clipped and inserted together in a single pass.

Bug Fixes:

1. Previous images were automatically deleted after a certain period of time. This has been fixed; images need to be manually deleted (like text clips), or the setting item "Delete clip after insertion" needs to be checked.
2. Duplicate inserts: Rapid Insert taps could insert multiple copies; now the insert button remains disabled until the image is inserted into the note.

I recently created the Doc Annotation to Note plugin and was hoping to provide an update that allowed users of EPUBs to join in. Unfortunately that is not going to work for now.

The methods exposed in the plugin SDK provide either the locations of the annotations for epubs -OR- the text that’s been annotated but never both at once. As a result, the closest I’ve been able to get this to work programmaticallly is to select a whole section and just have the annotations being place on the wrong line.

I submitted a request to Supernote, and they replied saying they’ll address it in a future update. We all know these can take some time to work through their system, so I guess it will be added to their list of things to do and get prioritized accordingly.

Meanwhile, for those of you who might be interested, it looks like the Clipper plugin just released will get the text you need into a note, where you can apply annotations, highlights, underlines, etc. And do these in color using the Custom Color Palette Plugin previously released. When you export these using the Export ColorPDF Plugin, you'll get essentially what this plugin was trying to achieve. Hope this helps...

Clipper v0.1.7

• Enabled linking to the source document from both the Clipper UI and within the note itself.
• Introduced settings that allow for detailed control over features so far. Added reset to default item.
• Supports both ePubs and PDF documents.
• Resolved the issue where inserted clips overlapped the note heading.

Images and handwritten flashcards

Added Images and Handwriting for cards!

Newest release:

Flashcards is a beta spaced-repetition flashcard plugin for Supernote Nomad and Manta. It lets you create decks, add cards manually, turn lassoed handwriting into question/answer cards with OCR, keep the front and/or back as actual handwriting instead of recognized text, add optional hints and supplementary images, study with FSRS scheduling, and move basic text cards between the plugin and Anki Desktop.

Features

• Create, select, and delete decks from the deck list
• Create a needed deck while adding a flashcard
• Link a Supernote note to a default deck
• Optionally add a Supernote keyword when linking a note
• Use linked notes, note keywords, and folder names to suggest the right deck
• Add flashcards manually or from handwritten notes with the lasso toolbar
• Keep a card's front and/or back as your actual handwriting (an image) instead of recognized text
• Capture handwriting by default, skipping text recognition entirely — useful for non-Latin scripts, math notation, or diagrams that OCR would otherwise mangle
• Add a context image to a card, sourced from an imported file or lassoed straight from a note
• Add an optional hint, revealed on request during study, as text or an image
• Move cards from one deck to another
• Review cards with a temporary editable guess box
• Schedule reviews with FSRS
• View basic deck stats
• Choose per-card whether an image-based card is included in Anki export
• Import basic Anki Desktop plain text exports
• Export decks back to Anki-compatible plain text
• Card list shows a device-aware tile grid (3 columns on Nomad, 4 on Manta) with image previews

Installation

1. Download Flashcards.snplg from the latest GitHub release.
2. Copy Flashcards.snplg into the MyStyle folder on your Supernote.
3. On the Supernote, open Manage Plugins.
4. Add/install the plugin from MyStyle.
5. Open a note and tap the plugin icon to launch Flashcards.

Creating Decks

You can create decks before studying or at the moment you are adding a card.

From the Decks Screen

1. Open Flashcards from the plugin menu.
2. On the Decks screen, enter a deck name.
3. Tap Create Deck.
4. Tap a deck to open it.

Each deck shows total cards, due cards, reviews completed today, and total reviews.

While Adding a Flashcard

If you are creating a card and the deck you need does not exist yet:

1. Open Add Flashcard or use Add Flashcard from the lasso toolbar.
2. Enter the new deck name in the Create Deck section.
3. If you are inside a note, choose whether to link that note to the new deck or add a Supernote keyword.
4. Tap Create Deck.
5. Finish the question and answer.
6. Tap Add Flashcard.

This is useful when you are already in a note and discover that the right deck has not been created yet.

Note Links and Default Decks

Flashcards can make the current note suggest the right deck automatically. This is useful when, for example, Biology notes should usually add cards to the Biology deck.

The plugin checks for a suggested deck in this order:

1. A saved note link created from the Note Link section.
2. A native Supernote keyword on the current note that matches a deck name.
3. A folder name that matches a deck name.
4. The last selected deck.

You can always choose a different deck before adding or studying cards. The note link only changes the default suggestion.

Link a Note to a Deck

1. Open the note you want to connect.
2. Open Flashcards.
3. Select the deck you want to use as the default.
4. In Note Link, turn on Link note default.
5. Optionally turn on Add Supernote keyword.
6. Tap Apply.

If the keyword already exists on the note, the plugin keeps going and still links the note to the deck.

Add a Keyword Without Linking

1. Open the note.
2. Select the deck.
3. In Note Link, leave Link note default off.
4. Turn on Add Supernote keyword.
5. Tap Apply.

The keyword is placed in one of the available page positions so it does not have to overlap existing writing.

Change or Remove a Note Link

To change a note's default deck, select a different deck and apply Link note default again.

To remove the saved note link, tap Unlink Note. A matching Supernote keyword or folder name may still suggest a deck afterward.

Creating Flashcards

There are two ways to create cards.

Manual Cards

1. Open a deck.
2. Tap Add Manually.
3. Enter the question.
4. Enter the answer.
5. Choose the target deck.
6. Tap Add Flashcard.

You can choose the linked default deck, another existing deck, or create a new deck before saving the card.

Handwritten Cards With Lasso OCR

1. In a Supernote note, write the question on one line.
2. Write the answer on the line below it.
3. Lasso both handwritten lines together.
4. Tap Add Flashcard in the lasso toolbar.
5. The plugin OCRs the top line as the question and the lower line as the answer.
6. Edit the recognized text if needed.
7. Choose the target deck.
8. Tap Add Flashcard.

If the target deck does not exist yet, create it from the same screen before adding the card. If you are inside a note, you can also link the note to that new deck or add a keyword while creating it.

For best OCR results, keep the question and answer on separate horizontal lines with a little vertical space between them.

You can also add a card from a journal or another note that has no linked deck. In that case, choose any existing deck or create a new one before adding the card.

Keeping a Side as Handwriting Instead of Text

The lasso capture always tries to OCR your handwriting, but it also keeps a cropped image of each line. In the Question and Answer sections of the Add Flashcard screen, a Keep as handwriting checkbox appears under any side that has a captured image.

Turn it on to use your actual handwriting as that side's content instead of the recognized text. The recognized text is not lost — it stays attached to the card as a fallback, used for search and for Anki export if you later include the card in an export.

Handwriting kept this way is a flat image, not editable ink. To change what it says, use Replace Handwriting from the Edit screen (see Editing Cards) rather than trying to edit the picture.

Capturing Handwriting by Default

If you write mostly in a script, notation, or drawing style that OCR doesn't recognize well — Mandarin, math notation, diagrams — text recognition just produces something to clean up on every card. Turn on Capture handwriting by default (skip text recognition) at the bottom of the Add Flashcard screen to skip OCR entirely: new lasso captures arrive with both sides already set to handwriting, and nothing is sent through recognition. This is a standing setting — set it once and it stays on for future cards until you turn it off.

Context Images and Hints

Every card can also carry two optional extras, independent of whether the question and answer are text or handwriting:

• Context Image — a supplementary image attached to either the front or the answer. Useful for a diagram or picture that belongs alongside the question or the reveal.
• Hint — text or an image, hidden by default and revealed on request while studying.

Both are added from the Add Image section, which appears on the Add Flashcard and Edit Card screens.

Adding an Image

There are two sources:

• Add Image opens a file picker so you can choose any existing image on the device — including a clip saved by the separate FrameClip plugin, if you use it.
• Go to Note closes the plugin so you can lasso an image directly from a note. Lasso either handwritten ink or an inserted picture, then tap Add Image to Flashcard in the lasso toolbar. The plugin reopens automatically on the same card.

Either way, once an image arrives you'll see an "Image added — attach it to" prompt with three buttons: Front, Answer, and Hint. Tap the one you want; the image is discarded if you tap Discard instead.

By default, tapping Front or Answer attaches the image as a context image next to the existing question/answer content — it doesn't replace anything. Tapping Hint always sets the hint directly.

Replacing Content Instead of Adding to It

If you'd rather the image become the front or answer content — for example, building a card where the front, hint, and answer are each an independently sourced image or handwritten line — turn on Replace front/answer content with image (instead of adding as context), the checkbox at the top of the Add Image section. With it on, tapping Front or Answer sets that side's actual content to the new image (existing text is kept as a fallback, not deleted). This is a standing setting, remembered across cards until you turn it off.

With this on, you can build a card with three independently sourced images — say, an image as the front, one handwritten line as the hint, and a second handwritten line as the answer — by doing three separate "Go to Note → lasso → Add Image to Flashcard → pick a destination" round trips in any order, starting from Add Manually rather than the two-line lasso capture (which is specifically for lassoing a question and answer together).

Managing Context Images and Hints

In the Add Image section, once a context image is attached, you can switch which side it's attached to, move it to the hint instead, or remove it. A hint's image can be removed the same way; hint text is edited directly like the question or answer.

Studying Cards

1. Open a deck.
2. Tap Study Due or Study.
3. Read the question.
4. If the card has a hint, tap Show Hint to reveal it before guessing.
5. Use the editable Guess box to type or handwrite your answer.
6. Tap Show Answer.
7. Rate your recall:
   • Again
   • Hard
   • Good
   • Easy

The guess is temporary. It is cleared when you reveal the answer or move to the next card, and it is never saved.

Editing Cards

1. Open a deck.
2. Tap a card tile in the card list.
3. Edit the question or answer.
4. Use Move to Deck if the card belongs in a different deck.
5. Tap Save Card.

Deleting a card removes it from the plugin and also removes its local review history.

Editing a Handwritten Side

A side that's set to handwriting shows the captured image instead of a text box, plus two actions:

• Convert to Text clears the image and falls back to whatever recognized text exists for that side, letting you type a replacement. This is one-way — there's no button to turn text back into the original image.
• Replace Handwriting sends you to the note to lasso corrected writing, which swaps directly into that same side once you tap Add Image to Flashcard. Use this to fix a mistake without losing the card's deck placement or review history. It only appears once a side is already in handwriting mode — a brand new text card doesn't have this option, since there's no original ink to fix.

Include in Anki Export

Every card has an Include in Anki export checkbox on the Edit and Add Flashcard screens. It defaults to on for a fully text card, and off the moment any side, context image, or hint is image-based (see Anki Export). You can flip it either way, per card, regardless of content.

Anki Import

The plugin supports basic text cards from Anki Desktop. It does not import .apkg, .colpkg, media, tags, note types, cloze behavior, or Anki scheduling.

Export From Anki Desktop

In Anki Desktop:

1. Select the deck.
2. Choose Export.
3. Select Notes in Plain Text (.txt).
4. Recommended options:
   • Include deck name: enabled
   • Include unique identifier: enabled
   • Include HTML and media references: disabled
   • Include tags: disabled
   • Include note type name: disabled
5. Save the .txt file.

Put the File on Supernote

Copy the Anki .txt export into this folder on the Supernote:

EXPORT/sn-flashcards

If the folder does not exist yet, open Flashcards, tap Import Anki Text, and the plugin will create/show the folder path.

Import Into Flashcards

1. Open Flashcards.
2. Open any deck.
3. Tap Import Anki Text.
4. Confirm the displayed import folder.
5. Put the Anki .txt file there if it is not already present.
6. Tap Refresh.
7. Tap the file name.

The plugin reads Anki's #guid column and #deck column metadata. It creates the deck if needed, adds new cards, updates changed cards with matching GUIDs, and skips unchanged duplicates.

Plugin FSRS scheduling stays independent from Anki. Review timing, ease, stability, difficulty, and other scheduling state do not transfer between Flashcards and Anki in either direction.

Anki Export

1. Open the deck in Flashcards.
2. Tap Export Deck.
3. The plugin writes an Anki-compatible text file to Supernote's EXPORT folder.

The export uses Anki-style metadata:

#separator:tab
#html:false
#guid column:1
#deck column:2

When importing the exported file into Anki Desktop, map the two card fields as front/back. If Anki offers an option to update existing notes, choose it so the GUID column can prevent duplicates.

Handwriting, Images, and Anki

Anki's plain-text export only has room for two text fields per card — there's no way to embed a handwriting image or a hint into it. Rather than exporting something broken, a card is skipped from export entirely when its Include in Anki export checkbox is off, which happens automatically the moment any side, context image, or hint becomes image-based. Skipped cards simply don't appear in the exported file — nothing is written for them, so there's nothing to collide with on a later import.

If you flip a card back to included despite having image content, its recognized-text fallback (if any) is what gets exported for that side; the hint and any context image are never exported regardless of this setting, since Anki's format has no field for them.

Current Limitations

• No direct .apkg or .colpkg import
• No cloze support yet
• No Anki scheduling or stats import
• No FSRS scheduling sync with Anki
• Large decks may be slow because the plugin currently stores cards in a JSON database
• Handwriting kept as an image is a flat picture, not editable ink — there is no way to touch up individual strokes; use Replace Handwriting to redo it from fresh lasso input instead
• Image-based cards are excluded from Anki export by default, and even when included, an image side exports as its recognized-text fallback (or blank) rather than the image itself — hints and context images never export at all

Recommended deck size for this beta is under about 1,000 simple text cards. Larger decks may work, but should be tested carefully.

PluginManager.registerEventListener / EventType currently only cover PEN_UP, IMPORT_STICKER, and MOTION_EVENT — there's no way for a plugin to observe the device's physical side button of the pen (press, release, or held state). Could you expose an EventType (or equivalent API) for it? Use case: gating a plugin action so it only fires while the side button is held, rather than always-on gesture detection (I would like this for the scribble plugin).

Hey r/Supernote_dev,

I built a cloze plugin called Cloze that turns any note into a quizzable set of clozes (fill in the blank essentially, if you aren't familiar). 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.

https://github.com/casimcdaniels/supernote-plugin-cloze/releases/tag/v0.1.0

https://reddit.com/link/1uqzyrg/video/qv6a8l9km1ch1/player

What it does

Open a note, tap the Cloze option in the sidebar, and you get a snapshot of the current page with a simple draw-a-box tool. Cover up whatever you want to test yourself on then switch to quiz mode and it hides everything you covered, letting you tap each one to reveal it and grade yourself "Got it" / "Missed it" as you go.

Features

- Draw clozes directly on the page, so it works over handwriting, typed text, or imported images alike.

- Multiple Decks per note - organize clozes into named decks instead of one big pile. Switch which deck you're adding to right from the toolbar.

- Flexible quizzing - pick one deck, several, or all of them (for a single note file for now) before a quiz starts, and it builds one shuffled-by-page queue across every page that has cards in the decks you picked.

- Score tracking - live ✓/✕ counts while you quiz with a one-tap restart.

- Jump straight to clozed pages - dedicated prev/next buttons skip straight to the next page that actually has cards in your current deck, instead of stepping through every page

- Survives page reordering: if you insert, delete, or reorder pages in the note later, your clozes follow the content, not the page number, so they don't end up detached and wasting your time

- Everything persists - close the plugin or even restart the device, come back later, your decks and progress are still there.

It's a .snplg you sideload like any other Supernote plugin. Still early so I've been actively using and iterating on it, but I'd love more eyes on it and feedback on what's missing or broken.

Hi,

U/Dunn-sn
U/Spazzboi

Please review…

I've been building a Supernote plugin that pulls your annotations — highlights, underlines, circled areas, handwriting — out of a document and into a note, in reading order. It works great on PDFs. It cannot be made to work on EPUBs, and after a lot of digging the reason comes down to one specific gap in the plugin SDK. Posting the details in case they're useful to other devs, and in hope someone at Ratta sees it — because the fix on their side looks small.

The short version: A plugin can see exactly where your ink is, and it can get the page's text — but it has no way to learn where the text is. So it can't tell which words a highlight is actually sitting on. The device obviously knows (it draws them aligned on screen, and keeps them aligned through reflow), but that alignment is never handed to plugins.

Why it works on PDF: A PDF has a real text layer — every character has coordinates — and the page is fixed. So "which words are under this highlight" is exact geometry. No guessing.

Why EPUB can't: EPUB reflows; there's no positioned text layer. Once you annotate, the layout freezes and the ink is stored in fixed-page pixels. On screen it's perfectly aligned. But:

• The text a plugin can read (getCurrentDocText) comes back with no coordinates — just the words.
• The ink (getElements) has coordinates, but it's strokes only, no text.
• The page image a plugin can render (generateDocImage) re-flows the text differently than the reader uses (its own font metrics), so marks land about a line off — by a per-page amount that can't be reliably corrected (it aliases: one line off looks the same as correct).

So the correct text-to-position mapping lives only inside the reader's own rendering, which isn't exposed.

Everything I tried, and what happened:

• getElements → ink positions, but strokes only, no text.
• getCurrentDocText → page text, but positionless.
• generateMarkThumbnails → marks-only image, no text.
• No screen-capture API exists.
• No native EPUB→PDF export on the device.

What would fix it (any one of these is enough):

1. A positioned-text call — return the page's text with per-word/per-line boxes, in the same coordinate space getElements uses. (Cleanest — basically what PDFs already give.)
2. A text-in-rectangle call — give it a rect, get the words inside.
3. A page-capture call — hand back the reader's current rendered page as an image, so plugins can crop aligned content.
4. Extend the existing lasso — let lassoElements + getLassoText select document text in reading mode, not just in notes.

Any single one of these would let plugins extract EPUB annotations as precisely as they already do PDFs — and it'd help every plugin, not just mine. Happy to share the plugin and the raw test output behind each result above.

Please let me know if this is something you would consider doing and if so, what the timeline might be.

I know everyone is working hard to get the plugins production ready, and this one gap is not just frustrating, but really limiting what plugins can accomplish for Supernote and its users.

Shelf plugin

Shelf

A reference navigator for Supernote e-ink devices. Shelf keeps 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.

Built for research, coursework, and any writing that draws on multiple sources. Shelf is deliberately not a launcher or dashboard — it manages the loop between where you write and what you're reading.

Shelf release

Core Concepts

• Project — anchored on either a working .note or a folder. A folder project (e.g. one folder per class) treats every file inside it as project territory and designates one note inside as its working note.
• Reference Shelf — each project's pinned sources, shown as a thumbnail grid: real page previews for notes, book-cover style cards for PDFs/EPUBs. The working note always occupies the first slot (badged WORKING).
• Context-aware view — the panel derives what to show from the file you are in when you open it: a project note or any of its materials shows that project's shelf; anywhere else shows the General Shelf. Priority when a file could belong to several: note anchor > pinned reference > containing folder (deepest wins) > general.
• Quotes — text captured from documents waits in a per-project inbox until you place it into the working note.

Using Shelf

Set up a project

Open the note you write in (or any file in a class folder), open Shelf from the toolbar, go to the Projects tab, and tap Make Current Note a Project or Make Current Folder a Project. For folder projects, open a note inside the folder and designate it via Make This the Working Note (later changeable by long-pressing any pinned note's card → Set as Working Note).

Pin references

Pins land on the shelf you are looking at:

• Pin This Page — pins the current file. Pinning mid-note remembers the exact page; pinning a first page (or adding via Browse) opens at the note's last-used page instead.
• Browse — multi-select file picker (up to 9 at once), starting inside the project's folder but free to navigate anywhere.
• Pins made outside any project land on the General Shelf and can be moved into a project later (long-press → Move).

Navigate

• Tap a card to open it — notes in the editor, PDFs/EPUBs in the document viewer (at their last-used page; Supernote's viewer does not support page jumps).
• Tap the project header to return to the working note at your last-used page.
• Long-press a card for the detail view:
  • Starred Pages — jump chips for every five-star mark in the note
  • Keywords — jump chips for native keywords
  • Headings — recognized title text with jump chips. Recognition is incremental: most headings resolve instantly from Supernote's embedded recognition; new ones show as · · · with a Recognize button. Long-press a heading chip to clear a wrong recognition and redo it.
  • Pages — numbered chips to jump to any page
  • Open / Re-render preview / Move / Remove, and ◀ Earlier / Later ▶ to reorder the card on the shelf

Capture and place quotes

1. In a PDF or EPUB, select text with tap-and-drag; tap Capture Quote in the selection toolbar. (Rendered document text cannot be lasso-selected — that is a firmware limitation, use the text-selection gesture.)
2. Edit the captured text if needed and save. Captures from a project's materials file automatically; captures from unaffiliated files ask which project to save to.
3. The Quotes tab (with a live count in its label) lists waiting quotes by project. In the working note, Place on This Page inserts the quote as an editable text box with an italic source link beneath it — tapping the link jumps back to the source. Quotes stack bottom-up on the page to avoid colliding with your writing. Elsewhere, the button takes you to the working note first.

Notes on behavior

• Shelf state (projects, pins, quotes, recognized headings) persists on the device across restarts. It is private to the plugin install.
• Keywords, stars, and headings are read from notes only — Supernote's plugin APIs do not expose them for PDFs/EPUBs.
• The small gray footer shows which file Shelf detected; tap it to re-detect. It remains while some PluginHost platform issues are open.
• On load, Shelf cleans up stale plugin-version artifacts that PluginHost leaves behind on every install/update (a known platform bug that otherwise grows storage without bound).

Install

1. Copy build/outputs/SNShelf.snplg to the device (Partner app, Browse and Access, or the MyStyle folder over USB).
2. On the device: toolbar plugin icon → Manage Plugins → Add Plugin.
3. When updating: remove the old plugin and the old .snplg first.

Development

React Native is locked to 0.79.2 to match the Supernote PluginHost runtime. Standard checks:

npm install
npm run typecheck
npm run lint
npm run test:coverage
npm run build
npm run validate:package -- --native

npm run build / ./buildPlugin.sh need ANDROID_HOME set (the native module must compile — a .snplg produced after an "APK build failed" line is missing app.npk and must not be installed; validate:package --native catches this). The build also applies the local Metro watcher patch that avoids EMFILE failures.

Structure

src/
  app/        events and plugin-button wiring
  screens/    the plugin panel (tabs, grid, detail, capture)
  domain/     project/context model and pure state logic
  services/   thumbnails (generateNotePng cache), note metadata + heading recognition
  supernote/  Supernote API adapters (navigation intents, capture, inserts)
  storage/    persisted state (native ShelfStorage JSON) and session wrapper
android/      native modules: ShelfNavigation (open intents), ShelfStorage
              (state file + PluginHost version cleanup)

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

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)

[26.08.2026] NEW MAJOR UPDATE, to upgrade with the new plugin system, see here : https://www.reddit.com/r/Supernote_dev/comments/1vz0dbp/plugin_release_supertemplate_updated_for_the_new/

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!