ReMarkable-scripts

Server-side bash scripts to use the ReMarkable tablet at its full potential.

The scripts work best if used all together.

Make sure that you read all the comments in each and every file to set them up correctly.

See the bottom of this file for instructions on how to demonize/run with cron.

The scripts do the following:

• upload.sh - Watch a folder on your server for new files, when a new file appears upload it to rmcloud/rmfakecloud
• mail.sh - Download attachments from a selected email account and move them to a folder synced with rmcloud/rmfakecloud through the upload.sh script
• convert.sh - Watch a directory and automatically convert .docx, .pptx files to pdf

License

The content of this repository is licensed under the WTFPL.

Copyright © 2023 giovi321
This work is free. You can redistribute it and/or modify it under the
terms of the Do What The Fuck You Want To Public License, Version 2,
as published by Sam Hocevar. See the LICENSE file for more details.

rmapi is being discontinued

Unfortunately rmapi is not being developed anymore. As long as it works, I will stick to it. If you have any other recommendation, please open an issue in this repository.

upload.sh

Watch a folder on your server for new files, when a new file appears upload it to rmcloud/rmfakecloud.

Configuration:

• Change the variables in the variables section of the script
• Run chmod +x upload.sh

Dependencies:

• rmapi (https://github.com/juruen/rmapi)
• inotify-tools (sudo apt install inotify-tools)

Fist time use:

• launch the command RMAPI_HOST="https://remarkable.mydomain.com" RMAPI_CONFIG_PATH="/root/.config/rmapi/rmapi.conf" /root/go/bin/rmapi
• Generate and enter the code from remarkable cloud or rmfakecloud
• type exit to save the configuration

mail.sh

Download attachments from a selected email account and move them to a folder synced with rmcloud/rmfakecloud through the upload.sh script.

Configuration:

• Look at the file .offlineimaprc to configure offlineimap
  • the location of the file is ~/.offlineimaprc
• In .offlineimaprc, in the last line you can configure the trusted senders
  • There can be more than one trusted sender, separated by | like in the example file provided
  • Don't forget to escape characters (such as . and _) preceding them with a backslash \
• Run chmod +x mail.sh
• Change the settings in .offlineimaprc and place it in the user root folder ~/.offlineimaprc

Features:

• Senders can be filtered
• Compatible with gmail, but need to configure less secure apps on gmail (here is an how-to: https://support.google.com/accounts/answer/6010255)

Dependencies:

• cron (usually installed by default on linux)
• offlineimap (sudo apt install offlineimap)
• munpack (sudo apt install mpack)

convert.sh

Watch a directory and automatically convert .docx, .pptx files to .pdf.

Configuration:

• Change the variables in the variables section of the script
• Run chmod +x convert.sh

Dependencies

• Unoconv (sudo apt install unoconv)

How to automatically run the scripts

In order to automatically run the scripts we will use cron and systemd.

Automatically run upload.sh

Procedure:

• Run nano /etc/systemd/system/upload.service
• Copy the content of the file upload.service in this repository
• ctrl+x and "y" + enter to save
• Run systemctl enable upload.service to enable the service

Automatically run mail.sh

Procedure:

• Run crontab -e
• Run touch /var/log/mail.log
• paste the following line at the end of the file in a new line: * * * * * /root/mail.sh >>/var/log/mail.log
• Press ctrl+x and "y" + enter to save

Automatically run convert.sh

Procedure:

• Run nano /etc/systemd/system/convert.service
• Copy the content of the file convert.service in this repository
• Press ctrl+x and "y" + enter to save
• Run systemctl enable convert.service to enable the service