A python script and module to extract and convert to IMG files used in some FSG games like Guitar Hero Live, DJ Hero and DJ Hero 2
Extract a IMG file to a decompressed format
ghl_img_converter.py extract input [--output OUTPUT] [--platform {ps3,ios,x360,wiiu,wii}]
input
Path of the input IMG file or root folder to extract
--output OUTPUT
Path to the output decompressed format or output folder
--platform {ps3,ios,x360,wiiu,wii}
Force extraction from the specified platform
Convert an image to a IMG file
ghl_img_converter.py convert input [--output OUTPUT] --platform {ps3,ios,x360,wiiu,wii} [--game {ghl,djh,djh2}] [--width WIDTH] [--height HEIGHT] [--format {BC1,BC2,BC3,R8G8B8A8}] [--tex0 {CMPR,RGB5A3,IA4}] [--mipmap MIPMAP] [--flip]
input
Path of the input image or root folder to convert
--output OUTPUT
Path to the output IMG or folder
--platform {ps3,ios,x360,wiiu,wii}
Platform to convert the IMG to
--game {ghl,djh,djh2}
Game to convert the IMG to, used in PS3 and X360 textures. Default option is ghl
--width WIDTH
Width of the output IMG. Not supported on Wii textures
--height HEIGHT
Height of the output IMG. Not supported on Wii textures
--format {BC1,BC2,BC3,R8G8B8A8}
DDS format of the output IMG, used in PS3, X360 and Wii U textures. Default option is BC1
--tex0 {CMPR,RGB5A3,IA4}
TEX0 format of the output IMG, used in Wii textures. Default option is RGB5A3
--mipmap MIPMAP
Mipmap count of the output IMG
--flip
Vertically flip the output IMG. Not supported on Wii textures
Prints information about the IMG file
ghl_img_converter.py info input
input
Path of the input IMG file
This program currently requires PVRTexToolCLI.exe version 4.23 or earlier installed and added to your config.ini
file. Downloading PowerVRSDK-4.0 is recommended.
Wii U conversion also requires gtx_extractor.py installed and added to your config.ini
file.
Wii conversion only requires wimgt.exe installed and added to your config.ini
file.
Feel free to contribute for more formats and platforms support
A special thanks to everyone in the GHLRE organization and Discord who helped figure out the image formats before me!