rePocket

Another reMarkable native application to sync download the latest articles from Pocket into a dedicated folder in the device.

Current Features

• Downloads the latest 10 articles since the previous request. Articles will include some images!

• Archive articles in Pocket by moving them to the folder Pocket/Archive in the reMarkable

• Syncing is user triggered from the UI, (or the CLI). Any changes to the Sync folder will trigger syncing. Changes in this instance means adding as Favorite, or editing a tag, as simple as that!

• The tool can be built and run in a host to generate all the files necessary to create the folder and its contents and add them to the device via SSH

• The installation should be impervious to reMarkable updates

Future Features and Featured Bugs

For a full list visit registered enhancements

Installation

Requirements

• A properly configured SSH connection to the reMarkable, call it remarkable
• Rust and Cargo in order to build from sources
• If you'd like to run the binary in the device, you'll need a cross-compiler toolchain. You can follow one of the guides from here. Under macos, I ended up installing the toolchain provided here (mostly because I found the other resource later)

Build from source and install

• Clone the repository

• Build the binaries (rePocketAuth and rePocket) from sources following the instructions for each of them

• Run the installation script from the repository root:

# Usage: ./scripts/install.sh <path to rePocket binary>"
./scripts/install.sh target/armv7-unknown-linux-gnueabihf/release/rePocket

Download a release and install

• Download a release.

• Unarchive and install:

tar -xvf rePocket.tar.gz
cd rePocket
./scripts/install.sh build/release/rePocket

The script will do the following:

• Launch rePocketAuth to authenticate your build for the app with Pocket

• Connect via SSH to the reMarkable to create the necessary file structure and copy the rePocket binary

• Createa a Linux service file, enable it and start it

# If will create the following folders, if necessary
#
# /home/root/.local/bin
# /home/root/.local/share/repocket
#
# It will copy rePocket to ~/.local/bin
# It will move the authentication file to ~/.local/share/repocket
# It will add the repocket.service to /etc/systemd/system

Thank yous! Credits, and the like

Although I set up to satisfy my curiosity and learn some rust in the process I couldn't have done this without leaning on the work of many others:

• motemen's go-pocket and GliderGeek's pocket2rm which were always my go-to when I run into a wall

• https://remarkable.guide for their documentation and all efforts

• canselcik/libremarkable helped me get cross-compilation working