https://github.com/allenporter/home-assistant-supernote-cloud
Home Assistant Custom Component for to the excellent Ratta Supernote products
https://github.com/allenporter/home-assistant-supernote-cloud
home-assistant supernote
Last synced: 4 months ago
JSON representation
Home Assistant Custom Component for to the excellent Ratta Supernote products
- Host: GitHub
- URL: https://github.com/allenporter/home-assistant-supernote-cloud
- Owner: allenporter
- License: apache-2.0
- Created: 2024-09-30T02:17:17.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-08T20:50:23.000Z (4 months ago)
- Last Synced: 2026-02-08T22:33:24.885Z (4 months ago)
- Topics: home-assistant, supernote
- Language: Python
- Homepage:
- Size: 896 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# home-assistant-supernote-cloud
Home Assistant Custom Component for accessing your Supernote Private Cloud instance. This is meant work with the excellent Ratta Supernote products.
This custom component authenticates with your local private cloud server
and provides access to the contents of your notebooks through the media
player.
The motivation is to use with [Journal Assistant](https://github.com/allenporter/home-assistant-journal-assistant) and [Supernote LLM](https://github.com/allenporter/supernote-llm/).
## Media Source
Notebooks are exposed as a [Media Source](https://www.home-assistant.io/integrations/media_source/). This can be
used to browse contents of the notebooks and view notebook pages as `.png` files. The media source
will query the Supernote Private Cloud API to look for backups and let you
browse them directly.
## Development
The client library used for accessing Supernote Contents:
- http://github.com/allenporter/supernote-lite/
With prior art from these libraries:
- https://github.com/bwhitman/supernote-cloud-python/
- https://github.com/adrianba/supernote-cloud-api/
- https://github.com/colingourlay/supernote-cloud-api/
## Local Development
### Pre-requisites
```bash
$ script/bootstrap
$ script/setup
```
### Run Home Assistant
From then on run home assistant:
```bash
$ script/server
```