Kindle Jailbreaking Support & FAQ

Common questions and answers about Kindle jailbreaking, troubleshooting, and modding.

Q: When is the 5.18.x jailbreak coming out?

A: Soon - hopefully. There is no ETA given, and side projects, such as KPM (Kindle Package Manager), KindleForge (GUI for KPM), Sh_Integration in C, New jb.sh must be finished too. The in-development jailbreak supports 5.16.4 - 5.18.3 in theory, 5.18.4 patches the jailbreak and will not be supported for a while. No, there is nothing you can do at this time.

Q: Can I downgrade my Kindle?

A: Only if you are jailbroken first. See kindlemodding.org/firmware-and-flashing/downgrading/#downgrading.

Q: The Kindle Disk Filler script isn't working!

A: You are likely on an MTP kindle. You can manually fill your kindle with junk files. github.com/bastianmarin/Kindle-Filler-Disk/tree/main/MTP.

Note: Ensure to delete any .partial.tmp.bin files or something of that sort when completing this step to prevent updates if you are susceptible to them.

Q: ;log mrpi fails

A: Drag the .bin file to the root of your kindle and press update your kindle in settings. This works functionally the same.

Note: Ensure to delete any .partial.tmp.bin files or something of that sort when completing this step to prevent updates if you are susceptible to them.

Q: MRPI says 'Destroying ...bin'/Update fails on the previous step

A: You have an incorrect .bin file. Ensure you are using the correct/compatible KUAL edition (try the other) or software update.

Q: KUAL Says 'Application Error'

A: Run the 'Run Hotfix/Bridge' scriptlet.

Q: Updated to 5.18.x post-jailbreak (e.g. during blocking OTAs)

A: You may still be jailbroken! search for ;log and if it says something along the lines of "no args passed", you are still jailbroken, reinstall mrpi & kual and run hotfix, it should work.

Q: KOReader isn't opening!

A: You have the incorrect KOReader version. Refer to this table to find out which version you need:

kindle-legacy: K2, DX, K3 (and all variants)
kindle: K4, K5, PW1
kindlepw2: PW2 and newer models running firmware <= 5.16.2.1.1
kindlehf: Any Kindle device running firmware >= 5.16.3

Q: I keep getting KPPMainAppv2 errors/logs!

A: Create an empty file named "DISABLE_CORE_DUMP" (no extension) in the kindle root.

Q: How can I prevent updates on 5.18.1-3 whilst waiting?

A: Fill up your kindle with junk files, either manually or with the filler script, forget networks, and enable aeroplane mode. kindlemodding.org/jailbreaking/prevent-auto-update.html.

Q: When copying winterbreak, I recieve "The file name you specified is not valid or too long."

A: Either you have really long file names, or forgot to extract the winterbreak files. Extract them first, and this should be fixed.

Q: Do I need a registered kindle to jailbreak?

A: Varies per-jailbreak. You do, for WinterBreak.

Q: Jailbreaking on a blacklisted Kindle?

A: Only with LanguageBreak for kindles on FW 5.16.2.1.1 or lower. Or WatchThis. Otherwise, wait for the new jailbreak.

Q: My Mac doesn't see my kindle!

A: This is because you have an MTP kindle. Download amazon's software to fix: amazon.com/sendtokindle/mac.

Q: Kindle store encounters an 'Unexpected Error'

A: Try the below solution:

  • Factory Reset your Kindle
  • Before registering - plug your Kindle into your PC, move the WinterBreak files to the root of your storage space
  • Login to your account, and enable Airplane mode as soon as possible
  • Connect your Kindle into your PC and delete the cache directory at the path .active_content_sandbox/store/resource/LocalStorage (skip this step if the LocalStorage directory does not exist)
  • Reboot your Kindle
  • Open the Kindle Store on your Kindle
  • When prompted, click Yes to turn off Airplane mode

Still doesn't work?

Force update to your current firmware, even if you have disabled OTA Updates. Quote: "You can also force an update by copying the firmware update file to your Kindle and, while still plugged in, hold down the power button until it restarts." Get the firmware version from here: kindlemodding.org/firmware-and-flashing/downloading-updates.html.

