A python script to automatically generate shellcode payload from assembly files.

Requirements

To use this tool, you first need to install nasm, objdump and python3. You can install them with:

sudo apt install nasm python3

Usage

$ ./shellcoding-companion.py -h
__ _ _ _ _ _ / _\ |__ ___| | | ___ ___ __| (_)_ __ __ _ \ \| '_ \ / _ \ | |/ __/ _ \ / _` | | '_ \ / _` | _\ \ | | | __/ | | (_| (_) | (_| | | | | | (_| | \__/_| |_|\___|_|_|\___\___/ \__,_|_|_| |_|\__, |_v1.0.1
/ __\___ _ __ ___ _ __ __ _ |___/(_) ___ _ __
/ / / _ \| '_ ` _ \| '_ \ / _` | '_ \| |/ _ \| '_ \ / /__| (_) | | | | | | |_) | (_| | | | | | (_) | | | |
\____/\___/|_| |_| |_| .__/ \__,_|_| |_|_|\___/|_| |_|
By Ooggle |_| https://twitter.com/Ooggle_
usage: ./shellcoding-companion.py [-h] [-o OUTPUT] [--show] [-p2] [-p3] [-P] source [source ...]
positional arguments:
source NASM source(s) file(s). (Example: shellcode.s)
options:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output file for the shellcode. (default: None)
--show Show the output shellcode. (default: False)
Output languages
-p2, --python2 Output python2 command to generate the shellcode from command line. (default: False)
-p3, --python3 Output python3 command to generate the shellcode from command line. (default: False)
-P, --perl Output perl command to generate the shellcode from command line. (default: False)

Example usage

Echo python command to print the generated shellcode of examples/shellcode.s:

./shellcoding-companion.py examples/shellcode.s -p2

Contributing

Pull requests are welcome. Feel free to open an issue if you want to add other features.

Thanks to @Podalirius for helping setting up the project!