Lib.rs

Examples • Screencast • How it works • Installation

binocle is a graphical tool to visualize binary data. It colorizes bytes according to different rules and renders them as pixels in a rectangular grid. This allows users to identify interesting parts in large files and to reveal image-like regions.

Examples

ELF binary	MS Teams memdump	Doom assets	perf record samples

Preview

Watch a short screencast here

How it works

The program allows you to control various parameters like the offset into the file, the stride, the width of the rectangular grid as well as the way in which (groups of) bytes are colorized.

Installation

On Ubuntu

Download the appropriate .deb package from the Release page and install it via dpkg:

wget https://github.com/sharkdp/binocle/releases/download/v0.3.1/binocle_0.3.1_amd64.deb
sudo dpkg -i binocle_0.3.1_amd64.deb

On Arch Linux

binocle can be installed from the extra repository using pacman:

pacman -S binocle

From binaries (Linux, macOS, Windows)

Download the corresponding archive from the Release page.

With cargo (Linux, macOS, Windows)

binocle can be installed via cargo:

cargo install binocle

License

binocle is dual-licensed under the terms of the MIT License and the Apache License 2.0.

See the LICENSE-APACHE and LICENSE-MIT files for details.

Related work

• A Visual Study of Primitive Binary Fragment Types
• binvis.io
• cantor.dust (talk)
• veles.io (GitHub [archived])