https://github.com/futo-org/ret
Reverse-Engineering Tool
https://github.com/futo-org/ret
assembly disassembler reverse-engineering
Last synced: 8 months ago
JSON representation
Reverse-Engineering Tool
- Host: GitHub
- URL: https://github.com/futo-org/ret
- Owner: futo-org
- License: gpl-2.0
- Created: 2024-05-29T21:33:42.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-07-23T21:18:26.000Z (8 months ago)
- Last Synced: 2025-07-24T00:03:58.775Z (8 months ago)
- Topics: assembly, disassembler, reverse-engineering
- Language: JavaScript
- Homepage: https://ret.futo.org/
- Size: 43.5 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ret: Reverse-Engineering Tool
This is a quick and easy to use assembler/disassembler/emulator tool that runs in the browser through WebAssembly.
It's perfect for learning a new CPU architecture, quickly disassembling bytecode, or trying out ideas in assembly.
# Features
- Assemble, disassemble, and run ARM64, ARM32, RISC, and X86
- Smart hex parser and formatter - output as bytes, 32bit integers, or C arrays
- Works entirely *client-side* in the browser through WebAssembly, no server required
- Incredibly lightweight - no unnecessary JS frameworks, assets, or cookies
- Customizable and ready for self-hosting - unpack a zip of static content into your web server
## Compiling WASM
Install emscripten (`sudo apt install emscripten`). It should be installed in `/usr/share/emscripten` on Debian/Ubuntu.
If not, then you can install emsdk manually and use the [toolchain file](https://github.com/emscripten-core/emscripten/blob/main/cmake/Modules/Platform/Emscripten.cmake).
```
cmake -G Ninja -B build -DSUPPORT_ARM64=ON -DCMAKE_TOOLCHAIN_FILE=/usr/share/emscripten/cmake/Modules/Platform/Emscripten.cmake
cmake --build build
```
Run it in a web server that mimicks the deployed version:
```
python3 tool.py --serve
```
## Compiling CLI
```
cmake -G Ninja -B buildcli -DSUPPORT_ARM64=ON -DSUPPORT_ARM32=ON -DSUPPORT_X86=ON -DSUPPORT_RISCV=ON -DUNICORN_SUPPORT=OFF
cmake --build buildcli
```
# Credits
- Unicorn: https://github.com/unicorn-engine/unicorn/blob/master/COPYING
- Capstone: https://github.com/capstone-engine/capstone/blob/next/LICENSES/LICENSE.TXT
- Keystone: https://github.com/keystone-engine/keystone/blob/master/COPYING
- CodeJar: https://github.com/antonmedv/codejar/blob/master/LICENSE
- Highlight.js: https://github.com/highlightjs/highlight.js/blob/main/LICENSE
- Google Fonts icons: https://fonts.google.com/ (Apache License)