README.md

Toltec

Toltec is a community-maintained repository of free software for the reMarkable tablet.

Install it

Toltec works on top of the Opkg package manager and the Entware distribution, which are in widespread use in embedded devices. To automatically install Opkg, Entware and Toltec, run the bootstrap script in a SSH session on your reMarkable:

$ wget http://toltec-dev.org/bootstrap
$ echo "2d1233271e0cc8232e86827bcb37ab2a44be2c5675cd15f32952614916ae246a  bootstrap" | sha256sum -c && bash bootstrap

Warning: Make sure to run the second line above, which verifies the integrity of the downloaded script before running it. Since the built-in wget binary does not implement TLS, you will expose yourself to MITM attacks if you skip this step! The bootstrap script takes care of replacing the built-in wget with a safer version.

What does this script do? This script will create a .entware folder in your home directory, containing a complete Entware distribution (fetched from https://bin.entware.net/armv7sf-k3.2/), and permanently mount it to /opt. It will then configure Opkg for use with Toltec and configure your system to automatically find binaries from /opt. You are encouraged to audit the script yourself if you can.

Compatibility with remarkable_entware. If you have already installed Entware through Evidlo’s remarkable_entware, this script will detect the existing install and configure Toltec on top of it.

You now have access to all of the Toltec and Entware packages!

Browse the list of available packages →

Use it

To install a package:

$ opkg install calculator

To remove a package:

$ opkg remove calculator

To update all packages:

$ opkg update
$ opkg upgrade

See information about advanced Opkg commands →
Choose between stable and testing →

Build it

This Git repository contains all the tools and recipes required to build the packages published on the package repository. This repository is automatically built and published every time that a commit is pushed to Git, using Github Actions. Since all the packaged software in Toltec is free, you can also build them from source yourself instead of using the pre-built binaries. The build process is fully reproducible, which means that you can verify that the published packages have not been tampered with during the automated build process.

Learn how to build the repository from source →

Improve it

Your contribution is welcome for adding new packages, updating existing ones or improving the build tooling.

Learn how to contribute to Toltec →