/toltec

Community-maintained repository of free software for the reMarkable tablet.

Primary LanguageShellMIT LicenseMIT

Toltec

Status of the stable repository Status of the testing repository rm1 rm2 Discord

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 "5f826348764f664e577700c4d9d97e36f250ac27b616f7c09ba4a80e604a3012  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 →