Skip to main content

An unofficial converter library for Ratta Supernote

Project description

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.23.36)
  • *.note file created on Supernote A5X (Firmware Chauvet 2.23.36)
  • *.note file created on Supernote A6X2 (Firmware Chauvet 3.25.39)
  • *.note file created on Supernote A5X2 (Firmware Chauvet 3.25.39)

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

supernotelib-0.7.0.tar.gz (27.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

supernotelib-0.7.0-py3-none-any.whl (38.7 kB view details)

Uploaded Python 3

File details

Details for the file supernotelib-0.7.0.tar.gz.

File metadata

  • Download URL: supernotelib-0.7.0.tar.gz
  • Upload date:
  • Size: 27.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.3

File hashes

Hashes for supernotelib-0.7.0.tar.gz
Algorithm Hash digest
SHA256 78d832a5b6d619b3a6f5b8f8341ebdc9348cb01e5b4a3b1c19756a53ca84ca39
MD5 24b57099bda1882032965b5941ad92ab
BLAKE2b-256 ac1b3c46ce33d37c33cadabc3acae510f6fd666fa9e85b5d9bce6d20e2d36288

See more details on using hashes here.

File details

Details for the file supernotelib-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: supernotelib-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 38.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.3

File hashes

Hashes for supernotelib-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5ae5175c1464ebad43f1105866c0c7aa82c76395e4a39625227921613ccdcf0f
MD5 f1aac0caffc3d54466d885b34cb84688
BLAKE2b-256 ce349b2f2d7d619550f388e8a98909fbd7b57f238f238fe4b6cf01424018e85a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page