Merge pull request #34 from bundlerocks/quicksave

Several minor and necessary modifications

Author: ThatHackerDudeFromCyberspace

index.md

@@ -10,20 +10,24 @@ nav_order: 0
 # The Kindle Modding Wiki
 This is the Kindle Modding wiki, an online resource which hopes to consolidate all Kindle Modding knowledge into a centralised resource.
 
-{: .warning}
-Anyone who installed a [Universal Hotfix](/jailbreaking/post-jailbreak/setting-up-a-hotfix) version below `v1.2.0` *MUST* install `v1.2.0` or newer due to an OTA persistence bug. This version was released Jan 02, 2025.
-
 ## Jailbreaking?
 Just want to jailbreak your Kindle to get access to KOReader and other homebrew?
-<br/>
+
 [Getting Started With Jailbreaking](/jailbreaking/getting-started){: .btn .btn-purple }
 
 ## Developing?
 Want to develop your own software?
-<br/>
+
 [Getting Started With Development](/kindle-dev){: .btn .btn-purple }
 
+## Questions?
+Got any questions about jailbreaking?
+
+[Kindle Jailbreaking F.A.Q](/jailbreaking/jailbreak-faq.md){: .btn .btn-purple }
+
 ## Community
+Want to join our community?
+
 [Join Our Discord](https://dsc.gg/kindle-modding){: .btn .btn-purple }
 
 ## Useful Links

jailbreaking/WinterBreak/index.md

@@ -24,7 +24,7 @@ It is based on [Mesquito](../../mesquito/)
 > RIP the original deadlines
 
 {: .warning}
-Mesquio does NOT work on firmware `5.18.1` and beyond.
+Winterbreak/Mesquito does NOT work on firmware `5.18.1` and beyond.
 
 
 ## Prerequisites
@@ -53,7 +53,7 @@ If you face any issues, please check the [troubleshooting](#troubleshooting) sec
         <div class="step">
             <h2>Airplane Mode</h2>
             <div class="stepContent">
-                <p>Turn on airplane mode on your Kindle</p>
+                <p>Turn on Airplane mode on your Kindle</p>
                 <img src="./airplane_mode.png" />
             </div>
         </div>
@@ -67,23 +67,20 @@ If you face any issues, please check the [troubleshooting](#troubleshooting) sec
         <div class="step">
             <h2>Extracting WinterBreak</h2>
             <div class="stepContent">
-                <p>Once it has booted, plug the Kindle into your computer and extract the contents of the `WinterBreak.tar.gz` file to a safe place on your computer</p>
-                <p>Then copy the files to your Kindle (do not extract direcly to the Kindle as this may fail)</p>
+                <p>Once it has booted, plug the Kindle into your computer and extract the contents of the <code>WinterBreak.tar.gz</code> file to a safe place on your computer</p>
+                <p>Then copy the files to your Kindle (do not extract direcly to the Kindle as this may fail). Replace any files if you are prompted to</p>
                 <p class="highlight">
-                    For Linux/MacOS users, ENSURE the hidden folder `.active_content_sandbox` has been copied to your Kindle
+                    For Linux/MacOS users, ENSURE the hidden folder <code>.active_content_sandbox</code> has been copied to your Kindle
                 </p>
                 <img src="./file_list.png" />
-                <p class="highlight">
-                    Replace any files if you are prompted to
-                </p>
             </div>
         </div>
-        <div class="step">
+<div class="step">
             <h2>Entering Mesquito</h2>
             <div class="stepContent">
                 <p>Eject the Kindle from your computer</p>
                 <p>Open the Kindle Store on your Kindle by clicking on the cart icon on the home screen</p>
-                <p>When prompted, click `yes` to turn off airplane mode</p>
+                <p>When prompted, click <code>Yes</code> to turn off Airplane mode</p>
                 <img src="./store_aeroplane.png" />
                 <p>Once Mesquito has loaded you can re-enable Airplane mode.</p>
             </div>
@@ -99,9 +96,9 @@ If you face any issues, please check the [troubleshooting](#troubleshooting) sec
             <h2>Done</h2>
             <div class="stepContent">
                 <p>Wait around 30 seconds, and your Kindle will say something along the lines of "Now you are ready to install the hotfix"</p>
-                <p>Once it does, turn airplane mode back on and you can move onto the post-jailbreak stage!</p>
+                <p>Once it does, turn Airplane mode back on and you can move onto the post-jailbreak stage!</p>
                 <p class="highlight">
-                    If you do not see any funky text then make sure Airplane mode is disabled - turn it back on after you see the text though!
+                    If you do not see any funky text then make sure Airplane mode is disabled to avoid any automatic update. Turn it back on after you see the text though!
                 </p>
                 <img src="./winterbreak_run.png" />
             </div>
@@ -116,18 +113,29 @@ If you face any issues, please check the [troubleshooting](#troubleshooting) sec
 <script>new Guide("guide", "../post-jailbreak/setting-up-a-hotfix", "Setting Up A Hotfix");</script>
 
 # Troubleshooting
-## Kindle store encountered an unexpected error
+## Kindle Store encountered an unexpected error
 > Faced this error and found a solution [DiabloSat](https://github.com/progzone122) & [Rexathion1](https://github.com/Rexathion1)
 
-If an **“Unexpected error”** occurs when you try to log in to the Kindle Store or **only the Kindle Store home page** is displayed, try the following solution:
+If an **“Unexpected error”** occurs when you try to log in to the Kindle Store or **only the Kindle Store home page** is displayed, try the following solutions:
 
-1. Factory Reset Kindle
-2. Before registering your Kindle/logging into your account - plug your Kindle into your PC, move the WinterBreak files to the root of your storage space
-3. Log in account and enter airplane mode as soon as possible
-4. Connect Kindle to 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)
-5. Reboot Kindle
+1. Factory Reset your Kindle
+2. Before registering - plug your Kindle into your PC, move the WinterBreak files to the root of your storage space
+3. Login to your account, and enable Airplane mode as soon as possible
+4. 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)
+5. Reboot your Kindle
 6. Open the Kindle Store on your Kindle
-7. When prompted, click `yes` to turn off airplane mode
+7. When prompted, click `Yes` to turn off Airplane mode
+
+### Alternative solution
+
+1. After successfully registered, plug your Kindle into your PC and delete the `.active_content_sandbox` folder,  make sure to also delete any files with a name similar to `update.bin.tmp.partial` from your Kindle to prevent an automatic update
+2. Reboot your Kindle
+3. Disable Airplane mode and connect to a WiFi connection
+4. Browse the regular Kindle Store for a couple of minutes to generate the files needed for Winterbreak to work, browse the book categories and download a free sample of any book
+5. After a couple of minutes, enable Airplane mode and plug your Kindle into your PC again
+6. Delete the cache directory in the path `.active_content_sandbox/store/resource/LocalStorage`. If this folder has not yet been generated, browse the Kindle Store for another couple of minutes until it is generated. Make sure to always delete the previously mentioned `update.bin.tmp.partial` file, especially before any rebooting
+7. Once deleted, copy the Winterbreak files to your Kindle and reboot
+8. Open the Kindle Store on your Kindle, when prompted, click `Yes` to turn off Airplane mode
 
 # Special Thanks To Our Courageous Beta Testers
 - Crystals (Bricked their PW4 testing)

jailbreaking/getting-started.md

@@ -12,8 +12,15 @@ In order to jailbreak your Kindle, you will need to know which Kindle you have a
 Unlike Amazon, the Kindle Modding community, such as this Wiki and MobileRead reffers to Kindle models by their nicknames, ie: the `PW4` referring to the `Kindle Paperwhite (10th Generation)`
 
 This is important to note due to the fact that many Kindle jailbreaks only work on specific models.
+
 [Kindle Models](./kindle-models){: .btn .btn-purple }
 
+## Questions about Jailbreaking?
+Before attempting to jailbreak your Kindle, we strongly recommend reading the Kindle Jailbreak F.A.Q as it provides answers to common questions and issues.
+
+[Jailbreaking F.A.Q](./jailbreak-faq.md){: .btn .btn-purple }
+
+
 ## Credits
 - Thanks to [marek](https://www.mobileread.com/forums/member.php?u=340787) for creating `LanguageBreak`
 - Thanks to [katadelos](https://www.mobileread.com/forums/member.php?u=308426) for creating `WatchThis`

jailbreaking/index.md

@@ -11,7 +11,7 @@ Jailbreaking a Kindle:
 - Also allows for the development of custom homebrew to run on the Kindle
 - Why not?
 
-## What Can I do?
+## What can I do?
 As a user, this gives you access to:
 - Custom screensavers
 - Custom fonts on firmwares that do not support it

jailbreaking/jailbreak-faq.md

@@ -10,7 +10,7 @@ nav_order: 98
 We recommend reading this article before or after jailbreaking your Kindle device and share it with other people.
 
 {: .note}
-Most of these instructions are subjected to changes due to newer jailbreaks, patches, extensions, firmware versions, etc.
+Most of these instructions are subjected to changes due to newer jailbreaks, patches, extensions, firmware versions, etc. <br>`(Last updated: May 5th, 2025)`
 
 ## General/Account
 ---
@@ -19,14 +19,15 @@ Most of these instructions are subjected to changes due to newer jailbreaks, pat
 
 Winterbreak needs your Kindle to be registered, it also needs a valid, internet-connected WiFi network saved.
 
-It's still possible to jailbreak an unregistered/blacklisted device, but currently, the only jailbreaking methods for those devices work on firmware below `5.16.2.1.1`. You can find these jailbreaking methods here [Legacy Jailbreaks](https://kindlemodding.org/jailbreaking/Legacy/).
+It's still possible to jailbreak an unregistered/blacklisted device, but currently, the only jailbreaking methods for those devices work on firmware below `5.16.2.1.1`. You can find these jailbreaking methods in [Legacy Jailbreaks](https://kindlemodding.org/jailbreaking/Legacy/).
 
 ### My Kindle updated to a firmware version that doesn't have any jailbreak method! Can I still jailbreak?
 
-No 🥀.
+No.
 
-If you still want to jailbreak, forget all saved internet connections, enable airplane mode and wait for a new jailbreak method (or patch) to be released. This may take weeks or even months.
-If you want to use the Internet in the meantime, be sure to always delete the file named `update.bin.tmp.partial` from your Kindle to avoid even newer and probably unsupported firmware versions.
+If you still want to jailbreak, forget all saved internet connections, enable Airplane mode and wait for a new jailbreak method (or patch) to be released. This may take weeks or even months.
+
+If you want to use the Internet in the meantime, be sure to always delete the file named `update.bin.tmp.partial` from your Kindle to avoid even newer unsupported firmware versions.
 
 ### Can I remove my account after jailbreaking?
 
@@ -45,6 +46,9 @@ Don't forget to re-enable automatic updates first (`Restore` option in `renameto
 
 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.
 
+### Will this void the warranty on my Kindle device?
+Probably.
+
 ### How do I get the Amazon store back again?
 
 [Read and follow this guide](https://kindlemodding.org/jailbreaking/post-jailbreak/re-enabling-the-store/).
@@ -64,19 +68,18 @@ This ultimately means that most extensions found on MobileRead/Discord servers w
 
 Yes.
 
-#### Will my books and highlights be deleted after jailbreaking?
+#### Can I still sideload books after jailbreaking?
 
-No. 
-
-### How do I read my Amazon ebooks within KOReader?
+Yes.
 
-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.
+#### Will my books and highlights be deleted after jailbreaking?
 
-### How do I read my Libby books?
+No.
 
-You cannot use the Libby service within KOReader. You can get the EPUB file from Libby by following [this guide](https://help.libbyapp.com/en-us/6059.htm).
+{: .note}
+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](https://www.mobileread.com/forums/showpost.php?p=4419300&postcount=409) 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.
 
-### Will Libby/Readwise/GoodReads/Kindle Unlimited still work after jailbreaking?
+### Will Libby/Readwise/GoodReads/Kindle Unlimited/Send To Kindle still work after jailbreaking?
 
 Yes. Jailbreaking doesn’t interfere with any of these services.
 
@@ -88,6 +91,14 @@ Unless there's a plugin for it, no.
 
 Unless there's a extension/port for any of them, no.
 
+### How do I read my Amazon ebooks within KOReader?
+
+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.
+
+### How do I read my Libby books?
+
+You cannot use the Libby service within KOReader. You can get the EPUB file from Libby by following [this guide](https://help.libbyapp.com/en-us/6059.htm).
+
 ### Where can I download free e-books?
 
 **You can Google this.**
@@ -109,8 +120,7 @@ KOReader currently does not support USBMS mode (USB transfer) and will only char
 
 Not necessarily.
 
-You can launch it with simple [scriptlets](https://kindlemodding.org/kindle-dev/scriptlets.html).  
-Specifically, Marek's launcher that is available [here](https://scriptlets.notmarek.com/).
+You can launch it with simple [scriptlets](https://kindlemodding.org/kindle-dev/scriptlets.html), specifically, Marek's launcher that is available [here](https://scriptlets.notmarek.com/).
 
 A [KUAL booklet launcher (made by yparitcher)](https://github.com/yparitcher/KUAL_Booklet/releases/) 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](https://www.mobileread.com/forums/showpost.php?p=4222466&postcount=15).
 
@@ -152,11 +162,11 @@ Download the "Check OTA Status" scriptlet from [here](https://scriptlets.notmare
 
 ### Is it possible to change screensavers in the native Kindle UI?
 
-Yes, but it is not recommended at least on hard-float firmware, as it is very easy to brick the device.
+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 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.
+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.
+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.
 
 {: .highlight}
 If you are, however, running soft-float firmware prior to 5.16.2.1.1 you can install [NiLuJe's screensaver hack](https://www.mobileread.com/forums/showthread.php?t=195474). **Please do not make the mistake in installing this extension on hard-float firmware.**
@@ -213,7 +223,7 @@ You can do one of the following:
 
 ### What does the KFT option in the settings menu do?
 
-:) 
+<p>¯\_(ツ)_/¯</p>
 
 ## Credits
 - Written by Bundlerocks