Introduction
Installing a GSI (Generic System Image) on devices like the F21 or Pixel, which feature a single super partition instead of separate system
, product
, and vendor
partitions, can be particularly challenging. The available documentation is often limited, making troubleshooting even more difficult.
Previously, tools like lpunpack or lpmake were required, but they could be complex, error-prone, and Linux-exclusive. Enter the Super Image Tool — a streamlined, efficient, and easier solution!
Features
The Super Image Tool, delivered as a Magisk module, automates tasks such as unpacking, editing, and repacking partitions, with advanced capabilities including:
- Backup and unpacking of the
super
partition. - Splitting and repacking the
super
image. - Partition resizing for GSI installation.
- System debloating (removing unnecessary system apps).
- Converting the system to read/write mode.
- Disabling encryption (decrypt).
Preparation
Download the Required Files:
- Super Image Tool Module: Download here
- Optional: MT Manager (for advanced manual edits).
Running the Tool:
- Install the module via Magisk.
- Open a terminal or use ADB to launch the tool:
adb shell su -c super
Main Menu Options
Once the tool is running, you’ll see the following options:
- Unpack Super – Unpack the
super
partition. - Edit Partitions & Repack Super – Modify partitions and prepare for repackaging.
- Disable Verity/VBMeta – Disable verification and encryption checks.
- Clean Folder Projects – Remove temporary module files.
- Quit – Exit the tool.
Unpacking the Super Partition
- Choose Option 1 (Unpack Super) to extract the super partition.
- Extracted files will be saved in:
/data/local/Super_Image/UNPACKED/
Editing Partitions
After unpacking, return to the main menu and choose Option 2 (Edit Partitions & Repack Super). Here, you can perform advanced modifications:
Key Options:
-
Automatic Debloat
- Removes unnecessary system apps.
- Customize
/data/local/Super_Image/SUPER_BIN/debloat.txt
to specify package names for removal.
-
Manual Debloat (Console)
- Interactive terminal-based file browsing and removal.
-
Manual Debloat (MT Manager)
- Use MT Manager to edit files with the generated
mount.sh
andumount.sh
scripts.
- Use MT Manager to edit files with the generated
-
Fix Overlay RW
- Removes read/write restrictions for Xiaomi devices.
-
DFE Decrypt
- Disables encryption on the device.
-
Adjust & Compile Super Image
- Resize partitions and allocate free space. The tool calculates the available space automatically.
Repacking the Super Partition
After making your changes, select Option 6 (Adjust & Compile Super Image):
- If an error occurs regarding missing partitions (e.g.,
system_b
orvendor_b
), create empty files (e.g.,.txt
) and rename them accordingly. - Choose No for sparse format unless necessary.
- For additional space allocation, select
system_a
.
The new image will be saved in:
/data/local/Super_Image/FILES/SUPER/repacked_super_rw.img
Notes and Troubleshooting:
- Negative Free Space: If you encounter negative space (e.g.,
-300MB
), perform debloating and retry. - VBMeta/Verity Issues: Use Option 3 to disable and fix these files.
Best of luck with your modifications! Let us know if you encounter any issues or need further assistance.