[GUIDE] OTA Tools LPUnpack

[bynarie]

Please see this URL https://android.googlesource.com/platform/build.git/+/eec4a7cba4face3370acb6293ab357879920b467 and this for more information.

Hi everyone. I'm surprised I havent seen a thread about ota tools yet and lpunpack. This zip file contains a lot of useful tools for modifying super.img and making super.img as well as other tools found in other toolkits. This was just compiled using aosp master. The most useful function is the lpunpack tool which can extract a super.img into system, vendor, odm and product images.


Browse individual files
Download HERE

• Extract super.img from device

adb shell

su

dd if=/dev/block/by-name/super of=/sdcard/super.img

exit

exit

adb pull /sdcard/super.img

• Extract super.img with lpunpack

Usage on PC(linux):

./lpunpack - command-line tool for extracting partition images from super

Usage:
  ./lpunpack [options...] SUPER_IMAGE [OUTPUT_DIR]

Options:
  -p, --partition=NAME     Extract the named partition. This can
                           be specified multiple times.
  -S, --slot=NUM           Slot number (default is 0).

**Make sure <output_directory> already exists as this tool will not create a directory for you and will error if not found.**
**If you run this command with no slot specified, it will output 0 byte empty b images.

To extract all A images:

./lpunpack --slot=0 <path-to-super.img> <output_dir>

To extract all B images:

./lpunpack --slot=1 <path-to-super.img> <output_dir>

This program can take a couple minutes to run. After it is complete, your $output_dir will contain vendor, system, product and odm with either _a or _b.
Thanks for reading!

ALL CREDIT GOES TO HANETZER @ntzrmtthihu777 FOR ALL OF THIS INFORMATION
He taught me, I just wrote this!​

 

[manan001]

We are waiting for good dev support to build twrp, custom roms and kernel.

 

[Lossyx]

We are waiting for good dev support to build twrp, custom roms and kernel.

Most kernels already support 7T/Pro. (Except Smurf)
Not that much on the ROM side but some are there.

Sent from my OnePlus7TPro using XDA Labs

 

[bynarie]

We are waiting for good dev support to build twrp, custom roms and kernel.

I agree. I just felt like a lot of people don't know about lpmake/lpunpack and wanted to share it. Think its a pretty cool tool.

 

[ntzrmtthihu777]

Bit of a clarification. If you call lpunpack without any flags, it will extract
{odm,product,system,vendor}_a.img properly without issue, but will create 'empty'
0 byte images for {odm,product,system,vendor}_b.img. In order to get the b-sides,
you must call it again like so:

./lpunpack --slot=1 super.img

@bynarie

 

[holedinh]

hello @All
How to repack super.img file from Odm.img.Product.img, system.img, vender.img
Pls help me , Thanks !

 

[oslo83]

Any idea how I could build an arm version of lpunpack ?

 

[Kolibass]

build an arm version of lpunpack ?

For android?
You can take the build tree from my github (I cannot post external links due to the small number of posts).

 

[jherwig]

hello @All
How to repack super.img file from Odm.img.Product.img, system.img, vender.img
Pls help me , Thanks !

+1

 

[Hitman478™]

I did not understand: this tool can extract .img partition or only extract them from phone?

Example: I want to extract product.img partition to edit it and then reconvert to .img and then flash it to phone. Is this possible?

 

[elliwigy]

I did not understand: this tool can extract .img partition or only extract them from phone?

Example: I want to extract product.img partition to edit it and then reconvert to .img and then flash it to phone. Is this possible?

you need to convert it using simg2img then mount the img to edit it then when done use img2simg to convert back into android sparse img then can b flashed

 

[VladSector]

Invalid sparse file format at header magic, how to fix this?

./lpmake --metadata-size 65536 --super-name super --metadata-slots 2 --device super:4294967296 --group main:2647101440 --partition system:readonly:1962512384:main --image system=./system.img --partition vendor:readonly:680239104:main --image vendor=./vendor.img --partition odm:readonly:4349952:main --image odm=./odm.img --sparse --output ./super.img
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition system will resize from 0 bytes to 1962512384 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition vendor will resize from 0 bytes to 680239104 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition odm will resize from 0 bytes to 4349952 bytes
Invalid sparse file format at header magic
Invalid sparse file format at header magic

 

[Hitman478™]

Invalid sparse file format at header magic, how to fix this?

./lpmake --metadata-size 65536 --super-name super --metadata-slots 2 --device super:4294967296 --group main:2647101440 --partition system:readonly:1962512384:main --image system=./system.img --partition vendor:readonly:680239104:main --image vendor=./vendor.img --partition odm:readonly:4349952:main --image odm=./odm.img --sparse --output ./super.img
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition system will resize from 0 bytes to 1962512384 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition vendor will resize from 0 bytes to 680239104 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition odm will resize from 0 bytes to 4349952 bytes
Invalid sparse file format at header magic
Invalid sparse file format at header magic

It is not an error

 

[M.sapry]

Invalid sparse file format at header magic, how to fix this?

./lpmake --metadata-size 65536 --super-name super --metadata-slots 2 --device super:4294967296 --group main:2647101440 --partition system:readonly:1962512384:main --image system=./system.img --partition vendor:readonly:680239104:main --image vendor=./vendor.img --partition odm:readonly:4349952:main --image odm=./odm.img --sparse --output ./super.img
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition system will resize from 0 bytes to 1962512384 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition vendor will resize from 0 bytes to 680239104 bytes
lpmake I 08-24 00:29:52   598   598 builder.cpp:1012] [liblp]Partition odm will resize from 0 bytes to 4349952 bytes
Invalid sparse file format at header magic
Invalid sparse file format at header magic

can you upload lpmake ! i cant find it anywhere

 

[mohamedfaky]

download link is broken, can you reupload it again bro?

 

[bynarie]

download link is broken, can you reupload it again bro?

My bad, link is fixed in post. - https://drive.google.com/file/d/1h4sGXNI1Al5Y_Te9T8xMWrp3mHw1tke-/view?usp=sharing

 

[bynarie]

can you upload lpmake ! i cant find it anywhere

Here is a link to a shared folder containing all of the ota tools. LPMake is located under bin/lpmake
https://drive.google.com/drive/folders/1BmBmFuYZXbISAncrnrMybQ0uQk0-cZXl?usp=sharing

 

[osahitzelgsngar]

can't get it to work... it always says "bash: ./lpunpack: Permission denied"

can someone help?

trying to run it in mint4kitchen with all updates

 

[Akhil99]

Sir, can you please expand on super image repack?

 

[bynarie]

can't get it to work... it always says "bash: ./lpunpack: Permission denied"

can someone help?

trying to run it in mint4kitchen with all updates

Probably need to chmod it..

chmod +x lpunpack

OR

chmod 755 lpunpack