Q: PW1 Running KOReader keeps crashing/flashing the default screensaver

A: Run KOReader in frameworkless instead.

Q: How to jailbreak K4/K4 jailbreaking issues

A: Refer to the following reddit thread: reddit.com/r/kindle/comments/1ipko3u/comment/mcvmj3s/.

Q: I cannot load Mesquite

A: If you are on firmwares below 5.16.4, follow the Winterbreak2 guide. Otherwise, force the store to use cache and not the remote by connecting to wifi without a true valid internet connection.

Q: On 5.16.3, Cannot jailbreak, 'WINTERBREAK JAILBREAK' appears at the top of the screen

A: Update manually to 5.16.4, .3 is not supported. It has been reported not to work on .3 in multiple cases.

Q: How does WinterBreak/Jailbreaking work/What programming languages do I need to know to get into Jailbreaking?

A: Look at this. Read it fully to understand. The actual exploit is fully detailed in the "Exploits" section.

Jailbreaking works by finding different ways to run sh as root on the kindle, and on most other devices you can jailbreak.

Many, depending on the exploit. But definetely sh, so you can actually run the jb code.

Q: Illusion isn't working/Illusion 'application error'!

A: Illusion requires LanguageBreak/WinterBreak with scriptlets (Universal Hotfix), and does not currently support 5.6.1.1. Ensure you meet this criteria, and try rebooting and clicking again if you are, indeed, compatible.

Q: Where can I find apps/tweaks?

A: Check out kindlemodshelf.me

Q: How can I set a custom screensaver?

A: Look at the KOReader Guide (koreader.rocks). Manually replacing the screensavers/using NiLuJe's screensaver hack is not recommended, highly dangerous as the kindle is very specific around image formatting and type. Could lead to bricks.

Q: Whats SF/HF and why does some software not work on my device?

A: Kindle firmware is SF on 5.16.2.1.1 and below. After 5.16.3, all kindle firmware is HF. SF software may not work on HF, and vice versa. That's why you need to select the correct package for your kindle when installing something.

Q: Can I not do x after jailbreaking?

A: You should still be able to do everything you could do post-jailbreak as you would on an unjailbroken kindle. Jailbreaking itself doesnt visually change anything unless you install apps or tweaks.

Q: Cannot install hotfix, no matter what.

A: You are probably not actually jailbroken!

Q: Any other issues?

A: Ask the kindle modding discord, or read the guide (kindlemodding.org).

Q: Can I remove my account after jailbreaking?

A: Yes, but for Winterbreak, you will have to log in again if you want to jailbreak from scratch. Your Kindle will remain jailbroken whether you log back in or log out.

After unregistering, the Kindle will delete all files located in the documents folder, including the KUAL Launcher booklet and any other scripts that have been transferred. Be sure to back up these files first.

Q: Can I un-jailbreak my Kindle?

A: Yes, re-enable automatic updates first (Restore option in renametobin) to avoid an update block. Then, perform a factory reset on the device and install the same firmware update (or a higher version).

Q: Will the jailbreak get my Amazon account banned?

A: No reports of Amazon accounts being banned after jailbreaking have been reported so far. However, please refrain from telling support that you have modified your device.

Q: Will this void the warranty on my Kindle device?

A: Probably.

Q: How do I get the Amazon store back again?

Q: Can I still use the default reader after jailbreaking?

A: Yes.

Q: Can I still sideload books after jailbreaking?

A: Yes.

Q: Will my books and highlights be deleted after jailbreaking?

A: No.

If your device has been in Airplane mode for a long period of time, there is a possibility that Amazon will delete all sideloaded books from your device after reconnecting to WiFi due to an internal book tag. This can happen regardless of whether your device is jailbroken or not. Backup your books whenever you can.

Q: Will Libby/Readwise/GoodReads/Kindle Unlimited/Send To Kindle still work after jailbreaking?

