https://github.com/braydos-h/remote-manager
A powerful self-hosted dashboard for remotely monitoring and controlling your Windows PC. Features real-time performance charts, power controls, file management, webcam/mic capture, process control, and a built-in keylogger all accessible from any browser on your network.
https://github.com/braydos-h/remote-manager
flask python rat remote-control windows windows11 windowsdefender
Last synced: about 2 months ago
JSON representation
A powerful self-hosted dashboard for remotely monitoring and controlling your Windows PC. Features real-time performance charts, power controls, file management, webcam/mic capture, process control, and a built-in keylogger all accessible from any browser on your network.
- Host: GitHub
- URL: https://github.com/braydos-h/remote-manager
- Owner: braydos-h
- Created: 2025-06-24T02:56:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-24T04:55:54.000Z (about 1 year ago)
- Last Synced: 2025-06-24T05:36:28.850Z (about 1 year ago)
- Topics: flask, python, rat, remote-control, windows, windows11, windowsdefender
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Windows Manager
This project is a self-hosted dashboard for remotely monitoring and controlling a Windows machine. It exposes a simple web interface for common administrative tasks such as taking screenshots, adjusting system settings, viewing live performance data and browsing files.
**Administrator privileges are recommended** when running the server to enable hardware controls like brightness and volume adjustment.
## Setup
1. Ensure Python 3.10+ is installed on the host machine.
2. Install dependencies:
```bash
pip install flask psutil pillow pynput opencv-python sounddevice soundfile GPUtil wmi pycaw comtypes requests werkzeug
```
3. Start the application:
```bash
python main/main.py
```
Then open `http://localhost:5000` in a browser to access the dashboard.
## Available Endpoints
These HTTP endpoints provide the dashboard functionality and can also be called programmatically:
| Method | Path | Description |
| ------ | ---- | ----------- |
| `GET` | `/` | Dashboard HTML interface |
| `GET` | `/status` | JSON with CPU, RAM, battery, disk usage, IP information and more |
| `POST` | `/action/` | Power actions (`lock`, `restart`, `shutdown`, `sleep`, `hibernate`) |
| `GET/POST` | `/brightness` | Get or set display brightness |
| `GET/POST` | `/volume` | Get or set master volume |
| `GET` | `/screenshot` | Current screen capture (PNG) |
| `GET` | `/webcam` | Snapshot from default webcam (JPEG) |
| `GET` | `/mic` | Capture audio for 5 seconds (WAV) |
| `POST` | `/keylogger/` | Control the keylogger |
| `GET` | `/keylogs` | Retrieve recent keystrokes |
| `GET` | `/processes` | List running processes |
| `POST` | `/process//kill` | Terminate a process |
| `POST` | `/process/start` | Start a new process (JSON body with `cmd`) |
| `GET` | `/files?path=` | List files or download a file |
| `GET` | `/download?path=` | Download the specified file |
| `POST` | `/upload` | Upload a file (multipart form) |
## Security Considerations
The server exposes powerful system controls. Run it only on trusted networks and restrict access with a firewall or VPN. Administrator privileges allow deeper integration (brightness control, volume control, process management) but also increase risk if the service is exposed. Use strong passwords or additional authentication if deploying beyond a local test environment.