Android IMG Editor

A simple editor tool for Android system.img and vendor.img ROM files. 💿

📥 Installation

Android IMG Editor is a portable application—you don’t need a formal installer. Just grab the latest build from our Releases section:

• Windows: Download the .exe and double-click the downloaded file to launch.
• Linux: Install WINE, download the .exe, then run the following command via terminal: wine AndroidIMG.Editor.GUI (GUI version) or wine Android.IMG.Editor.console (console version).

Once downloaded, launch the executable from your terminal or file explorer. There are both console and GUI versions of Android IMG Editor, their functionality is identical so choose whichever option suits you best.

🛠️ Features

• Unpack system.img and vendor.img
• Repack edited directories back into valid Android images
• Support both sparse and raw ext4 formats
• Browse and modify image contents without needing an emulator

💡 Usage

🖱 GUI version

Launch the tool, then use the buttons to select the desired functions.

• The main buttons allow for unpacking and repacking system.img, vendor.img, or both simultaneously.
• The folder button next to the Unpack All button allows you to manually choose an input .img file and output directory using File Explorer popups. Note that when using this function, output directory paths must not contain spaces, otherwise the tool will simply unpack the .img to the path excluding anything after the space.
• The Cancel button interrupts the currently-ongoing operation (note that there will be a 7-second delay before you can start a new operation).
• The progress bar displays the progress of an ongoing operation, and the log box displays textual updates, warnings, and error messages.
• The folder button in the top right corner allows you to clear (delete) unpacked ROM files in the current working directory (note that this action is irreversible).
• The "i" button in the top left corner displays some basic information and links about the program.

⌨ Console version

Launch the tool, then follow the on-screen instructions to use it. Each command, such as unpacking or repacking, will have an associated number printed before it. Enter the number of the command you would like to use, followed by Enter.

📦 Supported Image Formats

• Android images (*.img)
• Android sparse images (*.img)
• Both system and vendor images

🧪 Origin & Use Case

Android IMG Editor was developed as a simple, fast tool for ROM modders and developers needing to tweak Android images. From injecting custom apps to modifying vendor blobs, it’s the perfect companion for low-level Android system tweaks without requiring a full Linux setup.

🤝 Support

If you run into issues or want to contribute, check out our Discord server or open a GitHub issue! Contributions, feature suggestions, and pull requests are always welcome.

👥 Contributors

⭐ If this tool was of any use to you, please consider giving it a Star - it would make my day! ⭐

Thanks to JordanEJ for building the initial project from which this was forked.