View Single Post
Old 07-04-2016, 11:12 AM   #1
Going Viral
knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.
knc1's Avatar
Posts: 17,212
Karma: 18210807
Join Date: Feb 2012
Location: Central Texas
Device: No K1, PW2, KV, KOA
Software Jailbreak for PW2, PW3, PW3W, KT2, KV, KOA and KT3

This post is horribly out-of-date.
The dozens of copies and re-writes of this post, posted on the Internet are no better, usually much worse.

The most up-to-date version of these directions should be here:
Any user of the directions (does not require a membership in this forum or the wiki) can bring it up-to-date when they find something that needs to be changed.
Any user - there is no single person in charge of keeping it up-to-date.

Of course, anything in the Wiki might disappear without warning, discussion, or consultation at the whim of the Wiki moderator(s).


Software jail break for the 6th, 7th, and 8th generation devices listed in the title.
Software jail break for the 9th generation device (KOA2) still requires some work.
The KOA2 "hotfix" package does not auto-reinstall the jail break. No ETA on a resolution.

Step #1 below describes how to learn what nickname your device has here based on its serial number.

Will this jail break work on my current firmware?
If the third field of your firmware version number: is larger than 7 this jail break will not work on your device.
That means it will not work on: 5.8.8, 5.8.9, 5.8.10, ..., 5.8.99999999.
Please do not even think of asking if this message still means what is written. The message is kept current.

There is a single, complex, special case for firmware version. If you get a Kindle with that firmware version, please just post in this thread before you do anything to it, your device **might** be one of the rare exceptions.

If jailbroken on an earlier firmware version, the jailbreak is known to survive the update to either 5.8.8, 5.8.9,, 5.8.10, 5.8.11.
Untested with an update to 5.9.2
It should survive an update to any firmware version. It is designed to be viral.

None of our add-ins are protected across updates, you must always re-install them.

The G090LK, G090LL (Black and White, PW-3, 32GB, Wifi only) models along with the corresponding two Wifi+3G versions are partially supported.

Testing (touchscreen devices listed in title):
Attached below is a "Dummy" installation package which will test the jail break installed on your device.
If it runs, your JB is complete. If it fails to run, your JB is missing or damaged.
This dummy install package will not install anything, only write a report document in the top level of visible USB storage (dummy_updatetest.log, example attached below).
If this test package fails to write its report, follow these directions exactly and completely Step #0 to and including Step #8.
  1. Download the attached archive.
  2. Open the archive.
    The archive contains a single directory, "Dummy", all contents are in that directory.
  3. From the archive contents in the "Dummy" directory, move the file: Update_dummy_0.0.N.bin to the /mrpackages directory of your Kindle.
    If you do not have a /mrpackages on the visible root of your kindle, you either have a damaged JB or the JB was never installed.
  4. Trigger the test package installation either from KUAL or from the main search bar:
    ;log mrpi
    command. Only expect the search bar command version of triggering MrPI to work on the devices it was intended to work on, the 8th. generation devices.

PW-2 users running firmware or older, go directly to:
PW-2 Early firmware versions, jail break

For prior (grayscale) Kindle models, see:
Legacy devices, jail breaks

  • NiLuJe - for discovering the initial factory update could be recovered. PW-2
  • knc1 - for posting the 'HowTo' and recovering the KT-2 and PW-3 initial updates.
  • Forum members - several members who recovered and provided initial update images for the KV.
  • knc1 - recognition that the factory initial update could be re-installed on any (matching) customer model.
  • Branch Delay - the original software jb for version 5.6.5 and the generic jb for initial factory images.
  • Branch Delay, NiLuJe, Geekmaster - initial testing of the method.
  • Geekmaster - archivist of the off-site Kindle recovery resources.
  • knc1, Geekmaster, NiLuJe, kindlefere - server resources.
  • NiLuJe, Ryccardo, eschwartz - recognizing and testing of the source of the hung Kindles problem.
  • Forum member - who recovered the image required to create Oasis support.
  • eeeee - who recovered the image required to create updated, PW-3 and PW-3W support.
  • ktwombley - who recovered the image required to create KT3 support.
  • eschwartz - now the maintainer of Branch Delay's factory image jail break.
  • eschwartz, NiLuJe, others - New menu launcher for Oasis (KOA) and other models.
  • The first public announcement was made by Hackaday, see:
    Which can take credit for many of this thread's views.
