View Single Post
Old 06-04-2019, 10:48 AM   #2
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 13,482
Karma: 26012494
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
Here is an archived version of the previous iteration of this document that was focused on the KindleBreak JB, for archival purposes.

Spoiler:

What Is This?:

This aims to be an up-to-date version of @geekmaster's original "JailBreak Index" thread. It will recap what you can and cannot do with your device, and how to proceed, in a step by step process.

Identification.

First, you need to identify your device. Just follow the instructions on this wiki page.

If you can't find your exact variant in the table, PM me the first 6 characters of your S/N, along with as much information about your device as you can (marketing name, date & country of purchase/delivery, whether it's WiFi-only or has cellular capabilities, and the bezel color if appropriate). Then wait for me to confirm that stuff has been repackaged to handle it, because none of this will work until I do .

Device Generation Concerns.

The main focus of this document will be all current devices with a touchscreen, running FW 5.x.
If you're using an older device see this historical thread, with a special addition if you're using a K4.
That's for the JailBreak step itself, but everything else in here is still relevant (i.e., once you're jailbroken, you can resume following this thread).
On those older devices, you'll also want to replace the JB Hotfix with the Mobileread Kindlet Kit when the former gets mentioned later on.

The Right Tools For The Job.

You'll soon realize that most of my stuff, despite being spread over a few dedicated threads, will actually redirect you to my Snapshots thread to actually download the files. I'd suggest keeping it open in a separate tab, or you might start to get dizzy with the amount of cross-references .
This allows me to centralize and update everything in one step.
Most of the files are shipped as xz compressed tarballs (.tar.xz). You'll need a decent unarchiver to handle those. We generally recommend 7-zip. If your unarchiver only leaves you with a simple tarball (.tar), you'll have to unpack that, too, to get to the goods.
This applies to everything, even KUAL extensions (i.e., if a bit of documentation says "just unpack it to <somewhere>", it means unpack the *inner* tarball).

JailBreak.

The current method (KindleBreak) requires a device running on select FW versions in the 5.10.3 to 5.13.3 range (inclusive).
If that's not you, check the Factory JB instructions below instead.

If that's you, check out the KindleBreak thread for detailed installation instructions, and come back here once that's done .

TL;DR: Identify your device, make sure your device is running an appropriate FW version, then install the KindleBreak JB.

Making sure your JB survives updates.

It's as simple as installing the JB Hotfix.
This will also take care of a few other necessary bits and bobs for the following steps.

Speaking of updates, remember that everything is basically evil since FW 5.12.x, so the only sure fire way not to get screwed is to *permanently* stay in Airplane mode.
On older FW versions, there are ways to prevent OTA updates, c.f., the mentions about that in the final section of this document.

TL;DR: This one should be installed via the "Update Your Kindle" menu, after dropping the .bin file at the top-level of the visible USB storage.

Installing custom packages.

You can now forget about the "Update Your Kindle" (UYK) menu, everything will have to go through the MobileRead Package Installer (MRPI).

You might be wondering why this is listed first, while it appears to depend on another tool: KUAL. That's a bit of a catch-22 that we'll take care of shortly; for now, install MRPI as if you actually had KUAL installed .

TL;DR: This is as simple as extracting the package at the top-level of the visible USB storage.

KUAL.

This is a GUI frontend that many custom tools will rely on, as such, we consider it a mandatory dependency.

As it's designed to run across the *full* range of Kindle devices, there are four different variants of it available.
If you're running FW >= 5.9, you'll need the "Booklet (coplate)" variant.
If you're running FW < 5.9 you can use the "Booklet" variant, or the "KDK-2" variant. Prefer the Booklet variant.
On older FW < 5.x devices, you'll have to use the "KDK-1" variant.

While the KDK variants were simple files you just sideloaded like any other book, the Booklet variants are proper packages, which is why MRPI had to come first .

