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

repush.sh

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

Source

Note: In order for this script to work, the reMarkable web interface must be enabled first under Device Settings > Storage

rePush serves as a tool that can quickly transfer documents to the remarkable from the command line.

Dependencies

Supported document types

  • PDF
  • EPUB

Video Tutorial

A video tutorial on how to install and use repush can be found here

Installation

To obtain the latest copy of the script:

$ wget https://github.com/reHackable/scripts/raw/master/host/repush.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 repush.sh /usr/local/bin
# chmod +x /usr/local/bin/repush.sh

Usage

Usage: repush.sh [-v] [-h] [-o output] [-d] [-r ip] [-p port] doc1 [doc2 ...]

Options:
-v			Display version and exit
-h			Display usage and exit
-o			Output directory to which the provided files will be uploaded to
-d			Delete file after successful push
-r			Push remotely via ssh tunneling
-p			If -r has been given, this option defines the port to which the webui will be tunneled (default 9000)

Examples

Bulk push 1.pdf and 2.pdf via USB

$ bash repush.sh 1.pdf 2.pdf

Bulk push 1.pdf and 2.pdf remotely, assuming the device ip is 10.0.0.43.

$ bash repush.sh -r 10.0.0.43 1.pdf 2.pdf

Bulk push 1.pdf and 2.pdf to /Folder

$ bash repush.sh -o /Folder 1.pdf 2.pdf

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: Do I have to create a directory prior pushing files to it?

A: Yes, at the moment repush will not establish a new directory if it isn't already present. Attempting to push to a directory that hasn't been created yet, will fail.

Implementing this feature could require significant effort due to the fact the the WebUI does not provide an option to create a new directory. None of the current maintainers see this flaw to be significant enough to consider an implementation any time soon. Although we will gladly accept code contributions that would implement this feature.

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