Home

Awesome

<p align="center"> <img src="assets/logo.png" /> <br> <a href="#examples">Examples</a> • <a href="https://shark.fish/binocle.mp4">Screencast</a> • <a href="#how-it-works">How it works</a> • <a href="#installation">Installation</a> </p>

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 binaryMS Teams memdumpDoom assetsperf record samples
<img src="assets/example-elf.png" width="200" /><img src="assets/example-teams-memdump.png" width="200" /><img src="assets/example-doom.png" width="200" /><img src="assets/example-perf-record.png" width="200" />

Preview

Watch a short screencast here

<a href="https://raw.githubusercontent.com/sharkdp/binocle/master/assets/screenshot.png"><img src="assets/screenshot.png"></a>

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.

<p align="center"><img src="assets/binary-view.png" /></p>

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