super-supernote

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

super-supernote

★ 33 Open GitHub ↗

Tools to make Supernote devices even more super

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Super-Supernote
This is a collection of tools, scripts, and guides to make Supernote devices even more super.

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J6BINRX)

## Table of Contents

* [Tips and Tricks](#tips-and-tricks)
* [Good to Know](#good-to-know)
* [Tools](#tools)
* [Templates](#templates)
* [Planners](#planners)
* [Sideloading Apps](#sideloading-apps)
* [Supernote Private Cloud](#supernote-private-cloud)

## Tips and Tricks

[How to Create a Home Page](tips-and-tricks/how-to-create-a-home-page.md)

Supernote devices are notorious for not having a "home button" but that doesn't meant you can't create your own home page.

## Good to Know

**Wi-Fi** on Supernote devices does not support WPA3. If you can't connect to a WiFi access point, check if it is using WPA3. This is a serious security concern and Ratta should address this.

**PDF Templates** cannot be assigned to a note when creating the note file. However, you can create the note file and then change the template it is using to a PDF template.

## Tools

[supernote-tool](https://github.com/jya-dev/supernote-tool) (Python)

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.

[PySN](https://gitlab.com/mmujynya/pysn-digest) (Python)

PySN builds on supernote-tool and provides additional functionality like OCR and LLM processing of hand-written notes. Documentation is scant.

[supernote-typescript](https://github.com/philips/supernote-typescript) (TypeScript)

Heavily inspired on supernote-tool and provides similar functionality

[snpvclient](https://github.com/camerahacks/sn-private-client) (Python)

Supernote Private Cloud Python Client. Main use is to automatically upload files to your private cloud instance.

## Templates

[Supernote official documentation](https://support.supernote.com/en_US/faq/how-to-create-a-custom-note-template) on how to create a note template.

[eInk Template Gen](https://github.com/calebc42/eink-template-gen)

A device-agnostic command-line tool for generating mathematically balanced, pixel-perfect page templates for e-ink devices. Developed with the Supernote Manta, this tool supports millimeter or pixel specifications for human-readable, technically-precise, or true-scale template configurations.

Use this tool to create templates for any eInk device.

## Planners

[Remarkbly Organized](https://remarkably-organized.pages.dev/)

Free tool that lets you customize and download .PDF calendar planners.

## Sideloading Apps

Follow the [How to Sideload Apps](/tips-and-tricks/how-to-sideload-apps.md) guide to make your Supernote device even more super.

### Tested Apps

This is a list of apps I have used on my Supernote device and provide good functionality.
Please do your due diligence before downloading and sideloading apps to your device. You can introduce malicious software to your device if you are not careful.

This list will grow as I test more apps.

* [EinkBro](https://github.com/plateaukao/einkbro) - Lightweight, but full featured, web browser designed to work well with eInk devices.
* [F-Droid](https://f-droid.org/en/) - Android App store for Free and Open Source Software (FOSS)

## Supernote Private Cloud

Ratta offers free cloud service to sync notes between Supernote devices and partner apps. They also offer a Private Cloud Docker image so you can self-host a cloud sync service for Supernote devices.

Here is a guide I put together on how to get it up and running.

> [!NOTE]
> This guide assumes you are already running a Linux server and that you have some technical knowledge (or the patience) to troubleshoot a web application.
> Everyone's setup is different and this guide might not work for everyone.

[Supernote Private Cloud Helper Guide](private-cloud/README.md)

You can use the Supernote Private Cloud Python Client library to connect, upload and manage files using your private cloud instance.

[Supernote Private Cloud Python Client](https://github.com/camerahacks/sn-private-client)

super-supernote

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README