/hexit

A minimalistic hex editor.

Primary LanguageC++MIT LicenseMIT

Contributors Forks Stargazers Issues MIT License


Hexit

A minimalistic Hex-Editor!

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Controls
  5. License

About The Project

Product Name Screen Shot

  • Hexit is a easy to use program used to view and edit binary files.
  • Hexit allows editing the raw data contents of a file, instead of other programs which attempt to interpret the data for you.
  • Hexit's UI is separated into three visual areas: an address area on the left, a hexadecimal area in the center, and a character area on the right.

Built With

  • C

Getting Started

Prerequisites

  • gcc(c++-20 support is needed)
  • Make
  • CMake(3.23 or greater)
  • libncurses-dev

Installation

  1. Clone the repo 
    git clone https://github.com/marprok/hexit.git
  2. Cd into the directory 
    cd hexit
  3. Make a direcoty named "build" and cd into it 
    mkdir build && cd build
  4. Create build files 
    cmake -DCMAKE_BUILD_TYPE=Release ..
  5. Build the Project 
    make

Usage

  • Help Page:

    • ./hexit -h

  • Display the hex dump of a file:

    • ./hexit -f (--file) <file> [options]

  • Options:

    • Hexadecimal or decimal byte offset to seek during startup: -o (--offset) <offset>

  • If no file is given via the -f flag, then Hexit will read bytes from standard input until EOF is reached. When displaying the hex dump of standard input, saving will do nothing.

Controls

Key Function
ctrl + S Save the file
ctrl + X Toggle HEX mode
ctrl + A Toggle ASCII mode
ctrl + Q Exit the editor
ctrl + G Go to byte
Arrows keys Move the cursor
Page-up/Page-down Move the page up/down

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)