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

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.6.4.tar.gz (26.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.6.4-py3-none-any.whl (37.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: supernotelib-0.6.4.tar.gz
  • Upload date:
  • Size: 26.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.6.4.tar.gz
Algorithm Hash digest
SHA256 8b6500429d5625f9363cc83be1ae75987c3900e46b5ef4173d74d9af1227821c
MD5 cb3283c7e39c5349e9ee56d7c238d438
BLAKE2b-256 893f381f143b389a5b4aa090d89fd5511026ec0953b1923b47c6aab4037a7714

See more details on using hashes here.

File details

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

File metadata

  • Download URL: supernotelib-0.6.4-py3-none-any.whl
  • Upload date:
  • Size: 37.5 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.6.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a57745b6f9b54d08cc84850d12d83b9ea47253469056bf9bc2db0ce27240e98d
MD5 e446b3bebcc72c465aa80c52603b2a76
BLAKE2b-256 ab6f4a138d701673b48b17a2bbf502f5fe238d0a4236efb16b9ac1f1139801e4

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