Skip to content

Raffa064/thex

Repository files navigation

THex icon

THex

THex is a powerful binary editing tool designed for the terminal. It features a vim-like interface, and offers a variety of useful tools, such as markers, data preview, and string insertion.

screenshot screenshot

Features

  • Responsive Layout
  • Ascii preview
  • Nibble to nibble edition
  • Vim-like command line
  • Adicionar marcadores
  • Preview for strings, numbers, flags, etc
  • Swap files for store markers
  • Custom language for data processing schemas

Installation

If you're using a Linux device, you can download the latest version of THex from actions.

If you're in other platforms, like Android (with Termux), you'll need to build it from source.

Supported Platforms

  • Linux: Install directly via package manager or build from source.
  • Android (Termux): Build from source.
  • MacOS: Not officially tested, but may work if built from source.
  • Windows: Not officially supported. To build from source, significant changes are required, such as switching from ncurses to PDCurses and adjusting the compiler settings.

Build

First of all, clone this repository to your local machine:

git clone https://github.com/Raffa064/thex && cd thex

Before compiling the project, ensure that the compiler, cmake and ncurses library are installed:

$ sudo apt install clang libncuses-dev cmake

After done, execute cmake to generate configurations files:

$ cmake .

Tip

This command should be called every time you add or remove files frfom src or include directories, or when changing CMakeLists.txt file.

Build options

  • -DDEBUG: Disable compiler optimizaztions, to build faster; and enables warnigs and gdb debug.

The next step is to run cmake build command, to compile and generate our executable:

$ cmake --build .

Alright, now it's ready to be executed as follows:

$ ./thex test.bin

Important

The THex editor was created and tested only on an android device (Termux environment), with clang-19, which is similar (not equivalent) to a Debian environment. So, if you encounter any issue while building at your device, open an issue describing the problem.

Contributing

If you want to contribute to the project, read the contributing guide. Thanks you for considering supporting the project!

License

This project is under the MIT License. See the LICENSE file for details.

THex has the ncurses library as a dependency, licensed under the GNU General Public License (GPL). The use of this library does not change the license of this software, but its terms must be respected.

About

Terminal hex editor

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published