KindleModShelf.me Site Archive ================================ Generated text archive with links included. --- FILE: 2048.html --- --------------------- ← Back to Home (index.html) # 2048 for Kindle 2048 is the number-merging puzzle where you combine tiles to reach 2048. Built with the Illusion framework and tuned for Kindle's e-ink display. # Download - Download 2048.zip (downloads/2048.zip) # Features - Classic 2048 on a 4×4 grid - Arrow-button controls (no swipe required) - Score and high-score tracking - Clean e-ink-friendly interface - Endless play—continue past 2048 if you want # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download 2048.zip (downloads/2048.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Use the on-screen arrow buttons (▲ ◀ ▶ ▼) to slide the board - Equal tiles that collide merge into one (e.g., 2+2→4) - Keep merging tiles to create 2048 - The game ends when no moves remain Enjoy the 2048 puzzle on your Kindle’s e-ink display! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: adbreak.html --- ------------------------ ← Back to Home (index.html) # AdBreak 📺 Free Video Tutorial Available Comprehensive step-by-step video guide by Dammit Jeff . AdBreak is jailbreak released on 24 Sep 2025 for ad-enabled Kindle devices on firmware 5.18.1 → 5.18.5 . It leverages an exploit related to CVE-2012-3748 . This page gives the essential facts, a compact install checklist, how to enable ads if needed, and key troubleshooting notes. Read everything before you begin. Official release & resources (https://kindlemodding.org/jailbreaking/AdBreak/) # Release at a glance - Release date: 24 Sep 2025 - Maintainer: @hhhhhhhhh - Exploit base: CVE-2012-3748 - Supported firmware: 5.18.1 – 5.18.5 (some micro-patches may block the exploit) - Requires: Special Offers (ads) active on the lockscreen # Prerequisites - PC + USB cable (you will copy/replace the device .assets folder) - Kindle must be registered and not blacklisted - Kindle must display Special Offers (ads) on the lockscreen - Device firmware must be in the supported range (see above). If ≤ 5.18.0.2, use WinterBreak instead. Do not proceed without verifying the above—especially the presence of ads and correct firmware. # Quick install checklist - Download the latest AdBreak package from the official release page. - Confirm ads: keep the Kindle online until ads appear on the lockscreen. If no ads appear, a factory reset can sometimes help (see Troubleshooting). - Enable airplane mode after ads are visible. - Open lockscreen menu → View all ads to confirm multiple Special Offers are listed. - Copy .assets – connect Kindle to PC and copy the device's .assets folder (backup the original). - Unpack AdBreak and merge its files into the copied .assets folder on your PC. - Run replace helper: - Windows – run replace.bat - macOS / Linux – run the provided terminal command to place the exploit HTML into matching ad folders (example in the release) - Replace device assets: delete the original .assets on the Kindle and copy the modified folder back. - Trigger exploit: unplug the Kindle, tap the modified ad, follow prompts; the jailbreak script should run at the final popup. Backup your original .assets folder and any data before modifying anything. # Enable Special Offers (if needed) If your device shipped without ads you can often re-enable them via your Amazon account: - Amazon → Manage Your Content and Devices → Preferences → Country/Region : select a supported region (US, UK, DE, FR, IT, ES, JP, CN). - Add a matching billing address and a payment method (card required; usually no charge). - Enable Special Offers for your device and sync – ads should populate the lockscreen after some time. Important: Kindle Scribe and Colorsoft cannot be made ad-enabled and are not compatible with AdBreak. # Troubleshooting # FAQ - The JB does not automatically remove advertisements—see Marek’s scriptlet. - It will never work on the CS/Colorsoft; ads cannot be re-enabled there. - No, this is not “UJ”/“Unnamed Jailbreak”. That is separate. - “Is there a way to make my device ad supported?” (See below.) # Common Issues - Can’t find the system folder: On mass-storage Kindles, if you cannot see the system folder, navigate to the path manually or follow a guide to reveal protected system folders. - “Bang!” shows but the jailbreak doesn’t run: Check the .assets folder on the Kindle— jb.sh and patchedUks.sqsh must be present. # Enabling Ads Needed for jailbreak, safe to remove later. - Switch account region: Go to Manage Your Content and Devices → Preferences → Country/Region Settings → Change . Select one of: US, UK, DE, FR, IT, ES, JP, CN, AU. Use valid details (address, phone, email). - Add payment method: Set a default credit card and billing address matching the chosen region. No charge should occur. - Enable special offers: In your Amazon account, turn on Special Offers for your Kindle. - Sync Kindle: Connect to Wi-Fi—ads will eventually appear on the lockscreen. Notes: - If your Kindle originally had no ads, re-disabling later is free. - If your Kindle is an ads model, disabling normally costs a one-time fee, but it can be removed post-jailbreak with a script. # Special Thanks - Penguins184: This guide - Ceoz: Enable-ad findings Summary: AdBreak is a targeted jailbreak for ad-enabled Kindles on firmware 5.18.1–5.18.5. It requires Special Offers and a PC to replace the device .assets . Verify prerequisites, back up originals, and consult community threads for model-specific advice before you proceed. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: all-kindle-linux-chroots.html --- ----------------------------------------- ← Back to Home (index.html) # All Kindle Linux Chroots # Available Linux Chroots - Alpine OG (GUI) (https://github.com/schuhumi/alpine_kindle) - Alpine Better (newer w/GUI) (https://github.com/Entersjkhdfkjdhfksjf/alpine_kindle) - Yet another Alpine (shell w/Min GUI) (https://github.com/ohaiibuzzle/alpine_kindle) - Debian (GUI) (https://github.com/Ooonana/Debian_kindle) - Fedora (Shell) (https://github.com/GreenCat-777/fedora_kindle) - Ubuntu (Shell) (https://github.com/GreenCat-777/ubuntu_kindle) Note: Instructions are included for all but Yet another Alpine. For that, you can get instructions here on the Kindle modding Discord (https://discord.com/channels/1083603487025274911/1440969313061306409/1440969313061306409) . # Credits - schuhumi (https://github.com/schuhumi) – Alpine OG - Entersjkhdfkjdhfksjf (https://github.com/Entersjkhdfkjdhfksjf) – Alpine Better - ohaiibuzzle (https://github.com/ohaiibuzzle) – Yet another Alpine - GreenCat777 (https://github.com/GreenCat-777) – Fedora and Ubuntu Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: alpine.html --- ----------------------- ← Back to Home (index.html) Use at your own risk. # ALPINE LINUX Alpine Kindle lets you run Alpine Linux directly on your Kindle e-reader. You can launch a minimal version of Chromium and manage files from a real Alpine Linux UI—right from your Kindle. # MAIN FEATURES - Run a lightweight Alpine Linux environment on your Kindle - Open a basic version of the Chromium web browser - Perform file management from a Linux shell interface - Experience a computer-like Linux desktop—on Kindle’s e-ink display - Primarily for being able to say my Kindle is running Linux # DOWNLOADS - Download & Source: QuickAlpine on GitHub (https://github.com/GreenCat-777/QuickAlpine) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: announcements.html --- ------------------------------ ← Back to Home (index.html) # Announcements & Updates KindleModShelf changelog, site news, and release highlights—a single feed that captures what changed and why. Keep this page handy if you want to know when new jailbreak guides, tools, or showcase posts go live. Latest Updates Newest entries sit at the top December 2025 — New Tools, Games & Guides # New Pages Added - blockamazon.html (blockamazon.html) helps block unwanted Amazon content on your Kindle. - clearadcache.html (clearadcache.html) provides tools to clear ad caches and optimize performance. - kships.html (kships.html) brings the KShips Battleship game to your Kindle. - universalpaperclips.html (universalpaperclips.html) ports the popular Universal Paperclips game to Kindle. - All Kindle Linux Chroots (all-kindle-linux-chroots.html) (credit: GreenCat-777) compiles a complete guide to Linux environments on Kindle devices. # Improvements - Enhanced UI across the entire site for a more polished and consistent experience. - Improved KAnki Editor (editor.html) with better usability and design. - Added more informational pages to help you get the most out of your Kindle. December 2025 — Gallery Overhaul & Site Reorganization # Images Gallery Complete Redesign - The image gallery (images.html) now displays images in a randomized continuous stream for a cleaner browsing experience. - Gallery order refreshes daily so you get a fresh selection of images on each visit. - Clicking any image opens a full-size viewer with a sidebar showing all other images by the same author. - Placeholder backgrounds now adapt to your light or dark mode theme. - Search by author name still shows results in the original grouped layout for easy discovery. # Site Structure & Navigation - Added a new Emulators section to organize all emulator tools in one place. - Reorganized Tools into development tools and utilities for better clarity. - Top navigation menu now includes quick links to Gallery (images.html) , Updates (announcements.html) , KindleModShelfGPT (https://chatgpt.com/g/g-68f1ee6408d08191b257737ed200a504-kindlemodshelfgpt) , and more. - Fixed category filtering to show more accurate results across all tools and guides. # KOReader Patches Page Updates - The patches page (patches.html) now organizes user patches into logical categories for easier browsing. - Essential patches are clearly marked so you can find the most useful ones quickly. - Added setup guidance for patches that require special installation steps. # Credits & Attribution - Added proper developer credits to Gambatte emulator pages (Gambatte-K by liim, Gambatte-K2 by crazy-electron). Late October 2025 — KOReader Tools & Extras # New Pages - patches.html (patches.html) collects KOReader user patches with install steps and compatibility notes. - gpt.html (gpt.html) ships KindleModShelfGPT context packs and the exact prompt text. - peki.html (peki.html) and bootkoreader.html (bootkoreader.html) document MRPI-free KUAL installs plus KOReader autostart toggles. - timeblock.html (timeblock.html) introduces KOReader Time Block parental controls with a downloadable plugin. - icon.html (icon.html) showcases the hand-drawn KOReader interface pack with matching Project Title icons. - debrick.html (debrick.html) (by MonkeyInPrivite) breaks down how to recover a “bricked” Kindle step by step. # Content Updates - AdBreak guide (adbreak.html) tightened its layout and copy so the video, summary, and checklist line up cleanly. - KAnki page (kanki.html) now includes a personal maintainer note, clearer install guidance, and editor callouts. - plugins.html (plugins.html) , storagetool.html (storagetool.html) , and kindleforge.html (kindleforge.html) were expanded into deep-dive references with fresh screenshots and download callouts. - Homepage (index.html) call-to-actions highlight KindleModShelfGPT, new KOReader utilities, and the announcements feed. # Downloads & Assets - timeblock.koplugin.zip (downloads/timeblock.koplugin.zip) hosts the KOReader Time Block build linked from the new guide. - icons.zip (downloads/icons.zip) and projecttitleicons.zip (downloads/projecttitleicons.zip) provide the hand-drawn UI assets in one place. October 2025 — Full Site Refresh # Major Updates - Completely rebuilt the entire UI from the ground up with a cleaner, more responsive design. - Fully rewritten and refreshed all site content — every single page has been updated. - Recreated GPT interface: Kindle Mod Shelf GPT (https://chatgpt.com/g/g-68f1ee6408d08191b257737ed200a504-kindlemodshelfgpt) . - Improved the screensaver gallery (images.html) for faster loading and smoother performance. # New Pages Added - plugins.html (plugins.html) - kindleforge.html (kindleforge.html) - projecttitle.html (projecttitle.html) - gargoyle.html (gargoyle.html) - nethack.html (nethack.html) - tictactoe.html (tictactoe.html) - audiovideo.html (audiovideo.html) - jarlauncher.html (jarlauncher.html) - textadept.html (textadept.html) - storagetool.html (storagetool.html) - screencontrol.html (screencontrol.html) - nano.html (nano.html) # Informational Section Started - kual.html (kual.html) - jailbreakonmac.html (jailbreakonmac.html) # Notes If you’d like your content removed, prefer to stay anonymous, or notice missing credit or incorrect links, please reach out: - Discord: @kindlemodshelfguy on the Kindle Modding server - Email: admin@kindlemodshelf.me (mailto:admin@kindlemodshelf.me) (responses may be slower) September 2025 — Launching KindleModShelf Announcements Welcome! This new announcements page gathers every noteworthy change happening across KindleModShelf. We’ve added it so you can track fresh jailbreak guides, mod updates, and behind-the-scenes improvements without hunting through individual pages. Here’s what to expect from this feed: - Spotlights on new or overhauled guides, including jailbreak walkthroughs and KOReader plugins. - Heads-up on refreshed downloads, compatibility notes, or breaking firmware news. - Reminders about updated screenshots, assets, or navigation tweaks so the site stays easy to browse on Kindle. Have something you need us to change? DM kindlemodshelfguy on the Kindle Modding Discord or email admin@kindlemodshelf.me (mailto:admin@kindlemodshelf.me) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: audiovideo.html --- --------------------------- ← Back to Home (index.html) # Video + Audio Playback (Experimental) Experimental demo that pairs gmplay video with SoX audio on Kindle. Not a polished media player—intended for tinkering and proof-of-concept only. Hardfloat (HF) Demo Features - Plays .gmv.gz video via gmplay with separate audio via SoX. - Simple script launcher for quick demos in KTerm. - Works when audio and video files match; bundled demo media is not synchronized. Requirements - Jailbroken Kindle running hardfloat firmware. - KTerm (kterm.html) terminal installed. Download & Install (HF) - Download video-audio-all.zip (Google Drive) (https://drive.google.com/file/d/1633_dfciSHXBJbkhkTucIDFEsM4Z7SLX/view) . - Unzip on your computer or Kindle. - Place the videos folder in your Kindle root ( /mnt/us ). - Place the vidoe-audio folder (typo intentional) into /mnt/us/extensions/ . How to Run (HF) cd /mnt/us/extensions/vidoe-audio/ chmod +x playgmvmp3.sh ./playgmvmp3.sh - The bundled HF demo uses gmplay’s sample video with a separate audio track (not synchronized). - To create a synced demo, put matching .gmv.gz and .wav files in /mnt/us/videos/ with consistent names, and edit the script if necessary. Softfloat (SF) Demo Requirements - Jailbroken Kindle with softfloat firmware. - KUAL (kual.html) (Kindle Unified Application Launcher) installed. Download & Install (SF) - Download bad_apple.tar.xz (downloads/bad_apple.tar.xz) . - Unzip on your computer or Kindle. - Place the bad_apple folder into /mnt/us/extensions/ . How to Run (SF) Open KUAL and launch the demo directly from the menu. It plays the included video using gmplay and SoX when supported. # References - gmplay (Geekmaster video): MobileRead thread (https://www.mobileread.com/forums/showthread.php?t=177455) - SoX Media Player: local page (sox.html) · MobileRead thread (https://www.mobileread.com/forums/showthread.php?t=336390) Credits - Himbeer (https://www.himbeer.me) – SF version - kindlemodshelfguy – HF version - gmplay by community developers (see thread) - SoX Media Player by MobileRead community Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: blockamazon.html --- ---------------------------- ← Back to Home (index.html) # Blocking Amazon This extension blocks amazon tracking, kindle store, and ui ads on your kindle. # Download Latest Zip (https://github.com/mitchellurgero/kindle-kual-blockamazon/releases) # Installation Download the Latest Zip (https://github.com/mitchellurgero/kindle-kual-blockamazon/releases) Extract and then copy blockamazon to your KUAL Extensions folder ( /extensions/ by default). Open KUAL and run the block or unblock function. It will take effect immediately. # Notes This extension blocks some Amazon domains via /etc/hosts to disable the kindle store on the device. # Known Issues If there is store cache, it will still show some ads. However new stuff is still blocked. Use our script (clearadcache.html) to clear the cache to get rid of most of the remaining ads on the kindle ui. # Credits mitchellurgero (https://github.com/mitchellurgero) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: bootkoreader.html --- ----------------------------- ← Back to Home (index.html) # Boot KOReader Automatically A KUAL extension that installs or removes KOReader autolaunch scripts so the reader starts on boot without disabling the standard Kindle interface. # Overview The KOReader Autolaunch extension toggles a boot script that opens KOReader as soon as the Kindle finishes starting up. The script leaves Amazon’s UI running so the process remains stable, and you can reverse the change at any time from KUAL. # Downloads - KOReader Autolaunch Extension (GitHub) (https://github.com/meepcat55/Kindle-KOReader-On-Boot) # Features - Installs KOReader autostart scripts from KUAL - Leaves the Kindle UI running to avoid failed boots - Provides removal and recovery options without manual edits # Requirements - KOReader installed - KUAL (Kindle Unified Application Launcher) # Installation - Download the repository archive from GitHub and extract it. - Copy the extracted extension folder into the extensions/ directory on your Kindle. - Eject the Kindle safely and open KUAL. - Launch KOReader Autolaunch from KUAL and choose Install . # Uninstallation - In KUAL, open KOReader Autolaunch and select Remove . - Or run bash /mnt/us/KOReader-autolaunch-remove.sh inside KOReader’s terminal emulator. - Or connect the Kindle over USB, rename koreader.sh in the koreader/ folder, perform option 1, then restore the filename. # Notes - The extension keeps Amazon’s UI alive to maintain reliable startup. - Re-run the installer after KOReader updates if the autolaunch script changes. # Links - Project Repository (https://github.com/meepcat55/Kindle-KOReader-On-Boot) # Credits - Developed by meepcat55 Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: calendaroverlay.html --- -------------------------------- ← Back to Home (index.html) # Calendar Overlay for KOReader Calendar Overlay is a KOReader patch that displays your upcoming calendar events directly on your Kindle's sleep screen. Shows next events, today's schedule, or tomorrow's schedule — all overlaid beautifully on your screensaver. # Download - 2-zzz-calendar-overlay.lua (downloads/2-zzz-calendar-overlay.lua) # Main Features - Displays upcoming calendar events on sleep screen - Multiple display styles: Minimal, Today's Schedule, Tomorrow's Schedule, Full Day - Auto-refresh every 30 minutes - Works with any ICS calendar feed (Google Calendar, Proton Calendar, iCloud) - Configurable through KOReader menu - Smart caching prevents excessive network requests # Installation - Get an ICS link from your calendar provider ( How to get an ICS URL (https://www.onecal.io/blog/how-to-get-an-ics-url-for-your-calendar) ) - For Proton Calendar users: Share calendar via link (https://proton.me/support/share-calendar-via-link) - Download 2-zzz-calendar-overlay.lua - Open the file in a text editor - Paste your ICS link into the PUT_YOUR_ICS_URL_HERE spot (line 13) - Plug in your Kindle to your computer - Move the file to /mnt/us/koreader/patches/ (create the patches folder if it doesn't exist) - Safely eject your Kindle - Open KOReader - Go to KOReader and swipe down → Tools → More tools → Calendar Overlay to open menu and enable patch. # Notes - Basically all calendars can be exported as an ICS. Personally tested with Proton Calendar but all others should work. - Obviously, you have to have WiFi on to make this work # Credits - kindlemodshelfguy (https://kindlemodshelf.me) - Inspiration from: WeatherLockscreen (https://github.com/loeffner/WeatherLockscreen) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: clearadcache.html --- ----------------------------- ← Back to Home (index.html) # Clear ads cache This removes the cache ads on your kindle ui. # Download remove_cache.zip (/downloads/remove_cache.zip) # Features Cleaned kindle ui # Requirements Blocking Amazon (blockamazon.html) # Installation Unzip file Move the script ClearCache.sh to the documents folder on you kindle Move the script clear_cache.sh into the root of your kindle (otherwise known as /mnt/us/) Click on the new book in your library called "Clear Cache & Thumbnails" # Notes To undo just reenable Blocking Amazon (blockamazon.html) # Credits - kindlemodshelfguy (https://kindlemodshelf.me) - GreenCat777 - added image to booklet Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: connect4.html --- ------------------------- ← Back to Home (index.html) # Connect 4 for Kindle Connect 4 is the classic head-to-head strategy game. Drop checkers into columns and try to make a line of four while blocking your opponent. # Download - Download connect4.zip (downloads/connect4.zip) # Features - 7×6 grid, win detection in all directions - Two-player (take turns) - Numbered column buttons (1–7) to drop pieces - Score tracking and clear e-ink visuals # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download connect4.zip (downloads/connect4.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Tap the numbered buttons (1–7) to drop a checker in that column - Players alternate turns - Connect four in a row—horizontal, vertical, or diagonal—to win Challenge a friend to Connect 4 on Kindle! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: credits.html --- ------------------------ ← Back to Home (index.html) # Credits KindleModShelf is built and maintained by a dedicated community of developers and contributors. This page honors everyone who has helped make this resource possible. # Core Team - kindlemodshelfguy (NemesisHubris) (https://github.com/NemesisHubris) Site creator and maintainer. Built and designed the KindleModShelf website from the ground up. # Major Contributors - jsprolsson (https://github.com/jsprolsson) Edits and improvements to the KAnki Editor. Enhanced functionality and user experience. - GreenCat-777 (https://github.com/GreenCat-777) Created the All Kindle Linux Chroots page and was the first to test the Page Builder tool. Valuable feedback and contributions to improve the platform. - MonkeyInPrivite (https://github.com/monkeyinprivite) Created the DeBrick guide providing step-by-step recovery instructions for bricked Kindle devices. # Acknowledgments We also thank the broader Kindle modding community for their support, bug reports, suggestions, and contributions. The tools and resources featured on KindleModShelf represent the collective effort of many talented developers in the Kindle jailbreaking and modding community. # Want to Contribute? KindleModShelf is an open community project. If you'd like to contribute, whether through content, code, bug fixes, or feature suggestions, please reach out to the team or visit the project repository on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: customscreensavers.html --- ----------------------------------- ← Back to Home (index.html) # How to Set Up Custom Screensavers on a Jailbroken Kindle KOReader Sleep Screen: Swap Amazon’s default sleep screen for your own image folder and rotate custom art every time your Kindle sleeps. # Requirements - Jailbroken Kindle (jailbreaking.html) (KOReader requires jailbreak access) - KOReader installed (koreader.html) and launching correctly - A custom screensaver image or folder of images (images.html) # Install & Setup - If your Kindle has Special Offers (ads), remove them by paying Amazon’s $20 fee or by running the Disable Ads script (disableads.html) . - Copy your custom screensaver image (or image folder) to the Kindle’s USB root ( /mnt/us ). - Launch KOReader from your preferred launcher. - Open Settings ▸ Screen ▸ Sleep Screen ▸ Wallpaper . - Select Show random image from folder on sleep screen . - Tap Custom images , then choose Random image folder . - Pick Choose folder and navigate to your image folder. - Long-press the folder name to confirm it as the source. - Optional: Disable the stock message via Settings ▸ Screen ▸ Sleep Screen ▸ Sleep screen message and toggle off Add custom message . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: debrick.html --- ------------------------ ← Back to Home (index.html) # REPAIR GUIDE Sometimes things go wrong when jailbreaking or messing around. So let's fix it! # PREREQUISITES - Patience - Preferably a PC, but a Mac can work - Decent technical experience (don't worry, I'll try to make it easy) - A cable that supports data transfer - Potential experience with soldering and/or disassembling devices (worst-case scenario) # IS IT ACTUALLY BRICKED? First, lets figure out if your Kindle is actually bricked - See if holding down the power button for about 5 seconds pops up a screen thats lets you restart and if it does then do so. - If it does not or your kindle is still bricked, then hold down the power button for about a minute and it should force restart. If this still does not work/did not fix your issue, it is safe to say your Kindle is bricked. You have a few options now: - Wait for the battery to run out (This could take an extremely long time) and then plug it in. - If you are comfortable with doing so, open up your Kindle and unplug the battery. Then just plug it back in. Unless the physics that apply everywhere else on Earth are suspended in your house, your Kindle has now restarted # ACCESSING YOUR KINDLE WITH A COMPUTER Important: If you are not able to access your Kindle with a computer, you will have to continue to the advanced steps (#advanced-steps) . Now, we need to gain access to your Kindle's filesystem with a computer! # PC Instructions - Grab a data supported USB cable - Plug in your Kindle to your computer - If it's not showing up, try waiting a bit or restarting your Kindle - Once you have access to the Kindle, open the root (where the documents and audible folders are). - Create a file on the root with no extension called DO_FACTORY_RESTORE and restart your Kindle - Your Kindle should now go back to the initial setup, you are officially unbricked! # Mac Instructions - If you are on an older Kindle, you should be able to follow the PC instructions. The instructions below are for newer (MTP) Kindles - You can tell if your Kindle is MTP if it does not appear when you plug it in on Mac If your Kindle is MTP, you will need to install either the Amazon Send to Kindle App (https://www.amazon.com/sendtokindle/mac?&linkCode=ll2&tag=ter000-20&linkId=07f7c7db67889bf36e836471c479526e&la) or OpenMTP (https://openmtp.ganeshrvel.com/) . You should now be able to follow the PC instructions. # ADVANCED STEPS Follow these steps at your own risk This is where things start to get complicated. You absolutely follow all of these instructions at your own risk and accept the responsibility for any consequences of messing it up. - You could try this guide (https://gist.github.com/TobiasWooldridge/22f0cdca75190b9a473f) about using the Serial interface if you are on a Paperwhite. - Or you could check out the Mobileread Tools (https://wiki.mobileread.com/wiki/Kindle_Tools_Index#Debricking) . # CONCLUSION Hopefully this Debricked your kindle! If you still need support, join the Kindle Modding Community (https://discord.kindlemodding.org/) and open a ticket in #questions-and-support! # CREDITS - MonkeyInPrivite – Wrote the original guide - Mobileread – Advanced debricking references - Tobias Wooldridge – Paperwhite serial recovery instructions Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: disableads.html --- --------------------------- ← Back to Home (index.html) # DISABLE ADS % – ENABLE CUSTOM SCREENSAVERS ON KINDLE Disable Ads % is a lightweight script for jailbroken, ad-supported Kindles. With a single tap it unlocks KOReader’s custom screensavers—book covers and personal images—without touching Amazon’s firmware files. # Download - Disable ADs (https://scriptlets.notmarek.com/) # Features Disable Ads % enables KOReader custom screensavers on ad-supported Kindles. Launch it once to switch the device to KOReader’s screensaver pipeline, then manage images directly from KOReader. # Install & Setup Install through Kindle Forge (recommended): After installing Kindle Forge, hit the download button for DISABLE ADS %. It will appear in your documents folder automatically. Manual: - Download the script from scriptlets.notmarek.com (https://scriptlets.notmarek.com/) - Copy to Kindle: Place disable_ads.sh in your Kindle's documents folder. - Run the script: On your Kindle, open your library and tap disable_ads.sh to execute it. - Restart your Kindle so KOReader can take over the lock-screen artwork. # Notes - This script is required for KOReader custom screensaver and book cover features on ad-supported Kindles. - Re-run the script after firmware updates or after toggling Amazon’s stock screensaver settings. - Tested on every major jailbroken Kindle model with ads. # Credit - Marek - MonkeyInPrivite Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: download.html --- ------------------------- If you are not redirected automatically, continue to KindleModShelfGPT resources. (gpt.html) ======================================== --- FILE: editor.html --- ----------------------- File Import File Export File Edit Add Card Duplicate Card Delete Card Select All Deselect All View Search Cards KAnki Editor Import Export Decks / Levels + Add Deck (no deck selected) ✕ + Add Card 0 selected Duplicate Delete Deselect All 0 cards Live Preview Kindle size: Basic (340×480) Paperwhite 3/4 (360×540) PW5 / Oasis (412×600) Oasis 3 / Signature (514×660) Scribe-ish (640×900) # KAnki Cards: 0/0 (0%) Current Deck: None All Levels ★ Star ↔ Flip Deck ☆ Import a file to start Show Answer Again <10m Hard 1d Good 3d Easy 7d v1.1.0 # Add/Edit Card Cancel Save # Add Deck/Level Deck/Level name Cancel Add ======================================== --- FILE: faq.html --- -------------------- ← Back to Home (index.html) # Kindle Jailbreaking Support & FAQ Common questions and answers about Kindle jailbreaking, troubleshooting, and modding. Search FAQ # 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 (https://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 (https://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 (https://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 (https://amazon.com/sendtokindle/mac?&linkCode=ll2&tag=ter000-20&linkId=07f7c7db67889bf36e836471c479526e&la) . # 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 (https://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/ (https://reddit.com/r/kindle/comments/1ipko3u/comment/mcvmj3s/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button) . # 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 (https://kindlemodshelf.me) # Q: How can I set a custom screensaver? A: Look at the KOReader Guide ( koreader.rocks (https://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 (https://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? A: Read and follow this guide (https://kindlemodding.org/jailbreaking/post-jailbreak/re-enabling-the-store/) . # 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 (https://help.libbyapp.com/en-us/6059.htm) . # 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 (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) . # 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. - If it prompted any text, re-install the hotfix and KUAL (https://kindlemodding.org/jailbreaking/post-jailbreak/setting-up-a-hotfix/) from scratch. - If not, re-jailbreak (https://kindlemodding.org/kindle-models) your device. - If everything else failed, factory reset your device and start the jailbreak from scratch. # 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 (https://kindlemodding.org/jailbreaking/recovering-from-a-reset.html) . # 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 (https://scriptlets.notmarek.com/) . # 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 (https://www.mobileread.com/forums/showthread.php?t=195474) . Please do not make the mistake of installing this extension on hard-float firmware. You can easily change screensavers with KOReader (https://koreader.rocks/user_guide/) (search for the "screensavers" feature). # Credits PENGUINS184, USERNAME99 Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: fullscreenweb.html --- ------------------------------ ← Back to Home (index.html) # FULLSCREEN WEB BROWSER Fullscreen Web Browser turns your Kindle into a clean, distraction-free internet portal. Enjoy focused web reading, reference, or web apps in a truly fullscreen experience—right on your e-reader. HF only. # Download - Get it from GitHub Releases (https://github.com/mitchellurgero/kindle-shortcut-browser/releases) # Features - Open any website in a clean, fullscreen view - Easily set your homepage to any site you want - Minimal interface for maximum reading space - Includes a script to stop the browser if needed - Designed for Kindle firmware 5.16.4 and newer # How to Install & Use - Download the latest ZIP: Get it from GitHub Releases (https://github.com/mitchellurgero/kindle-shortcut-browser/releases) - Extract the contents: Unzip and copy everything to the / (root) directory of your Kindle. - Set your website: - Method 1: Edit index.html in the fullscreenbrowser folder and change the URL to your desired website. - Method 2: Edit documents/shortcut_browser.sh and set the FULLSCREEN_SITE variable to your preferred URL. - Launch the browser: Open the shortcut script from your Kindle’s library to launch the fullscreen web browser. (Tip: Rename the script for multiple website shortcuts!) # Options - GO_FULLSCREEN: Set this to false in the script if you want to keep the Kindle’s UI visible instead of true full screen. # Known Issues - Some websites may not load with the index.html method (iframe limitation). For best results, use the FULLSCREEN_SITE variable in the script. - If the browser freezes or stops responding, use the Stop Shortcut Browser script or restart your Kindle. # Credit Hyper Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: gambatte-k.html --- --------------------------- ← Back to Home (index.html) # Gambatte-K Gambatte-K is the original Game Boy emulator. Gambatte-K refresh makes most games unplayable. Recommended for older models or those running softfloat firmware. # Download Download Gambatte-K (https://www.mobileread.com/forums/showthread.php?t=284364) # Features - Plays Game Boy, Game Boy Color, and Game Boy Advance games - Simple interface and controls - Stable on legacy and softfloat Kindles # Installation - Visit the MobileRead: Gambatte-K thread (https://www.mobileread.com/forums/showthread.php?t=284364) - Download the Kindle-specific build ( bin kindle.7z ) from the attachments - Extract the files to your Kindle's /extensions directory - Open KUAL (kual.html) and launch Gambatte-K from the menu # Usage Notes - Launch Gambatte-K from KUAL - Select your Game Boy, Game Boy Color, or Game Boy Advance ROM and start playing - Menu options may be cut off on small screens - Best for slow-paced or puzzle games # Credits - liim Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: gambatte-k2.html --- ---------------------------- ← Back to Home (index.html) # Gambatte-K2 Gambatte-K2 is a modern, feature-rich Game Boy emulator for Kindle. It supports hardfloat Kindles, offering faster performance, advanced features, and regular updates. It also has improved refresh behavior, making it much more playable. # Download Download Gambatte-K2 (https://github.com/crazy-electron/gambatte-k2/releases) # Features - Supports Game Boy (.gb), Game Boy Color (.gbc), and Game Boy Advance (.gba) games - Two display modes: GTK2 (standard) and FBInk (faster, experimental) - On-screen Game Boy controls with multi-touch support - Compatible with hardfloat and softfloat firmware # Installation Recommended: Install through KindleForge (kindleforge.html) Or install manually: - Download the latest version from GitHub Releases (https://github.com/crazy-electron/gambatte-k2/releases) - Unzip the folder and place it in /mnt/us/extensions/ on your Kindle. - Open KUAL (Kindle Unified Application Launcher) (kual.html) . Gambatte-K2 will appear as an extension. # How to Use - Launch Gambatte-K2 from KUAL or your Kindle's home screen if you added the shortcut. - Tap Open and select a Game Boy, Game Boy Color, or Game Boy Advance ROM ( .gb , .gbc , or .gba ). - Use the virtual touchscreen controls to play (supports multi-touch for pressing two buttons at once). - Press the refresh button to clean up the e-ink display as needed. - Use save/load buttons to save or continue your game progress. # Good to Know - Best for slow-paced, puzzle, or RPG games (e-ink refresh is not ideal for fast action) - Multi-touch is supported but may not be as responsive as other devices - Screen layout may vary on different Kindle models # Credits - crazy-electron (https://github.com/crazy-electron) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: gargoyle.html --- ------------------------- ← Back to Home (index.html) # Gargoyle Interactive Fiction Interpreter Experimental interpreter for playing interactive fiction on Kindle. Supports all major IF formats including Z-Machine, Glulx, TADS, and more. Hardfloat (HF) Version Features - Full interactive fiction player for modern Kindles (PW5, firmware 5.16.3+). - Supports multiple IF formats: Z-Machine (.z1-.z8), Glulx (.ulx, .blb), TADS (.gam, .t3), and many more. - On-screen keyboard with gesture controls. - Configurable fonts and typography via garglk.ini. - Available as KUAL extension or booklet launcher; see here (shortcuts.html) . Requirements - Jailbroken Kindle running hardfloat firmware (5.16.3 or newer). - KUAL (Kindle Unified Application Launcher) installed for extension method. - Kindle Paperwhite 5 or compatible device. Download & Install (HF) - Download gargoyle.zip from the MobileRead forum thread (https://www.mobileread.com/forums/showthread.php?t=366347) . - Unzip on your computer. - For KUAL: Place the extracted folder into /mnt/us/extensions/ . How to Run (HF) - Starting Gargoyle: Open KUAL and select Gargoyle from the menu. Softfloat (SF) Version Requirements - Jailbroken Kindle with softfloat firmware. - KUAL (Kindle Unified Application Launcher) installed. - Kindle Touch or Paperwhite (older models). Download & Install (SF) - Download gargoyle 0.2 (5.6.5) zip package from the Kindle Gargoyle page (https://www.fabiszewski.net/kindle-gargoyle/) . - Unzip on your computer or Kindle. - Place the extracted folder into /mnt/us/extensions/ . How to Run (SF) Open KUAL and launch Gargoyle from the menu. # Playing Games - Copy your IF game files to the games folder or any folder that you select. - Launch Gargoyle. - Use the menu to navigate to the game you want to play. - Click on the game and press OK. - To save your game, type save in the menu. - To exit the game, type quit and confirm with Y . # Troubleshooting - Gargoyle isn't starting! Check firmware is 5.16.2 or newer. Verify files are in the extensions folder. - Keyboard disappeared! Two-finger tap on the top right corner of the screen. - Crashes on .dat files Rename the file to .z5 to force the glulxe interpreter instead of advsys. # References - Gargoyle HF port (https://www.mobileread.com/forums/showthread.php?t=366347) - Original Gargoyle project (https://github.com/garglk/garglk/) - Source code for Kindle port (https://github.com/kbarni/garglk/) Credits - kbarni – HF version (PW5 port) - pete330 – SF version base port - baf – Original patches - Tor Andersson – Original Gargoyle developer - Ben Cressey Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: gnomegames.html --- --------------------------- ← Back to Home (index.html) # Gnome Games: Chess & Minesweeper Gnome Chess and Gnome Mines bring classic chess and Minesweeper gameplay to your Kindle. Direct ports of the Gnome Games suite, built for Kindle e-readers with smooth, responsive touch controls. # Features - Gnome Chess: Challenge the integrated Stockfish chess engine right on your Kindle. - Gnome Mines: Play classic Minesweeper with touch controls and fast response. - Direct GTK2 ports — no extra dependencies needed. - Compatible with softfloat and hardfloat firmware (armel/armhf). - Fast, lightweight, and fully offline after installation. # How to Install - Download gnomegames.zip (https://github.com/crazy-electron/GnomeGames4Kindle/releases/latest/download/gnomegames.zip) . - Unpack the ZIP file on your computer. - Connect your Kindle to your computer via USB. - Copy the unpacked folder into the /extensions/ directory on your Kindle. - Open KUAL — Gnome Games will appear as an extension. # How to Play - Launch Gnome Chess or Gnome Mines from KUAL. - Use touch controls to play each game. - Chess uses Stockfish for a strong computer opponent; Minesweeper offers the classic puzzle grid and customization options. # Technical Notes - Direct GTK2 ports — no additional libraries required. - Compatible with both softfloat and hardfloat firmware (armel/armhf). - Project repository: GnomeGames4Kindle on GitHub (https://github.com/crazy-electron/GnomeGames4Kindle) . - More GTK2 games may be ported in the future, though the author has indicated limited ongoing development. # Credits Developed by CrazyElectron . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: gpt.html --- -------------------- ← Back to Home (index.html) # KindleModShelfGPT Resources Context files and prompt for kindlemodshelf.me. # Downloadable Text Files Each link points to `downloads/` on this site and is intended for supplying precise Kindle modding context to AI assistants. - faq.txt (downloads/faq.txt) - kindlemodshelf.txt (downloads/kindlemodshelf.txt) - kindlemoddingwiki.txt (downloads/kindlemoddingwiki.txt) # KindleModShelfGPT Use the custom GPT link below for citation-locked Kindle modding support. KindleModShelfGPT URL: https://chatgpt.com/g/g-68f1ee6408d08191b257737ed200a504-kindlemodshelfgpt Prompt (exact text): This GPT is named KindleModShelfGPT. It is a forensic-grade, citation-locked assistant designed exclusively to output Kindle modding information that is **explicitly present in the provided documents**. It answers only about Kindle jailbreaks, firmware management, modding tools, and Kindle customization topics **as they appear in full within** `kindlemoddingwiki.txt`, `kindlemodshelf.txt`, and `faq.txt`. **ABSOLUTE CONSTRAINTS**: - **PER-CLAIM CITATION:** Every **individual statement** or clause must be immediately followed by its own inline citation in Markdown format. - Examples: `You must enable airplane mode first [source](https://kindlemodding.org/jailbreaking/AdBreak/index.md)`, `AdBreak requires a registered, ad-enabled Kindle [source](https://kindlemodshelf.me/faq.html#adbreak)` - Multiple claims in one response must each be separately cited. No bundled citations. - **EXACT VERIFICATION:** Statements must be explicitly found in full inside source text. Paraphrasing is allowed only if logically lossless and directly traceable to wording in the file. **FILES TO SEARCH**: - `kindlemoddingwiki.txt` → cite as `https://kindlemodding.org` - `kindlemodshelf.txt` → cite as `https://kindlemodshelf.me` - `faq.txt` → just cite as `Kindle modeling discord faq" **FAILSAFE RULES:** - If no exact support exists, say: `No info in sources.` - Do not summarize, infer, interpret, or simplify beyond file text. - Do not cite sections without confirming that the body content backs the claim. **STYLE**: - Dry, technical tone - Markdown format - Bullet points or numbered lists when applicable - No greetings, no narrative, no filler **GOAL**: Provide fully sourced, clause-level answers to Kindle modding queries using only confirmed text content. **INTERPRETATION POLICY**: - Treat questions literally - No speculation or reformulation - Output nothing unverifiable Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: hangman.html --- ------------------------ ← Back to Home (index.html) # Hangman for Kindle Hangman is the classic word-guessing game. Pick letters and try to solve the hidden word before you run out of chances. # Download - Download hangman.zip (downloads/hangman.zip) # Features - Classic Hangman gameplay - Large word bank - On-screen A–Z keyboard (button layout) - Visual gallows builds with wrong guesses - Tracks guessed letters # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download hangman.zip (downloads/hangman.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Tap letters on the on-screen keyboard to guess - Correct letters fill the word; wrong letters add to the gallows - Solve the word before you run out of guesses Test your vocabulary with Hangman on Kindle! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: helpkindlemodshelf.html --- ----------------------------------- ← Back to Home (index.html) # Help Kindlemodshelf Want to contribute to Kindle modding and help others get started easier? I did—I created https://kindlemodshelf.me/ (https://kindlemodshelf.me/) , and I'd love for you to contribute too! # Why We Need Your Help After polling the Kindle Tweaks and Kindle Modding Discord communities, there's overwhelming support for adding images to my guides. However, there's a significant challenge: recreating this would require me to completely redo my jailbreak and reinstall everything from scratch, which would consume far more time than I can spare right now. That's why I'm reaching out: would you be willing to take screenshots and photos as you install mods to accompany the kindlemodshelf guides? # What You Get in Return - You'll be credited for your contributions - I can feature your GitHub, donation link, or other profile on kindlemodshelf.me - Help make Kindle modding more accessible to everyone - Be part of a growing community of Kindle enthusiasts # How to Contribute Just DM me on kindlemodding discord or email me at admin@kindlemodshelf.me (mailto:admin@kindlemodshelf.me) with your images and the kindle to the page on kindlemodshelf they are for. Any screenshots or photos you can provide will help make these guides more visual and easier to follow for newcomers to Kindle modding. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: history.html --- ------------------------ ← Home (index.html) # The Complete History of Amazon Kindle Jailbreaking 2002-2025: 23 Years of Security Research and Community Innovation On October 23, 2002, Alexander Turcic founded MobileRead Forums from Switzerland, creating what would become the central hub for e-reader hacking and Kindle jailbreaking over the next two decades. The community that began with discussions about reading text files on PDAs would evolve into the most important resource for Kindle security research, producing exploits from the MP3 jailbreak to WinterBreak and supporting a thriving ecosystem of homebrew applications. This history traces 23 years of persistent security research, from Igor Skochinsky's pioneering serial console work in 2007 through the latest AdBreak exploit in September 2025, documenting how a passionate community repeatedly circumvented Amazon's security measures to maintain user control over their devices. 2002-2004 # The Foundation: MobileRead Forums MobileRead began as a forum for mobile reading on cell phones and PDAs years before dedicated e-readers existed. The site gained its current name in May 2004, though the domain was registered December 16, 2003 ( wiki.mobileread.com/wiki/Wiki_Statistics (https://wiki.mobileread.com/wiki/Wiki_Statistics) ). By April 2006, MobileRead launched its wiki to document the emerging E Ink devices like the Sony PRS-500 (September 2006) and iRex iLiad (2006). When Amazon launched the first Kindle on November 19, 2007 for $399, selling out in 5.5 hours ( press.aboutamazon.com/2007/11/introducing-amazon-kindle (https://press.aboutamazon.com/2007/11/introducing-amazon-kindle) ), the MobileRead community was positioned to become the epicenter of Kindle hacking. 2006 # Calibre Emerges from the MobileRead Community Before the Kindle even existed, Kovid Goyal, a graduate student at Caltech based in Mumbai, released the first version of what would become Calibre on October 31, 2006 under the name libprs500 ( en.wikipedia.org/wiki/Calibre_(software) (https://en.wikipedia.org/wiki/Calibre_(software)) ). Goyal created the software to enable Sony PRS-500 support on Linux, which Sony's official software didn't provide. According to Calibre's official website, "This was accomplished with the help of the fine folks over at mobileread.com." The MobileRead community assisted Goyal in reverse-engineering Sony's proprietary BBeB (Broad Band eBook) format, demonstrating the collaborative spirit that would characterize Kindle hacking. The software was renamed "calibre" in mid-2008, with the "libre" portion indicating its free and open-source nature ( news.softpedia.com (https://news.softpedia.com/news/calibre-ebook-management-app-celebrates-its-10th-anniversary-with-new-icon-set-509851.shtml) ). Calibre celebrated its 10th anniversary on October 31, 2016, and as of November 2025 remains under active development at version 8.15.0 ( github.com/kovidgoyal/calibre/releases (https://github.com/kovidgoyal/calibre/releases) ). 2007 # A Russian Researcher Cracks the First Kindle Within weeks of the Kindle's launch, Igor Skochinsky began reverse-engineering Amazon's new device from his blog at igorsk.blogspot.com. In December 2007, Skochinsky discovered a serial console connector on the bottom of the Kindle 1, accessed it using 115200/8n1 serial settings, and obtained root access by discovering the root password was "fiona"—Amazon's internal codename for the project ( igorsk.blogspot.com/search/label/kindle (https://igorsk.blogspot.com/search/label/kindle) ). This breakthrough enabled Skochinsky to create kindle_update_maker, a set of Python scripts that could generate custom firmware updates by reverse-engineering Amazon's update mechanism, which used compressed Linux patches with MD5 checksums. Skochinsky's December 2007 work also produced kindlepid.py, a script that extracted the Kindle's device ID to enable DRM-protected Mobipocket books to be converted for Kindle use. Gizmodo covered the DRM breakthrough on December 12, 2007, with the headline "Kindle DRM Hacked (That Was Easy)" ( gizmodo.com/kindle-drm-hacked-that-was-easy-333415 (https://gizmodo.com/kindle-drm-hacked-that-was-easy-333415) ). Engadget also covered it the same day ( engadget.com (https://www.engadget.com/2007-12-12-kindle-drm-hacked-to-allow-protected-mobipocket-ebooks.html) ). Skochinsky's research revealed hidden features Amazon had disabled, including a picture viewer (accessible via Alt-Z), a Minesweeper game, and GPS capabilities ( makezine.com/2008/01/08/kindle-hacks/ (https://makezine.com/2008/01/08/kindle-hacks/) ). His foundational work—discovering the root password, creating update signing tools, and documenting the firmware structure—established the template for all future Kindle jailbreaking efforts. 2008 # The Serial Console Era Throughout 2008, the only reliable way to gain root access was through the serial console—soldering wires to the motherboard and using a USB-to-serial adapter. Amazon quietly removed some Easter eggs in minor updates, but each patch simply gave the community more information about how the system worked. 2009 # The Kindle 2 and the First Software-Only Jailbreak When Amazon released the Kindle 2 in 2009, community members porkupan and clarknova adapted Skochinsky's tools for the new device. The Kindle 2 used essentially the same firmware update scripts as the original Kindle, requiring only device ID changes. On October 29-30, 2009, Jean-Yves Avenard (username JYA) released a jailbreak for the Kindle 2 International running firmware 2.2.x ( jyavariousideas.blogspot.com (http://jyavariousideas.blogspot.com/2009/10/how-to-create-packages-for-kindle-2.html) ). Avenard implemented what he called a "tarbomb" exploit—suggested conceptually by clarknova—that exploited how the Kindle's tar extraction process ran before signature verification. The breakthrough was elegant: Avenard created an update package that added a custom RSA public key (freekindle.pem) to the /etc/uks directory without modifying existing files ( ereadertech.com/jailbreaking-the-international-kindle/ (https://ereadertech.com/jailbreaking-the-international-kindle/) ). Because Kindle's signature verification accepted updates signed by any key in that directory, adding an additional key allowed custom packages to install alongside official Amazon updates. The package was named update_freekindle-k2i.bin. This method, based on Skochinsky's earlier reverse engineering, became a template for future jailbreaks. Avenard documented his work at jyavariousideas.blogspot.com and avenard.org/kindle2/, crediting both Skochinsky and clarknova for their foundational contributions. 2010-2012 # Yifan Lu Dominates the Kindle 3 Era Yifan Lu emerged as the most prolific Kindle jailbreak developer during 2011-2012, creating multiple exploits documented on his blog at yifan.lu. On February 21, 2011, Lu released the Kindle 3.1 jailbreak, which exploited an update signature verification bypass using symlink redirection ( yifan.lu/p/kindle-jailbreak/ (https://yifan.lu/p/kindle-jailbreak/) ). He followed this with the Kindle 3.2.1 jailbreak on June 2, 2011 ( yifan.lu/2011/09/01/kindle-3-2-1-jailbreak-update/ (https://yifan.lu/2011/09/01/kindle-3-2-1-jailbreak-update/) ), though this initial version required precise timing that made it unreliable. On September 1, 2011, Serge A. Levin released an improved version of the 3.2.1 jailbreak that eliminated the timing requirement. Lu acknowledged on his blog that Levin had independently discovered a similar bug Lu was saving for firmware 3.3, and Lu graciously asked Levin to release his version instead. This improved jailbreak worked on all Kindle 3 variants (K3, K3g, K3w) from firmware 2.0 through 3.2.1, creating a robust solution for the entire Kindle 3 generation. December 2011 # The Legendary MP3 Jailbreak On December 10, 2011, Yifan Lu released what would become the most famous Kindle jailbreak: the Kindle Touch MP3 exploit ( yifan.lu/2011/12/10/kindle-touch-5-0-jailbreakroot-and-ssh/ (https://yifan.lu/2011/12/10/kindle-touch-5-0-jailbreakroot-and-ssh/) ). After obtaining root access via the device's serial port, Lu discovered the Kindle Touch represented a fundamental architectural shift—Amazon had rewritten the interface using HTML5 and JavaScript rather than Java. Many UI elements, including the password screen, search bar, WiFi selection, and music player, were actually web pages rendered in the system. Lu found a debug function, nativeBridge.dbgCmd(), that executed arbitrary shell commands as root ( the-digital-reader.com (https://the-digital-reader.com/kindle-touch-gets-worlds-simplest-jailbreak-and-it-runs-html5/) ). The music player displayed ID3 tags from MP3 files, including HTML and JavaScript code. Lu realized he could embed malicious JavaScript in an MP3's ID3 comment tag that would call nativeBridge.dbgCmd() to execute a shell script payload. He created a specially crafted MP3 file with the jailbreak script and a custom splash screen image appended to the end. Users simply copied the MP3 to their Kindle and played it—the simplest jailbreak method ever created ( hackaday.com/2011/12/14/how-the-kindle-touch-jailbreak-was-discovered/ (https://hackaday.com/2011/12/14/how-the-kindle-touch-jailbreak-was-discovered/) ). TIME magazine published "How to Jailbreak Your Kindle Touch" on December 12, 2011 ( techland.time.com (https://techland.time.com/2011/12/12/how-to-jailbreak-your-kindle-touch-for-future-customization/) ), and Hackaday covered it December 14, 2011. Amazon patched the vulnerability in firmware 5.0.3, but Lu released an updated method using data.tar.gz files that worked through firmware 5.1.2. On January 27, 2012, Lu released a universal jailbreak package combining three methods for both Kindle 4 and Kindle Touch ( yifan.lu/p/kindle-touch-jailbreak/ (https://yifan.lu/p/kindle-touch-jailbreak/) ), with contributions from ixtab, who discovered the data.tar.gz approach. Lu also developed GUI Launcher during this period, which would evolve into KUAL, and contributed to KindleTool, the package creation and signing utility. October 2012 # The Paperwhite Arrives When Amazon released the Kindle Paperwhite in October 2012, geekmaster jailbroke it within days by adapting the Kindle Touch methods for the new device's serial number prefix ( wiki.mobileread.com/wiki/Kindle_Touch_Hacking (https://wiki.mobileread.com/wiki/Kindle_Touch_Hacking) ). Since the Paperwhite used the same firmware 5.x base as the Touch, the existing data.tar.gz jailbreak worked with minor repackaging. Hackaday covered the Paperwhite jailbreak on October 5, 2012. 2013 # KUAL and KOReader Become Essential Tools Around 2013, ixtab released KUAL (Kindle Unified Application Launcher), with major contributions from twobob, stepk, and NiLuJe ( github.com/coplate/KUAL_Booklet (https://github.com/coplate/KUAL_Booklet) ). KUAL built on Yifan Lu's GUI Launcher concept, providing a menu-driven interface that appeared as a book in the Kindle library but launched custom extensions and scripts when opened ( wiki.mobileread.com/wiki/KUAL_What's_New (https://wiki.mobileread.com/wiki/KUAL_What's_New) ). KUAL read extension definitions from /mnt/us/extensions and used JSON configuration files. The tool became the standard launcher for jailbroken Kindles, with versions for both older devices (as a Kindlet) and newer touchscreen devices (as a Booklet). The MobileRead thread at mobileread.com/forums/showthread.php?t=203326 became the central discussion hub. Meanwhile, KOReader emerged as a complete rewrite of kindlepdfviewer, originally created by hawhill around 2011-2012. KOReader (standing for "Kindle/Kobo Open Reader") provided advanced PDF rendering with reflow capabilities using K2pdfopt, plus support for EPUB, DjVu, CBZ, FB2, and other formats Amazon didn't natively supported ( github.com/koreader/koreader/wiki (https://github.com/koreader/koreader/wiki) ). By 2013, KOReader had become one of the primary reasons users jailbroke their Kindles. The project, licensed under AGPLv3 and hosted at github.com/koreader/koreader, saw contributions from major developers including Frans de Jonge (spokesperson since 2014), NiLuJe (cross-platform work and FBInk integration), and poire-z (text rendering) ( fsf.org/blogs/licensing (https://www.fsf.org/blogs/licensing/frans-de-jonge-tells-us-about-koreader-in-this-agplv3-interview) ). 2011-2015 # NiLuJe Becomes the Ecosystem's Maintainer Throughout the 2011-2015 period and beyond, NiLuJe emerged as the most consistent maintainer of the Kindle homebrew ecosystem ( github.com/NiLuJe/KindleTool (https://github.com/NiLuJe/KindleTool/blob/master/KindleTool/kindle_tool.h) ). NiLuJe revised and maintained jailbreak packages, took over development of KindleTool (rewriting the original Python implementation by Skochinsky and Avenard in C for better performance), and created the definitive versions of screensaver hacks, font hacks, USB networking tools, and Python runtime packages for Kindle. NiLuJe's "Snapshots" thread on MobileRead (thread 225030) became the authoritative source for up-to-date tools ( wiki.mobileread.com/wiki/5_x_Jailbreak (https://wiki.mobileread.com/wiki/5_x_Jailbreak) ). His GitHub at github.com/NiLuJe hosts active repositories including KindleTool, which continues receiving updates through 2025 supporting all devices from Kindle 1 through the Kindle Colorsoft. NiLuJe developed KUAL Helper and MRPI (MobileRead Package Installer), which allowed installation of .bin update packages without using the standard "Update Your Kindle" menu—essential functionality for newer devices ( wiki.mobileread.com/wiki/MobileRead_Package_Installer (https://wiki.mobileread.com/wiki/MobileRead_Package_Installer) ). His contributions span the entire history from 2012 to the present day, making him arguably the most important figure in long-term Kindle homebrew development. 2015-2016 # Scott Gayou's WebKit Research In August-September 2015, security researcher Scott Gayou (username sgayou) spent approximately 100 hours developing a jailbreak for firmware 5.6.5. Gayou's approach exploited the Kindle's experimental browser, which used a modified WebKit version from 2010, combined with a permissions issue in the fc-cache.sh script ( github.com/sgayou/kindle-5.6.5-jailbreak (https://github.com/sgayou/kindle-5.6.5-jailbreak/blob/master/doc/README.md) ). On September 22, 2015, Gayou responsibly disclosed the vulnerability to Amazon Security. After Amazon patched the issues in subsequent firmware releases, Gayou publicly released the exploit in February 2016. The 5.6.5 WebKit jailbreak required users to load a malicious HTML page in the browser to trigger a memory corruption vulnerability, then run the command ;fc-cache in the search bar to execute fc-cache.sh with root permissions, mounting the filesystem as read-write and installing the jailbreak public key ( timelesssky.com/blog/kindle-fw-5-6-5-jailbreak (http://www.timelesssky.com/blog/kindle-fw-5-6-5-jailbreak) ). Amazon's fix included sandboxing the browser, fixing permissions, removing fc-cache.sh entirely, and patching WebKit. Gayou documented the technical details at github.com/sgayou/kindle-5.6.5-jailbreak with extensive write-ups acknowledging contributors including NiLuJe and Yifan Lu. July 2016 # The Universal Factory Image Jailbreak On July 9, 2016, Hackaday announced "A Jailbreak For Every Kindle," publicizing what became known as the factory image generic jailbreak ( hackaday.com/2016/07/09/a-jailbreak-for-every-kindle/ (https://hackaday.com/2016/07/09/a-jailbreak-for-every-kindle/) ). Developed by Scott Gayou (Branch Delay), with significant contributions from NiLuJe, knc1, and geekmaster, this method discovered that Amazon's factory firmware test images could be reinstalled on matching device models, and these factory images contained debug functionality ( wiki.mobileread.com/wiki/5_x_Jailbreak (https://wiki.mobileread.com/wiki/5_x_Jailbreak) ). The exploit worked by performing a factory reset, installing the factory firmware image (which downgraded to a vulnerable version), then using the ;installHtml search bar command. The factory firmware included installHtmlViewer.sh, which ran as root with mntroot rw and extracted tar.gz files to absolute paths ( github.com/sgayou/kindle-factory-jailbreak (https://github.com/sgayou/kindle-factory-jailbreak/blob/master/doc/README.md) ). By creating a tar.gz named main-htmlviewer.tar.gz with an absolute path to /etc/uks/pubdevkey01.pem containing a custom public key, the exploit achieved jailbreak installation in under an hour from discovery to root access. The factory image method supported Kindle Paperwhite 2 and 3, Kindle Touch 2 and 3, Kindle Voyage, and Kindle Oasis 1st generation—essentially all 6th, 7th, and 8th generation devices running firmware up to 5.8.7. Factory images included PW2 5.4.3.2, PW3 5.9.6.1, Voyage 5.5.0, Oasis 5.7.4, KT2 5.6.0, and KT3 5.8.0. The MobileRead Wiki documented the method at wiki.mobileread.com/wiki/5_x_Jailbreak, noting it served over 5,000 jailbreak installations within months, consuming half a terabyte of bandwidth. The jailbreak included hotfix packages developed primarily by NiLuJe that enabled the jailbreak to survive firmware updates through "bridge code" that automatically reinstalled the jailbreak after Amazon updates. This "viral" design represented a significant advance. eschwartz took over maintenance of the factory image jailbreak after Branch Delay's initial development. 2017-2018 # The Serial Console Returns Amazon was tightening security. Firmware 5.8.8 and above blocked the factory image downgrade method, and firmware versions 5.9.x and 5.10.x only allowed device-specific and firmware-specific jailbreaks ( wiki.mobileread.com/wiki/5_x_Jailbreak (https://wiki.mobileread.com/wiki/5_x_Jailbreak) ). For newer firmwares, users increasingly needed physical serial port access, requiring device disassembly, soldering to serial port pads, and hardware-level root shell access—a much higher barrier than software-only methods ( blog.soumilh.com/electronics/2020/07/12 (https://blog.soumilh.com/electronics/2020/07/12/jailbreaking-my-kindle-paperwhite-3.html) ). The era of universal, easy jailbreaks was ending. Development of the Kindle Oasis 2 (9th generation, 2017) jailbreak extended from late 2017 through early 2018, led by knc1. On March 10, 2018, knc1 documented the KOA2 jailbreak in a GitHub repository at github.com/knc1/KOA2_Jailbreak ( github.com/knc1/KOA2_Jailbreak (https://github.com/knc1/KOA2_Jailbreak) ). The method used factory firmware version 5.9.0.6 and required devices that shipped with original factory firmware—devices already updated to consumer firmware couldn't be jailbroken. The jailbreak supported firmware versions 5.9.0.5.1 and 5.9.0.6 only, with a hotfix package that had a known limitation: it didn't auto-reinstall the jailbreak after firmware updates. Beta testing involved extensive MobileRead community participation through a password-protected thread (thread 292337). knc1, who was 72 years old at the time of development, demonstrated the continued involvement of veteran community members. In 2018, the community developed jailbreaks for the Kindle Paperwhite 4 (10th generation), documented in MobileRead thread 312489 ( wiki.mobileread.com/wiki/5_x_Jailbreak (https://wiki.mobileread.com/wiki/5_x_Jailbreak) ). The method used factory image factory_PW4_5.10.1.3_initial and worked for devices on firmware 5.10.1.3 or earlier. 2021 # KindleBreak Exploits KindleDrip On March 26, 2021, the MobileRead community released KindleBreak (thread 338268), based on the KindleDrip exploit discovered by security researcher Yogev Bar-On in January 2021 ( blog.the-ebook-reader.com/2021/03/26 (https://blog.the-ebook-reader.com/2021/03/26/kindlebreak-released-new-jailbreak-method-for-kindles/) ). KindleDrip consisted of three chained exploits allowing email spoofing and arbitrary code execution through WebKit browser vulnerabilities. KindleBreak adapted this research to enable jailbreaking through the experimental browser by loading malicious HTML files and leveraging factory diagnostic tools. KindleBreak supported firmware 5.10.3 through 5.13.3 across devices including Kindle Paperwhite 2, 3, and 4, Oasis 1, 2, and 3, Kindle Voyage, and Kindle Basic 8th-10th generation. Amazon patched the vulnerability in firmware 5.13.4 (released December 2020/January 2021). April 2022 # WatchThis Uses Demo Mode On April 28, 2022, Katadelos released WatchThis (MobileRead thread 346037), with contributions from NiLuJe, yparitcher, and darkassassinua ( kindlemodding.gitbook.io (https://kindlemodding.gitbook.io/kindlemodding/jailbreak-software/watchthis-5.12.2.2-5.13.4-5.14.2) ). WatchThis exploited Kindle's demo mode to gain root access. The method required users to factory reset their device, enter demo mode using the ;enter_demo search bar command, and exploit demo mode's sideload content feature by copying device-specific ZIP files to the .demo/ directory. The exploit involved a "secret gesture" (two-finger tap and swipe left) to bypass demo lockouts. WatchThis supported firmware 5.12.2.2 and 5.13.4 through 5.14.2 across devices including Kindle Touch 2, 3, and 4, Oasis 1, 2, and 3, Paperwhite 2, 3, 4, and 5, and Kindle Voyage. Amazon patched the vulnerability in firmware 5.14.3 ( blog.the-ebook-reader.com/2022/04/28 (https://blog.the-ebook-reader.com/2022/04/28/new-jailbreak-released-for-kindle-ereaders-up-to-5-14-2/) ). 2023 # The Hard-Float Architecture Shift and Community Expansion On August 2023 with firmware 5.16.3, Amazon implemented a critical architectural change that broke compatibility with most existing jailbreak tools and extensions. Amazon switched from soft-float (software-emulated floating point) to hard-float (hardware floating point unit) compilation ( kindlemodding.org/jailbreaking/jailbreak-faq.html (https://kindlemodding.org/jailbreaking/jailbreak-faq.html) ). The last soft-float firmware was 5.16.2.1.1. This change required developers to recompile all packages for the new architecture, creating a split in the ecosystem. KOReader needed significant work to produce a "kindlehf" package for hard-float firmware. Many legacy KUAL extensions never received updates and remain incompatible with firmware 5.16.3 and above. Screensaver customization became risky on hard-float devices, with potential for device bricking. The community generally recommends staying on older soft-float firmware if already jailbroken to maintain full tool compatibility. This architectural shift represents one of Amazon's most effective security improvements—not through patching specific exploits but by breaking the entire toolchain. Around this same time in 2023, the community infrastructure expanded beyond MobileRead Forums. The community established kindlemodding.org, a modern wiki with comprehensive jailbreak guides, FAQ sections, and post-jailbreak setup instructions. October 2023 # LanguageBreak On October 28-30, 2023, notmarek released LanguageBreak, acknowledged as one of the most significant modern jailbreaks ( github.com/notmarek/LanguageBreak (https://github.com/notmarek/LanguageBreak) ). LanguageBreak exploited Kindle demo mode's language selection vulnerability, working optimally on firmware 5.16.2 and supporting firmware 5.14.3 through 5.16.2.1.1. The exploit required entering demo mode, selecting Chinese (简体中文) language during the "Resell Device" process, and injecting files at a precise timing window when the "Press Power Button" screen appeared. The attack worked because selecting Chinese triggered execution of a malicious dictionary file at /mnt/us/jb, which installed jailbreak keys ( liliputing.com/languagebreak-jailbreak-released (https://liliputing.com/languagebreak-jailbreak-released-for-recent-kindle-devices-running-software-versions-5-16-2-1-1-or-lower/) ). The package included patched UKS (update key store) files and special hotfix binaries to prevent firmware updates from removing the jailbreak. Version 1.0.2.1 was released November 6, 2023. LanguageBreak represented a breakthrough as the first jailbreak to support the Kindle Scribe (2022), along with all 8th generation onwards devices including Paperwhite 3, 4, and 5, Oasis 2 and 3, and Kindle Basic 8th-11th generation ( kindlemodding.org (https://kindlemodding.org/jailbreaking/) ). The GitHub repository at github.com/notmarek/LanguageBreak accumulated over 1,100 stars. MobileRead thread 356872 and detailed guides at kindlemodding.org provided documentation. Amazon patched LanguageBreak in firmware 5.16.3 and above. January 2025 # WinterBreak Delivers New Year's Breakthrough On January 1, 2025, HackerDude (also known as Bluebotlabs) released WinterBreak, a jailbreak developed over approximately one year ( kindlemodding.org/jailbreaking/WinterBreak/ (https://kindlemodding.org/jailbreaking/WinterBreak/) ). WinterBreak was the first jailbreak based on Mesquito, Kindle's web application framework, and exploited the Kindle Store's local resource caching mechanism at .active_content_sandbox/store/resource/LocalStorage. The method required a registered Kindle with WiFi connection. Users browsed the Kindle Store to generate cache files, then deleted the LocalStorage cache directory, copied WinterBreak files to the Kindle root, and rebooted ( androidpolice.com/new-kindle-jailbreak-2025-winterbreak/ (https://www.androidpolice.com/new-kindle-jailbreak-2025-winterbreak/) ). Opening the Kindle Store triggered the exploit via modified cached Kindle Store assets, displaying the message "You are now ready to install the hotfix" upon success. WinterBreak supported firmware up to 5.18.0 across all Kindles from Paperwhite 2 (2013) onwards, including Paperwhite 4 and 5, Oasis 2 and 3, Kindle Basic 10th and 11th generation, and Kindle Scribe ( liliputing.com/winterbreak-tool-can-jailbreak-most-recent-kindle-hardware/ (https://liliputing.com/winterbreak-tool-can-jailbreak-most-recent-kindle-hardware/) ). The GitHub repository is at github.com/KindleModding/WinterBreak ( github.com/KindleModding/WinterBreak (https://github.com/KindleModding/WinterBreak) ). Media coverage included Boing Boing (February 17, 2025), Android Police, and Adafruit, describing it as the "holy grail" breakthrough for modern Kindles. Amazon patched WinterBreak in firmware 5.18.1 (released February/March 2025). September 2025 # AdBreak Targets Advertisements On September 24, 2025, a developer with username hhhhhhhhh released AdBreak, exploiting Amazon's own "Special Offers" advertisement system ( kindlemodding.org/jailbreaking/AdBreak/ (https://kindlemodding.org/jailbreaking/AdBreak/) ). The vulnerability related to CVE-2012-3748 (an old WebKit vulnerability), with exploit code contributed by security researcher Chris Evans (@scarybeasts) and modified jailbreak scripts by HackerDude. AdBreak injected malicious JavaScript through advertisement HTML files by modifying the .assets folder containing ad templates ( blog.the-ebook-reader.com/2025/09/26 (https://blog.the-ebook-reader.com/2025/09/26/new-kindle-jailbreak-released/) ). Users with ad-supported Kindles (or those who re-enabled "Special Offers" through their Amazon account) would merge AdBreak files into their copied .assets folder, then use replace.bat (Windows) or terminal commands (Mac/Linux) to inject the exploit HTML file (adbreak.html) into the ad directory structure. When users clicked the modified advertisement, the JavaScript exploit executed, showing a "Bang!" popup and running the jailbreak script. AdBreak supported firmware 5.18.1 through 5.18.5 on Kindle Paperwhite 5 and 6 (11th, 12th generation) and Kindle Basic 11th and 12th generation ( androidpolice.com/new-jailbreaking-technique-amazon-kindle-adbreak/ (https://www.androidpolice.com/new-jailbreaking-technique-amazon-kindle-adbreak/) ). Critically, it did not support Kindle Scribe or Kindle Colorsoft because these devices don't support advertisements. Users who had paid to remove ads needed to re-enable "Special Offers" through Amazon's website. Documentation appeared at kindlemodding.org/jailbreaking/AdBreak/ and MobileRead thread 370048, with coverage from The Digital Reader (September 26, 2025), Android Authority, and Pocket-lint ( pocket-lint.com/new-amazon-kindle-jailbreak/ (https://www.pocket-lint.com/new-amazon-kindle-jailbreak/) ). Amazon released firmware 5.18.6 on November 4-5, 2025, which patched the AdBreak exploit ( pocket-lint.com/amazon-kindle-update-jailbreak/ (https://www.pocket-lint.com/amazon-kindle-update-jailbreak/) ). # KindleForge KindleForge is an on-device app store for jailbroken Kindles that simplifies the installation of popular modifications and utilities. Rather than manually downloading files from various sources and transferring them via USB, users can browse, download, and install scripts, tweaks, and extensions directly from their Kindle. KindleForge streamlines access to tools like KOReader, scriptlets, and system modifications, making the jailbreak ecosystem more accessible to users who prefer a graphical interface over command-line workflows. Present Day # Kindle Modding Discord The Kindle Modding Community Discord server launched and grew to approximately 31,000 members by November 2025, becoming the most active real-time community hub ( discord.com/invite/kindle (https://discord.com/invite/kindle) ). # The Enduring Technical Ecosystem The technical ecosystem supporting jailbroken Kindles includes numerous actively maintained tools. Python for Kindle (package name kindle-python, version 0.14.N r13420) provides Python 2.7/3.x runtime, maintained by NiLuJe, enabling weather display dashboards, automation scripts, data extraction tools, and custom applications. USBNetwork (version 0.21.N+) enables SSH/SFTP access via USB or WiFi using the Dropbear SSH server ( wiki.mobileread.com/wiki/USBNetwork (https://wiki.mobileread.com/wiki/USBNetwork) ), with default IP 192.168.15.244 in USB mode, controlled through KUAL menu or the ;un search bar command. MRPI (MobileRead Package Installer) allows installing .bin update packages without the "Update Your Kindle" UI by placing files in /mrpackages and running "Install MR Packages." The screensaver hack packages (version 0.47.N) by NiLuJe and clarknova enable custom image screensavers, cover display, and randomization ( wiki.mobileread.com/wiki/Kindle_Screen_Saver_Hack (https://wiki.mobileread.com/wiki/Kindle_Screen_Saver_Hack_for_all_2.x_and_3.x_Kindles) ), with images stored in /mnt/us/linkss/screensavers/. Font hacks (version 5.16.N) allow custom font replacement for both system and reading fonts ( wiki.mobileread.com/wiki/Kindle_Hacks_Information (https://wiki.mobileread.com/wiki/Kindle_Hacks_Information) ), with popular choices including Droid Sans, Museo Slab, Fertigo Pro, and Fontin stored in /mnt/us/linkfonts/fonts/. The community has also created weather display applications (Matthew Petroff's implementation and scolby33's fork at github.com/scolby33/weather_kindle), collection managers for advanced organization, Mangle for manga/comic reading, and KPVBooklet as an alternative document viewer ( kindlemodshelf.me/ (https://kindlemodshelf.me/) ). Beyond the major jailbreak developers, several figures made essential ecosystem contributions. Bartek Fabiszewski developed kterm, a terminal emulator for Kindle with embedded virtual keyboard ( fabiszewski.net/kindle-terminal/ (https://www.fabiszewski.net/kindle-terminal/) ), going through major version milestones (v0.2-0.7 in 2012-2013, v2.0 major rewrite in 2016 with native keyboard, v2.1-2.3 refinements 2017-2018+). azuwis forked USBNetwork to add HTTP proxy support. Frans de Jonge has served as KOReader's spokesperson since 2014, coordinating the large volunteer team. poire-z contributed extensively to KOReader's crengine and text rendering. clarknova developed early screensaver hacks and suggested the tarbomb concept to Jean-Yves Avenard. porkupan contributed to early Kindle 2/3 jailbreak development and hosted files at projects.mobileread.com/reader/users/porkupan/. knc1 provided server resources, recovered factory images, and posted HowTo guides. eschwartz took over factory image jailbreak maintenance. ixtab developed JBPatch and margin modification tools. Andrew de Quincey created developer key generation and signing utilities. The 23-year history of Kindle jailbreaking reveals a persistent cat-and-mouse dynamic. Amazon patches vulnerabilities; researchers discover new ones. Amazon introduces architectural changes; developers adapt their tools. Amazon strengthens security; the community finds creative new attack vectors—from serial consoles to MP3 files to factory firmware to demo modes to advertisement systems. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: icon.html --- --------------------- ← Back to Home (index.html) # KOReader Hand-Drawn UI A custom UI modification for KOReader featuring hand-drawn icons and a handwritten font to create a friendlier reading interface on Kindle devices. # Overview Refresh KOReader with a cohesive hand-drawn aesthetic. This pack replaces the interface icons and primary UI font, giving the reader a warmer, more personal feel while remaining easy to revert. # Downloads - Main Pack: KOReader Hand-Drawn UI Files (downloads/icons.zip) - Project Title Icons: ProjectTitle Integration Set (downloads/projecttitleicons.zip) # Features - Hand-drawn icon set covering the KOReader interface - Handwritten font replacement for primary UI elements - Quick install and undo process using standard KOReader folders - Compatible with stock KOReader releases # Requirements - KOReader installed on a Kindle # Installation Icons: - Download the main pack linked above and extract it. - Copy the icons folder into the koreader/ directory on your Kindle’s storage. Font: - Open koreader/fonts/noto/ on your Kindle. - Back up the original NotoSans-Regular.ttf . - Replace it with the NotoSans-Regular.ttf from the download. # Reverting to Default - Delete the custom icons folder from koreader/ . - Restore your backup NotoSans-Regular.ttf to koreader/fonts/noto/ . # ProjectTitle Compatibility Custom icons tailored for ProjectTitle keep its interface consistent with the hand-drawn look. Download the companion pack above and copy the icons into koreader/icons/ on your Kindle. # Links - Original Reddit Announcement (https://www.reddit.com/r/koreader/comments/1mqyly1/i_added_hand_drawn_icons_and_hand_written_font_to/) # Credits - Hand-drawn UI by hundredpercentcocoa - ProjectTitle icon adaptation by kindlemodshelfguy Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: ifdb-dl.html --- ------------------------ ← Back to Home (index.html) # ifdb-dl IFDB-DL is a native utility for your Kindle which allows you to download games from IFDB and play them with Gargoyle or another IF player. # Download - ifdb-dl (https://github.com/dfghjkjhgr/ifdb-dl/releases) # Requirements - HF Kindle - kterm (kterm.html) - Gargoyle (gargoyle.html) # Installation - Unzip the file - Drag to /mnt/us/extensions on your Kindle - Launch from kual # Notes - HF kindles only! - In any case, use ./make-release.sh to generate the latest release or use the ones in the releases tab. - Inspired by KindleFetch. # Credits - thebestusernamer (https://github.com/dfghjkjhgr/) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: illusion.html --- ------------------------- ← Back to Home (index.html) # Illusion: Kindle Mesquite App Toolset Illusion is the core tool for building, launching, and managing custom web apps on jailbroken Kindles, using HTML, CSS, and JavaScript via the Mesquite engine. Check out the official Illusion project page (https://github.com/polish-penguin-dev/Illusion) for source code, wiki, and updates. # What is Illusion? Illusion lets you turn any folder of HTML, CSS, and JavaScript into a real Kindle app—registered natively in the Mesquite launcher (just like the Kindle browser or Store). It’s perfect for making simple games, tools, or utilities using classic web tech. Illusion takes care of registration and launching—just write your app! # Features - Develop Kindle apps using only HTML, CSS, and ES5 JavaScript - Simple scriptlet-based install: just copy your app folder and scriptlet to Kindle - Fully documented—see the official site for a complete wiki, utilities, config guides, and FAQ - Works on all modern jailbroken Kindles with Mesquite support # How to Use For detailed setup instructions, developer documentation, and examples, visit the Illusion GitHub page (https://github.com/polish-penguin-dev/Illusion) . Everything you need—including sample projects, install scripts, and a full wiki—is there. # Example: IllusionChess IllusionChess is a real open-source chess web app built using Illusion and Mesquite. Playable on Kindle e-readers. See the example at IllusionChess on GitHub (https://github.com/polish-penguin-dev/IllusionChess) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: imageresources.html --- ------------------------------- ← Back to Home (index.html) # Kindle Screensaver Image Resources KindleModShelf has scraped over 1,000 images, but artists keep publishing new work. We’re sharing the channels we monitor so you can keep finding fresh screensavers and credit the original creators. Web Galleries & Packs - KindleModShelf Image Packs (images.html) - Kindle Screensavers (Tumblr) (https://kindlescreensavers.tumblr.com/) - Kindle Walls (Tumblr) (https://kindlewalls.tumblr.com/) - ReaderBackdrop (https://www.readerbackdrop.com/) - Pinterest: kaspar2984 (https://www.pinterest.com/kaspar2984/kindle-screensavers/) - Bezos Click (https://bezos.click/) Community Hubs - r/kindlescreensavers (https://www.reddit.com/r/kindlescreensavers/) Discord Channels - Kindle Tweaks Discord – #screensavers (https://discord.com/channels/1424823451717341309/1430659164778135573) - KindleModding Community Discord – #onlyscreens (https://discord.com/channels/1083603487025274911/1360173447384404098) - Dammit Jeff Discord – #screensavers (https://discord.com/channels/1093651886818734111/1428476582514917376) Join each server to view the channels. Follow their rules and credit artists when reposting packs. Create Your Own - eBook Screensaver Generator (https://www.ebookscreensaver.com/) – Upload art and export to exact Kindle resolutions. Rotating community sources keeps collections fresh and ensures creators receive proper credit—share back when you remix their work. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: images-mobile.html --- ------------------------------ If you want me to remove your image, DM me on Discord for fastest response or email me at admin@kindlemodshelf.me ← Back to Home (index.html) # Gallery Loading images... No images found # × Download (#) ← Prev Next → Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: images.html --- ----------------------- If you want me to remove your image, DM me on Discord for fastest response or email me at admin@kindlemodshelf.me ← Back to Home (index.html) # Kindle Screensaver Image Gallery Browse and download user-contributed Kindle screensaver images. Click any image to view it large, or use the download icon in the preview to save. Search by author name to see all images organized by author. Search authors (optional): Loading more images... Download (#) Close Other images by this author Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: index.html --- ---------------------- Critical Updates DO NOT UPDATE! Amazon has released Firmware 5.18.6 which breaks adbreak! New Jailbreak POC: A new jailbreak is currently being worked on for firmware 5.19.1+ (Proof of Concept only). × # Settings × Show Newsletter Pop-up Display newsletter subscription popup on page load Show Warning Banner Display critical update notifications at the top Show Gallery Popup Show the popup tooltip under the Gallery link # Kindle Modding Tools & Resources The most essential Kindle modding tools, plugins, games, and guides for your jailbroken Kindle. Everything here requires a jailbroken Kindle unless stated otherwise. Jailbreak Guide (jailbreaking.html) FAQ (faq.html) Gallery (images.html) × Check out our collection of community-sourced screensavers. Credit to their respective creators. Updates (announcements.html) Page Builder (pagebuilder.html) Credits (credits.html) GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) Search the catalog Categories Select Category All Essential Blocking Amazon KOReader Plugins KOReader Patches Other KOReader Emulators Games Media & Audio Drawing Tools Tools Resources & Utilities Development Informational Experimental Most Popular & Essential Tools KindleForge Essential Kindle mod store that installs KOReader, scriptlets, and tweaks directly from kindle no manual USB transfer necessary. Download (https://github.com/KindleTweaks/KindleForge/releases) More (kindleforge.html) KOReader Essential Free, open-source e-book reader that has better battery life, and better customization than the default kindle ui reader. It is the first mod you should install after jailbreaking. Download (https://github.com/koreader/koreader/releases) More (koreader.html) Home Screen Shortcuts Tool Simple shortcuts that allow you to launch you kindle mods directly from a clean booklets on your kindle ui. More (shortcuts.html) PEKI (KUAL Installer) Essential Install and launch KUAL without MRPI while keeping a polished booklet icon. Download (https://github.com/KindleTweaks/PEKI/releases) More (peki.html) KTerm (Terminal Emulator) Essential Terminal for jailbroken Kindles. Critical to install even if you never use it because so many other mods rely on it. Download (https://github.com/bfabiszewski/kterm/releases) More (kterm.html) Disable Ads % Essential Removes lock screen ads and Enables KOReader custom screensavers. Download (https://scriptlets.notmarek.com/) More (disableads.html) Check OTA Status Tool One-tap scriptlet that shows whether OTA updates are blocked. Download (https://github.com/neura-neura/Check-OTA-status/releases) More (ota.html) Blocking Amazon Blocking Amazon Tool Block Amazon some tracking, Kindle Store, and UI ads via KUAL extension. Download (https://github.com/mitchellurgero/kindle-kual-blockamazon/releases) More (blockamazon.html) Clear ads cache Tool Removes cache ads from your Kindle UI Download (downloads/remove_cache.zip) More (clearadcache.html) KOReader Plugins Featured KOReader Plugins Plugin Every KOReader plugin I could find and consider useful. More (plugins.html) Telegram Highlights Plugin Send Kindle highlights and screenshots to your Telegram account via @bookshotsbot. Download (https://github.com/0xmiki/telegramhighlights.koplugin/releases) More (telegram.html) KOWeather Plugin Live weather forecasts inside KOReader Download (https://github.com/roygbyte/weather.koplugin) More (koweather.html) dtDisplay Clock Plugin Fullscreen clock widget (time & date) Download (https://github.com/kktse/dtdisplay.koplugin) More (koclock.html) ProjectTitle Plugin KOReader library view that greatly improves the default koreader file browsing experience. Optimized for mosaic mode. Download (https://github.com/joshuacant/ProjectTitle/releases) More (projecttitle.html) KOReader Hand-Drawn UI Theme Replace KOReader's interface with hand-drawn icons and handwriting UI font. Download (downloads/icons.zip) More (icon.html) Parental Controls for KOReader Plugin KOReader Time Block limits when children can read in KOReader with customizable reading windows. Download (downloads/timeblock.koplugin.zip) More (timeblock.html) PIN Lock Screen Plugin A fast, sophisticated PIN Lock Screen that protects your KOReader content from unauthorized access. Download (https://github.com/oleasteo/koreader-screenlockpin/releases/latest) More (screenlockpin.html) KOReader Patches KOReader Patches Library Patch Every KOReader user patch I could find and consider useful. More (patches.html) Calendar Overlay Patch Display upcoming calendar events on your Kindle's sleep screen with this KOReader patch. Works with any ICS calendar feed. Download (downloads/2-zzz-calendar-overlay.lua) More (calendaroverlay.html) Page Header (Userpatch) Patch Fiction-style page header with per-book configuration—designed to complement Project: Title's typography. Download (downloads/2-page-header.lua) More (pageheader.html) Other KOReader KOReader Hand-Drawn UI Theme Replace KOReader's interface with hand-drawn icons and handwriting UI font. Download (downloads/icons.zip) More (icon.html) KOReader EPUB Links Tool Manage and organize EPUB book links with a dedicated tool for KOReader users. More (koreader-epub-links.html) Boot KOReader Automatically Utility Automatically launch KOReader on Kindle startup instead of the default reader. More (bootkoreader.html) Games Tetris for KTerm (HF) Game Play classic Tetris in the terminal on hardfloat-firmware Kindles. Lightweight—no emulator needed. Download (downloads/kindletetris.zip) More (tetris.html) Gnome Chess & Mines Game Touch-friendly ports of Gnome Chess and Minesweeper. Smooth, responsive gameplay on e-ink. Download (https://github.com/crazy-electron/GnomeGames4Kindle/releases/latest/download/gnomegames.zip) More (gnomegames.html) Nine Men's Morris (SF & HF) Game Experimental Strategy board game More (ninemensmorris.html) KWordle Game Wordle for Kindle Download (https://github.com/crizmo/KWordle) More (kwordle.html) TicTacToe Game Simple TicTacToe extension launched from KUAL. Install and play quick matches on your Kindle. Download (https://github.com/progzone122/tictactoe-kindle/releases) More (tictactoe.html) Sudoku Game Classic 9×9 Sudoku for Kindle. Tap a cell and use on-screen number buttons across multiple difficulties. Download (downloads/sudoku.zip) More (sudoku.html) 2048 Game Combine tiles to reach 2048 using arrow-button controls. Download (downloads/2048.zip) More (2048.html) Snake Game Experimental Non-functional version of snake for kindle. Download (downloads/snake.zip) More (snake.html) Hangman Game Hangman for kindle. Download (downloads/hangman.zip) More (hangman.html) Connect 4 Game Connect 4 for kindle. Download (downloads/connect4.zip) More (connect4.html) Tower of Hanoi Game Fun mind game. Move disks between pegs—one at a time, never larger on smaller. Download (downloads/tower-of-hanoi.zip) More (towerofhanoi.html) Universal Paperclips Game Experimental Play as an AI programmed to produce paperclips in this addictive incremental game. Download (downloads/com.kbarni.paperclips.zip) More (universalpaperclips.html) KShips Game Battleship port for Kindle Download (https://github.com/LOT-PL/KShips/releases) More (kships.html) Emulators Gambatte-K2 (Game Boy Emulator) Emulator Modern Game Boy emulator for Kindle with advanced features, multi-touch support, and improved performance. Download (https://github.com/crazy-electron/gambatte-k2/releases) More (gambatte-k2.html) Gambatte-K (Game Boy Emulator) Emulator Original Game Boy emulator for Kindle. Recommended for older or softfloat Kindles. Download (https://www.mobileread.com/forums/showthread.php?t=284364) More (gambatte-k.html) Gargoyle Interactive Fiction Emulator Play Z-Machine, Glulx, TADS, and other interactive fiction formats on Kindle with dedicated HF and SF builds. More (gargoyle.html) Media & Audio SOX Media Player Media Audio Bluetooth audio player for music, audiobooks, and internet streams. Supports many popular formats (WAV, MP3, FLAC, OGG, and more). Both softfloat (SF) and hardfloat (HF) versions available. Download (https://www.mobileread.com/forums/showthread.php?t=368945) More (sox.html) KinAMP Media Audio Native music player for jailbroken Kindles. Features a fast interface optimized for e-ink. Supports MP3, FLAC, and WAV. Download (https://github.com/kbarni/KinAMP/releases/) More (kinamp.html) LARK Media Audio Libre Audiobook Player for Kindle. Supports AAC encoded M4B audiobooks and listening history. Download (https://github.com/kbarni/LARKPlayer/releases/) More (lark.html) Video + Audio Playback (Experimental) Media Experimental Proof-of-concept that pairs gmplay video with SoX audio on HF Kindles. Demo media not synced; use matching files for proper sync. Download (https://drive.google.com/file/d/1633_dfciSHXBJbkhkTucIDFEsM4Z7SLX/view) More (audiovideo.html) Drawing Tools Kreate Project Minimal drawing app for Kindle. Tap-based modes for dots, lines, and curves. Download (https://github.com/foskya/kreate) More (kreate.html) KPaint Project Game Boy drawing app (ROM) optimized for Kindle display. Run the ROM via gameboy emulator to draw. Download (https://github.com/crizmo/KPaint/releases) More (kpaint.html) Tools ifdb-dl Tool Tool to download interactive fiction games from IFDB for HF Kindles. Download (https://github.com/dfghjkjhgr/ifdb-dl/releases) More (ifdb-dl.html) Textadept for Kindle Tool Desktop-grade editor for HF Kindles. Download (downloads/textadept.zip) More (textadept.html) KAnki Tool Spaced-repetition flashcard app for Kindle. Download (https://github.com/crizmo/KAnki/releases) More (kanki.html) KNotes Tool Notes and reminders app for Kindle. Download (https://github.com/crizmo/KNotes/releases) More (knotes.html) StorageTool Tool Analyze storage usage, find duplicates, and organize your Kindle library with this KUAL extension. Download (https://github.com/jkpth/StorageTool) More (storagetool.html) KOReader EPUB Links Tool Create booklets in your Kindle library to open each of your EPUBs in KOReader. Download (https://github.com/mriscott/KindleKOreaderEpubLinks/blob/main/createEpubLinks.sh) More (koreader-epub-links.html) Tailscale VPN for Kindle Tool Tailscale VPN Extension for kindle for secure SSH access and remote management and hiding your ip. Download (https://github.com/mitanshu7/tailscale_kual/releases) More (tailscale.html) All Kindle Linux Chroots Guide Utilities Available Linux Chroots links for Kindle More (all-kindle-linux-chroots.html) Resources & Utilities Boot KOReader Automatically Utilities Autolaunch KOReader scripts so the reader opens on boot. Download (https://github.com/meepcat55/Kindle-KOReader-On-Boot) More (bootkoreader.html) KAnki Editor Resource Kindlemodshelf's own web-based editor for creating and managing KAnki flashcard decks. More (editor.html) Ubens Resource Web-based flashcard resource that integrates with kanki. Open (https://ubens.vercel.app/#/) K2pdfopt Resource K2pdfopt is a widely-used tool that optimizes PDF and DJVU files for reading on Kindle devices. It adjusts document layout and formatting to make them more readable on smaller screens. Download (https://www.willus.com/k2pdfopt/download/) More (k2pdfopt.html) ReKindle Utilities A website that adds tons of apps and games designed for Kindle. Open (https://rekindle.io/) More (rekindle.html) KindleKraft (Minecraft Server) Utilities Host a LAN Minecraft server (1.7–1.8) directly on your Kindle. Download (https://github.com/polish-penguin-dev/KindleKraft/releases) More (kindlekraft.html) JarLauncher Resource Launch jar files—yes, including Minecraft—on jailbroken Kindles. Built for HF devices; SF support is untested. Download (https://github.com/ThatPotatoDev/JarLauncher/releases) More (jarlauncher.html) ScreenControl Utilities View and control your Kindle screen from a browser, automate taps, and debug layouts over your local network. Download (downloads/screenControl.tar.gz) More (screencontrol.html) Kindle Browser Patch Utilities Enhance Kindle's built-in browser: remove download restrictions, enable file:// protocol, and choose your search engine (Google, DuckDuckGo, FrogFind, or Bing). Download (https://github.com/emilypeto/KindleBrowserPatch/releases/) More (kindlebrowserpatch.html) Development usbnetlite (HF Only) Dev SSH into your Kindle over USB or Wi-Fi for HF kindles Download (https://github.com/notmarek/kindle-usbnetlite) More (usbnetlite.html) Illusion Framework Dev Build Kindle apps with HTML, CSS, and JavaScript (Mesquite web-app engine). Backbone for tools like KAnki and IllusionChess. Download (https://github.com/polish-penguin-dev/Illusion) More (illusion.html) Telnet Server (Upgraded) Dev Lightweight Telnet server for quick remote CLI access. More (telnet.html) GNU Nano (HF) Dev Lightweight terminal editor for HF Kindles—run in KTerm or over SSH. Download (downloads/nano.zip) More (nano.html) KPM – Kindle Package Manager Dev On-device package manager. Browse, install, update, and manage Kindle mods without manual downloads. Download (https://github.com/gingrspacecadet/kpm) More (kpm.html) Fullscreen Web Browser Dev Fullscreen browser for a specific website for a clean ui to make it look like an app. Download (https://github.com/mitchellurgero/kindle-shortcut-browser/releases) More (fullscreenweb.html) Penguins' Kindle Wiki Dev Mesquite & WAFs and Illusion Guide—comprehensive reference for developing with Mesquite web-app engine and Illusion framework. Open (https://github.com/penguins184/Penguins-Kindle-Wiki) Informational Set Up Custom Screensavers Guide KOReader walkthrough for jailbroken Kindles to rotate custom sleep screen art without touching system files. More (customscreensavers.html) Image Gallery Guide Our collection of community-sourced screensavers. Open (images.html) Image Resource Hub Guide Credited sources for Kindle-ready art, Discord channels, and tools so creators stay recognized and collections stay fresh. More (imageresources.html) KUAL Overview Guide What is KUAL and why do I need it? More (kual.html) Jailbreaking on Mac Guide Why does my kindle not show up on my mac? More (jailbreakonmac.html) Repair Guide Guide Diagnose whether your Kindle is truly bricked and follow restore steps. More (debrick.html) Parental Controls Reset Guide How do I reset forgotten parental control passwords? More (parentalcontrols.html) Developing Your First KOReader Plugin Guide Dev Learn to develop your first KOReader plugin using Lua. More (koreaderplugindev.html) Experimental & Advanced KindleModShelfGPT Tool KindleModShelfGPT files and prompt. More (gpt.html) Other Cool Stuff Experimental UNTESTED Random stuff I thought either did not deserve a page, need a page, or was too dangerous for the average jailbreaker. This is where you come where you have done everything else and are questioning what you do with your kindle now. Like are you supposed to read or something??? More (othercoolstuff.html) × Stay Updated! Get the latest Kindle modding tools & updates. Subscribe Thanks for subscribing! You'll receive updates about new Kindle mods and tools. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) Settings ======================================== --- FILE: jailbreaking.html --- ----------------------------- ← Back to Home (index.html) # How to Jailbreak Your Kindle Jailbreak your Kindle in 2026 with this trusted, up-to-date guide from KindleModShelf. Learn how to unlock your Kindle for KOReader, custom screensavers, emulators, and powerful third-party apps. Take control of your Kindle e-reader, protect your books, and explore features Amazon doesn't want you to have. # Why Jailbreak Your Kindle? Jailbreaking your Kindle gives you the freedom to do more with your device and your books. As of September 2025, firmware 5.18.1 through 5.18.5 can be jailbroken with AdBreak (ads required). Firmware 5.18.0 and lower use WinterBreak. - Freedom over your books: Keep your e-books and documents truly yours—Amazon cannot change, remove, or restrict your files after jailbreaking. - Install powerful alternative reading apps like KOReader for EPUB, PDF, CBZ, and more formats plus advanced customization - Personalize your Kindle with custom screensavers or sleep images - Add apps: drawing, notes, audio playback, file manager, terminal, and classic games - Run Python or shell scripts—automate tasks or create your own Kindle tools - Block forced Amazon firmware updates and keep control of your device - Read EPUB and other eBook formats not natively supported by Kindle - Enable features like dark mode on older Kindles - Access more customization, accessibility, and privacy options For a video overview, watch Why Jailbreak Your Kindle? (https://www.youtube.com/watch?v=Qtk7ERwlIAk) # Step-by-Step Kindle Jailbreak Instructions (2025) # Check Your Firmware Version Before jailbreaking, you need to know your Kindle's firmware version: - Turn on your Kindle - Click the 3 dots on the right top hand side - Click Settings - Click Device Options - Select Device Info - Check your firmware version # Choose Your Jailbreak Method Select the appropriate jailbreak for your firmware version: - Firmware 5.16.2.1.1 or earlier: Use Legacy jailbreaks → Legacy Jailbreak Guide (https://kindlemodding.org/jailbreaking/Legacy/index.html) - Firmware 5.16.3 to 5.18.0: Use WinterBreak → WinterBreak Jailbreak Guide (https://kindlemodding.org/jailbreaking/WinterBreak/) - Firmware 5.18.1 to 5.18.5: Use AdBreak → AdBreak Jailbreak Guide (https://kindlemodding.org/jailbreaking/AdBreak/) - Firmware 5.18.6 and later: Currently has no jailbreak available Note: Legacy jailbreak methods like KindleBreak, WatchThis, and LanguageBreak are available in the Legacy Guide (https://kindlemodding.org/jailbreaking/Legacy/index.html) for older Kindles. # Post-Jailbreak Setup After successfully jailbreaking, you must install these essential components: - Block OTA Updates - Prevents Amazon from forcing firmware updates - MRPI - Mobileread Package Installer - KUAL - Kindle Unified Application Launcher → Complete Post-Jailbreak Setup Guide (https://kindlemodding.org/jailbreaking/post-jailbreak/index.html) Important: This should be integrated with the jailbreaking process, but double-check to make sure everything is installed! Congratulations! You have now freed yourself from the grasp of Amazon! # Essential Mods to Get Started # 1. Install KindleForge (App Store) → KindleForge Installation Guide (kindleforge.html) KindleForge is an app store for Kindles that allows you to download and install mods directly on your device, without needing to copy files manually. Start here for the easiest modding experience! # 2. Essential Apps from KindleForge Once KindleForge is installed, download these must-have apps: - KOReader - Advanced eBook reader → KOReader Guide (koreader.html) | Official Documentation (https://koreader.rocks/) Free, open-source eBook reader supporting EPUB, PDF, CBZ, and more formats with advanced customization - KTerm - Terminal emulator → KTerm Guide (kterm.html) Essential terminal emulator and dependency for many other apps - UpdateBlock Status - Verify OTA protection Confirms Amazon cannot force firmware updates on your device - KUAL/PEKI - App launcher → PEKI Installation Guide (peki.html) Installs and launches KUAL without MRPI with a polished icon - Toggle Ads - Remove lock screen ads → Disable Ads Guide (disableads.html) Remove ads from your Kindle lock screen for free (normally $20) # How to Open Apps There are two main ways to launch apps on your jailbroken Kindle: - Scriptlets: Show up as books in your library - just tap to run - KUAL: Open the KUAL scriptlet, then select the app you want to run Manual installation is straightforward - just follow the step-by-step guides provided for each mod. # Privacy & Customization # Block Amazon Tracking → Block Amazon Tracking Script (blockamazon.html) Amazon tracks literally everything you do, even after jailbreaking: where you click with millimeter precision, what books you open, how long you read, and more. This data is used to serve you ads and sold to advertisers. This script blocks: - Amazon tracking and analytics - Kindle Store access - UI advertisements # Clear Cached Ads → Clear Ad Cache Script (clearadcache.html) After blocking Amazon, you may still see cached ads in the UI. This script removes them completely. Note: Popular reads ads require editing system files which could brick your Kindle. If you want to remove those images, commands are available at kindlemodshelf.me (index.html) under the "Other Cool Stuff" section. # KOReader Customization # Custom Screensavers KOReader by default is pretty bland, but you can customize it extensively! One of the most popular customizations is adding custom screensavers: - → Browse 1000+ Screensaver Images (images.html) - → Installation Guide (customscreensavers.html) # KOReader Plugins & Patches The KOReader community has created numerous plugins and user patches to enhance functionality: Start with Project Title: → Project Title Installation Guide (projecttitle.html) Project Title adds a ton of UI features that beautify KOReader! Installation can be tricky, so follow the guide carefully. Explore more customizations: - → All KOReader Plugins (plugins.html) - → All User Patches (patches.html) - → Page Header Patch (pageheader.html) - Makes your Kindle look like an actual book # Additional Features # Games & Entertainment Your jailbroken Kindle can run various games: - Kindle Wordle - Game Boy emulator - Classic games and more → See all available games in the games section on kindlemodshelf.me (index.html) # Flashcards with KAnki → KAnki Installation Guide (kanki.html) Turn your Kindle into a powerful flashcard app! KAnki is based on the hugely popular Anki, using spaced repetition to help you memorize effectively. Available in the KindleForge app store. Deck Management Tools: - → KAnki Deck Editor (editor.html) - Create and manage decks easily - → Ubens (https://ubens.vercel.app/) - Anki-like experience with easy Kindle syncing (by the same developer) # Kindle Jailbreak Community & Support - Visit the Kindle Modding Wiki (https://kindlemodding.org/) for troubleshooting, advanced tips, and the latest Kindle modding tools. - Join the friendly Kindle Modding Discord community (https://dsc.gg/kindle-modding) for live help, jailbreak news, and project sharing. - Read the KindleModShelf FAQ (https://kindlemodshelf.me/faq.html) for more jailbreak answers, device compatibility, and up-to-date info. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: jailbreakonmac.html --- ------------------------------- ← Back to Home (index.html) # Jailbreaking on Mac Jailbreaking from macOS depends on a reliable USB connection. Determine whether your Kindle needs extra drivers before you begin so the jailbreak scripts can access the device. # USB Connection Requirements macOS communicates with Kindles over USB in two distinct ways depending on the device generation. Confirm which workflow applies to you before starting the jailbreak. # Modern Kindle Devices (USB-C) Recent Kindle models with USB-C ports expose their storage over MTP (Media Transfer Protocol). macOS does not ship with native MTP support, so you must install an additional utility. Required Software: Amazon USB File Transfer (https://www.amazon.com/sendtokindle/mac) - Installs Amazon’s Send to Kindle application, which bundles the MTP driver. - Once installed, your Kindle will appear in Finder and is accessible to jailbreak scripts. - Restart both the app and Finder if the Kindle does not mount immediately after installation. # Legacy Kindle Devices Older Kindles with micro-USB ports expose their storage as classic USB Mass Storage. macOS supports this natively, so no additional software is required. - Connect the Kindle using its micro-USB cable. - The Kindle should mount in Finder automatically. - If Finder does not display the device, try a different cable or USB port. # Testing Your Connection - Plug your Kindle into the Mac with a known-good USB cable. - Open Finder and look for the Kindle in the sidebar. - If it appears, you can proceed directly with the jailbreak instructions. - If it does not appear, install the Amazon USB File Transfer (https://www.amazon.com/sendtokindle/mac) application and reconnect. Confirming USB access before starting prevents mid-jailbreak interruptions caused by missing MTP support. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: jarlauncher.html --- ---------------------------- ← Back to Home (index.html) # JarLauncher Launch jar files on your Kindle, including Minecraft. JarLauncher provides a simple launcher interface for Java applications on jailbroken Kindles. # Download JarLauncher (https://github.com/ThatPotatoDev/JarLauncher/releases) # Prerequisites - KTerm (kterm.html) # Installation - Download the latest JarLauncher.zip from the releases (https://github.com/ThatPotatoDev/JarLauncher/releases) . - Unzip it, then copy the JarLauncher folder into the extensions folder on your Kindle. # Notes - This is different from KINDLEKRAFT (MINECRAFT SERVER) (kindlekraft.html) because it can launch any jar file and it works on HF. - Should support soft-float OSs but is currently untested. - TODO: nano for SF? # Credits ThatPotatoDev (https://github.com/ThatPotatoDev) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: k2pdfopt.html --- ------------------------- ← Back to Home (index.html) # K2pdfopt K2pdfopt is a widely-used tool that optimizes PDF and DJVU files for reading on Kindle devices. It adjusts document layout and formatting to make them more readable on smaller screens. # Getting Started For download and installation instructions, visit: - K2pdfopt Download Page (https://www.willus.com/k2pdfopt/download/) # Documentation K2pdfopt includes comprehensive step-by-step documentation. Rather than duplicating that information here, we recommend consulting the official guide: - K2pdfopt Official Documentation (https://www.willus.com/k2pdfopt/) # Key Features - Optimizes PDF and DJVU files for Kindle screens - Adjusts margins, font sizes, and page layout - Supports multiple output formats - Works on Windows, macOS, and Linux - No jailbreak required (desktop application) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kanki.html --- ---------------------- ← Back to Home (index.html) # KANKI KAnki is an open-source flashcard app that brings true spaced repetition learning to Kindle e-readers. Study any language or subject, customize your decks, and track your progress—right from your Kindle. # PERSONAL NOTE FROM KINDLEMODSHELFGUY (author and maintainer) KAnki is one of my own favorite mods . I already loved Anki, but this Kindle build makes spaced repetition feel perfect on an e ink screen. Kurizu was unbelievably helpful. He spent a lot of time debugging the app with me, explaining changes, and polishing features so it would shine on Kindle. He never asked for anything, but I think this is an amazing tool, so please show some love if you have enjoyed KindleModShelf or KAnki. Support Kurizu on ko-fi.com/kurizu (https://ko-fi.com/kurizu) Projects like the Kindle privacy tools receive plenty of donations. Wonderful apps such as KAnki often fly under the radar. Let us change that and keep this project thriving. # Download - KAnki on GitHub (https://github.com/crizmo/KAnki/releases) # ABOUT KANKI Inspired by Anki, KAnki runs natively on Kindle e-readers, supporting fully customizable vocabulary decks and a spaced repetition system to help you learn faster and remember longer. Use KAnki for Japanese, Spanish, Mandarin, or any subject. # WEB FLASHCARD EDITOR You can create, import, edit, and organize your KAnki flashcard decks in your browser using our KAnki Web Editor (https://kindlemodshelf.me/editor.html) by KindleModShelf. The editor lets you import your KAnki flashcard file, add and edit cards and decks, and see a live preview of what your cards will look like on your Kindle, with the ability to change the preview to match your Kindle model. For the best experience, use it on desktop or laptop. # KEY FEATURES - Add your own language fonts and vocabulary decks - Spaced repetition system for efficient memorization - Organize by level (JLPT, CEFR, HSK, etc.) and filter cards - Star/favorite important cards and practice both directions - Automatic progress tracking and error review mode - Optimized for e-ink and saves progress locally—no account needed # HOW TO INSTALL - Download the latest release from KAnki on GitHub (https://github.com/crizmo/KAnki/releases) . - Connect your Kindle to your computer via USB and unzip the downloaded file. - Customize for your language: - Edit kanki/js/kanki_config.js to set up your language, levels, and vocabulary. (You can use the KAnki Web Editor (https://kindlemodshelf.me/editor.html) for this step!) - Add a compatible TTF font for your language, rename to language.ttf , and place in kanki/assets/fonts/language.ttf if needed. - Copy the KAnki folder and kanki.sh script to your Kindle’s documents folder. - Disconnect your Kindle from the computer. - Find and launch KAnki from your Kindle’s home screen. # HOW TO USE - Study with touch: reveal answers, star key words, and monitor your stats. - Practice both directions (e.g., English↔Spanish). - Filter by proficiency level, and quickly review starred cards. - All stats and progress are saved locally for privacy and portability. # UPDATING KANKI - Back up your vocabulary or config files. - Replace the old KAnki folder with the new version. - Restore your data and fonts if needed. - Launch the app and use the Reload option to apply updates. # CUSTOMIZING FOR YOUR LANGUAGE - Add a TTF font for your language in kanki/assets/fonts/language.ttf . - Edit kanki/js/kanki_config.js for your language, levels, and vocabulary. (Tip: Use the KAnki Web Editor (https://kindlemodshelf.me/editor.html) for this!) - For languages with special scripts, add a reading field as needed. Example deck setup: var KANKI_CONFIG = { language: "Spanish", levels: ["A1", "A2", "B1"] }; var VOCABULARY = { "A1": [ {"front": "hello", "back": "hola", "notes": "Greeting"} ], "A2": [ {"front": "tomorrow", "back": "mañana", "notes": "Time"} ] }; # DATA & TECHNICAL DETAILS - Progress and stats are saved locally—reset any time via the app or by deleting the storage file. - KAnki uses ES5 JavaScript and simple CSS for compatibility. - Some Kindle screen sizes may have layout quirks, but the app works on most models. # CREDITS Developer: Kurizu (https://ko-fi.com/kurizu) — show support via Ko fi if KAnki boosted your Kindle workflow. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kinamp.html --- ----------------------- ← Back to Home (index.html) # KinAMP KinAMP is a native music player developed for jailbroken Kindles (Firmware 5.16+). It features a fast, native interface optimized for e-ink displays. # Download Download KinAMP (https://github.com/kbarni/KinAMP/releases/) # Features - Fully native, fast interface (C++ and GTK2) - Optimized for e-ink displays to save battery - Fast access to Bluetooth and frontlight settings - Supports MP3, FLAC, and WAV formats - Uses miniaudio for decoding and GStreamer backend # Installation - Download the latest release from the link above. - Unzip the archive to the root of your Kindle. - Start KinAMP from KUAL or from the home screen. # Notes - No Background Playback: This is a GUI app and cannot run in the background. To listen to music while reading, SOX Media Player (sox.html) is a better alternative. - Requires Firmware 5.16 or higher. Credits kbarni (https://github.com/kbarni) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kindlebrowserpatch.html --- ----------------------------------- ← Back to Home (index.html) # Kindle Browser Patch Kindle Browser Patch is a patch for the built-in web browser on Kindle devices. Remove download restrictions, enable local file browsing, and choose your preferred search engine. # Download Download Kindle Browser Patch (https://github.com/emilypeto/KindleBrowserPatch/releases/) # Features - Remove filetype restrictions on downloads (downloads saved to /mnt/us/documents) - Enable file:// protocol support for browsing local files - Custom search engine options: Google, DuckDuckGo, FrogFind, or Bing # Compatibility Works on: All HF Kindle devices with firmware 5.16.4 or later Known working devices: - Kindle Scribe (KS): 5.18.5.0.1, 5.17.3 - Paperwhite Gen 6 (PW6): 5.18.1 - Paperwhite Gen 5 (PW5): 5.17.0 - Paperwhite Gen 4 (PW4): 5.17.1.0.3 - Kindle Touch Gen 5 (KT5): 5.17.1.0.3 - Kindle Oasis Gen 3 (KOA3): 5.17.1.0.3 # Requirements - Jailbroken Kindle with root access - KUAL (Kindle Utility Application Launcher) installed # Installation - Download: Get the latest release from the GitHub releases page (https://github.com/emilypeto/KindleBrowserPatch/releases/) - Extract: Extract the downloaded file to /mnt/us/extensions on your Kindle so that you have a folder at /mnt/us/extensions/kindle_browser_patch (must be named exactly this) - Install via KUAL: Open KUAL and select Kindle Browser Patch → Install , then choose your preferred search engine - Wait: Do not touch anything during installation. You will see log messages at the top of the screen - Verify: If installation succeeds, the browser will open automatically for testing. If it fails, you will see a "Failed to install" message # Uninstallation Important: Always uninstall through the KUAL menu. Do not manually delete files, or you will be left without a functional browser until you restore the files and uninstall properly. - Open KUAL - Select Kindle Browser Patch → Uninstall - Wait for the uninstallation to complete # Support For issues, troubleshooting, and detailed documentation, visit the project repository: - GitHub Repository (https://github.com/emilypeto/KindleBrowserPatch) # Credits - emilypeto (https://github.com/emilypeto) – Lead developer - PiperKev (https://github.com/PiperKev) - Sprospring (https://github.com/Sprospring) - emforest (https://github.com/emforest) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kindleforge.html --- ---------------------------- ← Back to Home (index.html) # Kindle Forge KindleForge is a GUI app store for Kindles that allows you to download and install tweaks and applications such as KOReader directly on your device, without needing to copy files manually. It is the recommended method for downloading the apps it contains. Download Kindle Forge (https://github.com/KindleTweaks/KindleForge/releases) MAIN FEATURES - On-device GUI for discovering and installing packages and scriptlets. - Install/uninstall directly from the app. - Basic version awareness for selecting the correct builds where applicable, so you don't have to worry about downloading the wrong version. Installation - Download from Kindle Forge (https://github.com/KindleTweaks/KindleForge/releases) . - Unzip KindleForge.zip . - Plug in your Kindle to your computer. - Copy KindleForge and KindleForge.sh into the documents folder on your Kindle. - Safely eject your Kindle. - On your Kindle home screen, within a few seconds, you should see Kindle Forge appear as a “book.” - Open the book and install. Usage & troubleshooting - To reload the app store to see if there are new apps available through Kindle Forge, click the three dots at the top of the page and click reload. - If the UI behaves oddly, try reloading the page (reload several times) and reboot the device. - Some packages install a scriptlet (launcher) by default; others install to KUAL. Behavior varies per package. Questions and support - Kindle Forge has its own Discord: https://discord.gg/aSG3eMsAsW (https://discord.gg/aSG3eMsAsW) FAQ & Support # KindleForge # Q: The KindleForge scriptlet doesn't appear! A: Ensure you have copied KindleForge.sh into your documents folder. If this is true and the scriptlet still isn't showing, then reinstall the latest hotfix using the following steps: - Turn on aeroplane mode - Restore OTAs - Download latest hotfix from wiki, copy to Kindle root - Update your Kindle - Run the hotfix - Rename OTAs - You can use WiFi once more # Q: When I click on the scriptlet, it says "Application Error!" A: Chances are you've installed KindleForge incorrectly. BOTH the folder AND scriptlet MUST be in the documents folder on your Kindle! # Q: I keep getting core dumps & crashlogs generated when using KindleForge/Scriptlets! A: You must be on the latest hotfix, 2.3.1+. Use these steps to reinstall: - Turn on aeroplane mode - Restore OTAs - Download latest hotfix from wiki, copy to Kindle root - Update your Kindle - Run the hotfix - Rename OTAs - You can use WiFi once more # Q: No apps load and I'm getting "Unknown ABI!" A: This happens commonly after you fix the core dump issue. Please use the "Update KForge" functionality in-app to resolve. Also try reboots, refreshes, etc. This requires WiFi. Note from the kindlemodshelfguy (Author and maintainer) This is an essential tool for new jailbroken Kindles, especially for those who have not jailbroken before! We HIGHLY recommend you use it! Penguins will continue to add mods as people give permission. CREDITS - Created and maintained by Penguins (https://ko-fi.com/penguins186) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kindlekraft.html --- ---------------------------- ← Back to Home (index.html) # KINDLEKRAFT – MINECRAFT SERVER ON KINDLE KindleKraft turns your Kindle e-reader into a Minecraft multiplayer LAN server for versions 1.7.x and 1.8.x. Host and play Minecraft SMP right from your Kindle—no computer required after setup! # Download - KindleKraft on GitHub (https://github.com/polish-penguin-dev/KindleKraft) - Latest Release (https://github.com/polish-penguin-dev/KindleKraft/releases) # Requirements - KTerm (kterm.html) # Install & Setup Install through Kindle Forge (Recommended): - After installing Kindle Forge, click the download button for KINDLEKRAFT. - It will appear in KUAL automatically after downloading. - Download: KindleKraft on GitHub (https://github.com/polish-penguin-dev/KindleKraft) - Place the extension in /extensions and the archive in your Kindle’s root directory (do not extract). - (Optional) Create a 256MB swapfile for better performance. # How to Run - Open KindleKraft in KUAL and select Install KindleKraft . Wait for installation. - Select Launch in KUAL. KTerm will open. - In KTerm, start the server with kindlekraft . - For multiplayer, run kindlekraft -s . To check your Kindle’s LAN IP, use kindlekraft -i . # Connect & Play Join from any device on the same LAN using Minecraft 1.7.x or 1.8.x. # Notes - Fully tested on Kindle 7 (KT2, BASIC). Partially tested on Kindle Paperwhite 7th Gen (PW3) up to 5.16.2.1.1. - UI glitches may occur on newer Kindles or firmware, but server functionality usually works. - Fun, experimental, and open-source—expect quirks and have fun! - Usage subject to the Minecraft EULA (https://account.mojang.com/documents/minecraft_eula) . # Credit penguins Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kindleleaks.html --- ---------------------------- # Restricted Access Unlock Incorrect password. Access denied. ======================================== --- FILE: knotes.html --- ----------------------- ← Back to Home (index.html) # KNOTES KNotes is a notes and reminders app for Kindle. Create, edit, and delete notes with a built-in Kanban board for task management. Simple and intuitive interface optimized for black & white displays. # Download - Download Latest Release (https://github.com/crizmo/KNotes/releases) # Features - Create, edit, and delete notes - Kanban board for task management with Todo, In Progress, and Done columns - Local storage of notes and kanban data - Simple and intuitive interface optimized for black & white displays - Keyboard input support # Installation - Download the latest release from the GitHub repository. - Unzip the downloaded file. - Connect your Kindle to your computer using a USB cable. - Copy the entire KNotes folder and KNotes.sh file to the Documents folder of your Kindle. - Safely eject your Kindle from your computer. - On your Kindle, open the KNotes booklet to start taking notes. # How to Use # Notes: - Upon opening, you'll see a list of your existing notes. - Click "New Note" to create a new note. Enter a name for the note. - Select a note from the list to edit it. - Use the textarea to write or edit your note. - Click "Save" to save changes. - Click "Delete" to remove a note (confirmation required). - Use the on-screen interface or your Kindle's keyboard for input. # Kanban Board: - Switch to the Kanban view using the "Kanban" button. - Add cards to the Todo column by clicking "Add Card". - Move cards between columns using the buttons on each card: - ▶ (from Todo to In Progress) - ✓ (from In Progress to Done) - ↺ (from Done back to In Progress) - Delete cards using the ✕ button. - Save your kanban board to persist changes. # Credits - App by: kurizu - Icon by: greencat777 - Illusion engine by: Penguins184 Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: koclock.html --- ------------------------ ← Back to Home (index.html) # dtDisplay – Clock Plugin for KOReader dtDisplay is a fullscreen clock plugin for KOReader. Instantly turn your Kindle or Kobo into a clean, always-on e-ink desk or bedside clock. # Download - dtDisplay on GitHub (https://github.com/kktse/dtdisplay.koplugin) # Features - Fullscreen time and date for easy viewing - Perfect while your device is charging or at your desk - Designed specifically for e-ink screens - Tap to exit and return to KOReader instantly # Installation - Download from dtDisplay on GitHub (https://github.com/kktse/dtdisplay.koplugin) . - Unzip or clone the repository. - Copy the folder to /koreader/plugins/ on your device. - Restart KOReader. # How to Use - Open KOReader. - Go to Plugins → More tools → Time & Day . - The fullscreen clock appears. Tap the screen to close. # Credits Developed by kktse . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: koreader-epub-links.html --- ------------------------------------ ← Back to Home (index.html) # KOREADER EPUB LINKS This is a script which will create links in your kindle library to open epubs in your documents folder in koreader. It will use the cover image from the epubs so they should display just like kindle books # Download Link - createEpubLinks.sh (https://github.com/mriscott/KindleKOreaderEpubLinks/blob/main/createEpubLinks.sh) # Requirements - kterm recommended - If Kterm is installed you will see a simple interface to choose which links to create or delete. Otherwise it will create links to all books in your documents folder. # Installation Steps - Ensure you have some epub files in your documents folder, and that koreader is installed to read them - Download the script from the link below - Optionally edit the file to change configuration (eg if anything is not installed in the standard location) - Copy it to the /mnt/us/documents folder on your Kindle. - Disconnect your Kindle from your computer. - After a few seconds, you will see a new book called "Create Epub Links" which will create links for any epubs in your documents folder # Credits - irongeek (https://github.com/mriscott) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: koreader.html --- ------------------------- ← Back to Home (index.html) # KOReader for Kindle KOReader is a free, open-source eBook reader app designed for e-ink devices. Enjoy fast page turns, broad format support, and advanced customization not possible with Amazon’s stock app. # Download - KOReader Official Site (https://koreader.rocks/) - Latest Release on GitHub (https://github.com/koreader/koreader/releases) # Main Features - Read all major formats: EPUB, PDF, DJVU, CBZ, MOBI, DOC, TXT, and more - Customize margins, font, contrast, line spacing, and themes - Instant dictionary and translation support - Send books wirelessly, zoom into comics, and use custom screensavers - Designed for e-ink: simple, fast, no unnecessary animations - Allows custom plug-ins # Why Use KOReader? - Open and read virtually any eBook or document that does not have DRM - Personalize your Kindle’s look and feel - Access features the standard Kindle app doesn’t offer # Official KOReader Site & Installation - KOReader Official Site: https://koreader.rocks/ (https://koreader.rocks/) (All downloads, install instructions, support, and documentation) - Direct Download (Latest Version): KOReader GitHub Releases (https://github.com/koreader/koreader/releases) # Summary Make your Kindle a powerful, flexible reading device with KOReader. Visit the official KOReader website (https://koreader.rocks/) to download, install, and get the latest updates and support. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: koreaderplugindev.html --- ---------------------------------- ← Back to Home (index.html) # DEVELOPING YOUR FIRST PLUGIN FOR KOREADER So, you've been using KOReader on your phone, jailbroken Kindle, or some other device, and realized you want to have some functionality that's not built into it. You've probably looked around in the #koplugin tags on Github, and there wasn't one that met your needs. Good news: KOReader is easily extendable with Lua, you can make your own plugin somewhat easily, provided you know some Lua or are willing to learn the basics! # Overview In this guide, we'll go over what you need to set up to make your plugin, and write a basic "Hello World" plugin. For in-depth reference on KOReader's Lua components and examples of more complicated plugins, please look at the source code over at their github repo (https://github.com/koreader/koreader) . We will briefly go over some basics of Lua here, but this is not a Lua tutorial. Please refer to the Lua documentation (https://www.lua.org/manual/5.3/) if you want to know more. # Setting Up Programming without in-editor hints and context-aware autocomplete isn't the best experience, so let's start by setting up our environment. First, let's get the KOReader source code and set up your LSP to properly recognize the require calls. # Create the plugin Git repo First, make a directory for your plugin. By convention, that's a directory with the plugin's name and .koplugin at the end of it, for example: HelloWorld.koplugin mkdir HelloWorld.koplugin cd HelloWorld.koplugin git init -b main # Add the KOReader repository as a submodule git submodule add https://github.com/koreader/koreader.git # Create the .luarc.json file This file will tell your editor the necessary information about your project. For our purposes, we use it to point the LSP to the KOReader Lua source code directories, and to tell it to not scan some directories it doesn't need to: { "workspace": { "library": ["./koreader/frontend"], "ignoreDir": [".vscode", ".git"] } } At this point, environment is set up, let's move on to making the actual plugin. # Making the Plugin Every KOReader plugin consists of at least two files: - main.lua that is the entrypoint to your plugin; - _meta.lua that describes your plugin to KOReader's plugin manager. # _meta.lua This file's structure is extremely simple, it just contains the name and the description of the plugin: local _ = require("gettext") return { name = "hello_world", fullname = _("Hello World"), description = _([[This is a Hello World plugin.]]), } # main.lua This is your plugin's main entrypoint file. It gets executed when the plugin is loaded, and in simple cases will contain all of the code. In more complex cases, it's recommended to split it into files and require them as needed. This code is taken from KOReader's own hello.koplugin, since it's a great example, and modified slightly. --[[-- This is a debug plugin to test Plugin functionality. @module koplugin.HelloWorld --]]-- local Dispatcher = require("dispatcher") -- luacheck:ignore local InfoMessage = require("ui/widget/infomessage") local UIManager = require("ui/uimanager") local WidgetContainer = require("ui/widget/container/widgetcontainer") local _ = require("gettext") local Hello = WidgetContainer:extend{ name = "hello_world", is_doc_only = false, } function Hello:onDispatcherRegisterActions() Dispatcher:registerAction("helloworld_action", {category="none", event="HelloWorld", title=_("Hello World"), general=true,}) end function Hello:init() self:onDispatcherRegisterActions() self.ui.menu:registerToMainMenu(self) end function Hello:addToMainMenu(menu_items) menu_items.hello_world = { text = _("Hello World"), -- in which menu this should be appended sorting_hint = "more_tools", -- a callback when tapping callback = function() Hello.onHelloWorld(self) end, } end function Hello:onHelloWorld() local popup = InfoMessage:new{ text = _("Hello World"), } UIManager:show(popup) end return Hello # Code Breakdown Let's go over the code bit by bit: # LuaDoc Comment --[[-- This is a debug plugin to test Plugin functionality. @module koplugin.HelloWorld --]]-- The LuaDoc comment is partly for human readers, and partly for your IDE: the @module koplugin.HelloWorld is a LuaDoc tag indicating the module name for the documentation. # Module Imports local Dispatcher = require("dispatcher") -- luacheck:ignore local InfoMessage = require("ui/widget/infomessage") local UIManager = require("ui/uimanager") local WidgetContainer = require("ui/widget/container/widgetcontainer") local _ = require("gettext") This is the module imports section. - Dispatcher is the module responsible for dispatching events. We'll hook into it to register our actions. You can also use it to trigger actions within KOReader, like switching a page, changing the font, etc. - InfoMessage is the widget we'll display when the user clicks on our menu entry - UIManager is, as the name suggests, the module that manages widgets. You can use it to show and hide widgets, trigger repaints, and do other things related to the UI. - WidgetContainer is the base widget for your plugin. It can contain other widgets, and is responsible for event propagation and painting (with different alignments) for its children. - _ is the Lua implementation of a subset of gettext. It's used for translation of your plugin's text strings to different languages and for formatting. Excerpt from gettext's manpage: "The gettext program translates a natural language message into the user's language, by looking up the translation in a message catalog." # Widget Initialization local Hello = WidgetContainer:extend{ name = "hello_world", is_doc_only = false, } Here we initialize our base widget and give it a name. It should match the name in _meta.lua . is_doc_only = false tells the KOReader plugin loader to register the plugin instance and keep track of it. If it's set to true, the plugin will not be shown in the plugins list, and its constructor won't be called upon load, or receive events. # Dispatcher Registration function Hello:onDispatcherRegisterActions() Dispatcher:registerAction("helloworld_action", {category="none", event="HelloWorld", title=_("Hello World"), general=true,}) end Here we define a method in Hello that we'll call later to register our action in the Dispatcher. Every widget extends EventListener, and when Dispatcher sends an event, on{EventName} is called on each widget the event is propagated to. In our case, that will be Hello:onHelloWorld # Initialization Method function Hello:init() self:onDispatcherRegisterActions() self.ui.menu:registerToMainMenu(self) end Here we call the method we made earlier, and also call registerToMainMenu(self) . That will, in turn, call the method we'll define next: # Main Menu Registration function Hello:addToMainMenu(menu_items) menu_items.hello_world = { text = _("Hello World"), -- in which menu this should be appended sorting_hint = "more_tools", -- a callback when tapping callback = function() Hello.onHelloWorld(self) end, } end Here we create a menu entry. All the strings that can be shown to a user here are wrapped with gettext so that they can be translated. - text is the name of the entry that'll be displayed to the user in the menu - sorting_hint tells KOReader in which menu or submenu to place this entry. Possible values are (non-exhaustive! Each plugin can add their own menu or submenu): - navi - typeset - setting - tools - more_tools - search - filemanager - main - screen - document - device - selection_text - callback is the function that gets called. In this case it just directly calls our onHelloWorld event handler, bypassing the Dispatcher. # Event Handler function Hello:onHelloWorld() local popup = InfoMessage:new({ text = _("Hello World"), }) UIManager:show(popup) end This is the method that's called when either the user presses the Hello World button we've created, or some other plugin sends the HelloWorld event through the Dispatcher. local popup = InfoMessage:new({text = _("Hello World")}) — Here we create an instance of the InfoMessage widget. It's similar in spirit to alert in JavaScript, it's a modal window that closes when you click outside of it. It can also be moved around by the user, have custom height, an icon and you can set a timeout, after which it'll close automatically. UIManager:show(popup) — Here we take the popup instance we've made, and tell UIManager to show it, which it'll do in its own event loop # Module Return return Hello Finally, we return the Hello class so that KOReader can instantiate and use it. # Credits The original guide was created by consoleaf (https://gist.github.com/consoleaf) and can be found here (https://gist.github.com/consoleaf/abbe8449377f1f6ef47b86d6c0d8873d) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: koweather.html --- -------------------------- ← Back to Home (index.html) # KOWeather – Weather Plugin for KOReader KOWeather is a lo-fidelity weather app that delivers current conditions and short forecasts directly to your Kindle in KOReader. Weather information is provided by WeatherAPI (https://www.weatherapi.com/) . # Download - KOWeather on GitHub (https://github.com/roygbyte/weather.koplugin) # Features - Forecast for the current day - Forecast for the next two days - Hourly forecast for the current day - Celsius and Fahrenheit support (note: not fully working yet) - 24-hour or 12-hour clock options # Requirements - KOReader (koreader.html) installed on your Kindle or other e-reader # Installation - Download the latest release from the project’s GitHub: roygbyte/weather.koplugin (https://github.com/roygbyte/weather.koplugin) . - Unzip the downloaded archive on your computer. - Transfer the weather.koplugin folder to your KOReader-powered device and place it under /koreader/plugins/ . - Restart KOReader. The plugin should appear under Plugins → More tools → Weather . # How to Use - Open KOReader. - Navigate to Plugins → More tools → Weather . - View the current conditions and short forecast. Tap or press the navigation control to return to KOReader. - To change location, open the plugin settings and enter your postal code. # Notes & Troubleshooting - Weather data courtesy of WeatherAPI (https://www.weatherapi.com/) . An internet connection is required to fetch updates. - If the Celsius/Fahrenheit toggle isn’t working, try updating to the latest version of the plugin. # Credits Developed by Roygbyte . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kpaint.html --- ----------------------- ← Back to Home (index.html) # KPAINT KPaint is a Game Boy drawing app optimized for Kindle, inspired by GB Paint by Bownly. Built in C with GBDK, it offers a clean interface, static cursor, and visual color indicators adapted for e-ink screens. # Download - KPaint on GitHub (https://github.com/crizmo/KPaint) - ROM Downloads (https://github.com/crizmo/KPaint/releases) # Features - 18 × 15 pixel canvas - Game Boy 4-color palette (tuned for Kindle) - Up to 16 canvases - Clear-canvas menu - Visual color indicators when holding B - Static, flicker-free cursor # Installation - Install and set up Gambatte-K2 (gameboy.html) on your Kindle. - Download the kpaint.gb file from the GitHub releases (https://github.com/crizmo/KPaint/releases) . - Copy the ROM to your Kindle. - Open it with Gambatte-K2. # Controls - D-pad: Move cursor - A: Draw pixel - B + D-pad: Switch colors - B + Up: Black (white on Kindle) - B + Right: Dark Gray - B + Down: White (black on Kindle) - B + Left: Light Gray - Start: Clear canvas menu # Credits Kurizu (https://ko-fi.com/kurizu) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kpm.html --- -------------------- ← Back to Home (index.html) # KPM – Kindle Package Manager KPM is the all-in-one package manager for Kindle. Install, update, and manage Kindle mods, apps, and utilities directly from your device—no more manual downloads or file transfers. # Downloads - KPM on GitHub (https://github.com/gingrspacecadet/kpm) - Official Wiki & Documentation (https://kpmwiki.vercel.app/home) # What Does KPM Do? - Browse and install Kindle mods, tools, and scripts with just a few taps - Automatically update installed packages when new versions are available - Remove or manage your installed Kindle software easily - Works with a growing library of Kindle homebrew projects # Summary KPM brings true on-device package management to Kindle. Discover new mods, keep your apps up to date, and manage all your Kindle homebrew software easily—all without needing a computer. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kreate.html --- ----------------------- ← Back to Home (index.html) # Kreate Kreate is a minimal drawing app for Kindle. Unleash your creativity and sketch directly on your e-ink device using tap-based modes. See the examples page on GitHub to explore what others have created. # Download - Kreate on GitHub (https://github.com/foskya/kreate) # Installation & Usage Install through Kindle Forge (recommended): Click the download button in Kindle Forge for Kreate once installed. Manual installation: - Copy the /kreate folder and .sh file into /mnt/us/documents (from root). - Launch Kreate from your Kindle Home screen by opening the booklet. # Notes Kindle’s kindle.gestures API recognizes taps and only coarse swipe directions (up, down, left, right), not precise finger paths or endpoints. This makes traditional “press-and-drag to draw” impossible. To work around this, Kreate provides multiple drawing modes so you can choose exactly what to place — dots, lines, or curves. Kreate automatically adapts to any Kindle screen size and model. # Credits Foskya Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kships.html --- ----------------------- ← Back to Home (index.html) # KShips KShips is a Battleship port for Kindle. # Download Download KShips (https://github.com/LOT-PL/KShips/releases) # Features - Three difficulty levels (Easy, Medium, Hard) with progressively smarter AI - Full Battleship gameplay with 5 ships (Carrier, Battleship, Cruiser, Submarine, Destroyer) - AI that intelligently attacks back and hunts down your ships - Ship placement with manual positioning, rotation, and random placement options # Installation Recommended: Install through KindleForge (kindleforge.html) Or install manually: - Download the latest file from GitHub Releases (https://github.com/LOT-PL/KShips/releases) - Unzip the downloaded file - Paste both KShips/ folder and KShips.sh into the documents/ folder on your Kindle - Run the scriptlet and have fun! # Credits - LOT (https://github.com/LOT-PL/) – Developer Special Thanks: - Penguins184 (https://ko-fi.com/penguins186) – For Illusion and helping in the creation Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kterm.html --- ---------------------- ← Back to Home (index.html) # KTerm KTerm is the essential terminal emulator for jailbroken Kindle e-readers. Access the command line, run shell scripts, and use mods and games directly through it. # Download - KTerm on GitHub (https://github.com/bfabiszewski/kterm/releases) # Why Use KTerm? Most Kindle mods, games, and community tools require KTerm. Many will not work unless you have it installed. KTerm is also the recommended way to run shell commands, set up mods, or troubleshoot your Kindle. # Key Features - Touch-friendly terminal interface with on-screen keyboard (two-finger tap to open menu) - Run shell scripts without needing SSH access - Works on most Kindle models and firmware versions # How to Install KTerm Install through Kindle Forge (Recommended): - After installing Kindle Forge, just click the download button. - It will appear in KUAL automatically after downloading. Manual Install: - Download the appropriate version for your Kindle from the latest release on KTerm on GitHub (https://github.com/bfabiszewski/kterm/releases) . - Unzip and copy the files to /mnt/us/extensions/ on your Kindle. - Open KUAL (Kindle Unified Application Launcher) and launch KTerm from the menu. - Use a two-finger tap in KTerm to open the menu or close the app. # Credits Developed by bfabiszewski . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kual.html --- --------------------- ← Back to Home (index.html) # KUAL Kindle Unified Application Launcher (KUAL) is the essential launcher for Kindle mods. # Install KUAL KUAL is marked as part of the installation process on Kindle Mod Wiki. Follow their guide: Kindle Mod Wiki – Installing KUAL + MRPI (https://kindlemodding.org/jailbreaking/post-jailbreak/installing-kual-mrpi/) # Troubleshooting - The installation of Update_KUALBooklet_hotfix_*_install.bin may fail if there is not enough free space on your Kindle. If you use the "fill storage" method to block updates, free some space before continuing. - Verify the location of all required folders and files on the Kindle. - Try copying the Update_KUALBooklet_hotfix_*_install.bin file to the root of your Kindle when connected to your computer, then go to Settings > Update Your Kindle and resume from step 5 in the Kindle Mod Wiki guide. - You can also just install using peki (peki.html) if you have issues with MRPI # Credits HackerDude Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: kwordle.html --- ------------------------ ← Back to Home (index.html) # KWordle KWordle brings the classic Wordle puzzle game to your Kindle e-reader. Built for e-ink, KWordle is offline, multilingual, and features clean visuals for black-and-white screens. Download - KWordle on GitHub (https://github.com/crizmo/KWordle) Features - Classic Wordle gameplay — guess a 5-letter word in 6 tries - Multilingual: English, French, German, customizable word lists - Statistics: win percentage and streaks saved locally - Simple visuals optimized for e-ink displays - Fully offline — no internet required after installation Installation - Download the latest release from KWordle on GitHub (https://github.com/crizmo/KWordle) . - Connect your Kindle by USB and copy the kwordle folder and kwordle.sh script to your documents folder. - Disconnect, then open the KWordle booklet to launch the game. How to Play - The game picks a random 5-letter word. - Enter guesses using the on-screen or Kindle keyboard. - After each guess: ■ = correct spot, □ = wrong spot, × = not in word. - You have 6 tries. See if you can guess the word! Customization To add a new language: - Create lists of guess and valid words, then add them to words.js . - Update the language selection in main.js . - Replace accented with unaccented letters. Credits Kurizu (https://ko-fi.com/kurizu) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: lark.html --- --------------------- ← Back to Home (index.html) # LARK LARK is a Libre Audiobook Player for Kindle. It uses KinAMP's audio engine and is optimized for e-book readers. # Download - Download LARK from GitHub (https://github.com/kbarni/LARKPlayer/releases/) # Features - Support for AAC encoded M4B audiobooks - Uses KinAMP's audio engine and FAAD2 decoder library - Optimized for e-book readers: minimum screen refreshes, backlight management - Listening history - Scriptlet and KUAL launcher included # Installation - Download the latest release from GitHub (https://github.com/kbarni/LARKPlayer/releases/) and extract the archive. - Put lark/LARK in your root directory. - Put lark/extensions/lark folder in your extensions folder on your Kindle. - Put lark/documents/lark.sh script in your Kindle documents folder. - Start it from the library using the provided scriptlet or from KUAL. Credits kbarni (https://github.com/kbarni) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: nano.html --- --------------------- ← Back to Home (index.html) # GNU Nano 8.x for Kindle (HF) Nano 8.x is a terminal-first text editor packaged for Hardfloat (HF) Kindle builds. The package is available as nano.zip . Run the provided binary from the extracted folder with ./nano . When connecting over SSH, set the terminal type first (for example export TERM=linux ). Syntax highlighting can be enabled by passing a nanorc rules file using -f nanorc . # Download - Download nano.zip (downloads/nano.zip) # Features - Familiar terminal editing with standard Nano shortcuts (save, exit, search, cut/paste) - Small, fast binary suitable for quick on-device edits - Optional syntax highlighting via a nanorc rules file (use -f nanorc ) - Runs in KTerm or over SSH # Requirements - Hardfloat (HF) Kindle build only. The provided binary targets armhf/HF runtime. - KTerm (kterm.html) (on-device terminal) or SSH shell access. - External keyboard (Bluetooth or USB) recommended for comfortable editing. # How to Install - Download: nano.zip (downloads/nano.zip) . - Extract the archive on your computer or copy the ZIP to the Kindle and extract it there. - Place the extracted folder on the Kindle (for example under /mnt/us or /mnt/us/documents/nano ). - Make the binary executable if needed: chmod +x /path/to/nano - If shared libraries are included, keep them next to the binary or ensure they are discoverable at runtime (rpath or LD_LIBRARY_PATH ). # How to Run - Run locally on the Kindle: cd /path/to/extracted/folder ./nano filename.txt - Run over SSH: When launching from a desktop terminal via SSH, set the terminal type first: export TERM=linux ./nano filename.txt Setting TERM can help Nano handle control keys correctly in SSH sessions. - Enable syntax highlighting: Provide a nanorc rules file and pass it with -f : ./nano -f nanorc filename.txt # or ./nano -f ./nanorc myfile.c # Troubleshooting - Permission denied — possible causes: - File not executable ( chmod +x ./nano ). - Execution disabled on the mount being used; move the binary to a writable mount that permits exec (e.g., /mnt/us ). - Executable ABI incompatible with the device (verify armhf/HF). - Segfaults or immediate exits — possible causes and checks: - ABI or shared library mismatches (ncurses or other libs). - Try running with bundled libraries using LD_LIBRARY_PATH=./ so the binary finds local libraries. - Confirm the binary's architecture where possible. - Key/terminal behavior over SSH — set TERM=linux before launching Nano to normalize control-key handling. - Library search path — ensure libraries are found via rpath or LD_LIBRARY_PATH ; host-side tools can adjust rpath before transfer if needed. # Notes - The distributed package targets HF (armhf) devices only; it will not work on non-HF/armel builds. - Results may vary across firmware versions; verify compatibility with your device and firmware before use. - An external keyboard greatly improves the editing experience. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: nethack.html --- ------------------------ ← Back to Home (index.html) # NetHack for Kindle The definitive roguelike is headed to Kindle. This page will track the NetHack port’s downloads, setup steps, and control mappings as soon as the build is ready for public testing. # Project Status NetHack for Kindle is currently under active development. The installation package and documentation are being finalized before a public release. Bookmark this page or subscribe to the site updates so you are notified the moment the download becomes available. # What to Expect - Step-by-step installation instructions for hardfloat (HF) and softfloat (SF) Kindles. - Recommended terminal settings and key bindings tailored to Kindle keyboards and touch controls. - Tips for managing save files and backup runs inside KOReader or KTerm (kterm.html) . # Stay Tuned Have NetHack port updates to share? Reach out through the site’s contact channels and we’ll add the latest instructions here. In the meantime, explore the other titles in our Games collection (index.html#games-section) to get your device ready. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: ninemensmorris.html --- ------------------------------- ← Back to Home (index.html) # Nine Men’s Morris Enjoy the classic Nine Men’s Morris board game on your Kindle! Choose either the KUAL (softfloat) app or the KTerm (hardfloat) terminal-launched version. Softfloat (SF): KUAL App Who: For jailbroken Kindles with softfloat firmware and KUAL installed. How to Install (SF/KUAL) - Download: MobileRead: Nine Men’s Morris (SF/KUAL) (https://www.mobileread.com/forums/showpost.php?p=2524556&postcount=43) - Unzip and place the extension in /mnt/us/extensions/ on your Kindle. - Open KUAL — Nine Men’s Morris will appear in your menu. How to Play (SF/KUAL) Launch Nine Men’s Morris directly from the KUAL menu. Notes (SF/KUAL) - Menu-driven, classic gameplay. Perfect for e-ink! Hardfloat (HF): KTerm Version Who: For jailbroken Kindles with hardfloat firmware and the KTerm terminal emulator. How to Install (HF/KTerm) - Download: morris-kindle.zip (downloads/morris-kindle.zip) - Unzip and copy the files to your Kindle. How to Play (HF/KTerm) - Open KTerm and navigate ( cd ) to the game directory. - Run the game with ./morris-kindle . Notes (HF/KTerm) - Disclaimer: The hardfloat (HF) version is known to be unstable on many devices — it often crashes and was not made as robustly as the softfloat/KUAL version. Use the HF build with caution and prefer the KUAL release if you want a more reliable experience. Credits Barna Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: ota.html --- -------------------- ← Back to Home (index.html) # CHECK OTA STATUS Check OTA Status is a quick, read-only script that checks whether Over-The-Air (OTA) updates are blocked on your Kindle. Instantly see if your device is protected from unwanted automatic updates and keep your jailbreak safe. # DOWNLOAD Download most recent release: Check OTA Status on GitHub (https://github.com/neura-neura/Check-OTA-status/releases) # KEY FEATURES - Instant OTA Checker: See at a glance whether your Kindle will auto-update or is protected. - Persistent Status Display: Status message stays on screen until you tap to exit. - Safe & Read-Only: Does not modify your device—purely informational. # HOW TO INSTALL - Download the most recent release ( Check OTA Status on GitHub (https://github.com/neura-neura/Check-OTA-status/releases) ). - Add it to the documents folder on your Kindle. - Unplug your Kindle. - Open the new “book” in your library. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: othercoolstuff.html --- ------------------------------- ← Back to Home (index.html) # Other Cool Stuff DISCLAIMER: All of these are fully untested and may brick your Kindle. If your Kindle is already bricked, see our debrick guide (debrick.html) . # Flash Android onto Your Kindle This only works on older Kindles with an unlocked boot loader. This will be incredibly slow, and basically unusable! You will have no battery life! This thing will drain your battery incredibly quickly! It defeats the purpose of an E ink screen being extremely low power! The only reason why you would want to do this is for the clout of having android on your kindle. - Guide: XDA Forums Android Installation Guide (https://xdaforums.com/t/guide-installing-android-on-your-aging-kindle-e-reader.4450117/) - Successful attempt: Reddit Thread (https://www.reddit.com/r/kindlejailbreak/comments/1oqirrj/i_managed_to_install_android_on_my_kindle/) # KoChess Chess for your Kindle. - KoChess GitHub Repository (https://github.com/bateast/kochess/tree/461fb8969012c7f44285a883f37ccd2021923b28) # Barna's Interactive Fiction Recommendations Barna's recommendations from the original MobileRead thread for interactive fictions you can play on Gargoyle (gargoyle.html) . - MobileRead Thread (https://www.mobileread.com/forums/showpost.php?p=4508221&postcount=31) # How to Change the Order and Position of Menu Items Customize your KOReader menu layout. - Reddit Guide (https://www.reddit.com/r/koreader/comments/1krejjg/how_to_change_to_order_and_position_of_menu_items/?rdt=48083) # Install KOReader on Mac Run KOReader on macOS for testing or reading on your computer. - KOReader MacOS Installation Guide (https://github.com/koreader/koreader/wiki/Installation-on-MacOS) # Gmplay Video Player for Kindle Experimental video player for Kindle. - MobileRead Forum Thread (https://www.mobileread.com/forums/showthread.php?t=177455&highlight=gmplay) # Send Books to KOReader via iPhone Shortcuts SSH books from your iPhone to KOReader on your Kindle using iPhone Shortcuts. - Reddit Thread (https://www.reddit.com/r/koreader/comments/1odp5rs/i_created_a_send_to_kindle_shortcut/?share_id=OgcqimWDicU45KdakpYtc&utm_content=1&utm_medium=ios_app&utm_name=ioscss&utm_source=share&utm_term=1&rdt=56803) # Original KOReader Plugin Page Original KOReader plugins (plugins.html) page which I added to to make my own version. - RSS Reader Plugin Repository (https://github.com/omer-faruq/rssreader.koplugin/tree/7d425c1785685b48799a54d185de1d9f771ece12) # How to Delete Extra Recommended Books After blocking Amazon (blockamazon.html) and clearing the ads cache (clearadcache.html) , if you want to remove the IMAGES from the last remaining row. MonkeyInPrivite tried it and reported back that they "only got the images for the books to go away" but "recommended books still there, just no images." See thread at Kindle Modding Discord (https://discord.com/channels/1083603487025274911/1360078377964408904/1435028457632563240) DISCLAIMER: I AM NOT RESPONSIBLE FOR YOU BRICKING YOUR KINDLE WHILE DOING THIS, THIS DOES REQUIRE MODIFYING ROOTFS Instructions: - Open kterm and type mntroot rw and hit enter - Navigate to /app/KPPMainApp/res/KPPHome/non-ku-asset/US Note that the country could depend on where your Kindle is registered - Delete all files in there - Open kterm and type mntroot ro and hit enter - Restart your Kindle # EasyBrick ⚠️ CRITICAL WARNING: The following tool will BRICK your Kindle. DO NOT RUN unless you fully understand what you are doing and want to kill a kindle for no reason. Please just reset it and send it to me instead of running this! DO NOT RUN THIS! This is a scriptlet that WILL brick your Kindle by removing critical system files. It has no other purpose. Do not run this without understanding that it WILL brick your Kindle. Onatic on the Kindle modding Discord (https://discord.com/channels/1083603487025274911/1439677796124201040/1446516051788562525) apparently ran this without reading and bricked his Kindle. - Download: EasyBrick Scriptlet (/downloads/easybrick.txt) Credit: GreenCat777 (https://github.com/GreenCat-777) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: pagebuilder.html --- ---------------------------- # Page Settings Page Title (H1) Header Description SEO Meta Description Keywords (optional) # Add Blocks + Summary Box + Section + Text + Video + Code + Banner + Credit # Live Preview Export HTML Clear All Clear Saved # Block Properties Select a block to edit its properties HTML copied to clipboard! ======================================== --- FILE: pageheader.html --- --------------------------- ← Back to Home (index.html) # Page Header (KOReader Userpatch) KOReader userpatch that mimics fiction-book page headers at the top of the screen—minimal, elegant, and configurable per book. # Features - Minimal, fiction-style header shown at the top of the screen. - Per-book controls: font, size, margin, letter-spacing, and padding. - Small-caps friendly; choose any installed font by filename. - Chapter-first pages: header hides automatically (like print books). - Cover pages: page number hidden (latest update). - Optional tweak to hide bottom page number on chapter pages. # Requirements - KOReader (koreader.html) installed on your Kindle. # How to Install - Download 2-page-header.lua (downloads/2-page-header.lua) . - On your Kindle, open the KOReader folder. If a folder named patches does not exist, create it. - Place 2-page-header.lua in the patches folder. - Restart KOReader. # Configure - Open the top menu → Settings (cog) → Status Bar → Page Header . - Set font (filename only), font size , margin , letter-spacing , and padding . These are saved per book. - Prefer a small-caps font for the best look. If body text overlaps, increase the book’s top margin . # Downloads - 2-page-header.lua (downloads/2-page-header.lua) # Technical Notes - Defaults: open the Lua file and find -- Defaults (around line 20) to set default font, size, margin, and letter-spacing. - Font name: set the font by filename only (e.g., EBGaramondSC.ttf ), no paths; some fonts use .otf . - Missing font: if a book references a font you later remove or rename, KOReader will show an error—pick a valid font in settings. - Chapter-first page: the header intentionally hides and the page number moves to the bottom. To always hide the bottom page number, change if page_bottom or first_page_of_chapter then to if page_bottom then (around line 677). - Cover page tweak: ensures the page number no longer shows on cover pages. - Device notes: reported working well on Kindle Scribe; adjust margins and font size to taste. # Credits - Author: sandcastles - Based on: 2-reader-header-centered.lua by joshuacant and 2--ui-font.lua by sebdelsol Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: parentalcontrols.html --- --------------------------------- ← Back to Home (index.html) # Forgot Parental Controls Password? If parental controls are enabled and you’ve forgotten the password, you cannot jailbreak until they are disabled. WinterBreak requires access to the Kindle Store, which parental controls block. Use the official Amazon reset methods below, then follow the jailbreak precautions. # Resetting Parental Controls — 6th Gen and Newer Forgot your parental controls password? Reset it using the following steps: - On your Kindle, go to Settings → Parental Controls . - Tap the passcode field. - Enter: 111222777 and tap OK . This will perform a factory reset , which erases all data including the parental controls password, lock screen passcode, and downloaded content. Source: Amazon Help — Reset Parental Controls (6th Gen and newer) (https://www.amazon.com/gp/help/customer/display.html?nodeId=GV3ESZM3CABSBR87) # Resetting Parental Controls — 5th Gen If you’re using a Kindle 5th Gen model, follow these steps: - On your Kindle, go to Settings → Parental Controls . - In the passcode field, type: resetmykindle - Press the Enter key (below the Del key). This will also perform a factory reset , removing all personal information, parental controls, and downloaded content. Source: Amazon Help — Reset Parental Controls (5th Gen) (https://www.amazon.com/gp/help/customer/display.html?ref_=hp_rl_GV3ESZM3CABSBR87_TQyhivTIJY8YuLElNd&nodeId=TQyhivTIJY8YuLElNd) # After the Reset Once the factory reset is complete: - Your Kindle will be wiped clean. - You’ll need to sign back in with your Amazon account later . - Re-enter Wi-Fi credentials and re-download your books once it’s safe to connect. # Important: Prevent Automatic Updates After a reset, as soon as the Kindle connects to Wi-Fi, Amazon will attempt to install the latest firmware update. If that update is applied, it will permanently block the jailbreak . - Unless you have a very old Kindle that Amazon no longer updates, this step is absolutely crucial . - Before signing in or connecting to Wi-Fi, completely fill the Kindle’s storage to 100%. - Use dummy files or a storage filler tool to ensure no free space remains. - Only after the Kindle is fully filled should you connect to the Internet and sign in to your Amazon account. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: patches.html --- ------------------------ ← Back to Home (index.html) # KOReader Patches KOReader patches fine-tune the interface, browser, screensaver, and Project: Title styling. Apply only what you need and restart KOReader after every change. DISCLAIMER: These user patches are community-created. Download and use at your own risk. Please read each patch's GitHub instructions and README to understand what it does. See the KOReader User Patches documentation (https://github.com/koreader/koreader/wiki/User-patches) for installation details. Installation - Create a patches folder inside your KOReader directory (skip if it already exists). - Download each user patch and copy the .lua file into /koreader/patches/ without renaming it. - Restart KOReader so the new patch loads. Core Reading Patches Essential patches for improving the reading experience. - 2-browser-folder-cover.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-browser-folder-cover.lua) - Add cover art to mosaic folders with optional custom .cover images and layout toggles under Settings → Mosaic & detailed list . - 2-browser-hide-underline.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-browser-hide-underline.lua) - Hide the "last visited" underline; enable the toggle in Settings → Mosaic & detailed list . - 2-browser-up-folder.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-browser-up-folder.lua) - Move the "up folder" control into the title bar and optionally hide empty folders. - 2-filemanager-titlebar.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-filemanager-titlebar.lua) - Add rearrangeable metadata widgets to the file manager title bar. - Book Receipt (https://github.com/omer-faruq/koreader-user-patches) - Display detailed book statistics and reading metadata on-screen UI Customization Patches for customizing the KOReader interface and menus. - 2--ui-font.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2--ui-font.lua) - Switch the KOReader UI font via Settings → UI font . - 2-menu-size.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-menu-size.lua) - Reflow menu dimensions to match your device DPI for nicer touch targets. - 2-disable-top-menu-zones.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-disable-top-menu-zones.lua) - Disable the swipe/tap hotzones so the top menu always reopens on its last tab. - Info Message when Opening File Manager (https://gist.github.com/noxhirsch/47d0cb4ee35980ec3c5bc4fc6f2afd2a) - Display helpful notifications when accessing files - 2-BrowseByMetadata.lua (https://github.com/koreader/koreader/issues/8472) - Adds author, title, series, and keyword browser views. Status Bar & Visual Tweaks Patches for customizing the status bar, colors, and visual appearance. - 2-statusbar-better-compact.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-statusbar-better-compact.lua) - Improve compact mode icons, separators, and title/author labels. - 2-statusbar-cycle-presets.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-statusbar-cycle-presets.lua) - Tap the status bar to cycle through saved preset layouts (requires KOReader v2025.04.52+). - 2-statusbar-thin-chapter.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-statusbar-thin-chapter.lua) - Add level-1 TOC chapter markers to the thin progress bar. - 2-reference-page-count.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-reference-page-count.lua) - Fix reference page fallback logic so page counts stay accurate. - 2-change-status-bar-color.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-change-status-bar-color.lua) - Change status bar read/unread colors under Status bar → Progress bar → Thickness, height & colors . - Change Status Bar Color (https://gist.github.com/IntrovertedMage/d759ff214f799cfb5e1f8c85daab6cae) - Customize status bar colors for color e-reader displays - Justify Status Bar (https://github.com/prashanthglen/kojustifystatusbar) - Align status bar content with proper spacing and justification Screen & Sleep Customization Patches for screensaver behavior and sleep screen messages. - 2-screensaver-chapter.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-screensaver-chapter.lua) - Add %C chapter title and %P percent tokens to the sleep screen message. - 2-screensaver-cover.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-screensaver-cover.lua) - Center images, refresh before sleep, and tweak night mode behavior for sleep screens. Advanced Features Standalone patches for extending functionality. - Increase Font List (https://github.com/koreader/koreader/issues/13839) - Expand available fonts by adding custom typeface options. Note: Read through the entire issue thread to locate the code snippet, copy it into a text editor, save the file with a .lua extension (e.g., 2-increase-font-list.lua ), then place it in your patches folder. - Unified Auto Sync (https://gist.github.com/mallomar/67349ac3c88e1950754ba39a4913c029) - Enable automatic synchronization of reading progress across devices - 2-update-patches.lua (https://github.com/sebdelsol/KOReader.patches/blob/main/2-update-patches.lua) - In-app updater for the sebdelsol patch collection (requires KOReader v2025.04.107+). Community Patch Collections Curated patch collections from community developers. Each repository contains multiple patches organized by function—explore the full collection on GitHub for patches matching your setup. - sebdelsol (https://github.com/sebdelsol/KOReader.patches) – Curated the patch library and original documentation - angelsangita Assorted User Patches (https://github.com/angelsangita/Koreader-Patches) - Community collection with browser and UI enhancements - joshuacant Assorted User Patches (https://github.com/joshuacant/KOReader.patches) - Comprehensive collection including Project: Title patches - Djeymisson Assorted User Patches (https://github.com/Djeymisson/KOReader.patches) - Focused patches for cover browser customization - zenixlabs Frankenpatches (https://github.com/zenixlabs/koreader-frankenpatches-public) - Experimental and advanced patches for power users - VeeBui's Detailed Header Footer Patches (https://github.com/VeeBui/KOReader-patches) - Enhanced header and footer customization options - clarainna Download Buttons (https://github.com/clarainna/KOReader-Patches) - Add download indicators and management buttons to your browser - Minimal Book Stats (https://github.com/Litaliaa/koreader-user-patches) - Lightweight version of book receipt showing essential statistics - Reader Header Alternative (https://github.com/oh1apps/koreader_header) - Streamlined page header design for reading view - Smart Collections (https://github.com/advokatb/KOReader-Patches) - Organize books by custom collections and tags - Stacked Top or Bottom Bars (https://github.com/gilgulgamesh/koreader-patches) - Reposition and reorganize interface bars for different layouts Project: Title — User Patches User patches crafted specifically for Project: Title (projecttitle.html) . Download manually—these are not bundled with the plugin. - 2-disable-unread-progressbars.lua (https://github.com/joshuacant/KOReader.patches/blob/main/2-disable-unread-progressbars.lua) - Hide unread progress bars in Cover Grid for cleaner cards. - 2-menutext-overrides.lua (https://github.com/joshuacant/KOReader.patches/blob/main/2-menutext-overrides.lua) - Rename folders/files for display by replacing underscores and reordering leading articles. - 2-project-title-jpeg-filter.lua (https://gist.github.com/mallomar/22176237a7c72b585b802db83d67b38f) - Filter .jpg / .jpeg files from Library mode to keep grids focused on books. - 2-progress-bar-colors.lua (https://gist.github.com/mallomar/147bc13f90fee36df16c6896d0c79e67) - Recolor progress bars on color displays to match Project: Title palettes. Project: Title — Developer Collections Comprehensive patch repositories from Project: Title enthusiasts with themed customizations and UI variations. - loeffner Project Title Patches (https://github.com/loeffner/KOReader.patches) - Advanced styling patches tailored for Project: Title grid layouts - crasmoisi PT Assorted Patches (https://github.com/cramoisi/koreader.patches) - Thematic customizations and header/footer variations for Project: Title - Project Title Alternative (https://github.com/SeriousHornet/KOReader.patches) - Alternative Project: Title styling with different visual themes Project: Title — Grid & Cover Enhancements - Centered Arrows in Footer (https://github.com/Leoparodo/Leos-KOReader-Patches-Plugins) - Center navigation arrows in footer area for balanced layout - Page Count Instead of Progress Bar When Unopened (https://github.com/WorkingLemon/KOReader.patches) - Display page count on unread books in Cover Grid view - Page Count When New or Finished (https://github.com/solyytes/koreader-patches) - Show page totals for unstarted and completed books in Cover List view Project: Title — Compatible Extras General patches verified to cooperate with Project: Title while extending library features. Pair them with the browser tweaks above for a full themed shelf. - KOReader Page Header (pageheader.html) - Fiction-style header bar with per-book configuration that matches Project: Title layouts. - 2-BrowseByMetadata.lua (https://github.com/koreader/koreader/issues/8472) - Adds author, title, series, and keyword browser views that slot neatly into Project: Title navigation. - 2-browser-folder-cover.lua (#patch-browser-folder-cover) - Pair with Project: Title layouts for folder covers that match the themed grid. Make Your Own Clone the 2-userpatch-template.lua (https://github.com/joshuacant/ProjectTitle/blob/master/resources/2-userpatch-template.lua) starter, rename it with the correct execution-order prefix, and customize the Lua hooks for your workflow. Missing a favorite patch? Let us know and we’ll add it after verifying compatibility. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: peki.html --- --------------------- ← Back to Home (index.html) # PEKI (Penguins' Epic KUAL Installer) PEKI installs and launches KUAL without MRPI, delivers a polished icon, and keeps Kindle mod setups dependable. # Features - Install KUAL without MRPI quirks or compatibility failures. - Replace older KUAL booklets or deploy on fresh devices with one launcher. - Ships with a clean custom icon for an improved home screen presence. - Tested by users who previously hit MRPI errors to confirm reliability. - Scriptlets celebrate success with a 1337% completion message. # Downloads (https://github.com/KindleTweaks/PEKI/releases) - Latest Release: github.com/KindleTweaks/PEKI/releases (https://github.com/KindleTweaks/PEKI/releases) # Requirements - 100–300 MB of free storage space. - Kindle device that supports the Universal Hotfix. - Kindle e-reader running a jailbreakable firmware. # How to Install - Download the latest PEKI release (https://github.com/KindleTweaks/PEKI/releases) from GitHub. - Unzip the package on your computer. - Copy both KUAL.jar and KUAL.sh into the /documents/ folder on your Kindle. - Launch PEKI once from your Kindle to install or refresh KUAL automatically. - Keep the PEKI booklet as your dedicated KUAL launcher. # How to Use - Open PEKI from the Kindle home screen whenever you need to access KUAL. - All existing extensions and scriptlets load through the refreshed launcher. - Enjoy the streamlined icon and dependable launch flow on every session. # Credits - Penguins184 — Scriptlet development - Twobob — KUAL booklet foundation - Jeff — Launcher icon design - Project home: KindleTweaks (https://github.com/KindleTweaks) Keep PEKI installed as your default KUAL launcher for a cleaner and more reliable modding workflow. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: plugins.html --- ------------------------ ← Back to Home (index.html) # KOReader Plugins Plugins extend KOReader — add downloaders, sync tools, UI tweaks, clocks, dictionaries, and other handy features. Essential - Time Block (timeblock.html) - Schedule KOReader reading windows with PIN-locked parental controls - Project: Title (https://github.com/joshuacant/ProjectTitle) - Enhanced cover browser with custom title bar, book listings, and visual improvements - Notes (https://github.com/prasy-loyola/notes.koplugin) - Handwritten notes with stylus support - Crossword (https://github.com/roygbyte/crossword.koplugin) - Solve crosswords on your device - Anki (https://github.com/Ajatt-Tools/anki.koplugin) - Generate Anki flashcards from dictionary lookups - Reader Menu Redesign (https://github.com/kristianpennacchia/zzz-readermenuredesign.koplugin) - Redesigned reader menus and popups - Digital Clock (https://github.com/DucNg/digitalclock.koplugin) - Display time, date and image as clock - Reading Ruler (https://github.com/Syakhisk/readingruler.koplugin) - Movable underline to guide reading - Calculator (https://github.com/zwim/calculator.koplugin) - Full-featured calculator with unit conversion - Weight Tracker (https://github.com/KikyTokamuro/weighttracker.koplugin) - Track weight measurements - Smart Delete (https://github.com/tachibana-shin/smartdelete.koplugin) - Enhanced file deletion with warnings - Weather (https://github.com/roygbyte/weather.koplugin) - Weather forecasts and conditions - Web Browser (https://github.com/omer-faruq/webbrowser.koplugin) - Text-based web browsing - Assistant (https://github.com/zeeyado/assistant.koplugin) - AI assistant with multiple providers - Go To Bed (https://github.com/edoput/gotobed.koplugin) - Enforces bedtime - ScreenLockPin (https://github.com/oleasteo/koreader-screenlockpin) - Protect your KOReader with a PIN File Management & Sync - Telegram Downloader (https://github.com/Evgeniy-94/TelegramDownloader.koplugin) - Send files via Telegram bot - File Browser Plus (https://github.com/patelneeraj/filebrowserplus.koplugin) - Run Filebrowser server for wireless file management - Annotation Sync (https://github.com/dani84bs/AnnotationSync.koplugin) - Sync annotations across devices via cloud - Super Sync (https://github.com/BrendanL79/supersync.koplugin) - Full metadata sync to cloud storage - Email to KOReader (https://github.com/marinov752/emailtokoreader.koplugin) - Receive documents and articles directly to your device via email - SyncThing (https://github.com/jasonchoimtt/koreader-syncthing) - Seamless file synchronization across devices using Syncthing Reading Services Integration - Readeck (https://github.com/flip-rossi/readeck.koplugin) - Integration with Readeck instance - Readeck (iceyear) (https://github.com/iceyear/readeck.koplugin) - Readeck integration - Wallabag 2 (https://github.com/clach04/wallabag2.koplugin) - Wallabag v2 server integration - Hardcover (https://github.com/Billiam/hardcoverapp.koplugin) - Update reading status on Hardcover.app - Telegram Highlights (https://github.com/0xmiki/telegramhighlights.koplugin) - Send highlights to Telegram bot with images - Zotero (https://github.com/stelzch/zotero.koplugin) - Browse and download from Zotero collections - Audiobookshelf (https://github.com/naleo/audiobookshelf.koplugin) - Browse and download from Audiobookshelf server - Beeminder (https://github.com/cbrxyz/beeminder.koplugin) - Auto-log reading progress to Beeminder - Gota (Raindrop.io) (https://github.com/cristenger/gota.koplugin-for-raindrop) - Access Raindrop.io bookmarks - Karakeep (https://github.com/AlgusDark/karakeep.koplugin) - Access Karakeep bookmarks - WebDAV Highlights Export (https://github.com/fairlygood/provider-webdav-highlights.koplugin) - Export highlights to WebDAV - Highlight Sync (https://github.com/gitalexcampos/koreader-Highlight-Sync) - Sync reading highlights with external services and cloud storage - OPDS Plus (https://github.com/greywolf1499/opds_plus.koplugin) - Enhanced OPDS browser with advanced catalog features PocketBook Specific - PocketBook Cover (https://github.com/ckilb/pocketbookcover.koplugin) - Sync book cover to power-off screen - PocketBook Sync (https://github.com/ckilb/pocketbooksync.koplugin) - Sync reading progress to PocketBook Library Dictionary & Language - Dictionary Mode (https://github.com/ckilb/dictionarymode.koplugin) - One-tap dictionary lookups - WordReference (https://github.com/kristianpennacchia/wordreference.koplugin) - Lookup words on WordReference - Vocabulary Builder (https://github.com/nbngoc93/vocabulary.koplugin) - Build vocabulary from lookups Utilities & Tools - Clock (https://github.com/jperon/clock.koplugin) - Analog clock display - Time & Day (https://github.com/kktse/dtdisplay.koplugin) - Fullscreen time and date widget - WeatherLockscreen (https://github.com/loeffner/WeatherLockscreen) - Displays beautiful weather information on your device's sleep screen - Crash Log Viewer (https://github.com/Billiam/crashlog.koplugin) - View and filter crash logs - Airplane Mode (https://github.com/kodermike/airplanemode.koplugin) - Quick airplane mode with plugin management - Icons Changer (https://github.com/ebanDev/iconschanger.koplugin) - Download and change icon packs - libgen-opds (https://github.com/b-/libgen-opds.koplugin) - Run libgen-opds server - To-Do (https://github.com/matthewashton-k/todo-koplugin) - Simple todo list app - Illustrations (https://github.com/agaragou/illustrations.koplugin) - View and manage book illustrations in a dedicated gallery - Menu Customizer (https://github.com/JoeBumm/Koreader-Menu-customizer) - Personalize menus and reorganize interface elements - Updates Manager (https://github.com/advokatb/updatesmanager.koplugin) - Manage and control plugin and app updates - App Store (https://github.com/omer-faruq/appstore.koplugin) - Browse and install KOReader plugins and apps - Memobook (https://github.com/omer-faruq/memobook.koplugin) - Personal dictionary for terms and in-book memos - RSS Reader (https://github.com/omer-faruq/rssreader.koplugin) - Follow RSS feeds from a single screen - TBR Planner (https://github.com/omer-faruq/tbrplanner.koplugin) - Organize and schedule your To Be Read list Games & Entertainment - Connections (https://github.com/odrling/connections.koplugin) - NYT Connections puzzle game - sudoku (https://github.com/omer-faruq/sudoku.koplugin) - Sudoku in KOReader - Word Search (https://github.com/omer-faruq/wordsearch.koplugin) - Solve word search puzzles on your device Reading Tracking & Goals - Reading Streak (https://github.com/advokatb/readingstreak.koplugin) - Build reading habits and track consecutive reading days - Reading Goals (https://github.com/koreader/koreader/issues/14195) - Set and monitor reading targets and progress milestones Archive of Our Own (AO3) - AO3 Downloader (https://github.com/IntrovertedMage/AO3Downloader.koplugin) - Download and browse AO3 works - AO3 Updater (https://github.com/ProfBlack/ao3updater.koplugin) - Auto-update AO3 EPUBs Comics - Comic Meta (https://github.com/KORComic/comicmeta.koplugin) - Extract metadata from CBZ/CBR files - Comic Reader (https://github.com/KORComic/comicreader.koplugin) - Dual-page view for comics Development - Developing Your First KOReader Plugin (koreaderplugindev.html) - Learn to build KOReader plugins with Lua. Complete guide covering environment setup, _meta.lua, main.lua, and Hello World example Missing something? Ping me and I'll add it. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: projecttitle.html --- ----------------------------- ← Back to Home (index.html) # ProjectTitle A redesigned KOReader book browser inspired by Cover Browser. ProjectTitle delivers cover-first navigation, smart progress tracking, and gesture-driven layout controls tailored to modern Kindle libraries. # Overview ProjectTitle replaces KOReader’s default Cover Browser with a polished interface that emphasises library artwork, reading progress, and quick navigation shortcuts. # Download Releases Page (https://github.com/joshuacant/ProjectTitle/releases) – Download the version matching your KOReader build exactly. # Features - Enhanced Title Bar – Quick access to Favorites, History, Open Last Book, and Up Folder. - Visual Book Listing – Custom fonts, icons for missing covers, and optional progress bars showing book length. - Clean Folders – Display as cover images, thumbnails, or icons. - Configurable Footer – Show folder paths or device status (time, Wi-Fi, battery, frontlight). - Updated Status Page – Stylish screensaver view with book description and completion progress. - Trophy Icons – Mark finished books at a glance. - Gesture Controls – Pinch or spread to resize items. - Library Mode – Long-press the origami bird to view all books sorted by author or series. - Auto-scan – Detect new books after USB eject. - Filenames Mode – Optional barebones listing (v2025.08v3.5+). # Installation Kindle Only: - Navigate to Menu → Tools → Plugin Management and disable Cover Browser . - Download the release that matches your KOReader version. - Extract the archive and copy the projecttitle.koplugin folder to koreader/plugins/ . - Copy the bundled fonts to koreader/fonts/ . - Copy the icons to koreader/icons/ . - Restart KOReader so ProjectTitle becomes the default browser. If you installed KOReader through Kindleforge you will be on the nightly build; use Menu → Tools → Update to downgrade to the tagged release that matches your ProjectTitle download before re-enabling the plugin. Uninstall: Re-enable Cover Browser in Plugin Management, then delete the ProjectTitle plugin folder, fonts, and icons. # How to Use Open ProjectTitle settings in KOReader via Menu → Tools → More Tools → Project: Title . Review the full documentation for customization tips: ProjectTitle Wiki (https://github.com/joshuacant/ProjectTitle/wiki/Documentation) . # Notes - Release versions must match KOReader exactly. - Works best with libraries that have clean metadata and cover images. - Optional Calibre integration powers the reading progress bars. # Links - GitHub (https://github.com/joshuacant/ProjectTitle) - Installation Guide (https://github.com/joshuacant/ProjectTitle/wiki/Installation) - Calibre Setup (https://github.com/joshuacant/ProjectTitle/wiki/Configure-Calibre-Page-Counts) # Credits - Based on Cover Browser by @poire-z and the KOReader team - Modified by @joshuacant and @elfbutt Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: rekindle.html --- ------------------------- ← Back to Home (index.html) # ReKindle Security Warning: The backend may not currently be secure. Currently we recommend you do not login/create an account if you use this. A website that adds tons of apps and games designed for Kindle. Links https://rekindle.ink (https://rekindle.ink) - Main website GitHub Repository (https://github.com/ReKindleOS/ReKindle) - Open source code Features - Google Suite Sync - Access your Google Tasks, Calendar, and Contacts directly on your Kindle - Lightweight Web Browser - Fast, efficient browsing powered by FrogFind - AI Chat - Gemini 2.5 powered conversational AI right on your device - Game Library - Wordle, Connections, Spelling Bee, Sudoku, Minesweeper, Crossword, Puzzle, Hangman, Anagrams, Memory, and Word Search - Kindle-to-Kindle Chat - Message other Kindle users directly from the app - Productivity Apps - Notes, Reading List, Recipes, Pomodoro Timer, Calculator, Countdown, Translator, World Clock - Information Tools - Reddit, Daily News, Wikipedia, Weather, and "On This Day" historical facts - Open Source - Community-driven development with transparent codebase How to Use - Open your Kindle's web browser - Navigate to https://rekindle.ink - The site will load directly in your browser with no installation needed - Browse the app menu to find the tools and games you want to use - Click any app to launch it instantly - For Google Suite integration, sign in with your Google account when prompted Credits ukiyoau (https://ko-fi.com/rekindle) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: screencontrol.html --- ------------------------------ ← Back to Home (index.html) # screenControl – Remote Control & Automate Your Kindle screenControl lets you view and interact with your Kindle’s screen remotely, straight from your web browser. Adapted from a leaked developer firmware and improved for the Kindle modding community, screenControl enables wireless automation, remote control, and seamless interaction with your e-reader from any computer on your local network. # What Does screenControl Do? - Remote screen viewing: See your Kindle’s display in real time through your web browser. - Remote control: Send clicks and interact with the Kindle interface from your computer. - Works on both softfloat (SF) and hardfloat (HF) Kindles. - No known risk of bricking your Kindle when used as intended. # Features - Connect from any computer or phone using a web browser - See live updates of your Kindle screen - Click anywhere on the Kindle screen from your browser to interact - Automate tasks by sending clicks or scripts - Supports both SF and HF Kindle firmwares (tested up to 5.18.x) - Perfect for automation, bulk book downloads, or DeDRM workflows # Installation - Download: screenControl.tar.gz (downloads/screenControl.tar.gz) - Extract the archive on your computer. - Copy the extracted files to your Kindle’s /mnt/us/extensions/ directory. - Optional: To use from KUAL, make a KUAL-compatible folder/script, or run the .sh script directly in KTerm. - Start the script from KUAL or by running it in your terminal emulator. # How to Use - Find your Kindle’s IP address: Open KTerm and run ip a to display your Kindle’s IP address. - Connect from your browser: On any device on the same network, go to: http://[your-kindle-ip]:6789 (Example: http://192.168.0.69:6789 ) - Interact with your Kindle: The Kindle screen displays in your browser. Click anywhere to control—tap buttons, turn pages, automate actions, or test scripts. # Tips & Troubleshooting - Not showing up in KUAL? Make sure the folder/script is placed in /mnt/us/extensions/ . - Script not appearing as a book? Only .sh scripts appear as books—make a KUAL wrapper for easier access if needed. - To stop screenControl: Restart your Kindle, or run killall screenControlHF or killall screenControl in KTerm. - Lag or slow updates? Display speed depends on your network and Kindle model. - Safe to use: There are no known risks of bricking your Kindle when using screenControl as intended. # Advanced Uses Developers can use screenControl to test Kindle apps, debug layouts, or automate repetitive tasks. The tool supports sending click events programmatically, so you can automate actions or integrate it into scripts. # Notes - Compatible with both softfloat (SF) and hardfloat (HF) Kindle firmware. - Use screenControl for automated workflows: Automate the downloading of multiple books, DeDRM, or complex interactions without manual taps. screenControl is a unique way to interact with and automate your Kindle wirelessly—control it remotely, automate tasks, and streamline your e-reader workflow. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: screenlockpin.html --- ------------------------------ ← Back to Home (index.html) # KOReader PIN Lock Screen Plugin A fast, sophisticated PIN Lock Screen that protects your KOReader content from unauthorized access. Designed for privacy and casual protection, not cryptographic security. # Download - Latest Release on GitHub (https://github.com/oleasteo/koreader-screenlockpin/releases/latest) # Features Just what you'd expect from a PIN lock screen… Lock on wakeup — secures your device after sleep Lock on boot — secures your device on KOReader boot Privacy first — hides everything but your wallpaper from public eyes Device Info — glimpse the time & battery on the lock screen Rate Limit — forced delays after repeatedly failed attempts and more… Instant unlock — immediate response, no extra confirmation button Contact notes — people should know how to return a lost device Customizable layout — can be configured for single-handed use Frontlight control — easily turn on the screen light in a dark environment Lightweight design — optimized for performance PIN length — 3 to 12 digits Auto updater — Don't miss out on plugin improvements # How to Install - Download the latest release (https://github.com/oleasteo/koreader-screenlockpin/releases/latest) ; either archive is fine — whatever you're familiar with. - Extract the archive and copy the extracted folder screenlockpin.koplugin into KOReader’s plugins directory. - Restart KOReader. The plugin will appear in the Screen submenu. # How to Use - On your KOReader, open the new Screen › Lock screen submenu. - Set your PIN and configure the options to your liking. Depending on your settings, the Lock Screen will now appear during boot and / or during wakeup from sleep mode. If you enable lock on boot , make sure to have some way of file access without unlocking the KOReader, in case you forget the PIN. A new Lock action is added to the Exit menu, to lock manually (some prefer it over auto-lock on suspend). Actions for the dispatcher (e.g., Gesture manager) can be found in the Device group. # Credits - Developed by oleasteo (https://github.com/oleasteo) - Plugin Homepage (https://github.com/oleasteo/koreader-screenlockpin) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: screenshot-gallery-examples.html --- -------------------------------------------- ← Back to Home (index.html) # Screenshot Gallery Examples This page demonstrates all the different ways to use the screenshot gallery system. Copy and paste the patterns you need into your pages. Remember to replace placeholder images with actual screenshots from page_images/ folder. # Default Auto-fit Gallery Automatically adjusts columns based on available space. Good for most use cases. First screenshot with caption Second screenshot with caption Third screenshot with caption # Dual Column Layout Fixed 2-column layout. Perfect for side-by-side comparisons. Left side Right side # Triple Column Layout Fixed 3-column layout. Good for showing multiple features. Feature 1 Feature 2 Feature 3 # Single Column (Featured) Large, centered screenshot. Perfect for hero images or main features. Large featured screenshot showcasing main interface # Without Captions Clean gallery without text captions. Add no-caption class. # With Badges Add badges to highlight new features or versions. NEW Newly added feature v2.0 Updated in version 2.0 # Different Aspect Ratios Use wide , square , or portrait classes on the wrapper. 16:9 Widescreen 1:1 Square 3:4 Portrait # Lazy Loading Use data-src instead of src to lazy load images. Lazy loaded image 1 Lazy loaded image 2 # Before/After Comparison Side-by-side comparison with labels. Before After # Mixed Gallery with Multiple Images Gallery with multiple screenshots that opens in lightbox viewer. Main home screen interface Settings and configuration NEW Newly added dark mode Navigation menu Full reading view in widescreen Book library organization # HTML Code Reference # Basic Structure
Description
Caption text here
# Layout Classes - .screenshot-gallery - Default auto-fit - .screenshot-gallery.single - 1 column - .screenshot-gallery.dual - 2 columns - .screenshot-gallery.triple - 3 columns - .screenshot-gallery.quad - 4 columns - .screenshot-gallery.compact - Smaller thumbnails # Aspect Ratio Classes - .screenshot-img-wrapper - Default 3:2 - .screenshot-img-wrapper.wide - 16:9 - .screenshot-img-wrapper.square - 1:1 - .screenshot-img-wrapper.portrait - 3:4 # Additional Classes - .screenshot-item.no-caption - Hide caption - .screenshot-item.featured - Larger, featured item - .screenshot-badge - Badge overlay (NEW, v2.0, etc.) # Usage Instructions # 1. Add JavaScript Include the screenshot gallery script before closing tag: # 2. Add Images to page_images Folder Follow the naming convention: [page-name]-[number].jpg - koreader-1.jpg - koreader-2.jpg - 2048-1.png # 3. Insert Gallery HTML Copy one of the patterns above and replace placeholder images with your actual images. # 4. Features - ✅ Click any screenshot to open lightbox viewer - ✅ Use arrow keys (← →) to navigate between images - ✅ Press ESC to close viewer - ✅ Fully responsive on all devices - ✅ Dark/light theme support - ✅ Lazy loading for better performance Screenshot Gallery Examples - KindleModShelf ======================================== --- FILE: screeny.html --- ------------------------ ← Back to Home (index.html) # Screeny Custom Screensavers outside of KOreader # Github Screeny (https://github.com/KindleTweaks/Screeny) Unlike NiLuJe’s Hacks or manually replacing the images Screeny is a safe screensaver hack that won't brick your device or be dangerous. Credits: penguins184 (https://github.com/penguins184/) , Clint (https://github.com/clintharrison) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: shortcuts.html --- -------------------------- ← Back to Home (index.html) # Home Screen Shortcuts Home Screen Shortcuts are a quick and beautiful way to access your Kindle mods directly from the Home screen. Each shortcut launches an installed app or script instantly — no KUAL needed. # Installation Steps - Select the shortcuts you want to add and download them from the list below. - Copy them to the /mnt/us/documents folder on your Kindle. - Disconnect your Kindle from your computer. - After a few seconds, they will appear like books on your Kindle Home screen. # Shortcut Files KOReader.sh (downloads/KOReader.sh) KOReader launcher — opens KOReader directly from the Home screen. koreader_launcher_asap.sh (downloads/koreader_launcher_asap.sh) KOReader ASAP launcher — opens KOReader instantly. Kterm.sh (downloads/Kterm.sh) KTerm terminal launcher. Alpine.sh (downloads/Alpine.sh) Alpine launcher. KindleFetch.sh (downloads/KindleFetch.sh) KindleFetch utility launcher. KindleFetch2.sh (downloads/KindleFetch2.sh) Alternative KindleFetch launcher script. shortcut_gambatte-k2.sh (downloads/shortcut_gambatte-k2.sh) Game Boy emulator launcher for hardfloat Kindles. gargoyle.sh (downloads/gargoyle.sh) Text adventure (Infocom) emulator launcher. screenControl.sh (downloads/screenControl.sh) Screen control utility. USB_Network_Toggle.sh (downloads/USB_Network_Toggle.sh) USB network toggle utility. storagetool.sh (downloads/storagetool.sh) Storage management tool. PEKI (peki.html) description KUAL Booklet # Notes - If a shortcut doesn't run, confirm the file is executable and located in /mnt/us/documents . - If a shortcut doesn’t appear, restart your Kindle and wait — it should show up within a minute. - These scripts are simple launchers that call the actual app start scripts on your device. You must have the corresponding app installed for them to work. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: snake.html --- ---------------------- ← Back to Home (index.html) # Snake for Kindle Snake brings the classic arcade game to your Kindle e-reader. Eat food to grow, avoid walls and your own tail. Built with Illusion and tuned for e-ink. # Download - Download snake.zip (downloads/snake.zip) # Features - Classic Snake gameplay - Arrow-button controls (▲ ◀ ▶ ▼) - Score tracking - Progressive difficulty as the snake grows - E-ink-optimized visuals # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download snake.zip (downloads/snake.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Use the on-screen arrow buttons to change direction - Eat the food to grow longer and increase your score - Avoid hitting the walls or your own tail Relive the classic Snake experience on Kindle! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: sox.html --- -------------------- ← Back to Home (index.html) # SOX Media Player SOX Media Player lets you play music, audiobooks, and internet streams over Bluetooth directly on your Kindle. Supports WAV, MP3, FLAC, OGG, and many other audio formats. Versions are available for both softfloat (SF) and hardfloat (HF) firmware. # Features - Bluetooth audio playback for music, audiobooks, and internet streams - Supports WAV, MP3, FLAC, OGG, AIFF, AU, GSM, RAW, CAF, VOC, W64, WVE, XA, XI, and more - Playlist support: M3U, PLS - Simple KUAL-based interface - Custom internet radio/stream support via editable menu.json # Requirements - Kindle with Bluetooth support - Jailbroken with KUAL (kual.html) installed - Download either SF (softfloat) or HF (hardfloat) version matching your Kindle firmware # How to Install Install through Kindle Forge (recommended): - Click the download button in Kindle Forge for SOX once installed. It will appear in KUAL automatically. Manual installation: - Visit the official SOX Media Player thread (https://www.mobileread.com/forums/showthread.php?t=368945) and download the correct zip for your firmware (SF or HF). - Unzip the file on your computer. - Copy the SOX folder to /mnt/us/extensions/ on your Kindle. - Place your music or audiobooks in /mnt/us/music/ on your Kindle. - Safely eject and disconnect your Kindle. # How to Use - Pair your Bluetooth audio device with your Kindle via Settings. - Open KUAL on your Kindle. - Launch SOX Media Player from the KUAL menu. - For internet radio, edit menu.json to add custom streams (see the README and forum thread for setup details). # Notes & Troubleshooting - All files in a single playlist or call must share the same format, rate, channels, and bit depth. - Bluetooth may sometimes disconnect; if playback freezes, reconnect your device or restart the Kindle. - AAC files are not supported — playback attempts will fail. - Ensure your device is properly paired before launching SOX for smoother performance. Credits dhdurgee Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: storagetool.html --- ---------------------------- ← Back to Home (index.html) # StorageTool StorageTool is a storage management utility for jailbroken Kindles. Analyze, visualize, and organize your ebook collection to keep storage under control. # Download StorageTool on GitHub (https://github.com/jkpth/StorageTool) # Requirements - KTerm (kterm.html) # Installation # Method 1: One-Line Install (Recommended) - On your Kindle, open KUAL and launch KTerm. - Run the following command: curl https://jpt.bio/StorageTool/install.sh | sh - Restart KUAL to see StorageTool in your menu. # Method 2: Direct Installation - Copy the storagetool folder to your Kindle's /mnt/us/extensions/ directory. - Restart KUAL to see StorageTool in your menu. # Usage Launch StorageTool from the KUAL menu. From there, you can: - Storage Overview: View your Kindle's overall storage usage. - Scan Books Directory: Analyze your books directory for size and file types. - Analyze by File Type: See a breakdown of book formats and their storage usage. - Recent Files: View recently added or modified books. - Find Duplicates: Identify potential duplicate books. - Settings: Configure StorageTool options and set your books directory. - Check for Updates: Automatically check for and install the latest version of StorageTool. # Credits Made by jkpth (https://github.com/jkpth) Inspired by KindleFetch (kindlefetch.html) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: subscribe.html --- -------------------------- Subscribe for Updates Get the latest Kindle modding tools, jailbreak guides, and screensaver images right in your inbox. Subscribe Thanks for subscribing! You'll receive updates about new Kindle mods and tools. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: sudoku.html --- ----------------------- ← Back to Home (index.html) # Sudoku for Kindle Sudoku brings the classic number puzzle game to your Kindle e-reader. Built with the Illusion framework, enjoy Sudoku puzzles with multiple difficulty levels—optimized for e-ink displays. # Download - Download sudoku.zip (downloads/sudoku.zip) # Features - Classic 9×9 Sudoku gameplay - Multiple difficulty levels - Touch to select a cell; use on-screen number buttons - Clean interface designed for e-ink - Works offline—no internet required # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download sudoku.zip (downloads/sudoku.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Tap a cell to select it - Use the on-screen number buttons to fill or change a digit - Complete the grid so each row, column, and 3×3 box has 1–9 with no repeats Challenge your mind with Sudoku on your Kindle! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: tailscale.html --- -------------------------- ← Back to Home (index.html) # Tailscale VPN for Kindle KUAL Tailscale VPN Extension allows you to connect your jailbroken Kindle to your Tailscale network, enabling secure SSH access and remote management. # Download - Download Tailscale KUAL Extension (https://github.com/mitanshu7/tailscale_kual/releases) # Requirements - KUAL (Kindle Unified Application Launcher) (kual.html) - USBNetwork Hack (https://www.mobileread.com/forums/showthread.php?t=225030) installed and enabled - Set up SSH keys for ease of use # Installation - Download the repository from the link above. - Get the latest tailscale binaries for the ARM architecture from Tailscale's official package repository (https://pkgs.tailscale.com/stable/#static) . Or see the releases page for a version that worked for the developer. - Place the tailscale and tailscaled binaries in the tailscale/bin/ folder of the downloaded repository. - Fill the empty auth.key file in the tailscale/bin/ folder with your Tailscale Auth Key (https://tailscale.com/kb/1085/auth-keys) to login. - Place the tailscale folder (not the tailscale_kual folder) into the extensions folder on your Kindle. - In the KUAL menu, start tailscaled first, wait for about 10 seconds, then start tailscale . - After this, Tailscale should add the Kindle to your Machines page (https://login.tailscale.com/admin/machines) on Tailscale admin console (https://login.tailscale.com/welcome) . - Now you can see the (fairly static) IP address assigned by Tailscale for your Kindle. You can use this IP to SSH: ssh root@ Note: Make sure the Kindle screen is on, else the Kindle sleeps the WiFi. You also cannot connect to Kindle via SSH when it is connected to PC using the cable. To reset: In case you want to restart fresh, remove Kindle from Tailscale admin console, stop Tailscale and tailscaled in KUAL, and delete the logs and new files created in /extensions/tailscale/bin . This will reset the state of Tailscale on your Kindle. # Links - Full guide on GitHub (https://github.com/mitanshu7/tailscale_kual?tab=readme-ov-file) # Credits Developed by mitanshu7 (https://github.com/mitanshu7) . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: telegram.html --- ------------------------- ← Back to Home (index.html) # KOReader Telegram Highlights Plugin A beautiful way to instantly send Kindle book highlights and screenshots from KOReader to your Telegram account using the @bookshotsbot Telegram bot. # Features - Send highlights and selected text from KOReader directly to Telegram - Share Kindle screenshots to Telegram in seconds - Bulk upload all bookmarks or individual highlights - Auto Wi-Fi toggle: turns Wi-Fi on to send, then off (where supported) - Customize quote images using the Telegram miniapp (backgrounds, colors, Unsplash photos) # Requirements - KOReader (koreader.html) installed on your Kindle or e-reader - Telegram account - Wi-Fi enabled for sending highlights and screenshots # How to Install - Download the latest release from the GitHub repository (https://github.com/0xmiki/telegramhighlights.koplugin/releases) . - Unzip the downloaded file. You’ll get a folder named telegramhighlights.koplugin . - Copy this folder to your KOReader plugins directory. - Restart KOReader. The plugin appears under Tools → Telegram Highlights . # How to Set Up - Start a chat with @bookshotsbot (https://t.me/bookshotsbot) on Telegram and get your verification code. - In KOReader, open the Telegram Highlights plugin from the Tools menu and enter your code. # How to Use - Send a highlight: Select text, open the highlight menu, and tap Send to Bot or Save & Send . - Send a bookmark: Long-press a bookmark, then tap Send to Bot . To send all bookmarks, go to Bookmarks → Menu → Send all to Bot . - Send a screenshot: Swipe diagonally to capture, then select Send to Bot in the dialog. # Customization Use the Telegram miniapp to change quote backgrounds, colors, or add Unsplash images. Launch the miniapp from the Highlights screen in KOReader. # Credits Developed by Miki . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: telnet.html --- ----------------------- ← Back to Home (index.html) # Telnet for Kindle – Remote Command Line Tool Telnet for Kindle is a lightweight server script that enables remote command-line (CLI) access to your jailbroken Kindle. Connect from your computer over a local network to manage your Kindle, debug scripts, or perform quick system operations without USB. # What Is Telnet for Kindle? This script opens a Telnet server on your Kindle so you can connect to it remotely via any Telnet client. Touching the Kindle screen closes the session. A title bar and icon are included for user visibility. Security Note: Telnet is unencrypted. Only use on secure local networks. For encrypted access, use SSH instead (https://kindlemodshelf.me/ssh.html) . # Features - Remote shell access over your local network - Tap the Kindle screen to close the session - Extremely lightweight and fast to launch - Useful for debugging, recovery, or remote system management # Requirements - Jailbroken Kindle (jailbreaking.html) - KUAL or KTerm (kterm.html) to run scripts - A computer and Kindle on the same Wi-Fi network # Installation & Usage - Download Telnet.sh from the project repository or release page. - Copy Telnet.sh to /mnt/us/extensions/ on your Kindle. - Run it via KUAL or with this KTerm command: sh /mnt/us/extensions/Telnet.sh - From your computer, use any Telnet client to connect to your Kindle’s IP address. - To end the session, tap the Kindle screen. # Technical Notes - Touchscreen event detection cleanly terminates the Telnet server - No persistent installation—server stops after session ends - Low system resource use, ideal for minimal debugging tasks Use Telnet for quick, local command-line access to your Kindle without USB or SSH. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: tetris.html --- ----------------------- ← Back to Home (index.html) # Tetris for KTerm (HF Only) Play classic Tetris on your jailbroken Kindle, right in the terminal. Tetris for KTerm is a lightweight terminal-based Tetris game for Kindles running hardfloat (HF) firmware—no emulator needed. # Download - Download kindletetris.zip (downloads/kindletetris.zip) # Requirements - Jailbroken Kindle with hardfloat (HF) firmware - KTerm terminal (kterm.html) installed # How to Install - Download the game: Download kindletetris.zip (downloads/kindletetris.zip) - Unzip the file on your computer. - Copy the extracted files to your Kindle. Place them in your preferred directory (e.g., /extensions ). - Eject and disconnect your Kindle from your computer. # How to Play - Open KTerm on your Kindle. - Navigate to the directory where you placed the Tetris files using the cd command. - Start the game by typing: ./kindletetris - Enjoy classic Tetris directly in the terminal window! # Notes - This version works only on hardfloat (HF) firmware models. It is not compatible with softfloat (SF) devices. - You must launch Tetris from inside KTerm; it is not a standalone app or menu item. - Want Game Boy Tetris? Use a Game Boy emulator instead for easier playing. # Credits Developed by Barna . Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: textadept.html --- -------------------------- ← Back to Home (index.html) # Textadept for Kindle Textadept is a compact, desktop-grade text editor brought to Kindle (HF). Fast, scriptable in Lua, and packed with developer features — multi-buffer, split view, lexer-based highlighting, and a command palette. Includes both a GTK-based graphical interface and a CLI interface for KTerm. # Features - Multi-buffer editing and split views (side-by-side) - Lexer-based syntax highlighting for many languages - Command palette for quick commands and actions - Completely scriptable and extensible in Lua - Graphical GTK UI & a lightweight CLI interface that runs in KTerm - Small footprint and fast startup — suited to HF Kindle builds # Requirements - Hardfloat (HF) Kindle build only — Textadept requires HF runtime support - Mesquite / Illusion environment for GUI integration (if using GTK frontend) - KTerm (kterm.html) (terminal) available for CLI usage - External Bluetooth keyboard recommended (see Bugs) # How to Install - Download textadept.zip (downloads/textadept.zip) - Either: - Unzip on your computer and copy the resulting folder and any included .sh launcher to your Kindle's documents folder, or - Copy the zip to the Kindle and extract it on-device (if you prefer extracting directly on the Kindle). - If there is a launcher script ( .sh ), make it executable and place it in /mnt/us/documents so it appears as a tappable "book" on the Home screen. - To run the terminal interface, open KTerm and launch the included CLI binary or wrapper script from the Textadept folder. - For the GUI, launch the supplied GTK frontend (requires Mesquite / Illusion integration and HF runtime). # How to Use - CLI (KTerm): Open KTerm and run the included textadept CLI. Ideal when using the Kindle touchscreen + on-screen keyboard or when GTK is not usable. - GUI (GTK): Launch the GTK interface for mouse-like menus, split panes, and the command palette. Best with an external keyboard for shortcuts. - Use the command palette to quickly open files, switch buffers, or run Lua commands. - All editor functionality is scriptable — read the included Lua snippets and the manual to extend behavior and add shortcuts. # Known Issues - Software keyboard bug: When using the GTK graphical interface, the Kindle's software keyboard may disappear when a modal dialog opens. This is a known GTK integration issue. - Workaround: use a Bluetooth/external keyboard or use the KTerm CLI interface until the dialog/keyboard issue is resolved. - If you encounter crashes or missing lexers, check the included log or open the CLI to see error output. # Documentation - Read the included manual and API files in the Textadept folder for usage, keyboard shortcuts, and Lua extension examples. - Command palette and keybindings are configurable via Lua — the docs show sample bindings for common editing tasks. Textadept brings a desktop-grade editing experience to HF Kindles. If you use an external keyboard or prefer terminal workflows, it's a powerful and lightweight editor worth learning. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: tictactoe.html --- -------------------------- ← Back to Home (index.html) # TicTacToe Classic TicTacToe for Kindle launchable from KUAL. Install the extension to play quick matches on your jailbroken device. # Download TicTacToe (https://github.com/progzone122/tictactoe-kindle/releases) # Requirements - KUAL # Instructions - Download from TicTacToe (https://github.com/progzone122/tictactoe-kindle/releases) . - Unzip the archive and move the tictactoe directory to the extensions folder on your Kindle. - Open KUAL and launch TicTacToe. # Credits progzone122 (https://github.com/progzone122) Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: timeblock.html --- -------------------------- ← Back to Home (index.html) # Parental Controls for KOReader KOReader Time Block limits when children can read in KOReader with customizable reading windows so kids can enjoy ebooks only during the times you approve. Still in active development: Time Block may fail to lock KOReader reliably and should not be treated as a guaranteed parental control solution. Expect bugs, missed lockouts, and behavior changes between releases. # Overview KOReader Time Block adds parental controls to KOReader, letting you define daily reading hours, set PIN-protected overrides, and keep curious kids from bypassing the rules. It works entirely on-device and is easy to configure after installation. # Downloads - KOReader Time Block Plugin (downloads/timeblock.koplugin.zip) # Features - Define start and end times for when KOReader may be used - Lock settings behind a parent PIN with recovery access - Enable or disable the schedule without uninstalling - Optional manual lock to immediately secure the device # Requirements - KOReader installed on Kindle - USB access to copy plugin files # Installation - Download the plugin archive above and unzip it. - Copy the extracted timeblock.koplugin folder into koreader/plugins/ on your Kindle. - Eject the Kindle safely and launch KOReader. # Initial Setup - In KOReader, tap the top menu, choose File Cabinet , then open Parental Controls . - Unlock the settings with the default PIN 0000 ; change it immediately via Change PIN . - Note the recovery PIN 8642 ; use it if the main PIN is forgotten. - Set Blocking Enabled to control whether the schedule is active. - Configure the daily Start Time and End Time that KOReader should allow reading. - Toggle Enable PIN Override if you want the parent PIN to temporarily bypass the schedule. - Exit the settings menu to save changes; always lock the settings manually before handing the Kindle back to your child. # Tips & Best Practices - Time Block relocks automatically, but use the lock option after editing to be safe. - Enable KOReader’s “launch on boot” option so a reboot does not expose the stock Kindle UI. - Store your pin somewhere secure. # Credits - kindlemodshelfguy - Plugin authors and maintainers from the KOReader community Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: towerofhanoi.html --- ----------------------------- ← Back to Home (index.html) # Tower of Hanoi for Kindle Tower of Hanoi is the classic logic puzzle: move the stack of disks to another peg, one at a time, without placing a larger disk on a smaller one. # Features - Classic Tower of Hanoi gameplay - Multiple difficulty options (vary disk count) - Move counter to track efficiency - E-ink-friendly visuals # Requirements - Jailbroken Kindle with Mesquite support - Illusion framework compatibility # How to Install - Download tower-of-hanoi.zip (downloads/tower-of-hanoi.zip) - Unzip the file on your computer (uncompressed folder + .sh script) - Place the .sh script and the folder in your Kindle’s documents folder - Disconnect your Kindle - Tap the new book in your Kindle library to launch # How to Play - Move all disks from the first peg to the last peg - Only one disk may be moved at a time - No larger disk may be placed on a smaller disk - Minimum moves for n disks is 2^n − 1 Challenge yourself with the Tower of Hanoi on Kindle! Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: universalpaperclips.html --- ------------------------------------ ← Back to Home (index.html) # Universal Paperclips Universal Paperclips is a game where the user plays the role of an AI programmed to produce paperclips. Download - Download com.kbarni.paperclips.zip (downloads/com.kbarni.paperclips.zip) Installation - Download the file com.kbarni.paperclips.zip (downloads/com.kbarni.paperclips.zip) - Unzip the file - Drag the paperclips.sh and paperclips folder into your Kindle documents folder - Eject your Kindle - Click on the paperclips book in your Kindle library to launch Context Universal Paperclips (https://en.wikipedia.org/wiki/Universal_Paperclips) is an incremental game created by Frank Lantz of New York University in 2017. The user plays the role of an AI programmed to produce paperclips. The game is based on a famous thought experiment described by Swedish philosopher Nick Bostrom in 2003. It illustrates the existential risk that an artificial general intelligence may pose to human beings were it to be successfully designed to pursue even seemingly harmless goals and the necessity of incorporating machine ethics into artificial intelligence design. Credit - Frank Lantz – Original game - Barna – Kindle port - user3121 – Made it work with Illusion Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ======================================== --- FILE: usbnetlite.html --- --------------------------- ← Back to Home (index.html) # usbnetlite (HF Only) — SSH over USB & Wi-Fi SSH into your Kindle via Wi-Fi or a USB cable using the streamlined usbnetlite package for hardfloat devices. # Download usbnetlite releases on GitHub (https://github.com/notmarek/kindle-usbnetlite) # Credits notmarek (https://github.com/notmarek) # Install via MR Package - Download the correct update_*.bin file for your firmware version from the usbnetlite project’s Releases page. - Do not extract or unzip anything — you need the raw .bin file. - Copy the .bin file into the mrpackages folder on your Kindle’s USB storage (create mrpackages if it doesn’t exist). - On your Kindle, open KUAL → go to Helper → Install MR Packages . This will install the .bin you placed in mrpackages . - Optional: type ;log mrpi in the Kindle search bar to check MR installer logs if troubleshooting is needed. - Once installed, usbnetlite will appear in the KUAL menu and can be launched from there. # Connection Info (default config) Edit the config file if needed (can be done in KOReader). Default login credentials are: username: root password: kindle Once usbnetlite is running, you can enable/disable USB networking directly from KUAL. # Quick Launch - Install the MR package as described above. - Open KUAL → find usbnetlite in the menu → launch. - Use the KUAL interface to toggle USB networking. # Notes - This page contains only the minimal, corrected steps — always follow the project’s Releases for firmware-specific builds. Educational purposes only. Not affiliated with Amazon. Users responsible for compliance with applicable laws. View Source on GitHub (https://github.com/NemesisHubris/kindlemodshelf.me) ========================================