TL;DR: Booklet variants should be installed via MRPI: drop the .bin in the mrpackages directory, located in the top-level of the visible USB storage (if you don't see it, you bungled the MRPI install in the previous step), then run MRPI by entering ;log mrpi in the Homescreen's searchbar, then wait for MRPI to proceed. If nothing happens, you bungled something along the way.

NOTE: If, despite the many earlier warnings, you're currently running FW >= 5.12.2, things get a little dicey: ;log may be gone. Instead, in the "Booklet (coplate)" archive, you'll find an Update_KUALBooklet_hotfix_*_install.bin install package, which you'll have to install via UYK (like the JB Hotfix earlier).


Enjoy!

You should now be ready to play with a lot of what's available on MR! A couple things to remember, though: As there's been a long history of various Kindle models and FW, some things may only target and/or behave properly on some specific models and/or FW versions. The documentation may not be any help in making you aware of that fact, especially for older stuff (the original author may be inactive, and even if he isn't, making sure stuff works everywhere and/or document it is a *lot* of work). Feel free to ask in the relevant thread, there's a good chance someone will tell you if it has a chance of working, or not .

As a rule, everything in my Snapshots thread should be sane & safe to use: it will either gracefully refuse to install on unsupported devices, or, barring that, gracefully refuse to *run* on unsupported devices.

Remember that MRPI supports installing *multiple* packages at once, and will attempt to install stuff in the right order if it matters (i.e., by installing Python first, for instance, as it's generally used by a few things, either as a hard dependency, or an optional one).

We generally recommend using the "Helper" KUAL extension, which provides a "PREVENT OTA Updates" button which, besides doing what it says on the tin, should prevent some battery drain caused by a tad aggressive "call home" behavior in some FW versions.
Fair warning, though: this will *no longer* protect you from automatic updates on FW >= 5.12.x! On those FW versions, slightly more aggressive methods are in various phases of development, check the forums (e.g., https://www.mobileread.com/forums/sh...d.php?t=327879).

If you're in a position to choose which FW version to update to, *avoid* anything >= 5.12.x, as it has become even more aggressive, preventing you both from (easily) blocking OTA updates, and greatly (potentially fatally) hampering the JailBreak's ability to survive, as well as your recovery options!

Keep in mind than an official FW update will basically throw you back to the post-hotfix step: you'll basically have to reinstall anything that came bundled in a .bin, except for the hotfix/bridge itself.

Speaking of the bridge/hotfix, you shouldn't ever need to reinstall it, unless you want to make extra sure it's got its hooks set in right before and/or after doing a severely destructive manipulation, like a factory reset. But, technically, if nothing untoward ever happened to your device, this shouldn't be needed, it's just a precaution.

And speaking of destructive manipulations, combining a factory reset with a FW update *will* irremediably wipe your JB. Don't be that guy.

Last Updated: $Id: RECAP_MR_THREAD 18539 2021-06-05 18:36:07Z NiLuJe $


----

Here is an archived version of the first iteration of this document that was focused on the Factory JB, for devices where KindleBreak is currently unsupported (e.g., the PW1).

Spoiler:

What Is This?:

This aims to be an up-to-date version of @geekmaster's original "JailBreak Index" thread. It will recap what you can and cannot do with your device, and how to proceed, in a step by step process.

Identification.

First, you need to identify your device. Just follow the instructions on this wiki page.

If you can't find your exact variant in the table, PM me the first 6 characters of your S/N, along with as much information about your device as you can (marketing name, date & country of purchase/delivery, whether it's WiFi-only or has cellular capabilities, and the bezel color if appropriate). Then wait for me to confirm that stuff has been repackaged to handle it, because none of this will work until I do .

Device Generation Concerns.

The main focus of this document will be all current devices with a touchscreen, running FW 5.x.
If you're using an older device see this historical thread, with a special addition if you're using a K4.
That's for the JailBreak step itself, but everything else in here is still relevant (i.e., once you're jailbroken, you can resume following this thread).
On those older devices, you'll also want to replace the JB Hotfix with the Mobileread Kindlet Kit when the former gets mentioned later on.

The Right Tools For The Job.

You'll soon realize that most of my stuff, despite being spread over a few dedicated threads, will actually redirect you to my Snapshots thread to actually download the files. I'd suggest keeping it open in a separate tab, or you might start to get dizzy with the amount of cross-references .
This allows me to centralize and update everything in one step.
Most of the files are shipped as xz compressed tarballs (.tar.xz). You'll need a decent unarchiver to handle those. We generally recommend 7-zip. If your unarchiver only leaves you with a simple tarball (.tar), you'll have to unpack that, too, to get to the goods.
This applies to everything, even KUAL extensions (i.e., if a bit of documentation says "just unpack it to <somewhere>", it means unpack the *inner* tarball).

JailBreak.

On current devices, the process involves installing a *factory* version of the FW. You are *not* able to downgrade a Kindle, which means you will have to be running a FW version <= to the factory image we have on hand.
If you're not, you're out of luck, at least not without hardware modifications, which we only know how to handle on *some* specific models (generally, older/simpler ones).

Which means making sure you won't get force-fed an unwanted OTA update is *very* important. Switch to airplane mode ASAP, and create a *folder* named update.bin.tmp.partial at the top-level (in other words, at the root) of the visible USB storage.
WARNING: FW >= 5.12.x is potentially much more aggressive, and we currently don't have a sure-proof way of preventing OTA updates on those newer FW versions (short of sticking to Airplane mode).
WARNING: FW >= 5.12.2 is definitely much more aggressive, and it will *probably* destroy your JailBreak. You'll want to make *absolutely* sure that your bridge is up-to-date *before* the update to have any chance of keeping it alive.
TL;DR: Stay away from FW >= 5.12.x.

As of right now, the list of supported devices is as follows:
  • PW2: 5.4.3.2 (MD5: 3cbac0b4821cec03432b9ed382744f41)
  • KT2: 5.6.0 (MD5: d85a86f5c75b4b9d43648f3b6afd2e84)
  • KV: 5.5.0 (MD5: f7c8905ea993fef902be82b70a98542a)
  • PW3: 5.9.6.1 (MD5: a5460e698a531c7770ba2b1ac31667b0)
  • KOA: 5.7.4 (MD5: 8f1e7c9124a2b12e643b15447d80feae)
  • KT3: 5.8.0 (MD5: 3f1a5294e1bca8c4fa7ca2762c5b4505)
  • KOA2: 5.9.0.6 (MD5: 18624db8c1838ec2b5b8bfb3406ac041)
  • PW4: 5.10.1.3¹ (MD5: 538d939c2cb4f05c7952d33d5348f010)
  • KT4: 5.11.0 (MD5: fd3e7ed8ebea59432163a5e713cd90c5)
  • KOA3: NONE (MD5: N/A)

Be *very* careful to pick the right file for your device, because failing to do that *will* result in a brick.

You should be able to find links to those images at the bottom of this WiKi page, or, barring that, via Google (in which case, double-check the md5 sum of the files).

Once you've got your hands on an image that fits your device, check out this thread for detailed instructions, and come back here once that's done .

NOTE: For older devices running FW <= 5.4.4.2, see this historical thread. Keep in mind that you will *still* then have to install the JB hotfix, except you'll have to use the "bridge" .bin from the full JailBreak package, instead of the actual "hotfix" .bin itself (because it will not run on FW < 5.5.0).

[1]: If your PW4 is running FW <= 5.13.3, all is not lost. Please see this thread for alternate details about this step.

TL;DR: Identify your device, install the appropriate factory image like any other FW update. Once it's done (it will take a while, longer than a "normal" FW update), you can install the Factory JB.

Making sure your JB survives updates.

It's as simple as installing the JB Hotfix.
This will also take care of a few other necessary bits and bobs for the following steps.

TL;DR: This one should be installed via the "Update Your Kindle" menu, after dropping the .bin file at the top-level of the visible USB storage.

Installing custom packages.

You can now forget about the "Update Your Kindle" (UYK) menu, everything will have to go through the MobileRead Package Installer (MRPI).

You might be wondering why this is listed first, while it appears to depend on another tool: KUAL. That's a bit of a catch-22 that we'll take care of shortly; for now, install MRPI as if you actually had KUAL installed .

TL;DR: This is as simple as extracting the package at the top-level of the visible USB storage.

KUAL.

This is a GUI frontend that many custom tools will rely on, as such, we consider it a mandatory dependency.

As it's designed to run across the *full* range of Kindle devices, there are four different variants of it available.
If you're running FW >= 5.9, you'll need the "Booklet (coplate)" variant.
If you're running FW < 5.9 you can use the "Booklet" variant, or the "KDK-2" variant. Prefer the Booklet variant.
On older FW < 5.x devices, you'll have to use the "KDK-1" variant.

While the KDK variants were simple files you just sideloaded like any other book, the Booklet variants are proper packages, which is why MRPI had to come first .

TL;DR: Booklet variants should be installed via MRPI: drop the .bin in the mrpackages directory, located in the top-level of the visible USB storage (if you don't see it, you bungled the MRPI install in the previous step), then run MRPI by entering ;log mrpi in the Homescreen's searchbar, then wait for MRPI to proceed. If nothing happens, you bungled something along the way.

NOTE: If, despite the many earlier warnings, you're currently running FW >= 5.12.2, things get a little dicey: ;log may be gone. Instead, in the "Booklet (coplate)" archive, you'll find an Update_KUALBooklet_hotfix_*_install.bin install package, which you'll have to install via UYK (like the JB Hotfix earlier).


Enjoy!.

You should now be ready to play with a lot of what's available on MR! A couple things to remember, though: As there's been a long history of various Kindle models and FW, some things may only target and/or behave properly on some specific models and/or FW versions. The documentation may not be any help in making you aware of that fact, especially for older stuff (the original author may be inactive, and even if he isn't, making sure stuff works everywhere and/or document it is a *lot* of work). Feel free to ask in the relevant thread, there's a good chance someone will tell you if it has a chance of working, or not .

As a rule, everything in my Snapshots thread should be sane & safe to use: it will either gracefully refuse to install on unsupported devices, or, barring that, gracefully refuse to *run* on unsupported devices.

Remember that MRPI supports installing *multiple* packages at once, and will attempt to install stuff in the right order if it matters (i.e., by installing Python first, for instance, as it's generally used by a few things, either as a hard dependency, or an optional one).

Do note that leaving your device locked to the "Factory" FW version you used for this process may not be a suitable long-term solution. Some stuff might break for no apparent reason.
Because of the downgrade restrictions, the least destructive approach would be to switch to the exact same FW version, except the "normal" one. Just go to the Amazon Software Update page for your device, fudge the download URL to point to the version you need, and install that .
As a FW update will wipe everything custom except the JB itself, you can optionally do this as early as right *after* having installed the JB Hotfix if you don't want to have to basically install your hacks twice .

On newer FW versions, we recommend using the "Helper" KUAL extension, which provides a "PREVENT OTA Updates" button that will be a little more zealous than what we did earlier, which should prevent some battery draining caused by a tad aggressive "call home" behavior from those FW versions.

If you do decide to go with a more current FW version, *avoid* anything >= 5.12.x, as it has become even more aggressive, preventing you both from blocking OTA updates, and greatly (potentially fatally) hampering the JailBreak's ability to survive, as well as your recovery options!

As mentioned earlier, an official FW update will basically throw you back to the post-hotfix step: you'll basically have to reinstall anything that came bundled in a .bin, except for the hotfix/bridge itself.

Speaking of the bridge/hotfix, you shouldn't ever need to reinstall it, unless you want to make extra sure it's got its hooks set in right before and/or after doing a severely destructive manipulation, like a factory reset. But, technically, if nothing untoward ever happened to your device, this shouldn't be needed, it's just a precaution.

And speaking of destructive manipulations, combining a factory reset with a FW update *will* irremediably wipe your JB. Don't be that guy.

Last Updated: $Id: RECAP_MR_THREAD 17983 2020-12-13 16:28:58Z NiLuJe $

Last edited by NiLuJe; 05-14-2022 at 06:43 PM.
NiLuJe is offline   Reply With Quote