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 : mpeg4 mpeg2-ts matroska avi asf/wmw (incomplete) Image : png jpeg (incomplete) gif Archive : zip Database : sqlite
We strongly encourage you to implement other formats and share them : see the HMScript documentation (http://www.hexamonkey.com/hmdoc.php) for more information.
Installing the project on Windows
There is an installer available on http://hexamonkey.com/, browse the download section.
Building the project
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:
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
to build hexamonkey. and
sudo make install
to install it on your system. Then type
to start the program.
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 (http://getgnuwin32.sourceforge.net/) 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 (www.fruitbat.org/Cygwin/) to get older version of the packages. So download the cygwin setup file from the official site (www.cygwin.com) and then run
setup-x86.exe -X -S ftp://www.fruitbat.org/pub/cygwin/circa/2012/08/20/222043 -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
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/gui.pro 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 :
Found in %QtINSTALLDIR%\Qt%VERSION%%VERSION%\mingw%VERSION%_32\bin:
Found in %QtINSTALLDIR%\Qt%VERSION%%VERSION%\mingw%VERSION%_32\plugins\platform:
You need to install wix (available at http://wix.sourceforge.net/) 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.)