Shellcoder.py 🐚⌨️

Write your shellcode in Assembly (NASM) and compile it on Windows x64 with one command!

This script helps automate the shellcode development and testing process. It takes your Assembly file with the payload (shellcode.asm) and generates a bunch of useful executable files (read below).

You don't have to repeat all these tedious activities anymore to make your shellcode executable! Keep your focus on shellcoding 🔥🐚🔥

Installation

The following software must be installed on your system:

Python 3
NASM (Netwide Assembler)
Visual Studio 2022

No Python dependencies are necessary! You are ready to go.

Usage

Write your shellcode in shellcode.asm
Run python shellcoder.py
Execute out/malware.exe file!

Output files

The output files of this script are stored in out/ directory:

malware.c - loader code with the injected payload as C string.
malware.exe - compiled loader with the injected payload.
shellcode.exe - executable file with the payload only. Great for debugging!
shellcode.bin - raw machine code of the assembly payload.

Caveats

Indicate that you are using 64-bit mode at the beginning of the assembly file. Add [bits 64] to the shellcode.asm.
Define entry point in assembly file (required for debugging):

[bits 64]

section .text:
    global _start

_start:
[...YOUR CODE HERE...]

You cannot use sections other than .text. It's a shellcode!
Remember about Microsoft x64 Calling Convention (stack alignment + shadow space!)

How to debug the payload?

The best way to debug your assembly code is to take out/shellcode.exe file and load it into your favorite debugger.

Finally you should run out/malware.exe to be sure that your payload works as intended after memory injection.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly