Supernote Upload

Upload documents to Supernote Cloud for syncing to your Supernote device.

Prerequisites Check

Before uploading, verify the supernote CLI is installed:

command -v supernote >/dev/null 2>&1 && echo "installed" || echo "not installed"

If not installed, install it:

pip install ~/hn2supernote/supernote_uploader

Authentication Check

Verify authentication by listing the root folder:

supernote ls / 2>&1 | head -5

If this fails or prompts for credentials, the user needs to login first:

supernote login

After login, credentials are cached and subsequent commands work without prompting.

Uploading Files

Single file to Inbox (default)

supernote upload /path/to/document.pdf

Single file to specific folder

supernote upload /path/to/document.pdf --folder /Documents/Books

Multiple files

supernote upload file1.pdf file2.pdf --folder /Inbox/Articles

Glob patterns

supernote upload *.pdf --folder /Documents

Other Commands

List folder contents

supernote ls /Inbox

Create folder

supernote mkdir /Documents/NewFolder --parents

Supported File Types

• PDF (.pdf)
• EPUB (.epub)

Guidelines

1. Always check if supernote is installed before attempting to upload
2. If authentication fails, prompt the user to run supernote login
3. Default upload location is /Inbox if no folder is specified
4. Use --folder to specify a custom destination
5. Create folders with --parents flag to create intermediate directories
6. Report success/failure clearly to the user