Skip to content
This repository has been archived by the owner on Aug 31, 2021. It is now read-only.

repull.sh

Patrick Pedersen edited this page Oct 13, 2019 · 8 revisions

Source

Note: In order for this script to work, the reMarkable web interface must be enabled first under device settings > storage

A host sided script that can download documents and directories from the reMarkable via the web client and SSH. Files can be downloaded via USB or remotely.

Dependencies

Installation

To obtain the latest copy of the script:

$ wget https://github.com/reHackable/scripts/raw/master/host/repull.sh

If desired, one may opt to copy the script to a path defined in the $PATH variable (such as /usr/local/bin/ so that it can be executed directly from the commandline:

# cp repull.sh /usr/local/bin
# chmod +x /usr/local/bin/repull.sh

Usage:

Usage: repull.sh [-v] [-h] [-d] [-o out] [-r ip] [-p port] path [path ...]

Options:
-v			Display version and exit
-h			Display usage and exit
-d			Recursively pull directories
-o			Output file or directory
-r			Pull remotely via ssh tunneling
-p			If -r has been given, this option defines port to which the webui will be tunneled (default 9000)

Example:

Download my-document via USB

$ bash repull.sh /my-document

The output will either be a PDF or a EPUB, depending on the document type

Download mydocument and /myfolder/mydocument remotely, assuming the ip is 10.0.0.43

$ bash repull.sh -r 10.0.0.43 /mydocument /myfolder/mydocument

Download the entire myfolder/ directory

$ bash repull.sh -d /myfolder/

FAQ

Q: How do I save my SSH password so that I don't have to enter it every time?

A: You can set up an SSH key. See the "Setting up ssh-keys" section on the reMarkable wiki SSH page.


Q: Where do I obtain the device's IP in order to push remotely?

A: On your remarkable, go to Device Settings > About and go to the Copyrights and licenses tab. From there go to General Information. The remote IP address will be listed at the bottom of the text (The IP address that isn't 10.11.99.1).


Q: How can I download a directory or file that contains spaces in its name?

A: Quotations marks should be used to escape characters. For instance, the following:

$ bash repull.sh "/my folder/my doc"

would download /my folder/my doc

Issues

Should an issue arise that has not been covered throughout this wiki entry, feel free to submit an issue. We will try our best to respond in time, but would also like to remind everyone that this is voluntary work, and people are busy!

Clone this wiki locally