🎯 Meterpreter GUI Controller

🚀 Modern GUI Interface for Controlling Meterpreter Sessions

Manage and control Meterpreter sessions easily through an intuitive graphical interface

---

✨ Key Features

🔧 Session Control 🔌 Start Listener - Easy Metasploit handler configuration 🤖 Session Manager - Manage all active sessions in table view ⌨️ Command Interface - Send commands with user-friendly interface 📊 Command Logging - Track all commands and their outputs

🎯 Advanced Features 🖼️ Screenshots - Capture screenshots from remote machines 📁 File Browser - Browse and transfer files 🎤 Audio Recording - Record target microphone audio 🗣️ Text-to-Speech - Send voice messages to target

📱 APK Backdooring

Inject Meterpreter payload into existing Android applications easily and safely.

---

📋 Prerequisites

✅ Python 3.6 or higher
✅ PyQt5 Framework
✅ Metasploit Framework
✅ Linux/macOS system (recommended)
✅ APKTool, Java JDK, ZipAlign (for APK features)

---

🚀 Quick Installation

1️⃣ Clone Repository

git clone https://github.com/yourusername/meterpreter-gui.git
cd meterpreter-gui

2️⃣ Install Python Dependencies

pip install -r requirements.txt

3️⃣ Install System Dependencies

🐧 Ubuntu/Debian

sudo apt-get update && sudo apt-get install -y \
    libxcb-xinerama0 libxcb-icccm4 libxcb-image0 \
    libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 \
    libxcb-xkb1 libxkbcommon-x11-0 python3-pyqt5.qtsvg \
    apktool default-jdk

🎩 Fedora

sudo dnf install -y \
    libxcb xcb-util-devel xcb-util-image-devel \
    xcb-util-keysyms-devel xcb-util-renderutil-devel \
    xcb-util-wm-devel apktool java-latest-openjdk

📖 Need installation help? See the complete guide in panduan_instalasi.txt

---

🎮 Usage

Run Application

python run.py

Platform Specific

# For X11 environment
python run.py --platform xcb

# For Wayland environment
python run.py --platform wayland

📱 APK Injection

1. 🎯 Open "APK Backdoor" tab
2. 📂 Select target APK file
3. ⚙️ Configure LHOST/LPORT
4. 🚀 Click "Inject APK"
5. 🎧 Start handler to receive connections

---

🔧 Troubleshooting

❗ Qt Platform Issues

# Run with Qt debugging
python run.py --debug

❗ APK Injection Issues

See installation guide for proper APKTool and Java JDK configuration.

---

⚠️ Disclaimer and Responsibility

🚨 IMPORTANT WARNING 🚨

Use of this tool is entirely at your own risk and responsibility. By using Meterpreter GUI Controller, you agree to the following terms:

📜 Terms of Use

• 🔐 Legal Use Only: This tool should ONLY be used for:

  • Authorized penetration testing
  • Security auditing of your own systems
  • Ethical cybersecurity research
  • Educational purposes in controlled environments

• ❌ PROHIBITED for:

  • Illegal access to systems you don't own
  • Cybercrime or illegal hacking activities
  • Damaging or disrupting other people's systems
  • Stealing data or personal information

🛡️ User Responsibility

1. You are fully responsible for all consequences of using this tool
2. Ensure you have permission before testing any system
3. Comply with local and international laws that apply
4. Use ethically and do not harm others

🚫 Limitation of Liability

• Developers are NOT responsible for misuse of this tool
• Developers are NOT responsible for any damage or loss that may occur
• This tool is provided "AS IS" without any warranty
• Users bear ALL RISKS of use

⚖️ Legal Aspects

WARNING: Using this tool for illegal purposes may result in:

• Criminal prosecution
• Heavy fines
• Imprisonment
• Civil lawsuits

---

🤝 Contributing

We welcome contributions from the community! Please:

1. 🍴 Fork this repository
2. 🌟 Create a new feature branch
3. 💻 Commit your changes
4. 📤 Push to the branch
5. 🔄 Create a Pull Request

---

📄 License

This project is licensed under MIT License

Made with ❤️ for the cybersecurity community

---

⭐ If this project is useful, give it a star! ⭐