====== File Transfer ======

==== File Transfer via SFTP ====

To transfer files with a graphic user interface (GUI), download an SFTP program like [[https://winscp.net/eng/index.php|WinSCP]], [[https://filezilla-project.org/|FileZilla]] or [[https://cyberduck.io/|Cyberduck]].

Create a new SFTP connection using the following settings:

  * Host: ''remarkable''
  * Username: ''root''
  * Password: ''your-password''
  * Port: ''22''

==== File Transfer via SCP ====

To transfer files with a command line interface (CLI), open a terminal and type a command with this syntax

<code>
scp <full_path_to_source_file> <full_path_to_destination>
</code>

If the source is a directory instead of a file, you need to use ''scp -r''

If you want to send an epub file ''book.epub'' from your Desktop folder to the reMarkable's home folder ''/home/root'', the above would translate to

<code>
scp -v ~/Desktop/book.epub root@10.11.99.1:
</code>

If you want to make a quick-and-dirty local backup of your [[https://github.com/toltec-dev/toltec|Toltec]] installation in your host machine's Downloads folder

<code>
scp -rv root@10.11.99.1:/opt ~/Downloads/
</code>

It is highly recommended that you [[https://remarkablewiki.com/tech/ssh#SSH_Config_File|configure an alias]] and set up a [[https://remarkablewiki.com/tech/ssh#Passwordless_Login_with_SSH_Keys|passwordless SSH login]] to save you from typing ''root@10.11.99.1'' and your password every time you want to transfer files to and from your reMarkable.

==== Making Local Backups ====

As an alternative (or in addition) to the reMarkable cloud sync backup service, you should back up your system files locally.

First, make a backup folder:
<code>
mkdir -p remarkable-backup/files
</code>

Make sure you are connecting over USB instead of WiFi for faster transfers. Then you probably want to back up at least the following, but if you intend to change other system files, feel free to add their paths too.

All your content (this will likely take the longest, and could be up to 8GB of data):

<code>
scp -r root@remarkable:~/.local/share/remarkable/xochitl/ remarkable-backup/files/
</code>

Your configuration file, which also contains your ssh password:

<code>
scp root@remarkable:~/.config/remarkable/xochitl.conf remarkable-backup/
</code>

The xochitl binary, if you plan on replacing or modifying it in any way:
<code>
scp root@remarkable:/usr/bin/xochitl remarkable-backup/
</code>

==== Other methods ====

The reMarkable community also offers a variety of 3rd party tools:

  * [[https://github.com/adaerr/reMarkableScripts/blob/master/pdf2remarkable.sh|pdf2remarkable.sh]] -- host sided script to push a PDF to the reMarkable using ssh (zsh, uuidgen, imagemagick)
  * [[https://github.com/reHackable/scripts/wiki/repush.sh|repush.sh]] -- host sided bash script that can push one or more documents to the reMarkable using the Web client and SSH (bash, curl, ssh, nc)
  * [[https://github.com/splitbrain/ReMarkableAPI|reMarkableAPI]]((**Does not support the transfer of EPUBs.**)) -- command line tool to upload and download via the cloud API (php)
  * [[https://chrome.google.com/webstore/detail/send-to-remarkable/mcfkooagiaelmfpkgegmbobdcpcbdbgh|ReMarkable Chrome Extension]] - Extension that allows you to 'print' any page from Chrome and send it to your ReMarkable wirelessly as a pdf.
  * [[http://www.davisr.me/projects/rcu/|reMarkable Connection Utility (paid)]] - Cross-platform, all-in-one client for low-level backups, managing documents and templates, uploading wallpapers and 3rd-party software
  * [[https://github.com/juruen/rmapi|rmapi]]((**Does not support the transfer of EPUBs.**)) -- interactive command line tool to upload and download via the cloud API (golang)