[TOOL] Android Image Kitchen - Unpack/Repack Kernel Ramdisk [Win/Android/Linux/Mac]

Search This thread

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Android Image Kitchen -- Unpack/Repack Kernel+Recovery Images, and Edit the ramdisk.

Windows ports of the necessary Linux utils for Android image (kernel/recovery) mod work:

mkbootimg, unpackbootimg: https://github.com/osm0sis/mkbootimg
pxa-mkbootimg, pxa-unpackbootimg: https://github.com/osm0sis/pxa-mkbootimg
elftool: https://github.com/osm0sis/elftool
unpackelf: https://github.com/osm0sis/unpackelf
mboot: https://github.com/osm0sis/mboot
dumpimage, mkimage: https://www.denx.de/wiki/U-Boot/WebHome
mkmtkhdr: https://github.com/osm0sis/mkmtkhdr
loki_tool: https://github.com/djrbliss/loki
futility: https://github.com/osm0sis/futility
boot_signer.jar (requires JRE 8+): https://xdaforums.com/android/software-hacking/signing-boot-images-android-verified-t3600606
blobpack, blobunpack: https://github.com/AndroidRoot/BlobTools
dhtbsign: https://github.com/osm0sis/dhtbsign
rkcrc: https://github.com/linux-rockchip/rkflashtool
sony_dump: https://xdaforums.com/crossdevice-dev/sony/tool-unpack-format-sony-kernel-image-t3530077
bzip2, cat, chmod, cpio, cut, dd, file, find, gzip, hexdump, lzop, printf, tail, truncate, xz;
cygbz2-1, cygcrypto-1.1, cyggcc_s-1, cygiconv-2, cygintl-8, cyglzma-5, cyglzo2-2, cygmagic-1, cygncursesw-10.dll, cygstdc++-6.dll, cygssl-1.1, cygwin1, cygz: https://cygwin.com/
lz4: https://lz4.github.io/lz4/
sudo: https://github.com/mattn/sudo
magic: https://www.darwinsys.com/file/

See the Mobile Edition (AIK-mobile) initial release notes for the specifics on the native Android version.
Likewise for the Linux/macOS Edition (AIK-Linux) initial release notes.

My original intent was to have this package dependency-free, but as you can see, I did have to include Cygwin. Initially just for mkbootimg since the huaixzk standalone version wouldn't work (it wasn't loading the kernel as binary, thanks trevd); then I discovered that using the GNUWin32 cpio to unpack somehow didn't play nice with repacking the ramdisk in a usable state, so at that point I decided I might as well go Cygwin across the board. As it is, I've included the latest Cygwin-dependent executables and required libraries from their repos and built my own custom Cygwin image and ramdisk utilities built from the latest sources.

Originally only for Google Pixel/Nexus/AOSP standard boot.img files, built-in support has now expanded to Google Pixel/AOSP vendor_boot.img files, Android Verified Boot (AVBv1)/ChromeOS/SignBlob signed boot.img files, Barnes & Noble Nook "Green Loader" signed boot.img files, Samsung/Spreadtrum DHTB header signed boot.img files, the Samsung/Marvell PXA1088/1908 board boot.img variant (AOSP-PXA), Loki patched boot.img files, amonet patched boot.img files, Sony SIN signed/packaged kernel.elf extraction, Sony ELF kernel.elf files, Intel OSIP Android image files, DENX U-Boot uImage files, Rockchip KRNL signed ramdisk image files, MTK headers for kernel/ramdisk, and LG Bump/Samsung SEAndroid footers for boot.img.

The main advantage here is you don't need Cygwin shell or PERL scripts. Other guides exist but none of them are universal for target device, compression and/or developed for Windows, Android ARM/x86/MIPS + ARM64/x86_64/MIPS64, and now macOS. With this universality in mind I've automated the whole process with batch/shell scripts.

My development work on my many projects comes out of my free time, so if you enjoy this project or anything else I've done on xda, please consider sponsoring my ongoing work using my GitHub Sponsors profile. For a one-time donation you can hit the donate link from my profile. Thank you for your support!


Instructions

1)
Unzip.
2) Either use the command-line "unpackimg <image-filename.img>", or simply drag-and-drop the image. This will split the image and unpack the ramdisk to a subdirectory.
3) Alter the ramdisk as you like.
4) The repackimg script requires no input and simply recombines the previously split kernel with the newly packed modified ramdisk using all the original image information (which was also split and saved).
5) The cleanup script resets the folder to its initial state, removing the split_img+ramdisk directories and any new packed ramdisk or image files.

There are a few optional, advanced command-line arguments for repackimg: "--original", which will cause it to repack using the original split ramdisk instead of repacking, this is useful for testing or trimming dumps; "--origsize", which will cause it to repack then pad it to the size of the original image, this is useful for repacking dumps to then be fastboot flashed; "--level" with 1-9 and possibly 0 allows changing the compression level used to repack to more closely match the original; "--avbkey" with (optionally path and) a keyname allows changing from the default AOSP verity key; "--forceelf" to attempt to make an older unpacked Sony ELF file repack as an ELF.

All scripts also allow unpacking/repacking with the current directory instead of the AIK directory if "--local" is the first command-line argument.

Supported ramdisk compression formats in the *-ramdiskcomp file are gzip, lzop, lzma, xz, bzip2, lz4, lz4-l (for lz4 legacy), cpio (for uncompressed), and empty (for no ramdisk).

Usage is similar for the Android and Linux versions, again, just review the release notes for them.

Hopefully this is some help to someone. It's been extremely useful for me in my messing around with kernel ramdisks, which is why I created it in the first place.

Enjoy!
Questions, comments and feedback welcome.



If you are reporting a problem with your device, please clearly state your device name and model/variant, attach a log, as well as provide a link to the image file.


Downloads

Android.Image.Kitchen.v3.8-Win32.zip

UPDATE-AIK.Mobile.Installer.v3.8-ALL-signed.zip

AIK-Linux-v3.8-ALL.tar.gz


Source Code

https://github.com/osm0sis/Android-Image-Kitchen


