reMarkable Paper Pro · KOReader
Install KOReader on the reMarkable Paper Pro
Enable developer mode, connect over SSH, install the Toltec package manager, and use it to install KOReader — plus how to keep it working across firmware updates.
KOReader on a reMarkable is the difference between a poor ebook reader and a good one, but the install is genuinely advanced: developer mode wipes the device, then you work over SSH to set up the Toltec package manager and install KOReader through it. Because the exact steps and supported firmware change, the authoritative source is the Toltec project’s own documentation, linked above. Keep your notebooks backed up, and expect to re-run the install after firmware updates.
Before you begin
-
Back up your notebooks first
Make sure everything on the device has synced to your reMarkable account, and export any notebook you cannot lose as a PDF. Community software carries a real risk of needing a factory reset to recover from a bad step.
-
Enable developer mode
In Settings, then "General", then "Software", turn on developer mode. This wipes the device as part of enabling it, which is why the backup comes first. After it re-provisions, developer mode gives you SSH access.
-
Find the SSH details and connect
In Settings, then "Help", then "Copyrights and licenses" (or the "GPLv3 Compliance" screen), the device shows its IP address over USB and an SSH password. Connect the USB cable, then from your computer run "ssh root@10.11.99.1" and enter that password.
-
Install the Toltec package manager
Toltec is the community repository that packages KOReader and other tools for reMarkable. From the SSH session, follow the current install command on the Toltec website — it is a single script that sets up the "opkg" package manager and the Toltec repo. Confirm it reports success.
-
Install KOReader through Toltec
With Toltec set up, run "opkg install koreader". This pulls KOReader and its launcher. It also installs a way to switch between the reMarkable software and KOReader — often a launcher such as "remux" or an entry added to the device's menu.
-
Launch KOReader and point it at your files
From the launcher on the device, start KOReader. Use its file browser to find your documents — synced reMarkable files live under a data folder; many people also copy an ebook folder over SSH with "scp". Set a home directory so it opens there.
-
Plan for firmware updates
A reMarkable firmware update can disable developer mode or remove Toltec's changes. Before updating, check the Toltec site for whether the new firmware is supported. After updating, you generally re-run the Toltec install and "opkg install koreader". Some users turn off automatic updates while running this setup.
-
To remove it
Run "opkg remove koreader", then Toltec's uninstall script, or simply turn developer mode back off in Settings, which wipes the device and returns it to stock.