Boot Image Extractor is a standalone Python script designed to extract the boot image from Android devices with root access. It supports both A/B and legacy partition styles. This script was developed as part of an automated method for extracting boot images described in the Boot Image Extraction Guide.

Requirements

• Python 3 or higher
• Root access on the Android device
• Python package: pyfiglet

Initial Setup

1. Install Termux: Download and install Termux on your device.

2. Grant Storage Permissions: Open Termux and allow storage permissions using the command:

   termux-setup-storage

3. Check for PHH Superuser (if applicable): If you are using a Phh-based GSI that ships with an inbuilt superuser, check if the PHH Superuser app is installed:

   (pm list packages | grep me.phh.superuser) && echo "App installed" || echo "Not found"

   Note: If "Not found" is displayed, install the app from F-Droid. This app is necessary to grant Termux requests to run as root. Skip this step if your device is already rooted with Magisk or another method.

4. Grant Superuser Permission: Grant superuser permission to Termux by typing:

   su

   Important: After granting superuser permissions, Return to the normal user environment by typing exit or pressing Ctrl+D. Then Proceed with the installation steps.

Installation Instructions

1. Clone or Download Source: Clone the repository and navigate to the project directory:

   git clone https://github.com/gitclone-url/Boot-image-Extractor.git
   cd Boot-image-Extractor

   Note: Install Git with pkg install git, if not already installed on the system.

   Alternatively, download the source zip file from GitHub, extract it, and navigate to the extracted directory.

2. Install Dependencies: Ensure Python and required packages are installed:

   pkg install python tsu -y
   pip install -r requirements.txt

3. Install the Script: Run the setup script to install Boot Image Extractor:

   pip install .

   This will install the Boot Image Extractor script on your terminal and make it accessible system-wide.

Usage Instructions

After installation, execute the script using the following command:

sudo boot_image_extractor.py

The extracted boot image will be saved in the same directory from which you run the script.

Contribution

Contributions to Boot Image Extractor are welcome. Please fork the repository, make your modifications, and submit a pull request. For detailed guidelines, see our Contributing Guidelines.

License

This script is distributed under the terms of the MIT License.

Support

For any issues or inquiries, please open an issue on the repository's issue tracker or contact the developer via Telegram.