https://github.com/bfjesso/jesso-decompiler
C decompiler for Windows and Linux
https://github.com/bfjesso/jesso-decompiler
c decompiler disassembler linux make reverse-engineering windows-10
Last synced: 8 months ago
JSON representation
C decompiler for Windows and Linux
- Host: GitHub
- URL: https://github.com/bfjesso/jesso-decompiler
- Owner: bfjesso
- License: gpl-3.0
- Created: 2024-12-07T18:59:33.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-26T22:42:14.000Z (8 months ago)
- Last Synced: 2025-07-26T23:40:07.336Z (8 months ago)
- Topics: c, decompiler, disassembler, linux, make, reverse-engineering, windows-10
- Language: C
- Homepage:
- Size: 17.9 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Jesso Decompiler: A C decompiler for Windows and Linux
The Jesso Decompiler is a tool that will generate readable C code from a compiled binary. It can either read from a file, or parse a given string
of bytes. The command line interface for Linux will handle reading from an ELF binary, and the Windows graphical user interface will handle reading a
portable executable file. All bytes must be in x86-64 machine code, and when generating assembly output, it will be in Intel style syntax. The GUI for Windows
is made using [wxWidgets](https://wxwidgets.org).
This is still a work in progress. Decompiling conditions (if statements and loops) is currently being worked on.
The disassembler is also not yet fully comprehensive of the Intel instruction set.
# Installation
If you do not want to compile it yourself, there are precompiled binaries already in bin. "jdc.exe" is the GUI application for windows, and "jdc" is
the CLI for linux. As of right now, there is only a GUI available for Windows and only a CLI for Linux.
To compile the CLI on Linux you will need git, gcc, and make installed. Then clone the git repository, cd into it, and then run "make jdc".
This will compile the CLI and place it in bin/linux
```bash
git clone https://github.com/bfjesso/jesso-decompiler.git
cd jesso-decompiler
make jdc
```
To build the GUI application on Windows you can use the Visual Studio project included in this repository.
Additionally you will need [wxWidgets](https://wxwidgets.org) installed.
# CLI Usage
If you run the CLI with the -h or --help flag, you will get a list of flags that can be used with the Jesso Decompiler.
```bash
./jdc -h
```
# Disassembling
If you only want to disassemlble, you can do using the -da or --disassemble flag.
By default, it will accept a file path as the final argument. If you want to disassemble a literal string of bytes, you can do so with the -s flag.
```bash
# jdc will identify the architecture of an elf binary. If you want, you can use -x86 or -x64 to override this.
./jdc -da ./test32 # disassembling an elf binary
./jdc -da -s 55 # disassemble the byte 0x55. it will assume x64 if not overridden.
```
When disassembling a file, jdc will look for the ".text" section and read the bytes from there. Same applies when decompiling.
# Decompiling
To use the decompiler, run jdc with the -dc or --decompile flag.
By default, jdc will search the binary for symbols and apply them to function names. To disable this, use the -ns flag.
```bash
./jdc -dc ./test32 # decompiling a 32-bit elf binary
```
This will then prompt for further input. Use h for help.
To list all functions that jdc identified, use l.
To decompile a function, first select it with s and enter the index of the function when prompted. Listing all the functions with l will show each functions's index.
Once a function is selected, you can use dc to print the decompilation. It will ask if you want it to show line numbers for the decompiled function.
