Skip to content

Simple CLI tool for the generation of bind and reverse shells in multiple languages

Notifications You must be signed in to change notification settings

lx6XC/shellerator

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Shellerator

Shellerator is a simple command-line tool aimed to help pentesters quickly generate one-liner reverse/bind shells in multiple languages (Bash, Powershell, Java, Python...). This project is inspired by Print-My-Shell. I just rewrote it and added some options and glitter to it. The lists of reverse and bind shells are not perfect yet. I'll work on this when I have the time to. I'll be happy to review pull requests too :)

Example

Install

The install is pretty simple, just clone this git and install the requirements.

git clone https://github.com/ShutdownRepo/shellerator
pip3 install --user -r requirements.txt

Usage

Usage is dead simple too.

usage: shellerator.py [-h] [-b | -r] [-t TYPE] [-p LPORT] [-i LHOST]

Generate a bind/reverse shell

optional arguments:
  -h, --help              show this help message and exit
  -b, --bind-shell        Generate a bind shell (you connect to the target)
  -r, --reverse-shell     Generate a reverse shell (the target connects to you) (Default)

Bind shell options:
  -t TYPE, --type TYPE    Type of the shell to generate (Bash, Powershell, Java...)
  -p LPORT, --port LPORT  Listener Port (required for reverse shells) (Default: 1337)

Reverse shell options:
  -t TYPE, --type TYPE    Type of the shell to generate (Bash, Powershell, Java...)
  -i LHOST, --ip LHOST    Listener IP address (required for reverse shells)
  -p LPORT, --port PORT   Listener Port (required for reverse shells) (Default: 1337)

Bind shell

python3 shellerator.py --bind-shell --port 1337

Reverse shell

If you want to generate reverse shells (choice by default), you'll need to supply the listener IP address and port.

python3 shellerator.py -i/--ip 192.168.56.1 -p/--port 1337
python3 shellerator.py -r/--reverse-shell -i/--ip 192.168.56.1 -p/--port 1337

Without a CLI menu

If you already know what type of shell you want to generate and don't have time to select the language in the beautiful CLI menu, you can set it with the appropriate -t (or --type) option.

python3 shellerator.py [-r | -b] -t/--type bash -i/--ip 192.168.56.1 -p/--port 1337

To-Do List

Things to add

Here are some things to add that I have in mind, I'll work on that asap

  • Add a -l/--list option for bind/revshell to list the types of shell in the DB (php, python, powershell, bash and so on)
  • Add binshells
  • Add somekind of option to help user get info on how to improve shell/tty (rlwrap, stty, ConPty (cf. PayloadsAllTheThings))

Sources

Shells mostly come from the following links

About

Simple CLI tool for the generation of bind and reverse shells in multiple languages

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%