Skip to main content

supernote-tool

supernote-tool is an unofficial python tool for Ratta Supernote. It allows converting a Supernote's *.note file into PNG image file without operating export function on a real device.

This tool is under development and may change.

Installation

$ pip install supernotelib

Usage

To convert first page of your note into PNG image:

$ supernote-tool convert your.note output.png

To convert all pages:

$ supernote-tool convert -a your.note output.png

If you want to specify page number to convert:

$ supernote-tool convert -n 3 your.note output.png

You can colorize a note by specifing alternative color codes in order of black, darkgray, gray and white. Note that use #fefefe for white because #ffffff is used for transparent.

To convert black into red:

$ supernote-tool convert -c "#ff0000,#9d9d9d,#c9c9c9,#fefefe" your.note output.png

To convert into SVG file format:

$ supernote-tool convert -t svg your.note output.svg

To convert all pages into PDF file format:

$ supernote-tool convert -t pdf -a your.note output.pdf

You can also convert your handwriting to vector format and save it as PDF with --pdf-type vector option. Note that converting to a vector takes time.

$ supernote-tool convert -t pdf --pdf-type vector -a your.note output.pdf

To extract text from a real-time recognition note introduced from Chauvet2.7.21:

$ supernote-tool convert -t txt -a your.note output.txt

You can specify a page separator string for text conversion:

$ supernote-tool convert -t txt -a --text-page-separator='----' your.note output.txt

You can also specify number of cpu threads used using --workers or -j (speeds the conversion up a little):

$ supernote-tool convert -t pdf -a -j 15 your.note finmat2.pdf

The default setting uses up to 8 threads.

For developers, dump note metadata as JSON format:

$ supernote-tool analyze your.note

Supporting files

  • *.note file created on Supernote A5 (Firmware SN100.B000.432_release)
  • *.note file created on Supernote A6X (Firmware Chauvet 2.25.39)
  • *.note file created on Supernote A5X (Firmware Chauvet 2.25.39)
  • *.note file created on Supernote A6X2 (Firmware Chauvet 3.28.42)
  • *.note file created on Supernote A5X2 (Firmware Chauvet 3.28.42)

License

This software is released under the Apache License 2.0, see LICENSE file for details.

Metadata

Release files for supernotelib 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for supernotelib 0.7.2
File Size Uploaded
supernotelib-0.7.2.tar.gz 28.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for supernotelib 0.7.2
File Interpreter ABI Platform
supernotelib-0.7.2-py3-none-any.whl Python 3 none any Details

Total release size: 66.7 kB

Release files / supernotelib-0.7.2.tar.gz

Download URL supernotelib-0.7.2.tar.gz
Size 28.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1c03c398de8ed7353b297e826db69fa37201f976795af41882dddc826d8fafff
BLAKE2b-256 checksum
How to use checksums
a81c10eccbf560dd8b2572734b5a165ff11c08ba503d5bf77a7fb493b313961f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / supernotelib-0.7.2-py3-none-any.whl

Download URL supernotelib-0.7.2-py3-none-any.whl
Size 38.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
36e25a6286265afd34cf8392c04e4cc632f845746aa4dfb8ed2b2e47f0fe1b55
BLAKE2b-256 checksum
How to use checksums
802b1c0049ceba3f50b1eafe0d1e699ae7e258b7d27349347480e38f3d7ebd51
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

0.7.3

2 release files

This release

0.7.2 This release

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page