README.md

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!