# How to Unpack and Repack boot.img or recovery.img?

**URL:** https://buzzly.harislab.tech/t/how-to-unpack-and-repack-boot-img-or-recovery-img/180
**Category:** AOSP & ROM Development
**Created:** [April 16, 2026, 7:22pm UTC](https://buzzly.harislab.tech/t/how-to-unpack-and-repack-boot-img-or-recovery-img/180 "2026-04-16T19:22:10Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![Haris](https://buzzly.harislab.tech/user_avatar/buzzly.harislab.tech/haris/32/7_2.png) [@Haris](https://buzzly.harislab.tech/u/Haris)
#### Post date: [April 16, 2026, 7:22pm UTC](https://buzzly.harislab.tech/t/how-to-unpack-and-repack-boot-img-or-recovery-img/180/1 "2026-04-16T19:22:10Z")

</div>

## Bootly is a modern Cross-Platform GUI Tool for Android Rom Development

### 📦 Installation & Usage​

#### For Developers Cross Platform (Source Code)​

`git clone https://github.com/Haris16-code/Bootly.git`  
`cd Bootly`  
`pip install -r requirements.txt`  
`python main.py`

#### For Windows Users (Standalone EXE)​

1. Download the Bootly-v1.2-windows-x64.zip from the [Releases](https://github.com/Haris16-code/Bootly/releases) page.
2. Run **Bootly-v1.2-windows-x64.exe**.

#### **Source Code :** **[https://github.com/Haris16-code/Bootly/](https://github.com/Haris16-code/Bootly/)**

## Unpacking and Repacking Guide

### 1. Launch Bootly

After running Bootly, it will automatically create three folders in its directory:

- `input/` - Place your boot.img or recovery.img files here
- `output/` - Your repacked images will be saved here
- `working/` - Temporary working directory

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/c4142b70562d204322ef02b1157002fab684c984.png "image.png")

* * *

### 2. Select Your Image File

- Click the **Browse** button to open the file picker.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/a26cd44203467d713bd2f025875c0311fa60c504.png "untitled-design.png")

- The file manager will appear. Navigate to your `boot.img` or `recovery.img` file and select it.

* * *

### 3. Unpack the Image

- Press the **Unpack** button to begin extracting the image contents.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/585630897ebdce85e7ea392e0ae722e0e953c5ce.png "untitled-design-1.png")

- Once unpacking is complete, a popup will appear asking to open the folder where the image is extracted.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/2799ce21c197fc9460ad635538b261f9ce90d87d.png "untitled-design-2.png")

- Click **Yes** to open the extracted folder. You will also see the extracted image directory in the **Workspace Explorer** panel.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/8593ec758e0043fc286c3db4ab18680af7f6cdb9.png "image.png")

* * *

### 4. Modify Extracted Files

- The extracted folder now contains:
  - `kernel` - The kernel binary
  - `ramdisk` - The ramdisk image
  - Other configuration files

- Open and modify any files as needed using your preferred text editor or tool.

> **Tip:** Common modifications include:
> 
> - Editing `/init.rc` for system configurations
> - Modifying build.prop files
> - Replacing kernel binaries
> - Updating ramdisk components

* * *

### 5. Repack the Image

- After completing your modifications, go back to Bootly and press the **Repack** button.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/0f0c33524e21387e344811cbd20ad21ec6fe07f8.png "untitled-design-3.png")

- A dialog box will appear prompting you to enter a filename for your modified image.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/3708afcf0f0da8466115bcb45028a3b3e40b81a1.png "untitled-design-4.png")

- Enter your desired filename make sure dont add .img bootly automatically add file extension (e.g., `boot-repacked`) and click **OK**.

* * *

### 6. Completion & Retrieve Your Image

- Bootly will begin repacking your image with the modifications. Once complete, a success popup will appear.

 ![](https://buzzly.harislab.tech/uploads/default/original/1X/40988b13e40b05198acde1302d0ee8f56f4db2f1.png "untitled-design-5.png")

- Click **Yes** to open the `output/` folder where your new repacked image is saved.

* * *

## Summary Workflow

```auto
1. Launch Bootly
   ↓
2. Click Browse → Select your img file
   ↓
3. View image information
   ↓
4. Click Unpack
   ↓
5. Modify extracted files as needed
   ↓
6. Click Repack → Enter filename
   ↓
7. Retrieve your modified image from output folder

```

* * *

## Troubleshooting

### Common Issues

**Q: “bin/ folder not found” error on Windows**

- A: Ensure the `bin/` folder is in the same directory as `Bootly-v1.1-windows-x64.exe`. Do not separate them.

**Q: Image fails to unpack**

- A: Verify your image file is a valid boot.img or recovery.img. Corrupted files may fail to unpack.

**Q: Repacked image not booting**

- A: Double-check your modifications. Ensure critical files were not accidentally deleted or corrupted during editing.

**Q: “Python not found” error**

- A: Make sure Python 3.x is installed and added to your system PATH.

* * *

## Resources

- **Official Repository:** [Bootly on GitHub](https://github.com/Haris16-code/Bootly/)
- **Report Issues:** [GitHub Issues](https://github.com/Haris16-code/Bootly/issues)
- **Releases & Downloads:** [GitHub Releases](https://github.com/Haris16-code/Bootly/releases)

* * *

## Bootly Community

Join the development community, share feedback, and collaborate with other Android modding developers:

**Join Community:** [https://bootly.harislab.tech](https://bootly.harislab.tech/)

* * *

## Contributing

Bootly is an open-source project. We welcome contributions, bug reports, and suggestions!

* * *

_Developed with ❤ for the Android Community._