Introduction

      Threebe is a Libre (FOSS - Free and Open Source) tool for displaying a Hexdump /
      / Disassembly / Strings / Information from/of a (binary) file
      and (at this time) is fully written in Python3.

Screenshots

Hexdump (-h option):

Hexdump - wide (-h32 option):

Disassembly (-dx86 option):

Color Schemes:

Color scheme nr. 2:

Color scheme nr. 3 (Windows CMD mode):

Information extracting / Patching a binary (-i, -pb options):

Strings extracting (-sb option):

Installation

Threebe is written from the ground up in pure Python3 (without any dependencies), so to run it, you only need to have Python3 installed on your system. (On Windows you may need to add Python3 to your system PATH.)

Link to python website: https://www.python.org/

Installation:

git clone https://gitlab.com/Ernest1337/Threebe.git
cd Threebe
python3 Threebe.py --help

Usage

Make sure you are in the Threebe directory before you begin. (You can also add this directory to your PATH, then you will be able to run Threebe from any place you want.)

General usage:

python3 Threebe.py [parameter(s)] [file_name/or/path/to/file]   or   ./Threebe.py [parameter(s)] [file_name/or/path/to/file]

You can get a list of all possible parameters by running command:

./Threebe --help

Features

This is a list of current features:

Hexdump / Hexdump at a given address
Information about binary
Extracting strings
Binary patching
x86 disassembly (partially)
(more in the future)

Supported architectures

Disassembly:

x86 (not fully completed)
(There will be more in the future)

Hexdump, strings, pathing:

All architectures will "probably" work. (If you have problems with an architecture please open an issue for that.)

Operating systems

Threebe is cross-platform and can be run on any operating system which allows to install python3.

Color Schemes

To change color scheme of Threebe, edit the colorScheme variable at the top of the Colors.py file inside of Functions directory. (Path: Threebe/Functions/Colors.py)

Color schemes to choose from:

1 (Default)
2 (Slightly darker)
3 (Clean / Windows CMD mode)

For Windows users

If you are using Windows CMD and experiencing weird text rendering, this is because CMD doesn't support using ANSI escape codes which i'm using to make output colorful. To solve this issue you need to set color scheme (see: Color Schemes section) to a value of 3 (windows cmd mode).

Contribution

If you want to contribute to this project, feel free to do that. Any help is much appreciated.

Ernest1338/Threebe