A: Yes. Jailbreaking doesn't interfere with any of these services.

Q: Can I use those applications within KOReader?

A: Unless there's a plugin for it, no.

Q: Can I install Android apps on my jailbroken Kindle (Libby, Nook, Webtoon)?

A: Unless there's an extension/port for any of them, no.

Q: How do I read my Amazon ebooks within KOReader?

A: KOReader currently doesn't (and likely never will) support the proprietary formats that Amazon converts all ebooks into (KFX, AZW3, and very limited support for MOBI). It is recommended to get all your books as EPUB and store them in a separate folder for easy access.

Q: How do I read my Libby books?

A: You cannot use the Libby service within KOReader. You can get the EPUB file from Libby by following this guide.

Q: What is the difference between the three KOReader launch options?

  • "Start KOReader": The designed way to start KOReader.
  • "Start KOReader (no framework)": Temporarily "kills" the Kindle UI to allocate more resources to KOReader.
  • "Start KOReader (ASAP)": Skips a couple of checks and starts KOReader as soon as possible.

Q: I can't transfer files through USB while I am in KOReader!

A: KOReader currently does not support USBMS mode (USB transfer) and will only charge the device. If you want to transfer files, you must exit KOReader to do so.

Q: Do I have to launch KOReader through KUAL?

A: Not necessarily. You can launch it with simple scriptlets, specifically, Marek's launcher that is available here.

A KUAL booklet launcher (made by yparitcher) extension is also available to install. You can further customize both the KUAL booklet and the KOR launcher with the coversetter extension made by Stanner.

Q: What is the "root directory"?

A: It's the first directory you see when you plug the device into your computer. If you have SSH access to the device, this directory can be found at /mnt/us/.

Q: Can I update/factory reset/downgrade my Kindle after jailbreaking?

A: Yes, but you must first enable Airplane mode and enable automatic updates again (Restore option in renametobin) to avoid any potential update blocks or unwanted automatic updates. When updating, ensure that the newer version supports a jailbreak.

After updating/factory reset/downgrading, re-install the hotfix from scratch. KUAL and some other extensions may need to be re-installed too.

Q: How do I check if my device is jailbroken?

A: Type ;log into the search bar. If a message pops up, you're jailbroken.

Q: KUAL stopped working! I can't launch any of my extensions!

A: Verify if your device is still jailbroken by typing ;log into the search bar.

Q: I can't update my Kindle after a factory reset/update!

A: If you reset your Kindle in a jailbroken state with renametobin left enabled, your Kindle may be in a locked state. To fix this, read this guide.

Q: I get a message saying "Failed to remount rootfs RO, waiting"!

A: This is expected. You can safely reboot your device manually (holding the power button until you get the Restart option).

Q: My device hasn't rebooted after the jailbreaking pop-up!

A: If you're using Winterbreak, unless the Kindle displays the message "You are now ready to install the hotfix" in small text, you can safely continue with the post-jailbreak instructions. If it doesn't, something went wrong during the jailbreak process, and you'll have to try again.

Remember to delete any automatic update file that might have appeared.

Q: How can I check OTA Status?

A: Download the "Check OTA Status" scriptlet from here.

Q: Is it possible to change screensavers in the native Kindle UI?

A: Although there are currently no extensions to change the screensavers in hard-float firmware, it is still possible to change them, but it is not recommended as it is very easy to brick the device.

If you still want to change the screensavers, check the details of your default Kindle screensavers inside the /usr/share/blanket/screensavers folder, get root writing permissions, and set the custom ones with the same name prefix and settings (bit-depth and resolution). You can either replace them all or add them to the slideshow queue.

Please note that even after following these precautions, it is not guaranteed your device won't brick, especially if you're using GIMP to export the images.

If you are, however, running soft-float firmware prior to or on 5.16.2.1.1, you can install NiLuJe's screensaver hack. Please do not make the mistake of installing this extension on hard-float firmware. You can easily change screensavers with KOReader (search for the "screensavers" feature).

Credits

PENGUINS184, USERNAME99