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.
- 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
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.
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 andgdb
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.
If you want to contribute to the project, read the contributing guide. Thanks you for considering supporting the project!
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.