Skip to content

Commit

Permalink
Merge pull request #24 from 0x00-0x00/zc00l-dev
Browse files Browse the repository at this point in the history
0.3.6
  • Loading branch information
Andre Marques (zc00l) authored Jun 21, 2018
2 parents 4c1a045 + 81c713e commit b7fd58a
Show file tree
Hide file tree
Showing 15 changed files with 1,096 additions and 225 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -7,3 +7,6 @@ dist/
dist/*
test/
test/*
.idea/*
venv/*
venv/
28 changes: 20 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
# ShellPop
## About
Pop shells like a master
Shell pop is all about popping shells. With this tool you can
generate easy and sophisticated reverse or bind shell commands
to help you during penetration tests.
Don't waste more time with .txt files storing your Reverse shells!

Shellpop is all about popping shells. With this tool you can
generate easy and sofisticated reverse or bind shell commands
to help you during penetration tests.

Don't waste more time with .txt files storing your Reverse shells!
-----
## Installation
Python 2.x is required.
Python 2.7 is required.

3.0+ version will not work.

**Required Dependencies Install**
```bash
root@kali# apt-get install python-argcomplete -y
root@kali# apt-get install python-argcomplete metasploit-framework -y
```
```bash
root@kali# pip install -r requirements.txt
Expand All @@ -32,6 +32,7 @@ root@kali# python setup.py install
* [Basics](#basics)
* [Encoders](#encoders)
* [Handlers](#handlers)
* [Meterpreter Shells](#meterpreter-shells-new)
* [Stagers](#stagers)
* [Protocols](#protocols)
* [Credits](#credits)
Expand Down Expand Up @@ -63,6 +64,11 @@ root@kali# shellpop --list

![ShellsList](img/img-shell-list.JPG?raw=true)

##### Auto-Complete [NEW]

Now shellpop has auto-complete feature. To use it, you need to forget about --number and (--reverse or --bind), just stick to --payload argument. Like the image below:

![Autocomplete](img/img-shell-autocomplete.JPG?raw=true)

### __Basics__
-----
Expand Down Expand Up @@ -132,12 +138,17 @@ Handler is a mechanism to "handle" the act of serving a socket to receive the in

Currently there is support of the following TCP handlers:
1. TCP PTY Handlers
2. TCP Handlers
2. TCP Meta-Handlers [NEW]

This means every TCP shell can have appended to their command-line argument the `--handler` option. Removing the necessity of the operator to spawn the handler (probably ncat or nc) by himself.

![Screenshot](img/handler.gif?raw=true)

### __Meterpreter Shells__ [NEW]
This feature was widely asked by people who used this tool. Now it is technically possible to upgrade all shellpop shells to meterpreter, as since 0.3.6, handler uses by default the Metasploit Framework to land shells.

![Meterpreter](img/handler-meterpreter.gif?raw=true)

-----
### __Stagers__
Stager is a mechanism of serving your payload in STAGES. Sometimes payload complexity or size can get troublesome. In such cases, you can craft a small payload which in turn can request and execute the bigger one.
Expand All @@ -161,6 +172,7 @@ Currently there is support of two protocols to land your shells:

1. TCP
2. UDP
3. ICMP (Nishang ICMP shell)

#### *Command line examples*
##### TCP is blocked but UDP is not? Let there be shell!
Expand Down
Loading

0 comments on commit b7fd58a

Please sign in to comment.