Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/droberin/remarkable-cloud-tools
reMarkable 2 Cloud Tools
https://github.com/droberin/remarkable-cloud-tools
python3 remarkable-tablet remarkable-tablets remarkable2-linux
Last synced: 17 days ago
JSON representation
reMarkable 2 Cloud Tools
- Host: GitHub
- URL: https://github.com/droberin/remarkable-cloud-tools
- Owner: droberin
- Created: 2020-11-14T14:07:26.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2020-11-14T21:48:23.000Z (about 4 years ago)
- Last Synced: 2023-08-05T11:54:02.893Z (over 1 year ago)
- Topics: python3, remarkable-tablet, remarkable-tablets, remarkable2-linux
- Language: Python
- Homepage:
- Size: 6.84 KB
- Stars: 20
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# remarkable-cloud-tools
## Motivation
There seem to be no official method to upload files to `reMarkable 2` through a GNU/Linux operating system, and we also like to share some files with out beloved device. Hence these Python3 scripts (tested on Python 3.8), will allow uploading files to our reMarkable Device(s). They may work on other Operating Systems, of course.
### Pull Requests are very welcome
If you want to improve this, you are welcome to.
Specially in terms of packaging and stop kicking PEP-everything.
Pull-requests are welcome!
## Improvements
Well, it'll be nice if this could be connected to some Frameworks like `django` or `flink` in order to use it as a hub. Meaning you could even generate some reports and send them right into your reMarkable device.
## Configuration
Example configuration file:
```yaml
devices:
default: reMarkable2
device:
reMarkable2:
device_token: youR_super_secret_token
last_user_token:
mom_reMarkable2:
device_token: yomammas_big_secret_token
last_user_token:
dad_reMarkable2:
device_token: yodaddy_mega_secret_token
last_user_token:
```
A default configuration would be created first time these scripts are called and this expect to find it at `~/.reMarkable2/reMarkable2.yaml`.
### Obtain Device Token
Currently I'm obtaining this token from Google Chrome reMarkable extension. This means you must have linked this extension with your reMarkable 2 device first.
For GNU/Linux users you can try something like this:
```shell
for log in "$(find $HOME"/.config/google-chrome/Default/Local Extension Settings/bfhkfdnddlhfippjbflipboognpdpoeh/" -iname \*.log)"; do strings "${log}" | grep -1 deviceToken | cut -d '"' -f2 ; done
```
This would print at least 2 lines, one should say `deviceToken` and the second one should be our device token itself.
## install
Inside project:
```shell
python3 -mvenv venv
source venv/bin/activate
pip3 install -r requirements.txt
```
Create an alias just for easier access
```shell script
cat < ${HOME}/.local/share/kservices5/ServiceMenus/uploadtoremarkable2.desktop
[Desktop Entry]
Type=Service
Actions=SendToReMarkable2Cloud
Encoding=UTF-8
MimeType=application/pdf
X-KDE-ServiceTypes=KonqPopupMenu/Plugin
X-KDE-Priority=TopLevel
X-KDE-Submenu=Send To
[Desktop Action SendToReMarkable2Cloud]
Name=reMarkable2
Exec=konsole -e $(which python3) ${PWD}/remarkable2_cloud_upload.py /%f"
EOF
```
This will show up a "reMarkable2" option into "Send To" on right-click on a PDF file.
### Send To menu for KDE4 (not tested yet!)
```shell script
mkdir -p ${HOME}/.kde/share/kde4/services/ServiceMenus/
cat << EOF > ${HOME}/.kde/share/kde4/services/ServiceMenus/uploadtoremarkable2.desktop
[Desktop Entry]
Type=Service
Actions=SendToReMarkable2Cloud
Encoding=UTF-8
MimeType=application/pdf
X-KDE-ServiceTypes=KonqPopupMenu/Plugin
X-KDE-Priority=TopLevel
X-KDE-Submenu=Send To
[Desktop Action SendToReMarkable2Cloud]
Name=reMarkable2
Exec=konsole -e $(which python3) ${PWD}/remarkable2_cloud_upload.py /%f"
EOF
```
This will show up a "reMarkable2" option into "Send To" on right-click on a PDF file.
# Author
Roberto Salgado A.K.A. DRoBeR.
Check reMarkable 2 website if you don't have already 3 of them.