https://github.com/ShutdownRepo/shellerator

Simple CLI tool for the generation of bind and reverse shells in multiple languages
https://github.com/ShutdownRepo/shellerator

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/ShutdownRepo/shellerator
• Owner: ShutdownRepo
• License: gpl-3.0
• Created: 2020-04-13T18:36:56.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-04-16T23:32:00.000Z (5 months ago)
• Last Synced: 2024-05-13T19:32:47.759Z (4 months ago)
• Language: Python
• Homepage:
• Size: 5.82 MB
• Stars: 344
• Watchers: 14
• Forks: 50
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hacking-lists - ShutdownRepo/shellerator - Simple CLI tool for the generation of bind and reverse shells in multiple languages (Python)

README

        
# 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...).

Another similar project for the generation of one-line file downloading commands is based on this code [Uberfile](https://github.com/ShutdownRepo/uberfile)

This project is installed by default in the pentesting OS [Exegol](https://github.com/ShutdownRepo/Exegol)

![Example (with menus)](https://raw.githubusercontent.com/ShutdownRepo/shellerator/master/assets/example-menus.gif)

# Install

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

```

git clone https://github.com/ShutdownRepo/shellerator

cd shellerator

python3 setup.py install --user

```

# 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

  -l, --list            Print all the types of shells shellerator can generate

  -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

Reverse shell options:

  -t TYPE, --type TYPE    Type of the shell to generate (Bash, Powershell, Java...)

  -i LHOST, --ip LHOST    Listener IP address

  -p LPORT, --port LPORT  Listener Port

```

If required options are not set, the tool will start in TUI (Terminal User Interface) with pretty menus but CLI works like a charm too.

![Example (without menus)](https://raw.githubusercontent.com/ShutdownRepo/shellerator/master/assets/example-no-menus.gif)

# To-Do List

## Things to add

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

- Add bindshells

- Add encrypted shells and separate them from bind/rev ?

- Add webshells

- Add some kind of option to help user get info on how to improve shell/tty (rlwrap, stty, ConPty (cf. PayloadsAllTheThings))

# Sources & credits

This project is inspired by [Print-My-Shell](https://github.com/sameera-madushan/Print-My-Shell/).

Some commands come from the following links

- https://github.com/swisskyrepo/PayloadsAllTheThings/blob/master/Methodology%20and%20Resources/Reverse%20Shell%20Cheatsheet.md

- http://pentestmonkey.net/cheat-sheet/shells/reverse-shell-cheat-sheet

- https://www.hackingtutorials.org/networking/hacking-netcat-part-2-bind-reverse-shells/

- https://ashr.net/bind/and/reverse/shell/cheatsheet/windows/and/linux.aspx