supernote
Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.
Quellinformationen
- Repository
- Kernel8901/ai-agent-skills-classification
- Letzte Quellaktivität
- 4. April 2026 um 15:26
- Erkannte Sprache von SKILL.md
- Englisch
- Sterne
- 6
- Forks
- 1
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Datei-Explorer
4 DateienSKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- name
- supernote
- description
- Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.
# Supernote Private Cloud
Browse, upload, and manage files on a self-hosted Supernote Private Cloud via its reverse-engineered REST API. Includes article-to-ebook conversion for sending web content to the device.
## Setup
```bash
export SUPERNOTE_URL="http://192.168.50.168:8080"
export SUPERNOTE_USER="your@email.com"
export SUPERNOTE_PASSWORD="your_password"
```
Python dependencies (for article conversion): `readability-lxml`, `ebooklib`, `requests`, `beautifulsoup4`, `lxml`.
## Commands
### Send a web article to the device
```bash
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format epub --dir-path Document
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format pdf --dir-path "Document/Articles"
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --title "Custom Title" --dir-path Document
```
Fetches article content, extracts readable text with images, converts to clean EPUB or PDF, then uploads to the specified folder. Default format: epub. Default folder: Document.
### List directory contents
```bash
{baseDir}/scripts/supernote.sh ls
{baseDir}/scripts/supernote.sh ls --path Document
{baseDir}/scripts/supernote.sh ls --path "Note/Journal"
{baseDir}/scripts/supernote.sh ls --dir 778507258886619136
```
### Directory tree
```bash
{baseDir}/scripts/supernote.sh tree --depth 2
```
### Find directory ID by path
```bash
{baseDir}/scripts/supernote.sh find-dir --path "Document/Books"
```
### Upload a file
```bash
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document
{baseDir}/scripts/supernote.sh upload --file /path/to/book.epub --dir-path "Document/Books"
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir 778507258773372928 --name "Renamed.pdf"
```
### Check storage capacity
```bash
{baseDir}/scripts/supernote.sh capacity
```
### Login (manual)
```bash
{baseDir}/scripts/supernote.sh login
```
## Default Folders
| Folder | Purpose |
|--------|---------|
| Note | Handwritten notes (.note files) |
| Document | PDFs, EPUBs, documents |
| Inbox | Incoming files |
| Export | Exported content |
| Screenshot | Screenshots |
| Mystyle | Custom styles/templates |
## Notes
- EPUB is recommended for articles — renders cleanly on e-ink with reflowable text
- The API is reverse-engineered and unofficial — endpoints may change with firmware updates
- Directory args accept paths (e.g., "Document/Books") or numeric IDs
- Some sites block scraping — if fetch fails, try a different URL or use a cached/saved page
Auf GitHub ansehen