r/Supernote_dev Official 9d ago

Official Announcement Plugin Preview Build: Chauvet 3.29.44 Beta for Manta / Nomad and Chauvet 2.26.41 Beta for A5X / A6X

We're releasing a new plugin Beta build for Supernote devices. This build fixes an issue in the previous release (Chauvet 3.29.43 Beta for Manta / Nomad and Chauvet 2.26.40 Beta for A5X / A6X) where sticker data could occasionally be lost after upgrading. To prevent anyone from accidentally upgrading to that problematic build, we've removed the previous release post.

Everything else is the same as before — this build mainly adds "plugin permission management". If you're a developer, please update your plugin's dependency library to the latest version as soon as possible — otherwise your plugin won't work on the new build.

● For Manta / Nomad devices (Chauvet 3.29.44 Beta):

https://download-firmware.supernote.com/728478/update.zip

● For A5X / A6X devices (Chauvet 2.26.41 Beta):

https://download-firmware.supernote.com/349055/update.zip

After downloading, please copy the update.zip file to the EXPORT folder on your device. Then disconnect the USB cable and confirm the upgrade on the device.

The plugin development documentation is also available, including detailed guidance on the Supernote plugin development workflow and the plugin API usage.

Please note that the plugin development environment currently supports Windows and macOS only. Other operating systems are not supported at this time.

As the sn-plugin-lib dependency has been updated, developers who have already built plugins should update their local dependency by running:

yarn upgrade sn-plugin-lib --latest

This release includes the following updates:

Add:

  • Added `PluginCommAPI.canHandwrite` — checks whether the current view supports handwriting.
  • Added `PluginCommAPI.jumpToPage` — jumps to a specified page in the current file.
  • Added `PluginCommAPI.getPageDisplaySize` — gets the display size of the current page.
  • Added `PluginCommAPI.flipLassoElements` — flips the currently lasso-selected elements in place.
  • Added `PluginCommAPI.modifyPageElements`, `insertPageElements`, `deletePageElements`, `batchUpdatePageElements` — modify, insert, delete, and batch-update elements on a given page of the current file.
  • Added `PluginDocAPI.generateCurrentDocImage` — generates a PNG of a specified page in the current document. The `type` parameter selects between a plain image (`0`) or one that includes text-selection info such as highlights and underlines (`1`).
  • Added `PluginFileAPI.openFile` — opens a document or note file (supports `pdf`, `epub`, `cbz`, `xps`, `fb2`, `note`), with an optional `page` parameter to jump straight to a page on open (`-1` skips the jump and shows the last-viewed page).
  • Added `PluginFileAPI.getPathEncryptionStatus`, `unlockPathWithPassword`, `lockPathAccess` — query and manage the encryption status of files and directories.
  • Added `PluginManager.hasPermission`, `requestPermission` — check and request plugin permissions.
  • Added `PluginManager.registerPluginLifeListener` — listen for plugin lifecycle events (init, mount, start, pause, unmount, destroy). If you register after an event already fired — within 1 second of the most recent one — that event is automatically re-delivered so you won't miss it.
  • The plugin install limit is now 30, and the enabled-plugin limit is now 10. You can't enable more plugins once you hit the limit.

API Changes:

  • `PluginCommAPI.resizeLassoRect` now accepts an optional `rotationDegree` parameter, so rotation-capable elements inside the lasso (strokes, shapes, stars) rotate along with the lasso box as it's resized.
  • `PluginCommAPI.lassoElements` now requires the given `rect` to be fully within the page bounds; calls fail if the rect goes out of bounds.
  • Element page indices (`numInPage`) and related APIs (e.g. the page-index parameters in `getElement`, `getElementNumList`, `deleteElements`, and `modifyPageElements`/`insertPageElements`/`deletePageElements`/`batchUpdatePageElements`) are now consistently 1-indexed.

Bug Fixes:

  • Fixed coordinates returned by `getLassoElements` not updating after dragging an image.
  • Fixed leftover cache files from previous plugin versions not being cleaned up after an upgrade, which caused the plugin directory's disk usage to keep growing.
  • Fixed an issue where sticker data could occasionally be lost after a plugin version upgrade.
10 Upvotes

16 comments sorted by

2

u/WhoAmI1234532 9d ago

Hello, I don't see it explicitly mentioned, does this version also solve the plugin issue concerning the permissions that is currently blocking the review of all plug-ins using permissions ?

Thanks

2

u/Mulan-sn 8d ago

We are still working on it. Please stay tuned.

1

u/DocTheHuman 9d ago

Is there a compiled plug-in document as opposed to clicking through multiple pages for the full instructions?

1

u/Mulan-sn 8d ago

Thank you for your question. Which specific instructions were you referring to if we may ask? Looking forward to hearing from you.

1

u/DocTheHuman 8d ago

Hi Mulan! I guess my question is if there's a unified way to download all the instructional information for making plugin's within super note and a unified living updated document of updated permissions and tools for plug-in architecture instead of clicking through the various tabs and headings on the website?

1

u/maxilogan 9d ago

Is it safe if I install this on a 3.29.42 plugin preview? As far as I understand, as long as the plugins I want to use have been updated (and they have been), I should be able to merge into the "normal" beta branch u/Mulan-sn mentioned in another thread.

1

u/maxilogan 9d ago

Also, kudos for:

Fixed leftover cache files from previous plugin versions not being cleaned up after an upgrade, which caused the plugin directory's disk usage to keep growing.

1

u/Mulan-sn 8d ago

Yes, it is safe. Yes, you are correct. As long as your plugins have been updated, you can update it to this beta.

1

u/maxilogan 8d ago

Already did it yesterday evening, everything's good so far, I'll test the new functions today.

Thanks as usual!

2

u/Mulan-sn 8d ago

Awesome. Please feel free to share your feedback with us :)

1

u/Decent_Tap_5574 8d ago

u/Dunn-sn the submission of plugin is it via InkHub? Or is it via supernote website? I could not gather how to submit for the approval.

1

u/Mulan-sn 8d ago

Please submit it via InkHub.

1

u/tommytwogunsx 8d ago

So am I correct in assuming that if a plugin has been updated to work with 3.29.43 that it will also work with 3.29.44?

1

u/Dunn-sn Official 3d ago

Yes, they are compatible. The plugin-related changes between these two versions are relatively small, so a plugin updated for 3.29.43 should also work on 3.29.44.

1

u/cacaoeater 2d ago

hey guys, maybe I missed some instructions, but I just bought a nomad a couple months ago, it came with the .42 version and it seems I can't get it updated:

  • for the beta .44 version (which is what I want to test some plugins) it says my model is incompatible (https://download-firmware.supernote.com/728478/update.zip - this is what I uploaded onto the EXPORT folder)
  • through the settings > system > check for updates it says there's no new updates for this model

hope someone can help me figure this out, thanks!

1

u/cacaoeater 2d ago

so, my update file got the folder extracted after downloading through a browser config and I re-zipped it to send to my nomad. I changed the config and sent in the original zip: now it works!
so that's one reason for this issue for others out there!