https://github.com/ztroop/dead-ringer

Binary Diff Utility
https://github.com/ztroop/dead-ringer

binary-analysis hexadecimal rust

Last synced: 22 days ago
JSON representation

Binary Diff Utility

• Host: GitHub
• URL: https://github.com/ztroop/dead-ringer
• Owner: ztroop
• License: mit
• Created: 2024-01-16T15:34:42.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-02T23:13:34.000Z (almost 2 years ago)
• Last Synced: 2026-02-14T19:15:40.215Z (about 1 month ago)
• Topics: binary-analysis, hexadecimal, rust
• Language: Rust
• Homepage:
• Size: 1.02 MB
• Stars: 42
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ratatui - dead-ringer - Binary diff tool for Hex/ASCII analysis. (💻 Apps / 🚀 Productivity and Utilities)

README

          
[![Build](https://github.com/ztroop/dead-ringer/actions/workflows/build.yml/badge.svg)](https://github.com/ztroop/dead-ringer/actions/workflows/build.yml)

# dead-ringer

A Rust-based command-line utility designed to compare two binary files, displaying differences by showcasing both hexadecimal and ASCII representations of the differing bytes.

![demo](./assets/demo.png)

## Features

- CLI Diff Viewer for Hex and ASCII.

- Color highlighting for different data types to enhance readability.

- Keyboard navigation enables interactive exploration of differences.

- Displays bit position for focused data, aiding in precise location identification.

## Installation

```sh

git clone git@github.com:ztroop/dead-ringer.git && cd ./dead-ringer

cargo install --path .

```

### From the AUR

```sh

paru -S dead-ringer

```

## Usage

```

Usage: dring  

Arguments:

    Path to the first binary file

    Path to the second binary file

```

## Color Reference

|Type of Byte|Color|

|---|---|

|NULL|![#555753](https://placehold.co/10x10/555753/555753.png) Gray|

|OFFSET|![#555753](https://placehold.co/10x10/555753/555753.png) Gray|

|ASCII Printable|![#06989a](https://placehold.co/10x10/06989a/06989a.png) Cyan|

|ASCII Whitespace|![#4e9a06](https://placehold.co/10x10/4e9a06/4e9a06.png) Green|

|ASCII Other|![#4e9a06](https://placehold.co/10x10/4e9a06/4e9a06.png) Green|

|Non-ASCII|![#c4a000](https://placehold.co/10x10/c4a000/c4a000.png) Yellow|

## Alternatives

If you're looking for a full-featured Hex/ASCII viewer, check out [Hexyl](https://github.com/sharkdp/hexyl)!