shellcodedbg

Advanced shellcode analysis & debugging toolkit for Linux

A powerful command-line tool for analyzing, disassembling, debugging, and encoding shellcode. Supports both x86 and x86-64 architectures with an interactive ptrace-based debugger.

✨ Features

Command	Description
-analyze	Hex dump + pattern detection + full disassembly
-run	Execute shellcode via mmap RWX
-debug	Step-by-step ptrace debugger with register view
-asm	Assemble NASM source to shellcode bytes
-bytes2asm	Convert raw bytes to NASM assembly
-convert	Export to C / Python / hex / base64 / NASM
-encode	XOR encoder with decoder stub generator
-stats	Byte frequency analysis and entropy
-decompile	Pseudo-C output (Ghidra-like)

🎯 Pattern Detection

Detects and classifies common shellcode patterns:

• [!] Critical: /bin/sh strings, NOP sleds, execve/system calls
• [~] Important: syscalls (int 0x80, syscall), dup2, connect, socket
• [ ] Normal: exit, ret, register clearing

📦 Installation

From Source

git clone https://github.com/kotbendi/shellcodedbg.git
cd shellcodedbg
make
sudo make install