Installing KUAL and MRPI

You will need to install KUAL (Kindle Unified Application Launcher) and MRPI (MobileRead Package Installer) to run homebrew on your Kindle.

Download the correct KUAL version

Device GenerationInstructionsKUAL Download
K5 and newerDownload and continue to next stepsUpdate_KUALBooklet_HDRepack.bin
K4 and olderDownload, place in documents folder and move onto Installing KOReaderKUAL-KDK-1.0.azw2
If none of the above methods workFollow the instructions on the repository and then move onto Disabling OTA Updateshttps://github.com/KindleTweaks/PEKI

Download MRPI

MRPI (for modern devices)

This version of MRPI is provided by Marek

MRPI (for legacy devices - pre-K5)

You may need to free up 220 MB of space to install both MRPI and KUAL without issues

Extracting MRPI

Extract the contents of the MRPI tar file you downloaded, and copy the extensions and mrpackages folders to your Kindle


Extracting/Copying KUAL

If your device is older than the K5 (Kindle Touch), you only need to copy the KUAL-KDK-1.0.azw2 file to your Kindle's documents folder, you can skip the next steps

If your device is the K3 (Kindle Keyboard) or older, you should instead use the KUAL-KDK-1.0.azw file and copy it to your Kindle's documents folder, you can skip the remaining steps

If you downloaded KUAL for legacy devices, extract the .tar.xz to get the Update_KUALBooklet_*_install.bin file

Copy the Update_KUALBooklet_HDRepack.bin file (if you chose KUAL Coplate for Kindles newer than the K5) or the Update_KUALBooklet_*_install.bin file (for legacy devices) to your Kindle's mrpackages folder


Eject and unplug your Kindle

Running MRPI

On your Kindle, type ;log mrpi into the search bar and hit enter


Done

Now wait whilst KUAL is installed, your Kindle screen turns white and shows some icons, after a while you will be returned to your library and see a KUAL book appear in it.

If you see a "Application Error" dialog, you can close it without worry - this is normal behaviour on some modern Kindles


If you face any issues, please read the troubleshooting section.

Troubleshooting

  • The installation or functionality of KUAL and MRPI may fail if there is not enough free space on your Kindle. If you are using the “fill storage” method to block updates, make sure your Kindle has 220 MB of available space before installing KUAL and MRPI
  • Verify that all folders and files are in the correct locations on your Kindle.
  • Try restarting the Kindle if the ;log mrpi command is not responding
  • Ensure that the file does not have any special characters such as brackets in it, some browsers may rename files adding (1) or other additional suffixes to the file name and these should be removed before copying to the Kindle