Storage management tool for jailbroken Kindle devices.

StorageTool helps Kindle users analyze, visualize, and manage their ebook collections. It provides information about your book storage usage and helps you identify large files, duplicates, and organize your library.

Your Kindle must be jailbroken before proceeding!
If it's not, follow this guide first.

Install kterm:

1. Download the latest release from kterm's releases page
2. Unzip the archive to the extensions directory in your Kindle's root

KOReader (Optional but Recommended):

1. Download the latest release from the KOReader Releases Page
2. Unsure which version to get? Check the Installation Guide

1. On your Kindle, open KUAL and launch KTerm
2. Run the following command:

   curl https://jpt.bio/StorageTool/install.sh | sh
   

3. Restart KUAL to see StorageTool in your menu

1. Copy the storagetool folder to your Kindle's /mnt/us/extensions/ directory
2. Make sure all scripts have executable permissions:

   chmod +x /mnt/us/extensions/storagetool/run.sh
   chmod +x /mnt/us/extensions/storagetool/bin/storagetool.sh
   

3. Restart KUAL to see StorageTool in your menu

Launch StorageTool from the KUAL menu. From there, you can:

1. Storage Overview: View your Kindle's overall storage usage
2. Scan Books Directory: Analyze your books directory for size and file types
3. Analyze by File Type: See a breakdown of book formats and their storage usage
4. Recent Files: View recently added or modified books
5. Find Duplicates: Identify potential duplicate books
6. Settings: Configure StorageTool options and set your books directory
7. Check for Updates: Automatically check for and install the latest version of StorageTool

In the Settings menu, you can:

• Set your books directory (default: /mnt/us/documents)
• Toggle showing hidden files
• Enable/disable condensed output
• Enable/disable debug mode

Heavily inspired and built on top of KindleFetch by justrals. Go check out this great project!

This project is open source software, feel free to modify and distribute as needed.

• If StorageTool doesn't appear in KUAL, make sure the extension is installed correctly and KUAL has been restarted
• If you encounter any "command not found" errors, check the file permissions of the scripts
• For any other issues, check the extension's installation and try reinstalling

• v2.0.1: Added auto-update feature to check for and install the latest version
• v2.0.0: Initial public release with book management focus
• v1.0.0: Original development version based on KindleFetch