Skip to content
/ toltec Public
forked from toltec-dev/toltec

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

License

Notifications You must be signed in to change notification settings

lambada/toltec

 
 

Repository files navigation

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 "46f556b06f5624b48e974ae040b6213828eff6aa2cc78618a4d8961a27cdc8b3  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 →

About

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

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 48.4%
  • Python 45.9%
  • HTML 2.7%
  • Makefile 2.1%
  • CSS 0.9%