hachoir

---

Hachoir

---

.. image:: https://img.shields.io/pypi/v/hachoir.svg :alt: Latest release on the Python Cheeseshop (PyPI) :target: https://pypi.python.org/pypi/hachoir

.. image:: https://github.com/vstinner/hachoir/actions/workflows/build.yml/badge.svg :alt: Build status of hachoir on GitHub Actions :target: https://github.com/vstinner/hachoir/actions

.. image:: http://unmaintained.tech/badge.svg :target: http://unmaintained.tech/ :alt: No Maintenance Intended

Hachoir is a Python library to view and edit a binary stream field by field. In other words, Hachoir allows you to "browse" any binary stream just like you browse directories and files.

A file is splitted in a tree of fields, where the smallest field is just one bit. Examples of fields types: integers, strings, bits, padding types, floats, etc. Hachoir is the French word for a meat grinder (meat mincer), which is used by butchers to divide meat into long tubes; Hachoir is used by computer butchers to divide binary files into fields.

• Hachoir website <http://hachoir.readthedocs.io/>_ (source code, bugs)
• Hachoir on GitHub (Source code, bug tracker) <https://github.com/vstinner/hachoir>_
• License: GNU GPL v2

Command line tools using Hachoir parsers:

• hachoir-grep: find a text pattern in a binary file
• hachoir-metadata: get metadata from binary files
• hachoir-strip: modify a file to remove metadata
• hachoir-urwid: display the content of a binary file in text mode

Installation instructions: http://hachoir.readthedocs.io/en/latest/install.html

Hachoir is written for Python 3.6 or newer.