Tool for editting Windows CE/Mobile firmware images.
C++ Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


eimgfs is a tool for creating, decoding, viewing and modifying Windows CE firmware images.

I am re-releasing it here on github. Originally this was posted as part of the itsutils package on xda-developers.

These formats are supported:

  • motorola flash.bin
  • htc (signed) .nbh
  • partitiontable with xips+imgfs
  • plain xip
  • compressed xip
  • plain imgfs

To be able to compress/decompress files it must either run on windows, or as a 32bit binary on osx.

This used to be part of the itsutils distribution.


I started developing this tool as dumprom in 2003 for xda-developers. Later converted to perl. And Later again, when WindowsCE started using the imgfs filesystem, converted to c++, now named eimgfs. Which stads for 'Edit imgfs'.

Several older tools with similar functionality:,,


Usage: editimgfs imgfile [operations]

You can specify as many operations as needed.

main options:

option arguments description
-v verbose
-r readonly
-d path where to save extrated files to
-s SIZE specify totalsize ( for motorola FLASH )
-extractall extract all to '-d' path
-list list all files
-info list available readers/filesystems
-filter <EXE SIGNED>
-resign update nbh sigs after modifications
-keyfile KeyFile nbh key file
-extractnbh extract SPL/IPL/OS images from nbh

READER operations:

option arguments description
-rd RdName specify reader to operate upon
-saveas Outfile save entire rd section
-getbytes offset size Outfile
-putbytes offset size Infile
-hexdump offset size
-chexdump {XPR XPH
-hexedit offset bytes...

FILESYSTEM operations:

option arguments description
-fs FsName specify fs to operate upon
-add RomName[=srcfile] ... adds a list of files
you can also add all files from a directory
-del RomName
-ren RomName=NEWNAME
-extract RomName=dstfile
-fileinfo RomName print detailed info about file
-dirhexdump for debugging


An example, how i have used this tool:

eimgfs -s 0x10000000  therom.nb \
       -fs imgfs -del delfiles -add files \
       -fs xip23 -del delfiles-xip23 -add files-xip23 \
       -fs xip20 -del delfiles-xip20 -add files-xip20

This will alter therom.nb, increasing its maximum size to 256Mbyte, deleting files from the imgfs, xip20, xip23 partition for the names found in the respective delfiles-... directories, and adding files from the files-... directories.


There are makefiles for OSX and Windows. Both depend on the presence of 32 bit libraries for boost and openssl.

Make sure the dlls from the dlls directory are somewhere in the search path. They are needed for decompression.


(C) 2003-2013 Willem Hengeveld