A long list of a lot of work done over a period of more than a year. Work that is continuing.
This downgrade attack did not happen over-night nor was it the work of any one person.

Release Policy:
It is our policy to use a 'single point of maintenance' model for our released items, with one exception:
  • NiLuJe's snapshots, use: (filter prefix: tools, show threads).
    Users should always check the snapshot thread for the most recent build of our after-market add-ins.
Make Ready:
Consider the following bullet list a "Step #0" that can be done in any order.
  • For some firmware versions, your Kindle must be registered with Amazon to access the required menus.
    • The general rule to cover all versions, is: If not yet registered, do that now.
      Read the rest of this specific section before connecting to the Internet.
    • Some of the more recent firmware versions are very aggressive about doing an OTA (Over The Air) update.
      Which will currently update to a version that can not be jail broken.
    • Currently the best way to avoid OTA updates is to add the OTA blocker directory (folder) name to the top level of visible USB storage.
      The blocker directory is named: update.bin.tmp.partial
      Use that exact name, no additional extension, no contents.
  • Remove any device passcode or parental control passcode you may have set.
  • If you have an ad supported (Special Offers) model consider unsubscribing it at your Kindle account.
    If you do unsubscribe from special offers, be sure to give your Kindle enough time on-line for Amazon's servers to update its local status files.
  • Is your Kindle fully charged?
    Get started with that now, put it on a wall charger to be certain.
  • Only do one step at a time.
    They are intended and designed to be done one at a time.
    At the completion of a step, if the file you previously put at the top level of visible USB storage is still there, remove it.
  • Your Kindle should remain off-line (in airplane mode) during this procedure.
  1. Positively identify the nickname of your Kindle model from the serial number.
    Use four of the first six characters, older Kindles: xxxx xx, newer Kindles: xx xxxx in this table:
    Serial Number Nicknames
    The factory images **are not** model locked, your care taken with this step is your Kindle's only protection! If not found in the table, STOP HERE and tell us.
  2. Prepare your Kindle for running an earlier version of the firmware.
    The Kindles have two user storage areas, the one seen over the USB cable and a hidden one.
    The process that wipes the hidden one will also wipe what can be seen over the USB cable.
    • Make backup copies of the contents of /documents
      You are about to wipe them all out, if you have them pushed to your Kindle's cloud, you should be covered.
      You should not need copies of the contents of /system - the 'system' should re-build them for you.
    • Do not copy the contents of /documents back to the Kindle until after you have returned to the same firmware version that you copied them from.
      The indexer might go crazy if you try anything else than 'back to same place, with same version running'.
    • You are about to lose all personalization of your kindle.
      You can't reach that hidden directory they are stored in and it is this database that causes most of the problems, so it MUST go.
    • Home -> Menu -> Settings -> Menu -> Reset
      Or whatever the path is on your current firmware version.
      This is the infamous "Reset (to factory defaults)" menu choice, but in this case it is a requirement, a must use entry.

      This is the ONLY TIME you should ever use the Reset menu entry in the lifetime of the device because it wipes out the jail break survival code that is about to be added in step 6 below.

    Never, ever, unless you intended to wipe out the jailbreak survival code. Which you really, really, need.

    If you should happen to trigger the "Reset" action by accident (nobody does it intentionally after reading the above), you can find a package on coplate's snapshots thread that will restore the jailbreak survival code you just destroyed.
    The special purpose package linked above is placed in the root of visible USB storage and run using UYK menu entry.
    It is intended to install without MrPI even on customer firmware builds as recent as the 5.8.10 version.
  3. Download your model's initial factory firmware image to your computer from one of these (IPv4 only) links.
    The *.md5 validation file may be used to confirm that the download was complete and correct.
  4. After validating the downloaded file, transfer the initial factory image from your computer to your Kindle.
    Do not panic if the update is not immediate, it usually takes 10 minutes or longer.
    If there is not a very noticeable delay and when you check USB storage the file has disappeared, that means this method will not work on the firmware version currently installed on your Kindle.
    1. Connect Kindle to PC with the USB cable.
    2. Place the downloaded update_*.bin file in the topmost, visible level of USB storage (alongside of /documents).
    3. Eject and/or Safely Remove (term depends on OS) the Kindle, USB storage.
    4. Remove the USB cable.
    5. Home -> Menu -> Settings -> Menu -> Update Your Kindle
    6. Confirm
    7. Wait

    ** The PW-2 is a special case at this point in the directions **
    1. Use the prior 'universal jailbreak' from this post:
      Old Universal Jail Break
    2. After completing those directions, skip the next two steps here and continue with Steps #7 and #8 below.
  5. Download and install the current version of Branch Delay's factory firmware jail break.
    This step installs two files, our signature certificate and a 'Jail Broken' document.
    If the 'Jail Broken' document is not on your Kindle in the /documents folder after the completion of this step, then the certificate is not on it either!
    If this happens to you, stop here and post about the problem, there is no reason to continue if the JB is now missing.
    The current version is attached to its release post, see:
    Factory Image Jail Break
    1. Connect Kindle to PC with the USB cable.
    2. Place the downloaded file (an archive - as is) in the topmost, visible level of USB storage (alongside of /documents).
    3. Eject and/or Safely Remove (term depends on OS) the Kindle, USB storage.
    4. Remove the USB cable.
    5. Home
    6. Search bar, enter:
      Press 'return'
      Yes, the semi-colon is part of the search bar command string.
  6. Download and install the current 'hotfix'
    The current version is attached to its release post, see:
    Jail Break Survival Code
    1. Unarchive the release archive package.
    2. Connect Kindle to PC with the USB cable.
    3. Place the Update_jailbreak_hotfix_*_install.bin in the topmost, visible level of USB storage (alongside of /documents).
    4. Eject and/or Safely Remove (term depends on OS) the Kindle, USB storage.
    5. Remove the USB cable.
    6. Home -> Menu -> Settings -> Menu -> Update Your Kindle
    7. Confirm
    8. Wait
  7. You can now update your Kindle to a newer firmware version, the jailbreak will survive.
  8. All of the models covered in this thread must use one of the two following installation methods for update_*.bin name format packages.
    The KOA and KT3 owners must use the new installation methods.
    The other device models may use either the old or the new installation methods.
    1. Any of our after-market add-ins, with an update_*.bin format filename requires the use of the Mobileread Package Installer (MrPI).
      • Get the MR Package Installer from the KUAL and KUAL extensions section of:
      • This is an "un-archive to top level of visible USB storage" package.
        Be sure that the un-archive tool you use has options set to create directories.
      • KOA and KT3 owners:
        You must run the installer with your new, search bar command: ;log mrpi
        Other models covered in this thread may do the same or may run it from KUAL.
    2. Nearly all of our after-market add-ins require an application launcher.
      • Get the KUAL package from the KUAL and KUAL extensions section of:
      • Beginning with version 2.6.40 of the release, the archive contains three (3) different builds of KUAL.
        The 'keyboard' version, the '(old) touchscreen' version, and the new 'KOA, KT3' version.
      • This is not a substitute for reading the README.txt file included in the archive bundle, but ...
        • KOA and KT3 owners:
          You must use the update_*.bin format package of KUAL and you must use the MrPi installer to install it.
        • Other devices:
          The archive still contains the previous 'document' style of KUAL, used by just placing the (correct) KUAL document into the /documents folder of USB storage.
          Note: The new (update_*.bin format KUAL) will run on all touchscreen devices running firmware 5.1.2 or newer.
      • "Nearly all applications require an application launcher" - I was expecting someone to ask . . . .
        KUAL is one of the applications that does not required an application launcher.
        It has a mime type associated with it that tells the system how to run it, when it is selected.

    These update_*.bin package name format packages must be re-installed after each firmware update.
    The MrPI application can handle multiple update_*.bin packages at the same time, just put them all in /mrpackages and trigger MrPI.
Attached Files
File Type: zip (11.9 KB, 8630 views)
File Type: txt dummy_testupdate.txt (13.5 KB, 6765 views)
File Type: zip (1.6 KB, 3837 views)

Last edited by knc1; 01-05-2018 at 11:53 AM. Reason: post status
knc1 is offline   Reply With Quote