This tool is for AUTHORIZED USE ONLY on systems you own or have explicit permission to manage.
Unauthorized use of this tool to access, monitor, or control systems without proper authorization may violate:
- Computer Fraud and Abuse Act (CFAA) in the United States
- Computer Misuse Act in the United Kingdom
- Similar cybercrime laws in other jurisdictions
- Ethical guidelines and professional codes of conduct
Use this tool responsibly and legally. The developers are not responsible for any misuse.
Injector is a Python-based remote administration tool with a client-server architecture designed for managing multiple Windows machines. It provides comprehensive remote management capabilities including file transfer, system monitoring, and visual capture.
┌─────────────────────────────────────────────────────────────┐
│ Injector Server (Python) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ HTTP Server │ │ Command │ │ File Management │ │
│ │ (Threaded) │ │ Queue │ │ (Upload/Download) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Interactive Menu System ││
│ │ - Color-coded ASCII interface ││
│ │ - Multi-client management ││
│ │ - Real-time command execution ││
│ └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Remote Admin Client (VBScript) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Auto- │ │ Command │ │ File Transfer │ │
│ │ Registration│ │ Execution │ │ (Upload/Download) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ - Screenshot Capture (nircmd/PowerShell) ││
│ │ - Webcam Capture (DirectShow/FFmpeg/fswebcam) ││
│ │ - System Information Gathering ││
│ └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
- ✅ Multi-PC management capability
- ✅ Client-server architecture
- ✅ HTTP-based communication
- ✅ Multi-threading for concurrent connections
- ✅ Command queuing system
- ✅ Real-time result reporting
- ✅ System information gathering
- ✅ Running processes listing
- ✅ Drive information
- ✅ Directory listing
- ✅ Remote command execution
- ✅ Administrative command execution
- ✅ User messaging
- ✅ Remote reboot/shutdown/logoff
- ✅ Upload files to clients
- ✅ Download files from clients
- ✅ Base64 encoding for safe transfer
- ✅ Progress reporting
- ✅ Error handling
- ✅ Screenshot capture (nircmd.exe preferred, PowerShell fallback)
- ✅ Webcam capture (DirectShow, FFmpeg, fswebcam fallbacks)
- ✅ Automatic timestamping
- ✅ Image viewing capability
- Python 3.6 or higher
- Windows, Linux, or macOS
- Network connectivity between server and clients
- Windows 7 or higher (Windows 10 recommended)
- PowerShell (for fallback methods)
- Optional: nircmd.exe for screenshot capture
- Optional: FFmpeg for webcam capture
# Clone or download the repository
cd injector-remote-admin
# No additional Python packages required!
# The server uses only standard library modulesThe server will automatically create the following directories on first run:
./
├── uploads/ # Files to be sent to clients
├── downloads/ # Files received from clients
├── screenshots/ # Screenshot captures from clients
└── webcam/ # Webcam images from clients
# Default port (8080)
python injector_server.py
# Custom port
python injector_server.py 8081
# With specific host (for remote access)
python injector_server.py 8080| Argument | Description | Default |
|---|---|---|
[port] |
Server port number | 8080 |
Copy remote_admin.vbs to the target Windows machine(s).
Method 1: Double-click
- Simply double-click the
remote_admin.vbsfile - Uses default server URL:
http://localhost:8080
Method 2: Command Line
# Connect to local server
cscript remote_admin.vbs
# Connect to remote server
cscript remote_admin.vbs http://your-server-ip:8080
# Run minimized (no console window)
wscript remote_admin.vbs http://your-server-ip:8080- The client automatically registers with the server on first run
- A unique client ID is generated and saved to
injector_client_id.txt - The client maintains a persistent connection, polling for commands
The server provides an interactive color-coded menu system:
_____ _ _ _____ _
| ___| | ___ ___| |_|_ _|__ _ __ ___ ___ __| |
| |_ | |/ _ \/ __| __|| |/ _ \ '_ ` _ ` _ \/ _ \/ _` |
| _| | | __/ (__| |_ | | __/ | | | | | | | __/ (_| |
|_| |_|\___|\___|\__||_|\___|_| |_| |_| |_|\___|\__,_|
_____ _ _ _____ _____ ____ _ _ _____ ____
|_ _| | | |_ _| ____| _ \| | | |_ _| _ \
| | | | | | | | | _| | |_) | | | | | | | |_) |
| | | |_| | | | | |___| _ <| |_| | | | | _ <
|_| \___/ |_| |_____|_| \_\\___/ |_| |_| \_\
================================================================================
Injector Remote Administration Tool
Server running on port 8080
================================================================================
MAIN MENU:
1. Send command to specific PC
2. Send command to all PCs
3. View command results
4. View screenshots
5. View webcam images
6. Upload file to PC
7. Download file from PC
8. Exit
- Select a specific client from the list
- Choose a command to execute
- Provide any required arguments
- Command is queued and sent to the selected client
- Send the same command to all connected clients
- Useful for broadcast messages or system-wide operations
- View results from executed commands
- Results are displayed with timestamps
- Automatically cleared after viewing
- Browse captured screenshots from clients
- Open screenshot files directly
- View file sizes and timestamps
- Browse captured webcam images from clients
- Open image files directly
- View file sizes and timestamps
- Select a file from the
uploads/directory - Send it to a specific client
- Client saves the file to its temporary directory
- Request a file from a client
- Specify the file path on the client
- File is saved to the
downloads/directory on the server
- Shutdown the server
- Exit the application
| Command | Description | Arguments | Example |
|---|---|---|---|
sysinfo |
Get system information | None | sysinfo |
processes |
List running processes | None | processes |
drives |
List available drives | None | drives |
dir |
List directory contents | path |
dir C:\ |
exec |
Execute command | command |
exec ipconfig /all |
runas |
Run as administrator | command |
runas net user |
msg |
Send message to user | message |
msg Hello from server |
screenshot |
Capture screenshot | None | screenshot |
webcam |
Capture webcam image | None | webcam |
reboot |
Reboot system | None | reboot |
shutdown |
Shutdown system | None | shutdown |
logoff |
Log off user | None | logoff |
upload_file |
Upload file to client | filename, data |
(Internal) |
download_file |
Download file from client | path |
(Internal) |
Command: sysinfo
Result:
System Information:
==================
Hostname: CLIENT-PC
Username: JohnDoe
OS: Windows 10
OS Version: 10.0.19045
OS Architecture: AMD64
Processor: Intel(R) Core(TM) i7-8700K CPU @ 3.70GHz
Total Memory: 16384 MB
System Uptime: 2 days, 3 hours, 15 minutes, 30 seconds
Current Time: 12/15/2024 2:30:45 PM
Command: dir C:\Users
Result:
Directory Listing: C:\Users
=================
Files:
------
Subdirectories:
---------------
JohnDoe
Public
Default
Default User
Command: exec ipconfig /all
Result:
Command Output:
Windows IP Configuration
Host Name . . . . . . . . . . . . : CLIENT-PC
Primary Dns Suffix . . . . . . . : example.com
Node Type . . . . . . . . . . . . : Hybrid
IP Routing Enabled. . . . . . . . : No
WINS Proxy Enabled. . . . . . . . : No
DNS Suffix Search List. . . . . . : example.com
Ethernet adapter Ethernet:
Connection-specific DNS Suffix . : example.com
Link-local IPv6 Address . . . . . : fe80::1234:5678:90ab:cdef%19
IPv4 Address. . . . . . . . . . . : 192.168.1.100
Subnet Mask . . . . . . . . . . . : 255.255.255.0
Default Gateway . . . . . . . . . : 192.168.1.1
injector-remote-admin/
├── injector_server.py # Main server script
├── remote_admin.vbs # Client VBScript
├── README.md # This documentation
├── uploads/ # Files to send to clients
│ └── example.txt # Example upload file
├── downloads/ # Files received from clients
│ └── 20241215_143022_client123_file.txt
├── screenshots/ # Screenshot captures
│ └── screenshot_20241215_143022_client123.png
└── webcam/ # Webcam images
└── webcam_20241215_143022_client123.jpg
- Place file in
uploads/directory on server - Select "Upload file to PC" from menu
- Choose the file and target client
- Client receives and saves the file
- Select "Download file from PC" from menu
- Specify file path on client
- Client reads and sends the file
- Server saves to
downloads/directory
The client captures screenshots using the following priority:
-
nircmd.exe (Preferred)
- Fast and reliable
- Download from: https://www.nirsoft.net/utils/nircmd.html
- Place in
C:\Windows\orC:\Windows\System32\
-
PowerShell (Fallback)
- Uses .NET System.Drawing
- Works on most Windows systems
- No additional dependencies
The client captures webcam images using the following priority:
-
DirectShow (PowerShell)
- Native Windows media capture
- Requires Windows 10+ for full functionality
-
FFmpeg
- Cross-platform
- Download from: https://ffmpeg.org/
- Add to system PATH
-
fswebcam
- Linux/WSL compatible
- Install via package manager
- Select "View screenshots" or "View webcam images" from menu
- Browse available images with timestamps
- Select an image to open with default viewer
- Or choose "open" to open the directory in file explorer
Edit injector_server.py to customize:
# Change default port
DEFAULT_PORT = 8080
# Change directory names
UPLOADS_DIR = "uploads"
DOWNLOADS_DIR = "downloads"
SCREENSHOTS_DIR = "screenshots"
WEBCAM_DIR = "webcam"
# Change color scheme
class Colors:
HEADER = '\033[95m' # Purple
OKBLUE = '\033[94m' # Blue
OKGREEN = '\033[92m' # Green
WARNING = '\033[93m' # Yellow
FAIL = '\033[91m' # RedEdit remote_admin.vbs to customize:
' Change default server URL
Const SERVER_URL = "http://localhost:8080"
' Change temporary directory
Const TEMP_DIR = "injector_temp"
' Change file names
Const SCREENSHOT_FILE = "injector_screenshot.png"
Const WEBCAM_FILE = "injector_webcam.jpg"This tool is designed for authorized use only in controlled environments. It has the following security considerations:
- No Authentication: The server does not implement client authentication by default
- No Encryption: Communication is not encrypted (HTTP, not HTTPS)
- No Authorization: Any client can connect to the server
- Clear Text: All commands and data are transmitted in clear text
For production use, implement the following security measures:
- Run server on internal network only
- Use firewall rules to restrict access
- Consider using VPN for remote connections
- Add HTTP Basic Authentication
- Implement client certificates
- Use API keys for client registration
- Use HTTPS instead of HTTP
- Implement TLS/SSL certificates
- Encrypt sensitive data before transmission
- Implement client whitelisting
- Add IP-based access control
- Use role-based permissions
- Enable detailed logging
- Monitor client connections
- Set up alerts for suspicious activity
| Issue | Solution |
|---|---|
| Port already in use | Change port or stop conflicting service |
| Permission denied | Run with administrator privileges |
| Module not found | Install required Python modules |
| Connection refused | Check firewall settings |
| Issue | Solution |
|---|---|
| Cannot connect to server | Verify server URL and network connectivity |
| Screenshot capture fails | Install nircmd.exe or enable PowerShell |
| Webcam capture fails | Install FFmpeg or check camera permissions |
| Command execution fails | Check user permissions on client |
Enable debug output in the server:
# In injector_server.py, add debug logging
def log_debug(message):
print(f"{Colors.OKBLUE}[DEBUG] {message}{Colors.ENDC}")| Code | Meaning | Action |
|---|---|---|
| 400 | Bad Request | Check request parameters |
| 404 | Not Found | Verify endpoint URL |
| 500 | Server Error | Check server logs |
| 503 | Service Unavailable | Server is busy or down |
- Thread Pool: The server uses threading for concurrent connections
- Command Queue: Commands are queued and processed sequentially per client
- Memory Usage: Results are stored in memory and cleared after viewing
- Polling Interval: Client polls for commands every 2 seconds
- Heartbeat: Client sends ping every 5 seconds
- Cleanup: Temporary files are cleaned up automatically
- Maximum Clients: Limited by system resources and thread pool
- Command Throughput: Depends on network latency and client processing speed
- File Transfer: Base64 encoding adds ~33% overhead to file size
- Initial release
- Basic client-server architecture
- Core command execution
- File transfer capabilities
- Screenshot and webcam capture
- Interactive menu system
This project is provided as-is for educational and authorized use purposes only. No warranty is expressed or implied.
Important: Before using this tool, ensure you have proper authorization for all systems you intend to manage. Unauthorized use may result in legal consequences.
- Inspired by legitimate remote administration tools
- Built with Python's standard library
- VBScript client for maximum Windows compatibility
- Color-coded interface for better user experience
For issues, questions, or suggestions:
- Check this documentation for setup and usage instructions
- Review the code for implementation details
- Test in a controlled environment before production use
- Ensure proper authorization for all target systems
THIS TOOL IS FOR AUTHORIZED USE ONLY.
By using this software, you agree to:
- Only use it on systems you own or have explicit permission to manage
- Comply with all applicable laws and regulations
- Respect privacy and ethical guidelines
- Accept full responsibility for your actions
The developers are not responsible for any misuse of this tool.
Last updated: 10/2026