Credits & Thanks: All authors of the included binaries and libraries for their amazing work, as linked (or linked via GitHub) above. Peteragent5, alansj & iridaki for the general methods used in their PERL scripts and Linux guides. SuperR. & tobias.waldvogel for the general methods used in their kernel.elf unpacking scripts. _that and rayman for the general methods used to repack a working boot.blob. Chainfire for the ChromeOS and SEAndroid general methods. cybojenix for the Bump general method. xyz` & k4y0z for the amonet general method.

Thanks to Goatshocker for testing out things for the HTC image issues, leading to the workaround and subsequent fix, avinashrocks1990 & tajimura for testing out compression support and the large pagesize fix, civato for testing out dtb support, talich for testing out the Linux version, shoey63 for testing out Linux + ELF support, moonbutt74 for testing out Android-x86 support, nathanchance for testing out the new AIK-mobile cpio method on his Pixel 2, leading to important fixes for its support, shakalaca for the great help with completing and testing Intel OSIP support, and Postman1year & CXZa for their help testing to find out the workaround for the Cygwin cut + symlink regression issues. Huge thank you to trevd and Modding.MyMind/SHM for all the contributing work they've each done and support they've provided.

Disclaimer: Naturally, you take all the responsibility for what happens to your device when you start messing around with things.

Download counts:

AIK - v1.0: 1540; +HTCFix: 430. v1.5: 4718. v1.6: 3556. v1.8: 8678; +Lok2Img: 1629. v1.9: 2580. v2.0: 22886. v2.2: 20522. v2.3: 14524. v2.4: 84432; +LokiAddon: 20071. v2.5: 5004. v2.6: 9354. v2.7: 5442. v2.8: 6639. v2.9: 7672. v3.0: 2810. v3.1: 6502. v3.2: 27104. v3.3: 17736. v3.4: 25988. v3.5: 19051. v3.6: 32472. v3.7: 21457.
Mobile - v1.0: 311. v1.1: 265. v1.2: 302. v1.3: 100. v1.4: 486. v1.5: 224. v1.6: 3303. v1.7: 7798. v1.8: 16286. v1.9: 3800. v2.0: 5444. v2.1: 2526. v2.2: 926. v2.3: 1346. v2.4: 18426. v2.5: 2586. v2.6: 6068. v2.7: 2936. v2.8: 3932. v2.9: 4181. v3.0: 1301. v3.1: 3300. v3.2: 3254. v3.3: 6824. v3.4: 10786. v3.5: 8624. v3.6: 14020. v3.7: 8951.
Linux - v1.0: 75. v1.1: 208. v1.2: 233. v1.3: 112. v1.4: 421. v1.5: 173. v1.6: 1838. v1.7: 2596. v1.8: 4818. v1.9: 604; +v1.9.1: 1068. v2.0: 1836. v2.1: 1240. v2.2: 466. v2.3: 522. v2.4: 8126. v2.5: 1052. v2.6: 2018. v2.7: 1248. v2.8: 2486. v2.9: 5057. v3.0: 1455. v3.1: 2957. v3.2: 14508. v3.3: 10046. v3.4: 16294. v3.5: 12651. v3.6: 16478. v3.7: 12927.
 

Attachments

  • Android.Image.Kitchen.v3.8-Win32.zip
    7.5 MB · Views: 73,822
  • UPDATE-AIK.Mobile.Installer.v3.8-ALL-signed.zip
    14.1 MB · Views: 34,080
  • AIK-Linux-v3.8-ALL.tar.gz
    13.1 MB · Views: 29,717
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
AIK should be universal for Android devices that accept AOSP, ELF, OSIP, U-Boot and KRNL format images in theory, but there is always a chance it doesn't work for your device due to image packing differences, etc. Here is a running list of confirmed working and questionably/confirmed not working devices. If your device isn't in either list odds are that it will still work fine.

Known Working Devices

Amazon Fire HD 10
Asus Nexus 7 (2012, 2013)
Asus Transformer Pad
Asus Zenfone (2, 5)
Auchan QiLive (Q5, Q7)
Barnes & Noble Nook ( , HD+, 7)
BQ Aquaris M8
Coolpad Catalyst
Essential PH-1
Google Pixel (C, , XL, 2, 2 XL, 3, 3 XL, 3a, 3a XL, 4, 4 XL, 4a, 4a 5G, 5, 5a)
Huawei Ascend Y300
Huawei Mate 8
Huawei Nexus 6P
Huawei U8800 Ideos X5
HTC Nexus 9
HTC One (M7, M8, S, X)
HTC Vivid/Raider 4G
HP Slate 21
LeEco Le Pro3
Lenovo A706
Lenovo K900
Lenovo Vibe K5
LG G(2, 2 Mini, 3, 3 Stylus, 5)
LG GPad (7.0, 8.3, X 8.0)
LG Nexus (4, 5, 5X)
LG Optimus (3D, 4X HD)
LG Stylo 3 Plus
LG V(10, 20)
Micromax Ninja/Bolt A27
Motorola Moto G (2013, 2014)
Motorola Moto X 2014
Motorola Nexus 6
Nextbit Robin
OnePlus (One, 2, X, 3, 3T, 5, 5T, 6, 6T, 7, 7 Pro, 7T, 7T Pro, 8, 8 Pro, 8T, 9R, 9, 9 Pro)
OnePlus Nord ( , N10 5G, N100)
Pantech Vega Iron
Pantech Vega Secret Note
Samsung Galaxy A3 2016
Samsung Galaxy Ace II X
Samsung Galaxy Core Mini 4G
Samsung Galaxy Mega
Samsung Galaxy Nexus
Samsung Galaxy Note (2, 3, 4, Pro 12.2)
Samsung Galaxy S(3, 3 Mini, 4, 5, 6, 7, 8, 8+)
Samsung Galaxy Star
Samsung Galaxy Tab (2 7.0, 3 10.1, 4 7.0, 4 8.0, 4 10.1, A 7.0, A 10.1, Pro 8.4)
Samsung Galaxy Victory
Samsung Galaxy Xcover 3
Samsung Nexus 10
Sony Xperia (Arc S, M, Neo, Neo V, SP, Tab Z4, Z, Z1, Z5)
Spice Mi-355 Stellar Craze
Vodafone Smart Ultra 6
Xiaomi Mi Pad
Xiaomi Poco X2
Xiaomi Redmi (6A, Note 3 Pro)


Confirmed Not Working Devices
  • Blackview BV4000 - some newer MediaTek (MTK) devices use special image signing that adds a "BFBF" pre-header signature. While present on multiple MTK devices, it only appears to be enforced by the bootloader on some. See this post.
  • HTC Desire 326G, Huawei Honor Bee, Huawei MediaPad T1 7.0 - some newer Spreadtrum devices use special image signing that adds a "SPRD-SECUREFLAG" pre-header signature, so images will unpack/repack but most likely won't boot unless run through their internal signing tool. See this post.
  • Nibiru V05-A, Pipo Max - some RockChip (RK) devices use a variant of the AOSP image format with extra checksums and hidden sections with extra data. There is not currently an open source tool that can handle repacking these. See this post.
  • Samsung Galaxy S (Advance, Captivate, Vibrant), Samsung Galaxy S2, Samsung Galaxy Note & Samsung Galaxy Tab - contain zImage (kernel) + ramdisk (possibly within the zImage) but are the "headerless" Linux kernel blob format and require a full cross-compiler to repack correctly. See this post.
  • Samsung [various] - the image and SEANDROIDENFORCE footer are followed by a signature that, while present on many Samsung devices, only appears to be enforced by the bootloader on some. See this post.
  • Skyworth 50G2A TV - some newer MediaTek (MTK) devices use special image part signing that adds a 256-byte checksum/signature to both Image.gz-dtb/zImage-dtb (kernel) and ramdisk.cpio.gz, so images will unpack/repack but most likely won't boot unless run through their internal signing tool. See this post.
  • Xiaomi Mi Box 3S, ZTE B860H STB - some newer Amlogic devices use special image signing that adds an "AMLSECU!" signature within the header and appears to encrypt the ramdisk, so the image itself will unpack/repack but cannot be re-signed, and the ramdisk cannot be unpacked or modified.

Note: For devices requiring Loki patched images (e.g. LG G2, AT&T Samsung Galaxy S4), your device's aboot.img dump must be in the script directory to Re-Loki. (Thank you to jeboo for the original one-way Lok2Img Workaround's binary source, used prior to the official Loki Tool gaining un-Loki support).


Release Notes

Windows:
v1.0 - Dec 30, 2012 - Initial release.    
v1.5 - May 6, 2013 - Linked.
v1.6 - Sep 16, 2013 - Linked.
v1.8 - Dec 9, 2013 - Linked.
v1.9 - Jun 7, 2014 - Linked.
v2.0 - Aug 3, 2014 - Linked.
v2.2 - Mar 25, 2015 - Linked.
v2.3 - Oct 11, 2015 - Linked.
v2.4 - Feb 8, 2016 - Linked.
v2.5 - Jan 26, 2017 - Linked.
v2.6 - Feb 27, 2017 - Linked.
v2.7 - May 1, 2017 - Linked.
v2.8 - Jun 5, 2017 - Linked.
v2.9 - Sep 14, 2017 - Linked.
v3.0 - Dec 14, 2017 - Linked.
v3.1 - Jan 7, 2018 - Linked.
v3.2 - Mar 19, 2018 - Linked.
v3.3 - Jul 23, 2018 - Linked.
v3.4 - Oct 28, 2018 - Linked.
v3.5 - Apr 17, 2019 - Linked.
v3.6 - Sep 22, 2019 - Linked.
v3.7 - May 22, 2020 - Linked.
v3.8 - May 5, 2021 - Linked.

Android:
v1.0 - Mar 23, 2014 - Linked. (ARM only)
v1.1 - Apr 19, 2014 - Linked. (ARM only)
v1.2 - May 15, 2014 - Linked. (ARM only)
v1.3 - Jun 7, 2014 - Linked. (ARM, x86 with emulation)
v1.4 - Jun 17, 2014 - Linked. (ARM, x86 with emulation)
v1.5 - Aug 3, 2014 - Linked. (32bit only)
v1.6 - Aug 19, 2014 - Linked. (32bit only)
v1.7 - Dec 26, 2014 - Linked. (32bit only)
v1.8 - Mar 25, 2015 - Linked. (32bit only)    
v1.9 - Oct 11, 2015 - Linked. (32bit only)
v2.0 - Dec 7, 2015 - Linked.
v2.1 - Feb 8, 2016 - Linked.
v2.2 - Mar 16, 2016 - Linked.
v2.3 - Apr 1, 2016 - Linked.
v2.4 - Apr 20, 2016 - Linked.
v2.5 - Jan 26, 2017 - Linked.
v2.6 - Feb 27, 2017 - Linked.
v2.7 - May 1, 2017 - Linked.
v2.8 - Jun 5, 2017 - Linked.
v2.9 - Sep 14, 2017 - Linked.
v3.0 - Dec 14, 2017 - Linked.
v3.1 - Jan 7, 2018 - Linked.
v3.2 - Mar 19, 2018 - Linked.
v3.3 - Jul 23, 2018 - Linked.
v3.4 - Oct 28, 2018 - Linked.
v3.5 - Apr 17, 2019 - Linked.
v3.6 - Sep 22, 2019 - Linked.
v3.7 - May 22, 2020 - Linked.
v3.8 - May 5, 2021 - Linked.

Linux/macOS:
v1.0 - Apr 11, 2014 - Linked. (x86, Linux only)
v1.1 - Apr 19, 2014 - Linked. (x86, Linux only)
v1.2 - May 15, 2014 - Linked. (x86, Linux only)
v1.3 - Jun 7, 2014 - Linked. (x86, Linux only)
v1.4 - Jun 17, 2014 - Linked. (x86, Linux only)
v1.5 - Aug 3, 2014 - Linked. (x86, Linux only)
v1.6 - Aug 19, 2014 - Linked. (x86, Linux only)
v1.7 - Dec 26, 2014 - Linked. (Linux only)
v1.8 - Mar 25, 2015 - Linked. (Linux only)
v1.9 - Oct 11, 2015 - Linked. (Linux only)
v2.0 - Dec 7, 2015 - Linked. (Linux only)
v2.1 - Feb 8, 2016 - Linked. (Linux only)
v2.2 - Mar 16, 2016 - Linked. (Linux only)
v2.3 - Apr 1, 2016 - Linked. (Linux only)
v2.4 - Apr 20, 2016 - Linked. (Linux only)
v2.5 - Jan 26, 2017 - Linked. (Linux only)
v2.6 - Feb 27, 2017 - Linked. (Linux only)
v2.7 - May 1, 2017 - Linked. (Linux only)
v2.8 - Jun 5, 2017 - Linked. (Linux only)
v2.9 - Sep 14, 2017 - Linked. (Linux only)
v3.0 - Dec 14, 2017 - Linked.
v3.1 - Jan 7, 2018 - Linked.
v3.2 - Mar 19, 2018 - Linked.
v3.3 - Jul 23, 2018 - Linked.
v3.4 - Oct 28, 2018 - Linked.
v3.5 - Apr 17, 2019 - Linked.
v3.6 - Sep 22, 2019 - Linked.
v3.7 - May 22, 2020 - Linked.
v3.8 - May 5, 2021 - Linked.




Everyone please let me know if AIK works for your devices or if you encounter any problems, so I can make these lists more comprehensive. 👍

If you are reporting a problem with your device, please clearly state your device name and model/variant, attach a log, as well as provide a link to the image file.
 
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
WIP Soon-to-be FAQ 😉

If you are reporting a problem with your device, please clearly state your device name and model/variant, attach a log, as well as provide a link to the image file.

Frequently Asked Questions (FAQ)

  1. Q: Why don't my .img.lz4 and .img.tar files unpack, I tried renaming them to .img and everything?!
    A:
    File extensions exist for a reason, they denote the format of a file. AIK supports .img files, but renaming things isn't the same as changing the file format, e.g. for .img.lz4 you actually need to unlz4 to get .img, and for .img.tar you actually need to untar to get .img.

  2. Q: Why is the repacked .img smaller than the original, how will this even work?!
    A:
    It's smaller because most of a partition dump is empty space, so AIK's repack is only the actual data inside. If you tried it you'd see it probably works fine (provided you haven't changed anything). Modern devices also AVBv2 sign images, which uses a bit of space at the end of the partition as well, but this must be done separately with the avbtool Python script from AOSP, and not all devices enforce this signing. You can also try the --origsize option if you want to ensure writing the new image blanks out the old (a fastboot bug on some old bootloaders).

  3. Q: How come nothing works, there's nothing in bin / android_win_tools?!
    A:
    That's because no binaries are hosted on GitHub so you can't just clone/download it and expect it to work. Only use the complete AIK package download links/attachments from the OP of this thread.

  4. Q: This triggered some generic antivirus alert, what the f*ck, are you hax me?!
    A:
    No. Antivirus heuristics recognize patterns in executables and try to guess what might be a threat because it's "similar" code. Some compression formats (especially the older UPX-compressed Go built sudo.exe AIK uses for Windows Administrator privilege requests) trigger these. Everything here's open source, I've been doing this for over 10 years and I'm an XDA Senior Recognized Developer, so you can either trust my track record, or build them yourself if you're that worried.

  5. Q: Why is default.prop 0 bytes, why can't I edit it or prop.default and/or why my changes don't stick?!
    A:
    Since project Treble brought system-as-root (SAR) - which is years now - default.prop is now a symlink to prop.default, and you can't open prop.default because the root / filesystem is in the system partition. In boot-as-recovery devices (no recovery partition) there is still a ramdisk containing another prop.default in the boot partition, but it's only used when booting to recovery so any changes will have no effect on booted Android.

  6. Q: Why does it warn there's no ramdisk, it can't unpack it or something?!
    A:
    It tells you there's no ramdisk because there's no ramdisk. Your device uses system-as-root (SAR), but doesn't have recovery in boot, so there's no boot.img ramdisk at all (0 bytes). See also the above answer for boot-as-recovery devices (no recovery partition).

 
Last edited:

dancer_69

Senior Member
Jan 2, 2007
2,011
617
I just tried it with a recovery.img. I don't get any errors on unpacking/repacking process, but how to get the repacked recovery.img? When I run the repackimg.bat, I don't get any error, but it doesn't generate a new recovery.img.
 

dancer_69

Senior Member
Jan 2, 2007
2,011
617
Thanks, seems that works fine now.

EDIT:

Generates new-image.img, but this recovery is unbootable. I tested it with the same recovery.img, without to change anything, just unpack/repack. The generated image is unbootable. Device just stuck on boot logo.
 
Last edited by a moderator:

trevd

Inactive Recognized Developer
Jul 19, 2011
895
1,271
Hull
Samsung Galaxy Tab 4
Android Image Kitchen -- Unpack/Repack Kernel+Recovery Images, and Edit the ramdisk.

My initial intention with this was to gather Windows ports of the necessary Linux utils for Android image (kernel/recovery) mod work with as few dependencies (like Cygwin, etc.) as possible. Here's what I ended up with:

unpackbootimg - http://github.com/huaixzk/android_win_tool/
mkbootfs, mkbootimg - http://xdaforums.com/showthread.php?t=443994
cpio, gzip, libiconv2, libintl3 - http://gnuwin32.sourceforge.net/
cygwin1 - http://cygwin.com/

As you can see, in the end I did have to include Cygwin for mkbootimg since the huaixzk standalone version doesn't appear to work for some reason. I've left a note with the author and will update the package to remove Cygwin if he ever fixes the issue. As it is, I've included the cygwin1.dll as it's the only one required, and grabbed the working Cygwin-dependent executable from another thread.

Hi Buddy,

I like what you're doing here, cygwin dependencies are no good........ native on whatever platform you're using is the way to go.... with that in mind here's a mkbootimg compiled from the aosp source tree.using the MIN_GW toolchain, not a cygwin in sight :D

not tested it but should be alright for you.......I think I'll finish the job and smash it althought into one tool, saving f***king about., it'll will come in useful on linux too :D
 

Attachments

  • mkbootimg_windows_new.7z
    10.8 KB · Views: 6,826
  • split_bootimg.7z
    8 KB · Views: 5,897
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Thanks, seems that works fine now.

EDIT:

Generates new-image.img, but this recovery is unbootable. I tested it with the same recovery.img, without to change anything, just unpack/repack. The generated image is unbootable. Device just stuck on boot logo.

Crap. I'll take it down for now and do some testing. Might be a few days. Things were working over here with the few images I'd tried before. Maybe I messed something up once the scripts got more robust. Batch is an ugly way to do things. :(

Thanks for the help testing.

Hi Buddy,

I like what you're doing here, cygwin dependencies are no good........ native on whatever platform you're using is the way to go.... with that in mind here's a mkbootimg compiled from the aosp source tree.using the MIN_GW toolchain, not a cygwin in sight :D

not tested it but should be alright for you.......I think I'll finish the job and smash it althought into one tool, saving f***king about., it'll will come in useful on linux too :D

Thanks bro! I'll throw that in with the new (hopefully working) version. :good: :)

And hey go ahead and finish the job if you like. Coding is better than scripting so I'd be happy to get a mod to remove this thread once something better comes along.
 
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Alright people, sorry about those initial issues. OP updated with the new, fully working, v1.0. There was just some craziness in the one before with cpio not behaving like it should.

It's all Cygwin for now but trevd has been great and offered to port some things over properly while weeding out the issues, so expect a new release, completely dependency free and automated as always in the coming months, all thanks to him. :)
 
Last edited:

Goatshocker

Senior Member
Oct 23, 2010
945
416
Hm, doesnt seem to work for me. I unpacked boot.img, repacked it (didnt change anything) and then flashed it with fastboot - resulted in a bootloop.
The boot.img before unpack/repack boots fine.
 
  • Like
Reactions: osm0sis

trevd

Inactive Recognized Developer
Jul 19, 2011
895
1,271
Hull
Samsung Galaxy Tab 4
Interesting. Worked for both dancer_69 and myself. Device info and image in PM please. :)

Hi Folks....

The boot loop maybe because ueventd /watchdogd in the sbin directory haven't been created, they are (normally) symlinked back to ../init, obviously windows doesn't support symlinks. a work around when using windows would be to copy-rename the /init to sbin/ueventd and sbin/watchdogd.

This is just "finger in the air" guessing but just something I've noticed :laugh:
 

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Hi Folks....

The boot loop maybe because ueventd /watchdogd in the sbin directory haven't been created, they are (normally) symlinked back to ../init, obviously windows doesn't support symlinks. a work around when using windows would be to copy-rename the /init to sbin/ueventd and sbin/watchdogd.

This is just "finger in the air" guessing but just something I've noticed :laugh:

No that doesn't seem to be the issue here, though I think that's what the issue was when I was using the gnuwin32 cpio. I was also worried about permissions being set correctly but I haven't seen any issues with that yet either. I just made sure of both by unpacking and repacking the maguro CWM recovery image then flashing it to my device, and both symlinks and permissions are restored correctly in the filesystem. What's going on with Goatshocker's One S is a bit more bizarre.

Oddly enough, even just recombining the original zImage and ramdisk from split_img doesn't work for him, meaning it's either unpackbootimg, or more likely mkbootimg at fault. All the commandline variables match for the original and built images (cmdline, pagesize, base), and I've tried the Cygwin executable and the native one you posted, so it's leading me to believe there is something different about how images must be packaged for the HTC One S. Another One S user that can confirm would be good though. :(

Edit: One S testing was done with Fusion v4 and CM stock from the latest Dark Jelly -
http://xdaforums.com/showthread.php?t=1837630
http://xdaforums.com/showthread.php?t=1848100
 
Last edited:
  • Like
Reactions: void main()

trevd

Inactive Recognized Developer
Jul 19, 2011
895
1,271
Hull
Samsung Galaxy Tab 4

I do know some htc boot images they have an additional 256 byte header which you have to strip off in linux you do that with dd, like so
Code:
dd if=htcsen.img of=htcstrip.img bs=256 skip=1
I've just done this with an HTC Sensation stock boot image and it unpacked alright after that..... not sure about repacking though :eek:

You can check if an additional header is present by opening the boot image in an hex editor, A standard boot image starts with the android magic, which is the byte sequence
Code:
41 4E 44 52 4F 49 44 21
This spells ANDROID! in ascii text. If it doesn't you can normally strip the additional header without any problems.

Looking at the various boot images in my htc sensation backups it seems my CM boot images don't have the special header..
HTC do have some specialness going on with the S-ON/OFF business etc but I'd just be speculating If I said anymore as my knowledge of the htc boot sequence is limited.
 

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Getting reports that HTC One X and One X+ are also not working, so it must be some kind of newer HTC thing. When I get a bit of free time I'll compare the custom kernels and recoveries for those devices and/or fire some PMs off to the kernel devs to see if there's anything special I should know and if there's a way I can fix it. :good:
 
Last edited:
  • Like
Reactions: void main()

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Was looking into this again today and found a nice build.sh on the One S Fusion Kernel github..

The mkbootimg command does have an extra parameter:

mkbootimg --kernel zImage --ramdisk ramdisk.cpio.gz --base 80400000 --ramdiskaddr 81800000 --cmdline console=ttyHSL0,115200,n8 -o boot.img

Not yet sure if that ramdiskaddr is the magic difference or not. That ramdiskaddr parameter doesn't even exist in any win32 compile I've seen of mkbootimg. I just downloaded a few images (the Dark Jelly ones we tested before) to hexedit and compare. I'll post again shortly on that.
 
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
Took a look with HxD and "ANDROID!" is present in all of them, so it's not the HTC header problem.

Since repacking the original ramdisk still wouldn't boot for the HTC One S in my tests with Goatshocker (which is crazy because it should all be exactly the same), I did just that with Fusion v3.2 and then ran a diff on the original and repack. Doing the same for a GN kernel produces zero differences, ie. the files are identical, but interestingly enough for the One S images there is a single difference, and it's in the header.

fv32-boot.xxd versus repack-boot.xxd:
Code:
0000000: 414e 4452 4f49 4421 0879 5100 0080 4080  ANDROID!.yQ...@.
0000010: b4a2 0200 0000 [color=blue]80[/color]81 0000 0000 0000 3081  ......[color=blue].[/color].......0.
0000020: 0001 4080 0008 0000 0000 0000 0000 0000  ..@.............
0000030: 0000 0000 0000 0000 0000 0000 0000 0000  ................
0000040: 636f 6e73 6f6c 653d 7474 7948 534c 302c  console=ttyHSL0,
0000050: 3131 3532 3030 2c6e 3800 0000 0000 0000  115200,n8.......
----
0000000: 414e 4452 4f49 4421 0879 5100 0080 4080  ANDROID!.yQ...@.
0000010: b4a2 0200 0000 [color=red]40[/color]81 0000 0000 0000 3081  ......[color=red]@[/color].......0.
0000020: 0001 4080 0008 0000 0000 0000 0000 0000  ..@.............
0000030: 0000 0000 0000 0000 0000 0000 0000 0000  ................
0000040: 636f 6e73 6f6c 653d 7474 7948 534c 302c  console=ttyHSL0,
0000050: 3131 3532 3030 2c6e 3800 0000 0000 0000  115200,n8.......

Same change with the TWRP recovery images for the One S (ville) and One X (evita). So somehow I believe that's our problem with certain HTC devices... No idea why such a thing would occur. I looked into S-ON a bit and it seems that's controlled from the radio, and would prevent the image from being written, so it shouldn't have to do with that either. Perhaps it has to do with that extra ramdiskaddr parameter somehow affecting the header. :confused:

I could write an extra batch file that flips that byte as a workaround, but I'd prefer to actually figure out why it happens and fix that..
 
Last edited:

osm0sis

Senior Recognized Developer / Contributor
Mar 14, 2012
16,697
40,165
Halifax
GT-i9250
Google Nexus 4
OP updated with the workaround zip, instructions in the 2nd post. Tested and working fully, many thanks to Goatshocker for the assistance. :good:

Any ideas or leads on why this single byte difference would occur are welcome, but in the meantime the workaround should make this "universal" again. :)
 
Last edited:

Top Liked Posts

  • There are no posts matching your filters.
  • 788
    Android Image Kitchen -- Unpack/Repack Kernel+Recovery Images, and Edit the ramdisk.

    Windows ports of the necessary Linux utils for Android image (kernel/recovery) mod work:

    mkbootimg, unpackbootimg: https://github.com/osm0sis/mkbootimg
    pxa-mkbootimg, pxa-unpackbootimg: https://github.com/osm0sis/pxa-mkbootimg
    elftool: https://github.com/osm0sis/elftool
    unpackelf: https://github.com/osm0sis/unpackelf
    mboot: https://github.com/osm0sis/mboot
    dumpimage, mkimage: https://www.denx.de/wiki/U-Boot/WebHome
    mkmtkhdr: https://github.com/osm0sis/mkmtkhdr
    loki_tool: https://github.com/djrbliss/loki
    futility: https://github.com/osm0sis/futility
    boot_signer.jar (requires JRE 8+): https://xdaforums.com/android/software-hacking/signing-boot-images-android-verified-t3600606
    blobpack, blobunpack: https://github.com/AndroidRoot/BlobTools
    dhtbsign: https://github.com/osm0sis/dhtbsign
    rkcrc: https://github.com/linux-rockchip/rkflashtool
    sony_dump: https://xdaforums.com/crossdevice-dev/sony/tool-unpack-format-sony-kernel-image-t3530077
    bzip2, cat, chmod, cpio, cut, dd, file, find, gzip, hexdump, lzop, printf, tail, truncate, xz;
    cygbz2-1, cygcrypto-1.1, cyggcc_s-1, cygiconv-2, cygintl-8, cyglzma-5, cyglzo2-2, cygmagic-1, cygncursesw-10.dll, cygstdc++-6.dll, cygssl-1.1, cygwin1, cygz: https://cygwin.com/
    lz4: https://lz4.github.io/lz4/
    sudo: https://github.com/mattn/sudo
    magic: https://www.darwinsys.com/file/

    See the Mobile Edition (AIK-mobile) initial release notes for the specifics on the native Android version.
    Likewise for the Linux/macOS Edition (AIK-Linux) initial release notes.

    My original intent was to have this package dependency-free, but as you can see, I did have to include Cygwin. Initially just for mkbootimg since the huaixzk standalone version wouldn't work (it wasn't loading the kernel as binary, thanks trevd); then I discovered that using the GNUWin32 cpio to unpack somehow didn't play nice with repacking the ramdisk in a usable state, so at that point I decided I might as well go Cygwin across the board. As it is, I've included the latest Cygwin-dependent executables and required libraries from their repos and built my own custom Cygwin image and ramdisk utilities built from the latest sources.

    Originally only for Google Pixel/Nexus/AOSP standard boot.img files, built-in support has now expanded to Google Pixel/AOSP vendor_boot.img files, Android Verified Boot (AVBv1)/ChromeOS/SignBlob signed boot.img files, Barnes & Noble Nook "Green Loader" signed boot.img files, Samsung/Spreadtrum DHTB header signed boot.img files, the Samsung/Marvell PXA1088/1908 board boot.img variant (AOSP-PXA), Loki patched boot.img files, amonet patched boot.img files, Sony SIN signed/packaged kernel.elf extraction, Sony ELF kernel.elf files, Intel OSIP Android image files, DENX U-Boot uImage files, Rockchip KRNL signed ramdisk image files, MTK headers for kernel/ramdisk, and LG Bump/Samsung SEAndroid footers for boot.img.

    The main advantage here is you don't need Cygwin shell or PERL scripts. Other guides exist but none of them are universal for target device, compression and/or developed for Windows, Android ARM/x86/MIPS + ARM64/x86_64/MIPS64, and now macOS. With this universality in mind I've automated the whole process with batch/shell scripts.

    My development work on my many projects comes out of my free time, so if you enjoy this project or anything else I've done on xda, please consider sponsoring my ongoing work using my GitHub Sponsors profile. For a one-time donation you can hit the donate link from my profile. Thank you for your support!


    Instructions

    1)
    Unzip.
    2) Either use the command-line "unpackimg <image-filename.img>", or simply drag-and-drop the image. This will split the image and unpack the ramdisk to a subdirectory.
    3) Alter the ramdisk as you like.
    4) The repackimg script requires no input and simply recombines the previously split kernel with the newly packed modified ramdisk using all the original image information (which was also split and saved).
    5) The cleanup script resets the folder to its initial state, removing the split_img+ramdisk directories and any new packed ramdisk or image files.

    There are a few optional, advanced command-line arguments for repackimg: "--original", which will cause it to repack using the original split ramdisk instead of repacking, this is useful for testing or trimming dumps; "--origsize", which will cause it to repack then pad it to the size of the original image, this is useful for repacking dumps to then be fastboot flashed; "--level" with 1-9 and possibly 0 allows changing the compression level used to repack to more closely match the original; "--avbkey" with (optionally path and) a keyname allows changing from the default AOSP verity key; "--forceelf" to attempt to make an older unpacked Sony ELF file repack as an ELF.

    All scripts also allow unpacking/repacking with the current directory instead of the AIK directory if "--local" is the first command-line argument.

    Supported ramdisk compression formats in the *-ramdiskcomp file are gzip, lzop, lzma, xz, bzip2, lz4, lz4-l (for lz4 legacy), cpio (for uncompressed), and empty (for no ramdisk).

    Usage is similar for the Android and Linux versions, again, just review the release notes for them.

    Hopefully this is some help to someone. It's been extremely useful for me in my messing around with kernel ramdisks, which is why I created it in the first place.

    Enjoy!
    Questions, comments and feedback welcome.



    If you are reporting a problem with your device, please clearly state your device name and model/variant, attach a log, as well as provide a link to the image file.


    Downloads

    Android.Image.Kitchen.v3.8-Win32.zip

    UPDATE-AIK.Mobile.Installer.v3.8-ALL-signed.zip

    AIK-Linux-v3.8-ALL.tar.gz


    Source Code

    https://github.com/osm0sis/Android-Image-Kitchen


    Credits & Thanks: All authors of the included binaries and libraries for their amazing work, as linked (or linked via GitHub) above. Peteragent5, alansj & iridaki for the general methods used in their PERL scripts and Linux guides. SuperR. & tobias.waldvogel for the general methods used in their kernel.elf unpacking scripts. _that and rayman for the general methods used to repack a working boot.blob. Chainfire for the ChromeOS and SEAndroid general methods. cybojenix for the Bump general method. xyz` & k4y0z for the amonet general method.

    Thanks to Goatshocker for testing out things for the HTC image issues, leading to the workaround and subsequent fix, avinashrocks1990 & tajimura for testing out compression support and the large pagesize fix, civato for testing out dtb support, talich for testing out the Linux version, shoey63 for testing out Linux + ELF support, moonbutt74 for testing out Android-x86 support, nathanchance for testing out the new AIK-mobile cpio method on his Pixel 2, leading to important fixes for its support, shakalaca for the great help with completing and testing Intel OSIP support, and Postman1year & CXZa for their help testing to find out the workaround for the Cygwin cut + symlink regression issues. Huge thank you to trevd and Modding.MyMind/SHM for all the contributing work they've each done and support they've provided.

    Disclaimer: Naturally, you take all the responsibility for what happens to your device when you start messing around with things.

    Download counts:

    AIK - v1.0: 1540; +HTCFix: 430. v1.5: 4718. v1.6: 3556. v1.8: 8678; +Lok2Img: 1629. v1.9: 2580. v2.0: 22886. v2.2: 20522. v2.3: 14524. v2.4: 84432; +LokiAddon: 20071. v2.5: 5004. v2.6: 9354. v2.7: 5442. v2.8: 6639. v2.9: 7672. v3.0: 2810. v3.1: 6502. v3.2: 27104. v3.3: 17736. v3.4: 25988. v3.5: 19051. v3.6: 32472. v3.7: 21457.
    Mobile - v1.0: 311. v1.1: 265. v1.2: 302. v1.3: 100. v1.4: 486. v1.5: 224. v1.6: 3303. v1.7: 7798. v1.8: 16286. v1.9: 3800. v2.0: 5444. v2.1: 2526. v2.2: 926. v2.3: 1346. v2.4: 18426. v2.5: 2586. v2.6: 6068. v2.7: 2936. v2.8: 3932. v2.9: 4181. v3.0: 1301. v3.1: 3300. v3.2: 3254. v3.3: 6824. v3.4: 10786. v3.5: 8624. v3.6: 14020. v3.7: 8951.
    Linux - v1.0: 75. v1.1: 208. v1.2: 233. v1.3: 112. v1.4: 421. v1.5: 173. v1.6: 1838. v1.7: 2596. v1.8: 4818. v1.9: 604; +v1.9.1: 1068. v2.0: 1836. v2.1: 1240. v2.2: 466. v2.3: 522. v2.4: 8126. v2.5: 1052. v2.6: 2018. v2.7: 1248. v2.8: 2486. v2.9: 5057. v3.0: 1455. v3.1: 2957. v3.2: 14508. v3.3: 10046. v3.4: 16294. v3.5: 12651. v3.6: 16478. v3.7: 12927.
    159
    AIK should be universal for Android devices that accept AOSP, ELF, OSIP, U-Boot and KRNL format images in theory, but there is always a chance it doesn't work for your device due to image packing differences, etc. Here is a running list of confirmed working and questionably/confirmed not working devices. If your device isn't in either list odds are that it will still work fine.

    Known Working Devices

    Amazon Fire HD 10
    Asus Nexus 7 (2012, 2013)
    Asus Transformer Pad
    Asus Zenfone (2, 5)
    Auchan QiLive (Q5, Q7)
    Barnes & Noble Nook ( , HD+, 7)
    BQ Aquaris M8
    Coolpad Catalyst
    Essential PH-1
    Google Pixel (C, , XL, 2, 2 XL, 3, 3 XL, 3a, 3a XL, 4, 4 XL, 4a, 4a 5G, 5, 5a)
    Huawei Ascend Y300
    Huawei Mate 8
    Huawei Nexus 6P
    Huawei U8800 Ideos X5
    HTC Nexus 9
    HTC One (M7, M8, S, X)
    HTC Vivid/Raider 4G
    HP Slate 21
    LeEco Le Pro3
    Lenovo A706
    Lenovo K900
    Lenovo Vibe K5
    LG G(2, 2 Mini, 3, 3 Stylus, 5)
    LG GPad (7.0, 8.3, X 8.0)
    LG Nexus (4, 5, 5X)
    LG Optimus (3D, 4X HD)
    LG Stylo 3 Plus
    LG V(10, 20)
    Micromax Ninja/Bolt A27
    Motorola Moto G (2013, 2014)
    Motorola Moto X 2014
    Motorola Nexus 6
    Nextbit Robin
    OnePlus (One, 2, X, 3, 3T, 5, 5T, 6, 6T, 7, 7 Pro, 7T, 7T Pro, 8, 8 Pro, 8T, 9R, 9, 9 Pro)
    OnePlus Nord ( , N10 5G, N100)
    Pantech Vega Iron
    Pantech Vega Secret Note
    Samsung Galaxy A3 2016
    Samsung Galaxy Ace II X
    Samsung Galaxy Core Mini 4G
    Samsung Galaxy Mega
    Samsung Galaxy Nexus
    Samsung Galaxy Note (2, 3, 4, Pro 12.2)
    Samsung Galaxy S(3, 3 Mini, 4, 5, 6, 7, 8, 8+)
    Samsung Galaxy Star
    Samsung Galaxy Tab (2 7.0, 3 10.1, 4 7.0, 4 8.0, 4 10.1, A 7.0, A 10.1, Pro 8.4)
    Samsung Galaxy Victory
    Samsung Galaxy Xcover 3
    Samsung Nexus 10
    Sony Xperia (Arc S, M, Neo, Neo V, SP, Tab Z4, Z, Z1, Z5)
    Spice Mi-355 Stellar Craze
    Vodafone Smart Ultra 6
    Xiaomi Mi Pad
    Xiaomi Poco X2
    Xiaomi Redmi (6A, Note 3 Pro)


    Confirmed Not Working Devices
    • Blackview BV4000 - some newer MediaTek (MTK) devices use special image signing that adds a "BFBF" pre-header signature. While present on multiple MTK devices, it only appears to be enforced by the bootloader on some. See this post.
    • HTC Desire 326G, Huawei Honor Bee, Huawei MediaPad T1 7.0 - some newer Spreadtrum devices use special image signing that adds a "SPRD-SECUREFLAG" pre-header signature, so images will unpack/repack but most likely won't boot unless run through their internal signing tool. See this post.
    • Nibiru V05-A, Pipo Max - some RockChip (RK) devices use a variant of the AOSP image format with extra checksums and hidden sections with extra data. There is not currently an open source tool that can handle repacking these. See this post.
    • Samsung Galaxy S (Advance, Captivate, Vibrant), Samsung Galaxy S2, Samsung Galaxy Note & Samsung Galaxy Tab - contain zImage (kernel) + ramdisk (possibly within the zImage) but are the "headerless" Linux kernel blob format and require a full cross-compiler to repack correctly. See this post.
    • Samsung [various] - the image and SEANDROIDENFORCE footer are followed by a signature that, while present on many Samsung devices, only appears to be enforced by the bootloader on some. See this post.
    • Skyworth 50G2A TV - some newer MediaTek (MTK) devices use special image part signing that adds a 256-byte checksum/signature to both Image.gz-dtb/zImage-dtb (kernel) and ramdisk.cpio.gz, so images will unpack/repack but most likely won't boot unless run through their internal signing tool. See this post.
    • Xiaomi Mi Box 3S, ZTE B860H STB - some newer Amlogic devices use special image signing that adds an "AMLSECU!" signature within the header and appears to encrypt the ramdisk, so the image itself will unpack/repack but cannot be re-signed, and the ramdisk cannot be unpacked or modified.

    Note: For devices requiring Loki patched images (e.g. LG G2, AT&T Samsung Galaxy S4), your device's aboot.img dump must be in the script directory to Re-Loki. (Thank you to jeboo for the original one-way Lok2Img Workaround's binary source, used prior to the official Loki Tool gaining un-Loki support).


    Release Notes

    Windows:
    v1.0 - Dec 30, 2012 - Initial release.    
    v1.5 - May 6, 2013 - Linked.
    v1.6 - Sep 16, 2013 - Linked.
    v1.8 - Dec 9, 2013 - Linked.
    v1.9 - Jun 7, 2014 - Linked.
    v2.0 - Aug 3, 2014 - Linked.
    v2.2 - Mar 25, 2015 - Linked.
    v2.3 - Oct 11, 2015 - Linked.
    v2.4 - Feb 8, 2016 - Linked.
    v2.5 - Jan 26, 2017 - Linked.
    v2.6 - Feb 27, 2017 - Linked.
    v2.7 - May 1, 2017 - Linked.
    v2.8 - Jun 5, 2017 - Linked.
    v2.9 - Sep 14, 2017 - Linked.
    v3.0 - Dec 14, 2017 - Linked.
    v3.1 - Jan 7, 2018 - Linked.
    v3.2 - Mar 19, 2018 - Linked.
    v3.3 - Jul 23, 2018 - Linked.
    v3.4 - Oct 28, 2018 - Linked.
    v3.5 - Apr 17, 2019 - Linked.
    v3.6 - Sep 22, 2019 - Linked.
    v3.7 - May 22, 2020 - Linked.
    v3.8 - May 5, 2021 - Linked.

    Android:
    v1.0 - Mar 23, 2014 - Linked. (ARM only)
    v1.1 - Apr 19, 2014 - Linked. (ARM only)
    v1.2 - May 15, 2014 - Linked. (ARM only)
    v1.3 - Jun 7, 2014 - Linked. (ARM, x86 with emulation)
    v1.4 - Jun 17, 2014 - Linked. (ARM, x86 with emulation)
    v1.5 - Aug 3, 2014 - Linked. (32bit only)
    v1.6 - Aug 19, 2014 - Linked. (32bit only)
    v1.7 - Dec 26, 2014 - Linked. (32bit only)
    v1.8 - Mar 25, 2015 - Linked. (32bit only)    
    v1.9 - Oct 11, 2015 - Linked. (32bit only)
    v2.0 - Dec 7, 2015 - Linked.
    v2.1 - Feb 8, 2016 - Linked.
    v2.2 - Mar 16, 2016 - Linked.
    v2.3 - Apr 1, 2016 - Linked.
    v2.4 - Apr 20, 2016 - Linked.
    v2.5 - Jan 26, 2017 - Linked.
    v2.6 - Feb 27, 2017 - Linked.
    v2.7 - May 1, 2017 - Linked.
    v2.8 - Jun 5, 2017 - Linked.
    v2.9 - Sep 14, 2017 - Linked.
    v3.0 - Dec 14, 2017 - Linked.
    v3.1 - Jan 7, 2018 - Linked.
    v3.2 - Mar 19, 2018 - Linked.
    v3.3 - Jul 23, 2018 - Linked.
    v3.4 - Oct 28, 2018 - Linked.
    v3.5 - Apr 17, 2019 - Linked.
    v3.6 - Sep 22, 2019 - Linked.
    v3.7 - May 22, 2020 - Linked.
    v3.8 - May 5, 2021 - Linked.

    Linux/macOS:
    v1.0 - Apr 11, 2014 - Linked. (x86, Linux only)
    v1.1 - Apr 19, 2014 - Linked. (x86, Linux only)
    v1.2 - May 15, 2014 - Linked. (x86, Linux only)
    v1.3 - Jun 7, 2014 - Linked. (x86, Linux only)
    v1.4 - Jun 17, 2014 - Linked. (x86, Linux only)
    v1.5 - Aug 3, 2014 - Linked. (x86, Linux only)
    v1.6 - Aug 19, 2014 - Linked. (x86, Linux only)
    v1.7 - Dec 26, 2014 - Linked. (Linux only)
    v1.8 - Mar 25, 2015 - Linked. (Linux only)
    v1.9 - Oct 11, 2015 - Linked. (Linux only)
    v2.0 - Dec 7, 2015 - Linked. (Linux only)
    v2.1 - Feb 8, 2016 - Linked. (Linux only)
    v2.2 - Mar 16, 2016 - Linked. (Linux only)
    v2.3 - Apr 1, 2016 - Linked. (Linux only)
    v2.4 - Apr 20, 2016 - Linked. (Linux only)
    v2.5 - Jan 26, 2017 - Linked. (Linux only)
    v2.6 - Feb 27, 2017 - Linked. (Linux only)
    v2.7 - May 1, 2017 - Linked. (Linux only)
    v2.8 - Jun 5, 2017 - Linked. (Linux only)
    v2.9 - Sep 14, 2017 - Linked. (Linux only)
    v3.0 - Dec 14, 2017 - Linked.
    v3.1 - Jan 7, 2018 - Linked.
    v3.2 - Mar 19, 2018 - Linked.
    v3.3 - Jul 23, 2018 - Linked.
    v3.4 - Oct 28, 2018 - Linked.
    v3.5 - Apr 17, 2019 - Linked.
    v3.6 - Sep 22, 2019 - Linked.
    v3.7 - May 22, 2020 - Linked.
    v3.8 - May 5, 2021 - Linked.




    Everyone please let me know if AIK works for your devices or if you encounter any problems, so I can make these lists more comprehensive. 👍

    If you are reporting a problem with your device, please clearly state your device name and model/variant, attach a log, as well as provide a link to the image file.
    63
    Android ARM/ARM64, x86/x86_64 + MIPS/MIPS64 version of Android Image Kitchen! Now you can easily modify ramdisks on the go! :D

    AIK-mobile:
    - Almost complete feature parity with the Windows/Linux version, including compression support, --original to repack with the original ramdisk, --origsize to pad the repacked image to the size of the original, --level to change the compression level of the repacked ramdisk, --avbkey to change the key used for Android Verified Boot (AVBv1) signing of the repacked image, and --forceelf to make an older unpacked Sony ELF file repack as an ELF. The only thing missing is --local since AIK-mobile's ability to unpack/repack while booted in Android is too complex to easily allow moving the unpack/repack directory around.
    - The flashable zip installs AIK for your Android architecture (ARM/ARM64, x86/x86_64, MIPS/MIPS64) to /data/local/AIK-mobile/ and a helper script created at /system/xbin/aik (alternately /su/bin/aik or /sbin/supersu/bin/aik if SuperSU systemless root is detected, or, /sbin/.magisk/img/aik-mobile/bin/aik or /data/adb/modules/aik-mobile/bin/aik if Magisk is detected).
    - Type "aik" in Terminal Emulator to automatically go to the install directory and get a root prompt, then use, eg. "unpackimg.sh boot.img" to get started.
    - Running su -c "/data/local/AIK-mobile/bin/aik --restore" will recreate the aik helper script in the appropriate place (see above), e.g. after a ROM flash with su.img SuperSU or magisk.img Magisk removed.
    - "aik --uninstall" should be self-explanatory, and "--help" is also available for all included scripts.

    Now also possible to run entirely from a file explorer app, see this post for details!

    To run from TWRP (recovery shell), follow the instructions in this post.


    mkbootimg, unpackbootimg: https://github.com/osm0sis/mkbootimg
    pxa-mkbootimg, pxa-unpackbootimg: https://github.com/osm0sis/pxa-mkbootimg
    elftool: https://github.com/osm0sis/elftool
    unpackelf: https://github.com/osm0sis/unpackelf
    mboot: https://github.com/osm0sis/mboot
    dumpimage, mkimage: https://www.denx.de/wiki/U-Boot/WebHome
    mkmtkhdr: https://github.com/osm0sis/mkmtkhdr
    loki_tool: https://github.com/djrbliss/loki
    futility: https://github.com/osm0sis/futility
    boot_signer-dexed.jar: https://xdaforums.com/android/software-hacking/signing-boot-images-android-verified-t3600606
    blobpack, blobunpack: https://github.com/AndroidRoot/BlobTools
    dhtbsign: https://github.com/osm0sis/dhtbsign
    rkcrc: https://github.com/rockchip-linux/rkflashtool
    sony_dump: https://xdaforums.com/crossdevice-dev/sony/tool-unpack-format-sony-kernel-image-t3530077
    busybox: https://busybox.net/; https://github.com/osm0sis/android-busybox-ndk
    file, magic: https://www.darwinsys.com/file/
    xz: https://tukaani.org/xz/
    lz4: https://lz4.github.io/lz4/

    GitHub: https://github.com/osm0sis/Android-Image-Kitchen/commits/AIK-mobile

    Originally all but busybox were compiled natively on my Nexus 7 2013 using a KBox2 build environment, now cross-compiled with the NDK on my PC and my own AIK Build Farm. :cowboy:

    Notes: You may delete /data/local/AIK-mobile/bin/busybox if you want to use your ROM's busybox instead.


    Linux will be next on the list, and should be pretty easy since I did all of the shell script leg work with the Android version. ;) (y)


    If you are reporting a problem with your device, please clearly state your device name and model/variant as well as provide a link to the image file.
    34
    Another longtime request. New Linux version of Android Image Kitchen up in the OP! Bringing my updated binaries back home! ;)

    Now also supporting macOS out-of-the-box (i.e. no Homebrew or MacPorts addons needed) with v3.0+!

    AIK-Linux:
    - Complete feature parity with the Windows/Android versions, including compression support, --original to repack with the original ramdisk, --origsize to pad the repacked image to the size of the original, --level to change the compression level of the repacked ramdisk, --avbkey to change the key used for Android Verified Boot signing of the repacked image, and --forceelf to make an older unpacked Sony ELF file repack as an ELF.
    - Unpacks as root by default to maintain full control over all repacked ramdisk file ownership/permissions, --nosudo argument available to attempt unpack/repack as user if possible.
    - All scripts allow unpacking/repacking with the current directory instead of the AIK directory if --local is the first command-line argument.
    - "--help" is also available for all included scripts.
    - Unpack with "tar -xzvf AIK-Linux-*.tar.gz" in your home directory then you can go to AIK-Linux and use, eg. "./unpackimg.sh boot.img" to get started.

    mkbootimg, unpackbootimg: https://github.com/osm0sis/mkbootimg
    pxa-mkbootimg, pxa-unpackbootimg: https://github.com/osm0sis/pxa-mkbootimg
    elftool: https://github.com/osm0sis/elftool
    unpackelf: https://github.com/osm0sis/unpackelf
    mboot: https://github.com/osm0sis/mboot
    dumpimage, mkimage: https://www.denx.de/wiki/U-Boot/WebHome
    mkmtkhdr: https://github.com/osm0sis/mkmtkhdr
    loki_tool: https://github.com/djrbliss/loki
    futility: https://github.com/osm0sis/futility
    boot_signer.jar (requires JRE 8+): https://xdaforums.com/android/software-hacking/signing-boot-images-android-verified-t3600606
    blobpack, blobunpack: https://github.com/AndroidRoot/BlobTools
    dhtbsign: https://github.com/osm0sis/dhtbsign
    rkcrc: https://github.com/rockchip-linux/rkflashtool
    sony_dump: https://xdaforums.com/crossdevice-dev/sony/tool-unpack-format-sony-kernel-image-t3530077
    lz4: https://lz4.github.io/lz4/
    magic: https://www.darwinsys.com/file/
    cpio, dd, file, lzop, tail, truncate, xz; libiconv.2, libintl.8, liblzma.5, liblzo2.2, libmagic.1 (macOS): https://www.macports.org/
    gzip, bzip2, lzop, xz; awk, basename, bash, cpio, cut, dd, dirname, env, file, find, grep, hexdump, java, printf, rev, sed, stat, sudo, tail, truncate, wc (Linux): (required system packages/commands)

    GitHub: https://github.com/osm0sis/Android-Image-Kitchen/commits/AIK-Linux

    Most included binaries were compiled using my patched crosstool-ng i686 and x86_64 Cygwin to Linux cross-compiler toolchains, now as part of my own AIK Build Farm. :cowboy:

    macOS compiles built with osxcross. Instructions available via my Build Farm post.

    I'm not going to interfere with anyone's Linux installations, nor needlessly bundle a ton of commonly available binaries, so if you need extra compression support you need to have those packages installed. In my Ubuntu Server VM gzip, bzip2 and xz/lzma all seem to come pretty much by default, and "apt-get install lzop bsdmainutils" handles lzop and hexdump. Java depends on your setup, but openjdk-8-jre will be what most will want if not already included. lz4 would be the only one that would have to be built from source on many distros, so I have considered it an exception, built it and included it myself.

    Thanks to shoey63 and talich for testing. Cheers! :)


    If you are reporting a problem with your device, please clearly state your device name and model/variant as well as provide a link to the image file.
    30
    It's been a busy few weeks!

    After a Herculean effort to get the DENX U-Boot utilities to build with the NDK, which required me firing up my Ubuntu VM (for more than testing for once) and then hacking both the NDK toolchains and tool sources, say hello to U-Boot support! It's a *nix standard, and pretty rare on Android but it does exist (e.g. LG Optimus 3D) and I'm extremely pleased to add support for this completely different type of image format to AIK! :cowboy:

    I then added support for the Samsung/Marvell variant of the AOSP standard for their pxa1088 board, which I've termed "AOSP-PXA", by updating a modified bootimg tools fork to continue the excellent work done by @ketut.kumajaya and @akuhak. There aren't a lot of known examples of these either (e.g. Samsung Galaxy Core Mini 4G, Samsung Galaxy Tab 4 7.0 & Samsung Galaxy Xcover 3) but it was pretty straightforward and removes another entry from the "Confirmed Not Working" list in the OPs. ;)

    Next up, Sony SIN packaging/signature unpack support, thanks to the brilliant research and development of @munjeni for his closed-source kernel_dump binary, of which he also supplied the builds.

    Last but not least, it turns out the signatures I identified on the Pixels last month almost immediately went into enforcement after my release.. and it turns out we misunderstood the nature of these signatures so I have reverted the unpackbootimg patch that was originally submitted to me for the Xioami Mi MAX where these signatures were first found; while reappending the original signature was reported to have worked for the Mi MAX, the Pixel bootloader appears to be enforcing it even more strictly and so they must be signed correctly. Luckily, thanks to the great and ongoing work of @Chainfire we've got a cross-platform working signing tool, but it does rely on a Java-like VM - Java Runtime Environment (JRE) 8+ for Windows/Linux to run correctly - and we can use the Dalvik VM on Android without any issues drawing in part from my previous experiments in this area.

    Since the original AVB signing OEM keys are naturally unavailable this presents a bit of a problem and there are numerous keys already floating around including SuperSU, ElementalX and a few custom Pixel ROMs. To be sensible we the modding community should all try to use the same keys for interoperability, to make sure different mods stack correctly and avoid any possible problems with encrypted devices, so I have generated the required extra certificate for AVB signing from the usual AOSP testkeys and would encourage all other boot image modifying projects to use them; they are available for use on my GitHub. They are the default for AIK, but a user may specify --avbkey on the repackimg commandline to force the use of other keys. The keys may be placed in the main AIK directory and specified without path with only the base name of the files (e.g. --avbkey supersu for supersu.pk8 and supersu.x509.der) or with a path, but still omitting the file extensions to keep it simple (e.g. --avbkey /path/to/ex for /path/to/ex.pk8 and /path/to/ex.x509.der). Hopefully that'll cover all the bases and some other projects will come around to using the testkeys.

    Per usual, the AIK Build Farm has been updated accordingly. Enjoy! :)

    NOTE: Downloads have switched to being hosted on the XDA DevDB Project Downloads page since AIK-mobile now exceeds the 20mb zip attachment size limit.

    I work on these projects in my limited time off, so if you like the progress I'm making, or enjoy anything else I've done on xda, please do hit the donate link from my profile. Thanks for your support!


    Android Image Kitchen v2.8:
    - general cleanup using if/else and absolute paths wherever possible and removing hidden hideErrors option for simplicity since it's no longer needed
    - add detection if running directly from a command prompt and do not pause if so
    - add error catching for unsupported/unrecognized formats on repack, and compression formats on unpack
    - update unpackbootimg and unpackelf binaries from my repos
    - add DENX U-Boot uImage detection and use dumpimage and mkimage to unpack/repack
    - add Samsung/Marvell boot.img variant (AOSP-PXA) and use pxa1088-unpackbootimg and pxa1088-mkbootimg to unpack/repack
    - add Sony SIN signature/packaging detection and use kernel_dump to extract the kernel.elf
    - add Android Verified Boot (AVB) signature footer detection and use BootSignature.jar to re-sign with AOSP testkeys (https://github.com/osm0sis/testkeys)
    - dump AVB type (boot/recovery) to -avbtype so that it may be changed for repack if desired
    - refactor repackimg commandline parameter parsing and introduce --avbkey to specify custom keys (accepts path and/or filename minus extensions) to use for AVB re-signing
    - update slimmed magic file (from file 5.31) with my own fixes
    - update to the latest Cygwin binaries and libraries

    AIK-mobile v2.8 + AIK-Linux v2.8:
    - general cleanup using absolute paths wherever possible
    - add error catching for unsupported formats on repack, and compression formats on unpack
    - fix unpack error output on some xz/lzma ramdisks by using included xz binary instead of busybox (AIK-mobile)
    - update unpackbootimg and unpackelf binaries from my repos
    - add DENX U-Boot uImage detection and use dumpimage and mkimage to unpack/repack
    - add Samsung/Marvell boot.img variant (AOSP-PXA) and use pxa1088-unpackbootimg and pxa1088-mkbootimg to unpack/repack
    - add Sony SIN signature/packaging detection and use kernel_dump to extract the kernel.elf
    - add Android Verified Boot (AVB) signature footer detection and use BootSignature.jar to re-sign with AOSP testkeys (https://github.com/osm0sis/testkeys)
    - dump AVB type (boot/recovery) to -avbtype so that it may be changed for repack if desired
    - refactor repackimg commandline parameter parsing and introduce --avbkey to specify custom keys (accepts path and/or filename minus extensions) to use for AVB re-signing
    - actually fix chromeos subfolder permissions during install (AIK-mobile)
    - fix unpackimg --help to show --sudo option (AIK-Linux)
    - update file binary (5.31) (AIK-mobile)
    - update slimmed magic file (from file 5.31) with my own fixes


    More on my own build changes in the commits here: https://github.com/osm0sis/mkbootimg; https://github.com/osm0sis/pxa1088-mkbootimg; https://github.com/osm0sis/unpackelf.

    Installation information and details on each edition can be found in the OP for Win32 or the AIK-mobile and AIK-Linux initial release notes.


    If you are reporting a problem with your device, please clearly state your device name and model/variant as well as provide a link to the image file.