RMPP Entware allows you to install additional software packages from the Entware repositories on your reMarkable device. This enhances your device's functionality through a lightweight package manager designed for embedded systems.
Special Thanks:
I extend my gratitude to Evidlo for his original work on remarkable_entware, which served as the foundation to this script.
- Features
- Prerequisites
- Installation
- Usage
- Managing Updates
- Cleanup
- Additional Information
- Managing Packages with Opkg
- Final Notes
- Support
- Extended Functionality: Install a wide range of packages from Entware repositories.
- RMPP Support: Tailored for devices running the RMPP firmware.
- Persistent Installation: Remains intact even after firmware updates.
Before installing reMarkable Entware, ensure you have the following:
- reMarkable Device: Ensure your device is running the RMPP firmware.
- USB Connection: A USB cable to connect your reMarkable to your computer.
- Internet Access: The device must be connected to the internet.
- SSH Access: Ability to access your device via SSH.
Follow these steps to install RMPP Entware on your device.
- Connect via USB: Use a USB cable to connect your reMarkable device to your computer.
- Ensure Internet Access: Verify that your device is connected to the internet to download necessary packages.
- Enable SSH: If not already enabled, follow these instructions to enable SSH on your reMarkable (dev mode).
- Connect to SSH: Use an SSH client to connect to your device. For example:
ssh root@<your-device-ip>
Execute the installation script to set up Entware on your device.
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bashIf you prefer a non-interactive installation that automatically answers to prompts:
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --forceTo remove any partial or existing Entware installation:
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --cleanupwget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --cleanup --forceWarning: This part of the script has not been tested yet & may not work as expected. After updating your device's firmware, Entware remains safe in
/home/root/.entware. To remount/optand re-enable Entware:
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --reenablewget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --reenable --forceNote: The base installation requires approximately 13MB of space. All Entware data is stored in
/opt, which is bind-mounted to/home/root/.entwareto optimize space usage on the root partition.
Once installed, you can manage packages using the opkg package manager.
To install a package, use the following command:
opkg install <package_name>Example: Install Git
opkg install gitTo search for available packages, use:
opkg find '<search_term>'Example: Search for Packages Related to 'top'
opkg find '*top*'Firmware updates might overwrite data outside /home/root. However, Entware remains safe in /home/root/.entware. To ensure Entware remains functional:
-
Remount
/opt:wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --reenable -
Force Re-enable (No Prompts):
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --reenable --force
If you need to remove Entware from your device, follow these steps.
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --cleanupwget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --cleanup --forceTo free up space on the root partition by cleaning up system logs:
journalctl --vacuum-size=2MDuring installation, the script can automatically add /opt/bin and /opt/sbin to your PATH. If you skipped this step or used the --force option, you can manually update your PATH:
-
Add to PATH:
export PATH=/opt/bin:/opt/sbin:$PATH
-
Apply Changes:
source ~/.bashrc
- Compatibility Limitation: Toltec is not supported on firmware versions above 3.3.2.1666 (as of 2024-12-22).
- RMPP Users: Toltec is currently not viable for RMPP users.
Use opkg to manage your Entware packages effectively.
opkg updateopkg install <package_name>opkg remove <package_name>opkg upgrade- Supported Devices: This installer is specifically designed for RMPP devices.
- Avoid Interruptions: Do not power off your device during the installation process to prevent potential system corruption.
- Use at Your Own Risk: I am not responsible for any damage or issues arising from the use of this software.
- No Guaranteed Support: While I will try to help & update the script, support is limited.
Happy hacking!
For more detailed information about script usage and available options, run:
wget -O - http://raw.githubusercontent.com/hmenzagh/rmpp-entware/main/rmpp_entware.sh | bash -s -- --helpIf you encounter issues or have questions, consider the following resources:
- Documentation: Refer to the Entware Wiki for comprehensive guides.
- Remarkable.Guide: reMarkable.Guide is a great resource to learn more about the reMarkable devices.
Disclaimer: Always ensure you have backups of important data before making significant changes to your device. Proceed with caution and at your own risk.