📱 Mobile Storage Analyser

An interactive, fast, and visual Android storage analysis tool. It extracts storage details (both Internal Storage and external SD cards) from your connected Android device via ADB and generates a premium, interactive Treemap HTML visualization of space consumption.

• ⚡ Fast Startup: Powered by uv for ultra-fast virtual environment creation and package installation.
• 📊 Interactive Treemap: Generates an HTML report (storage_visualisation.html) using Plotly with dynamic hover details (exact size in MB/GB, share of parent folder, and share of total storage).
• 📂 Full Storage Deep Scan: Parses the entire /storage directory, mapping:
  • Internal Storage (/storage/emulated/0 displayed as Internal_Storage)
  • Physical/External SD Card storage (/storage/XXXX-XXXX displayed with its breakdown)
• 🔍 Auto-clean Logic: Safely ignores non-leaf nodes (parent directory totals) to prevent visualization layout crashes.
• 🛡️ Error Resilience: Handles permission denied directories gracefully and ensures the scan completes.

Before running the tool, ensure you have the following installed and configured:

1. Python 3.8+: Ensure Python is added to your system PATH.
2. Android SDK Platform Tools (ADB):
   • Ensure adb is installed and globally accessible in your system PATH.
   • Enable USB Debugging on your Android device (Settings -> Developer Options -> USB Debugging).
   • Connect the device via USB and authorize the computer when prompted.
3. uv (Optional but Recommended): If installed, the script will utilize it for blazing-fast package management. If not, it falls back to standard pip automatically.

1. Clone or download this repository to your computer.
2. Double-click or run the startup batch script:

   start.bat

3. The script will:
   • Create and activate a Python virtual environment (.venv).
   • Auto-install/update required libraries (pandas, plotly) using uv (or pip).
   • Run an ADB command to scan files on the device.
   • Run the Python parser and generator.
   • Automatically open the final interactive storage_visualisation.html report in your default web browser.

1. ADB File Scan: Runs a fast list query using du -ak /storage to find sizes of all files/directories on the device.
2. Data Cleansing: A python script processes paths, converts KB to MB/GB, filters out intermediate parent directory totals to avoid visualization schema errors, and separates Internal Storage and SD Card routes.
3. Plotly Visualization: Renders a gorgeous Treemap visualization showing storage consumers recursively, colored by size intensity.