Publication of Hachoir project version 1.0

Victor Stinner victor.stinner at
Thu Jul 19 03:11:05 CEST 2007

Hachoir is a framework for binary file manipulation: file format
recognition, metadata extraction, search files in any binary stream
(forensics), view file content with human representation, etc. It's
composed of many component:

 * hachoir-metadata: fault tolerant metadata extraction;
 * hachoir-subfile: search subfiles in a disk image or any other
 * hachoir-urwid, hachoir-wx, hachoir-gtk, hachoir-gtk: user interface
   view file content (curses, wxPython, pygtk, web+ajax);

 * hachoir-core: library to split binary data into a field tree;
 * hachoir-parser: collection of 70 file format parsers;
 * hachoir-regex: regular expression optimization/manipulation and
   matching (used by hachoir-subfile).

Project website:

List of supported file formats:
  (jpeg, ttf, exe, rar, ogg, ntfs, ole2, torrent, ...)

Examples of metadata extraction:

hachoir-wx screenshots:

Hachoir works any operating system and only depends on Python (2.4+).
Packages are available for Debian, Mandriva, Gentoo, Arch and FreeBSD.

hachoir-core goal is to ease binary parser writing. It takes care of
problem, has bit resolution (for addresses and sizes), and only use
charset for text. It gives a nice API to the programmer (see parsers
code): each field is an object. A parser is lazy: its value, display
description, etc. is computed on demand (when the program ask it). So
possible to parse very complex structures and huge files (60 GB or
more is
not a problem).

hachoir-core and hachoir-metadata are "fault tolerant": on parser/
error or file error (truncated or damaged file), the program doesn't
but continue to next valid state. It allows to extract informations on
damaged files.

hachoir-metadata create a dictionary with typed values: track number
is an
integer, creation date is datetime.datetime object, etc. and all text
stored as Unicode string. The API allows easy reuse of extracted data.

Source code has good code coverage with automatic tests (lot of
Fuzzing is sometimes used to find more bugs.

Some experimental programs exist like hachoir-strip: program to remove
personal information (author name, timestamp, copyright, etc.) from a
picture, movie, sound, archive, etc. Another example:
to extract pictures and sounds from a SWF (Flash) document.

Victor Stinner aka haypo

More information about the Python-announce-list mailing list