Skip to content

rushyaayt/Automated-Payload-Helper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 

Repository files navigation

1. Automated-Payload-Helper

Automated Payload Helper is a lightweight, efficient Bash-based Command Line Interface (CLI) utility designed for cybersecurity professionals, penetration testers, and ethical hacking students.

The tool streamlines the post-exploitation workflow by automating the repetitive syntax of Metasploit's msfvenom and msfconsole. It enables users to generate target-specific payloads and automatically structure handler resource files (.rc) with a single command line wizard, eliminating manual entry errors.


🛠️ Key Features

  • Streamlined Cross-Platform Generation: Generate standalone payloads for both Windows (Portable Executables) and Linux (Executable and Linkable Format) dynamically.
  • Automated Resource Scripting: Automatically generates custom Metasploit Resource scripts (.rc) matching your session handler criteria.
  • One-Click Multi-Handler Integration: Spawns a configured Metasploit multi-handler listener in the background instantly without navigating the standard interactive MSF console setup.
  • Clean ANSI Logging: Built-in color-coded diagnostic levels ([+] Success, [-] Error, [*] Information) for clean output readability.

📋 Prerequisites

Ensure your host environment meets the following requirements before executing the tool:

  • Operating System: Linux (Kali Linux, Parrot Security OS, or Ubuntu recommended)
  • Dependencies: Metasploit Framework installed and mapped to your system's global $PATH variable (msfvenom and msfconsole must be accessible).

🚀 Installation & Setup

Execute the following commands sequentially within your terminal environment to deploy the script:

1. Clone the Repository

git clone [https://github.com/rushyaayt/Automated-Payload-Helper.git](https://github.com/rushyaayt/Automated-Payload-Helper.git)
cd Automated-Payload-Helper
cd Payload_Scripts

This tool uses msfvenom to quickly create a payload and create a resource file to start its 'Listener'. (Note: You will need to have Metasploit installed on your system to run this).

2. Enter this command to allow the script to execute:

chmod +x payload_helper.sh

3. Let's run the tool:

./payload_helper.sh

What happens when this tool runs?

  • ⭕ The script asks you for your LHOST (IP Address) and LPORT. (You can use ifconfig or ip a command in another terminal to find your IP).
  • ⭕ It then asks you whether you want a Windows (exe) or Linux (elf) payload (press 1 or 2 and enter).
  • ⭕ As soon as you do this, msfvenom will start in the background and a file called backdoor.exe or backdoor.elf will be created in your folder.
  • ⭕ Along with this, a resource file named listener.rc will be created. As per the instructions at the end, you can directly start Metasploit's hacking listener by entering the command msfconsole -r listener.rc.

📖 Operational Workflow

  • 1️⃣ Upon startup, the script prompts for the Listener Host configuration (LHOST - your local or listener IP address).
  • 2️⃣ Input the destination port (LPORT, e.g., 4444).
  • 3️⃣ Select your target architecture deployment profile:
    • ⭕ Option 1 : Windows Architecture (windows/meterpreter/reverse_tcp) -> Outputs backdoor.exe
    • ⭕ Option 2 : Linux Architecture (linux/x64/meterpreter/reverse_tcp) -> Outputs backdoor.elf
  • 4️⃣ The tool constructs the raw binaries alongside a unified listener.rc execution profile.
  • 5️⃣ Launch your automated listener instance instantly by using the terminal command provided at execution termination:
  • msfconsole -r listener.rc

2. Reverse Shell Payload Generator

A highly versatile script designed to quickly output customized, multi-language interactive reverse shell strings for rapid use during capture-the-flag (CTF) challenges or authorized lab assessments.

🚀 Usage Guide

# Grant execution permissions
chmod +x rev_gen.py

# Launch the generation script
python3 rev_gen.py

3. Payload Encoder / Obfuscator (Node.js Tool)

A lightweight cryptographic and structural script used to encode raw payloads, assisting security researchers in studying detection mechanics and anti-virus evasion behaviors.

📋 Environment Setup

Ensure Node.js is deployed on your system before proceeding:

# Update local packages and install Node.js runtime
sudo apt update
sudo apt install nodejs -y

🚀 Execution Profile

# Grant execution permissions to the encoder script
chmod +x encoder.js

# Execute the tool via Node.js
node encoder.js

⚠️ Legal Disclaimer

[!WARNING]

This software utility is developed strictly for Educational Purposes Only and Authorized Penetration Testing Assessments where proper managerial sign-off and explicit scopes of work have been established. Utilizing this tool against infrastructures without explicit prior consent is unlawful and constitutes a breach of computer misuse acts globally. The developer assumes no legal accountability for unauthorized utilization or collateral infrastructure impairments

🤝 Acknowledgments

  • Special thanks to my own automated AI agent and my close partner-friend for continuous technical collaboration.
  • Developed and maintained with passion by Ayushya (rushyaayt).

🥰 Special Thanks to my own agent and my partner friend.

Hayo i am ayushya

About

Automated Payload Helper

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors