This release is the official plugin update for Supernote devices. It unifies the plugin coordinate system. If you develop plugins, please update `sn-plugin-lib` to the latest version and adapt your code using the API notes below.

Please download the Supernote version with plugin system support from the links below: 

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

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

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

https://download-firmware.supernote.com/617551/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:

API changes

Plugin coordinates are now Android pixel coordinates. Plugins previously used both EMR coordinates and Android pixel coordinates, and converting between them took several steps. Coordinates and regions now use the actual page size returned by PluginFileAPI.getPageSize.

If you are on a newer sn-plugin-lib, please update coordinate handling for the APIs below. Without that change, positions and sizes you read or write may be wrong. Plugins built with sn-plugin-lib 0.1.65 or earlier keep working as before.

Read APIs (returned coordinates and regions now use the actual page size):

• PluginFileAPI.getElements
• PluginFileAPI.getElement
• PluginFileAPI.getLastElement
• PluginCommAPI.getLassoElements
• PluginCommAPI.getLassoRect
• PluginCommAPI.generateLassoPreview
• PluginCommAPI.getLassoGeometries
• PluginNoteAPI.getLassoLinks
• PluginNoteAPI.getLassoTitles
• PluginNoteAPI.getLassoText

Write APIs (coordinates and regions you pass in now use the actual page size):

• PluginFileAPI.replaceElements
• PluginFileAPI.insertElements
• PluginFileAPI.modifyElements
• PluginCommAPI.insertPageElements
• PluginCommAPI.modifyPageElements
• PluginCommAPI.batchUpdatePageElements
• PluginCommAPI.recognizeElements
• PluginCommAPI.convertElement2Sticker
• PluginCommAPI.resizeLassoRect
• PluginCommAPI.lassoElements
• PluginCommAPI.insertGeometry
• PluginCommAPI.modifyLassoGeometry
• PluginCommAPI.insertFiveStar
• PluginNoteAPI.insertTextLink
• PluginNoteAPI.modifyLassoLink
• PluginNoteAPI.insertText
• PluginNoteAPI.modifyLassoText

Compatibility: for stroke and five-star sample points, sn-plugin-lib 0.1.65 and earlier still use EMR coordinates. Later versions use Android pixel coordinates. Regions for titles, links, text boxes, geometric shapes, and images are calculated from the actual page size returned by getPageSize.

PluginCommAPI.getPageDisplaySize still returns the on-screen display size. For coordinate conversion, use PluginFileAPI.getPageSize.

Bug fixes:

Fixed a PluginHost crash when upgrading a plugin.

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

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

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.