https://github.com/erikbrinkman/rmapi-js
JavaScript implementation of the reMarkable api
https://github.com/erikbrinkman/rmapi-js
remarkable-tablet typescript
Last synced: 3 months ago
JSON representation
JavaScript implementation of the reMarkable api
- Host: GitHub
- URL: https://github.com/erikbrinkman/rmapi-js
- Owner: erikbrinkman
- License: mit
- Created: 2022-04-18T15:42:05.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-02-12T03:13:41.000Z (5 months ago)
- Last Synced: 2025-04-02T16:24:41.298Z (3 months ago)
- Topics: remarkable-tablet, typescript
- Language: TypeScript
- Homepage: https://erikbrinkman.github.io/rmapi-js/modules.html
- Size: 6.26 MB
- Stars: 41
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# rmapi-js
[](https://github.com/erikbrinkman/rmapi-js/actions/workflows/build.yml)
[](https://erikbrinkman.github.io/rmapi-js/modules.html)
[](https://www.npmjs.com/package/rmapi-js)
[](LICENSE)
JavaScript implementation of the reMarkable api. It should also be pretty easy
to customize to work with
[rmfakecloud](https://github.com/ddvk/rmfakecloud), although that might take a
little bit of extra plumbing.
## API
Before using this API it's necessary to have some rudimentary understanding of
how the API works.
All data is stored via its sha256 hash. This includes raw files ("documents")
and folders ("collections"). The hash indicates the full current state to manage simultaneous edits. Most entries or edits will take an input hash, and return an output hash. Additionally, every entry has an id, which is a uuid4, and remains constantant over the lifetime of the file or folder. There are two special ids, "" (the empty string) which corresponds to the root collection, e.g. the default location for all files, and "trash", which is the trash.
## Usage
To explore files in the cloud, you need to first register your api and persist
the token. Then you can use `listFiles` to explore entries of different file
collections.
```ts
import { register, remarkable } from "rmapi-js";
const code = "..."; // eight letter code from https://my.remarkable.com/device/desktop/connect
const token = await register(code);
// persist token so you don't have to register again
const api = await remarkable(token);
const fileEntries = await api.listFiles();
```
To upload an epub or pdf, simply call upload with the appropriate name and buffer.
```ts
import { remarkable } from "rmapi-js";
const api = await remarkable(...);
await api.uploadEpub("name", buffer);
await api.uploadPdf("name", buffer);
```
There are alos low level apis that more directly manipulate cloud storage.
Using these apis is a little riskier since they can potentially result in data loss, but it does come with increased flexibility.
```ts
// ...
// upload with custom line height not avilable through reMarkable
await api.putEpub("name", buffer, { lineHeight: 180 })
// fetch an uploaded pdf, using the hash (from listFiles)
const buffer = await api.getEpub(hash)
```
### Gotchas
By default, all calls try to do their best to verify that the input and output
matches what I expect. However, since I reverse-engineered this, some of it
could be wrong. If you ever run into a `ValidationError` and know you want
whatever data is returned, You'll have to use the low-level api under `api.raw`
to access the raw text file and parse the result yourself.
It seems that exporting happens within the apps themselves, which will require
layout of the remarkable file structure. That's currently outside the scope of
this project.
## Users
- [✉️ Send Via](https://sendvia.me/) [[github](https://github.com/PaulKinlan/send-to-remarkable)] - upload to reMarkable via email
- [ⓡ rePub](https://chromewebstore.google.com/detail/repub/blkjpagbjaekkpojgcgdapmikoaolpbl) [[github](https://github.com/hafaio/repub)] - web clipper for reMarkable that supports images and customization
- [reMarkable Digest](https://digest.ferrucc.io) - create and receive a daily digest on your reMarkable
## Contributing
Since this has all been reverse engineered, any help expanding the api would be
helpful. For example, There's currently a function to download the entire state
of a document, but I ran into trouble trying to reupload that exact same file as
a clone.