RM2 Installation notes for 3.8.2 #32

UniqueName992 · 2023-12-27T18:53:39Z

UniqueName992
Dec 27, 2023

Here's my notes on installing rocket and rm2fb on RM2 version 3.8.2.

Experimental Software Warning

A few people including myself have ended up needing to fix a boot-loop remarkable trying to install on this version. I don't recommend proceeding unless you're comfortable fixing things when they go wrong.

This is an unsupported and unofficial configuration relying on bleeding edge patches and some hacks to work and is not recommended. See https://toltec-dev.org/#install-toltec for the latest supported version and consider using codexctl to downgrade instead.

Installation

1. Install 3.8.2 using codexctl (https://github.com/Jayy001/codexctl/releases/tag/1703028363).

./codexctl.bin install 3.8.2.1965

Disable automatic updates in the xochitl system settings.

2. Install toletc. Either re-enable a previously installed version:

toltecctl reenable

Or use this patched bootstrap if installing toltec fresh.
The patch changes the bootstrap script to use the latest wget available from https://github.com/toltec-dev/bootstrap. If you wish to make your own instead, download the usual bootstrap from the instructions at https://toltec-dev.org/#install-toltec and modify lines 82 and 83 to v1.21.1-1 Wget, which works on Remarkable above v3.6 without the segmentation fault issue.
rm bootstrap
wget http://raw.githubusercontent.com/UniqueName992/rm2-bootstrap-temp/main/bootstrap
echo "a94ddad2aae1b560f5ff168dc309d4c4e39a4723136010253c31cdf3c5c5faad  bootstrap" | sha256sum -c && bash bootstrap

If you run into issues, removing any previous versions of binaries or entware may help before installing the bootstrap from the above instructions:

rm -r ~/.local/bin
rm -r ~/.entware

3. Mask the service remarkable-fail. This prevents ending up in a boot-loop situation if your device reboots before all steps are complete.

systemctl mask remarkable-fail

4. Restart the SSH session, or source the .bashrc to load the toltec binaries onto path:

source ~/.bashrc

5. Download the fixed xochitl package.

Either download from the pull request (https://github.com/toltec-dev/toltec/actions/runs/6991087513?pr=718) and extract it, then copy to the tablet or use the following commands which use a pre-extracted version:

wget https://raw.githubusercontent.com/UniqueName992/rm2-bootstrap-temp/main/xochitl_0.0.0-17_rmall.ipk
opkg remove xochitl
opkg install xochitl_0.0.0-17_rmall.ipk
opkg flag hold xochitl

The hold command will prevent this version being updated automatically. This is recommended as updates may not support 3.8.2 yet.

6. Install rm2fb

First install the toltec opkg, which won't work on this version so this will error. This is needed so Toltec doesn't install the toltec rm2fb and default to it later (which does not support 3.8.2):

opkg install rm2fb-client
opkg flag hold rm2fb-client

Now install the version for 3.8.2:

wget https://github.com/timower/rM2-stuff/releases/download/v0.1.1/rm2fb.ipk
opkg install rm2fb.ipk

7. install rocket

wget https://github.com/timower/rM2-stuff/releases/download/v0.1.1/rocket.ipk
opkg install rocket.ipk

8. Enable rm2fb

systemctl enable rm2fb

9. Set Rocket as default

systemctl disable xochitl
systemctl enable rocket

10. reboot

reboot now

All being well, Rocket should load on startup and can be used to load xochitl or any other installed packages.

11. Lastly, unmask the failure service:

systemctl unmask remarkable-fail

Other Packages

At this point you should be fine to install other packages from toltec, most of which seem to work as expected showing up in rocket:

opkg install nao
opkg install koreader

The other packages from this rM2-stuff github can be installed either from toltec or similarly using wget.

RM-Hacks

The new Rm-hacks for 3.8.2 can also be installed as normal and work alongside toltec.
For the Lamy plugin with Rm-Hacks, a bit of extra work is needed to load the plu 8000 gin by creating the following file:

nano /opt/etc/xochitl.env.d/lamy.env

with contents

export QT_QPA_GENERIC_PLUGINS=evdevlamy

Launchers tested

Rocket - Working well
Remux - High CPU / battery drain Issue remux eats 40% of the CPU after a while on 3.8.2.1965 rmkit-dev/rmkit#210
Oxide - Not working

Thanks to @gullradriel for testing

data-flux · 2024-01-03T13:55:20Z

data-flux
Jan 3, 2024

Good stuff! I don't suppose there's a way to use another launcher than rocket? I'm not a big fan of its sleep screen.

7 replies

UniqueName992 Jan 12, 2024
Author

Thanks, same results here testing Oxide (Tarnish)
I'll add a not to the main post

gullradriel Jan 13, 2024

One more note:
remux works, but eats 40% of the CPU after a while. It's not eating the CPU at the start, but after a while.
Didn't investigated it more than that, but I tried to switch launchers a few times, and each time remux ended up eating 40% of the CPU constantly.
Only rocket seems to be going nice, without eating up the machine.
I ended up using rocket.

data-flux Jan 13, 2024

Thanks @gullradriel, I was wondering why my battery was draining more quickly in the last few days.

timower Jan 13, 2024
Maintainer

Interesting, I wonder if it's just a bug in remux or if it's my rm2fb + remux that's the issue.
For the different paths of rm2fb_client.so, e915fcb should help

UniqueName992 Jan 13, 2024
Author

Re. Remux Paths
On validating, it's enough to pass the LD_PRELOAD alone or make the symlinks alone. Remux can launch with either configuration (and the high cpu usage issue exists with both configurations).

Here's a screenshot of the Remux High CPU issue, it seems to happen after a couple of switches and a notebook is opened in Xochitl, and remains high once the notebook is closed or xochitl is switched away from. Killing Xochitl reduces the CPU usage again. The high CPU usage is reported to belong to Remux.

UniqueName992 · 2024-01-13T13:10:03Z

10000

UniqueName992
Jan 13, 2024
Author

Interesting edge case, after experimenting Rocket duplicated my icons on the main screen.
It looks like a package (possibly Draft) made a symlink from /etc/draft/ to /opt/etc/draft. In this instance, Rocket read both directories and presents them as duplicate icons. Very interesting I can then have multiple instances of the same program open.

0 replies

Cyrus-Harding · 2025-06-17T14:21:27Z

Cyrus-Harding
Jun 17, 2025

I had to use a new version of codexctl, and I had to use

wget http://toltec-dev.org/bootstrap
echo "72f08437001523c1eba86dabc054e9fe81b3fb12532f9eb41db0e7e29ff47f72  bootstrap" | sha256sum -c && bash bootstrap --force

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

RM2 Installation notes for 3.8.2 #32

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 3 comments 7 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

RM2 Installation notes for 3.8.2 #32

Uh oh!

Uh oh!

UniqueName992 Dec 27, 2023

Experimental Software Warning

Installation

1. Install 3.8.2 using codexctl (https://github.com/Jayy001/codexctl/releases/tag/1703028363).

2. Install toletc. Either re-enable a previously installed version:

3. Mask the service remarkable-fail. This prevents ending up in a boot-loop situation if your device reboots before all steps are complete.

4. Restart the SSH session, or source the .bashrc to load the toltec binaries onto path:

5. Download the fixed xochitl package.

6. Install rm2fb

7. install rocket

8. Enable rm2fb

9. Set Rocket as default

10. reboot

11. Lastly, unmask the failure service:

Other Packages

RM-Hacks

Launchers tested

Replies: 3 comments · 7 replies

Uh oh!

data-flux Jan 3, 2024

Uh oh!

UniqueName992 Jan 12, 2024 Author

Uh oh!

gullradriel Jan 13, 2024

Uh oh!

data-flux Jan 13, 2024

Uh oh!

timower Jan 13, 2024 Maintainer

Uh oh!

UniqueName992 Jan 13, 2024 Author

Uh oh!

UniqueName992 Jan 13, 2024 Author

Uh oh!

Cyrus-Harding Jun 17, 2025

UniqueName992
Dec 27, 2023

Replies: 3 comments 7 replies

data-flux
Jan 3, 2024

UniqueName992 Jan 12, 2024
Author

timower Jan 13, 2024
Maintainer

UniqueName992 Jan 13, 2024
Author

UniqueName992
Jan 13, 2024
Author

Cyrus-Harding
Jun 17, 2025