Skip to content


Repository files navigation


HexaMonkey is a freely distributed framework which goal is to provide tools to view the internal structure of any binary file and navigate through it seamlessly. It can be used to facilitate the development and debugging of encoding and decoding software.

It relies on lazy and asynchronous parsing to offer a pleasant experience to the user. It is highly exentensible thanks to its modular architecture and a powerful description langage : HMDL.

The formats already supported are :

Video :
    asf/wmw (incomplete)
Image :
    jpeg (incomplete)
Archive :
Database :

We strongly encourage you to implement other formats and share them : see the HMScript documentation ( for more information.

Installing the project on Windows

There is an installer available on, browse the download section.

Building the project

Under Linux

You need qt5, gcc>=4.7, bison and flex on your computer, make sure qmake is available in your PATH. At the root of the project, type:

qmake -r

to prepare the build. You may specify your lib and bin directory (default /usr/lib and /usr/bin) by typing :

qmake -r LIBDIR=/my/own/lib BINDIR=/my/own/bin

then type


to build hexamonkey. and

sudo make install

to install it on your system. Then type


to start the program.

Under Windows

Build compiler

First step is to build compiler which is used to compile hmscript files. For this you can either use GnuWin32 or Cygwin :

Option 1: GnuWin32 (recommended)

Install GnuWin32 ( and MinGW (should be provided in with your Qt install) and make sure that the bin folders are in the PATH variable environment. Then you need to browse to open a console, cd to the compiler directory and run


Option 2: Cygwin

Install cygwin with gcc3, flex, bison and make. Sadly the most recent version of cygwin don't ship gcc3, so you'll have to use the Cygwin time machine ( to get older version of the packages. So download the cygwin setup file from the official site ( and then run

setup-x86.exe -X -S -O

Follow the installer instructions and select the packages gcc, flex, bison and make. Then you should have all the tools you need to build the project.

In cygwin browse the compiler directory of the source then run

make CFLAGS=-mno-cygwin

if it doesn't work you may check that gcc in cygwin is pointing to /usr/bin/gcc-3.exe.

Build Qt project

Install Qt5 with the MinGW compiler to build the project. Open gui/ with qt creator. Check in your project configuration that shadow build is unchecked then compile with the button or Ctrl+B.

Create windows installer

Check that all the required DLLs are in a dll directory you have created at the root of the project.

Required DLLs :


  • Qt5Core.dll
  • Qt5Gui.dll
  • Qt5Widgets.dll
  • D3DCompiler_43.dll
  • icudt49.dll
  • icuin49.dll
  • icuuc49.dll
  • libEGL.dll
  • libgcc_s_sjlj-1.dll
  • libGLESv2.dll
  • libstdc++-6.dll
  • libwinpthread-1.dll

Found in %QtINSTALLDIR%\Qt%VERSION%%VERSION%\mingw%VERSION%_32\plugins\platform:

  • qminimal.dll
  • qwindows.dll

You need to install wix (available at then run in the root of the project (after adding the bin dir of wix to your PATH or run full path to the candle.exe and light.exe instead of just their names.)

candle.exe installer.wxs

light.exe installer.wixobj