06-04-2019, 11:46 AM | #1 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
Open Sesame! (AKA., The New & Improved JailBreak Index)
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 (WatchThis) requires a device running a FW version <= to 5.14.2. If that's not you, then you're currently sorely out of luck. If that's you, check out the WatchThis 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 WatchThis 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 non-intrusive ways to prevent OTA updates, c.f., the mentions about that in the final section of this document. WARNING: FW >= 5.15.1.1 INTRODUCED A BREAKING CHANGE. DO NOT UPDATE! 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, (almost) *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 19014 2023-02-23 04:55:03Z NiLuJe $ Last edited by NiLuJe; 02-23-2023 at 12:55 AM. |
06-04-2019, 11:48 AM | #2 |
BLAM!
Posts: 13,497
Karma: 26047188
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:
---- 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:
Last edited by NiLuJe; 05-14-2022 at 07:43 PM. |
Advert | |
|
06-04-2019, 12:06 PM | #3 |
Wizard
Posts: 1,086
Karma: 3592591
Join Date: Sep 2014
Location: Ukraine
Device: Kindle PW2, PW3, PW4, Voyage
|
Great and thanks! May I correct a little bit:
- KDK-2 doesn't work beginning from FW 5.9.2, but - on PW2 KDK-2 works on any FW including the latest one. |
06-04-2019, 12:30 PM | #4 | |
Going Viral
Posts: 17,212
Karma: 18210809
Join Date: Feb 2012
Location: Central Texas
Device: No K1, PW2, KV, KOA
|
This looks more like office politics than technical decisions:
Quote:
Evidently, each "lead person" lives in a different country and they all speak different languages (if they even try to speak to each other before a release). Jeff "D.A." Bezos at work (again). |
|
06-04-2019, 12:39 PM | #5 |
Wizard
Posts: 1,086
Karma: 3592591
Join Date: Sep 2014
Location: Ukraine
Device: Kindle PW2, PW3, PW4, Voyage
|
And factory 5.4.3.2 can be installed to PW2 with up to FW 5.8.7.0.1 including.
|
Advert | |
|
06-04-2019, 01:05 PM | #6 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
@hius07: All true, but left out of the first post to avoid any more "... except if x.z.y you might get away with a.b.c" than strictly necessary .
See also the decision to just say "you can't downgrade a Kindle", which wasn't always technically true either . (i.e., KISS). Last edited by NiLuJe; 06-04-2019 at 01:09 PM. |
06-04-2019, 02:36 PM | #7 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
Okay, everything should now be live .
This officially marks the death of the outrageously old & outdated tagged releases of my packages (at least those targeting FW 5.x), so it's snapshots & MRPI all the way now . (You'll also notice that a few things have moved to the main snapshots post itself, namely, KUAL (coplate) and the JB Hotfix). I should have updated each relevant thread accordingly, do drop me a line if something feels wonky, or if I messed up/forgot something! Many thanks to @ilovejedd for the KT4 factory image and her test of the PoC . Last edited by NiLuJe; 06-04-2019 at 02:45 PM. |
06-04-2019, 02:47 PM | #8 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
And before I forget, much like in the KUAL thread, I highly recommend installing gawk to speed KUAL up, as well as the Helper extension, which includes a button to block OTA updates in a potentially more complete manner, which was shown to curb some stupid battery-draining behavior in some recent FW releases...
|
06-04-2019, 03:00 PM | #9 | |
hopeless n00b
Posts: 5,110
Karma: 19597086
Join Date: Jan 2009
Location: in the middle of nowhere
Device: PW4, PW3, Libra H2O, iPad 10.5, iPad 11, iPad 12.9
|
Quote:
|
|
06-04-2019, 03:07 PM | #10 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
@ilovejedd: Yeah, @hius07 mentioned that already, I could swear stuff started braking down as early as 5.8, though. Might only be KPVBooklet, not KUAL, I'll trust the both of you .
|
06-04-2019, 03:21 PM | #11 | |
hopeless n00b
Posts: 5,110
Karma: 19597086
Join Date: Jan 2009
Location: in the middle of nowhere
Device: PW4, PW3, Libra H2O, iPad 10.5, iPad 11, iPad 12.9
|
Quote:
I'm still running the KDK-2 on a PW3 5.8.11 (for the absolutely shallow reason that it has an icon). |
|
06-04-2019, 03:27 PM | #12 |
BLAM!
Posts: 13,497
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
Good to know .
And in the same vein, to complement what @hius07 mentioned about the PW2, the classic Booklet also works just fine on a PW2 @ 5.9.7 . |
06-04-2019, 03:36 PM | #13 |
Wizard
Posts: 1,086
Karma: 3592591
Join Date: Sep 2014
Location: Ukraine
Device: Kindle PW2, PW3, PW4, Voyage
|
OK, to complete exclusions, it should be mentioned that factory firmware 5.8.0 can he installed to any version of shipped (not updated) KT3.
|
06-04-2019, 04:54 PM | #14 | |
Member
Posts: 15
Karma: 10
Join Date: May 2019
Device: KT4
|
Quote:
Sucssesfuly JB'ed my Kindle. Thank you NiLuJe and all, you rock! Last edited by jhh; 06-04-2019 at 04:56 PM. |
|
06-04-2019, 04:57 PM | #15 | |
Going Viral
Posts: 17,212
Karma: 18210809
Join Date: Feb 2012
Location: Central Texas
Device: No K1, PW2, KV, KOA
|
Quote:
In case you missed reading all of what you quoted: Go to your device's update page Copy the update URL (in this case, to 5.11.2) Edit the URL (by changing the 5.11.2 to 5.11.0) Click and save. Last edited by knc1; 06-04-2019 at 04:59 PM. |
|
|
Similar Threads | ||||
Thread | Thread Starter | Forum | Replies | Last Post |
Kindle Developer's Corner Master Index (aka. Where Do I Start?) | geekmaster | Kindle Developer's Corner | 131 | 11-19-2021 12:51 PM |
Kindle (eink) Jailbreak Index | geekmaster | Kindle Developer's Corner | 9 | 09-21-2017 01:13 PM |
[M96] App switch aka ALT+TAB aka long press home | machinogodzilla | Onyx Boox | 19 | 09-17-2017 01:21 PM |
Best firmware for Hanlin V5 aka Bebook Mini aka Papyre 5.1? | javimm | HanLin eBook | 1 | 01-11-2010 06:37 PM |
PRS-500 PRS-500 (aka Sony Reader) cracked open. | Stuart Young | Sony Reader Dev Corner | 11 | 11-21-2006 04:58 PM |