yuanyuanxiang/simpleremoterA remote control program based on Gh0st: 实现了终端管理、进程管理、窗口管理、远程桌面、文件管理、语音管理、视频管理、服务管理、注册表管理等功能，优化全部代码及整理排版，修复内存泄漏缺陷，程序运行稳定。项目代码仅限于学习和交流用途。
[!WARNING] Important Legal Notice
This software is intended solely for educational purposes and authorized use cases such as:
- Remote IT administration within your own organization
- Authorized penetration testing and security research
- Personal device management and technical learning
Unauthorized access to computer systems is illegal. Users are fully responsible for compliance with all applicable laws. The developers assume no liability for misuse.
SimpleRemoter is a full-featured remote control solution, rebuilt from the classic Gh0st framework using modern C++17. Started in 2019, it has evolved into an enterprise-grade remote management tool supporting both Windows and Linux platforms.
Original Source: zibility/Remote | Started: 2019.1.1
Please read the following statement carefully before using this software:
Lawful Use: This project is intended solely for legitimate technical research, educational exchange, and authorized remote management. It is strictly prohibited to use this software for unauthorized access to others' computer systems, data theft, privacy surveillance, or any other illegal activities.
User Responsibility: Users must comply with the laws and regulations of their country/region. Any legal liability arising from the use of this software shall be borne by the user.
No Warranty: This software is provided "as is" without any express or implied warranties, including but not limited to warranties of merchantability or fitness for a particular purpose.
Limitation of Liability: The developers shall not be liable for any direct, indirect, incidental, special, or consequential damages arising from the use, misuse, or inability to use this software.
Copyright Notice: This project is open-sourced under the MIT License, allowing free use, modification, and distribution, provided that the original copyright notice is retained.
By continuing to use this software, you acknowledge that you have read, understood, and agreed to all the above terms.
[!IMPORTANT] Network Connection & Privacy Notice
The master program (server) communicates with the authorization server based on license status:
License Type Connection Behavior Trial Version Maintains persistent connection to authorization server V1/V2 Licensed Connects at startup for verification, disconnects after V2 Offline License No connection to authorization server required Unless offline authorization is obtained, the master program will exchange necessary data with the authorization server (e.g., detecting cracking attempts, validating license status).
By using this software, you accept the data transmission between the master program and the authorization server. If you do not agree, please do not use this software.
| Process Management | Window Management |
|---|---|
 |  |
| Video Management | Audio Management |
|---|---|
 |  |
┌─────────────────────────────────────────────────────────┐
│ IOCP Communication Model │
├─────────────────────────────────────────────────────────┤
│ • I/O Completion Ports: Most efficient async I/O on │
│ Windows │
│ • Single master supports 10,000+ concurrent connections │
│ • Supports TCP / UDP / KCP transport protocols │
│ • Auto-chunking for large packets (max 128KB send buf) │
└─────────────────────────────────────────────────────────┘
Intelligent quality adjustment system based on RTT (Round-Trip Time):
// 77-byte protocol header + filename + data payload
struct FileChunkPacketV2 {
uint8_t cmd; // COMMAND_SEND_FILE_V2 = 85
uint64_t transferID; // Transfer session ID
uint64_t srcClientID; // Source client ID (0=master)
uint64_t dstClientID; // Destination client ID (0=master, C2C)
uint32_t fileIndex; // File index (0-based)
uint32_t totalFiles; // Total file count
uint64_t fileSize; // File size (supports >4GB)
uint64_t offset; // Current chunk offset
uint64_t dataLength; // Current chunk data length
uint64_t nameLength; // Filename length
uint16_t flags; // Flags (FFV2_LAST_CHUNK, etc.)
uint16_t checksum; // CRC16 checksum (optional)
uint8_t reserved[8]; // Reserved for extension
// char filename[nameLength]; // UTF-8 relative path
// uint8_t data[dataLength]; // File data
};
Features:
%TEMP%\FileTransfer\)┌─────────────────────────────────────────────────────────────────────────────┐
│ Multi-Layer Authorization Architecture │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────┐ │
│ │ Super Admin │ │
│ │ (Authorization │ │
│ │ Server) │ │
│ └─────────┬───────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ │ V2 License │ V2 License │ V2 License │
│ │ (ECDSA) │ (ECDSA) │ (ECDSA) │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Layer-1 A │ │ Layer-1 B │ │ Layer-1 C │ ◄── Independent │
│ │ │ │ │ │ │ & Isolated │
│ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │
│ │ │ │ │
│ ┌────────┴────────┐ │ ┌──────┴──────┐ │
│ │ V1 License │ │ │ V1 License │ │
│ ▼ ▼ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ... ┌──────────┐ ┌──────────┐ │
│ │ Sub A1 │ │ Sub A2 │ │ Sub C1 │ │ Sub C2 │ │
│ │ Master │ │ Master │ │ Master │ │ Master │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Clients │ │ Clients │ │ Clients │ │ Clients │ │
│ │ 10,000+ │ │ 10,000+ │ │ 10,000+ │ │ 10,000+ │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
├─────────────────────────────────────────────────────────────────────────────┤
│ License Type Verification Features │
│ ───────────────────────────────────────────────────────────────────────── │
│ V2 License ECDSA P-256 Signature Offline verify, connection limits │
│ V1 License HMAC + Online Verify Connects to upstream server │
│ Trial Online Verify Limited features, always connected │
└─────────────────────────────────────────────────────────────────────────────┘
The master program YAMA.exe provides a graphical management interface:
Runtime Forms:
| Type | Description |
|---|---|
ghost.exe | Standalone executable, no external dependencies |
No compilation required, download and run:
YAMA.exe and enter the license info (see trial license below)[!TIP] For initial testing, run both master and client on the same machine using
127.0.0.1as the server address.
# 1. Clone the repository (must use git clone, do not download as zip)
git clone https://github.com/yuanyuanxiang/SimpleRemoter.git
# 2. Open the solution
# Open SimpleRemoter.sln with VS2019+
# 3. Select configuration
# Release | x86 or Release | x64
# 4. Build
# Build -> Build Solution
Common Issues:
Master and clients are on the same LAN, clients connect directly to master IP:Port.
Client ──> VPS (FRP Server) ──> Local Master (FRP Client)
For detailed configuration, please refer to: Reverse Proxy Deployment Guide
Starting from v1.2.4, a trial password is provided (2-year validity, 20 concurrent connections, intranet only):
Authorization: Bound by computer IP
Master IP: 127.0.0.1
Serial: 12ca-17b4-9af2-2894
Password: 20260201-20280201-0020-be94-120d-20f9-919a
Verification: 6015188620429852704
Valid: 2026-02-01 to 2028-02-01
[!NOTE] Multi-Layer Licensing
SimpleRemoter uses an enterprise-grade multi-layer authorization architecture, supporting independent operation for agents/developers:
- Offline Verification: First-layer users can operate completely offline after obtaining authorization
- Independent Control: Your downstream users connect only to your server, with data fully under your control
- Free Customization: Supports secondary development to create your own branded version
System Requirements: Windows 7 SP1 and above
Feature Completeness: ✅ All features supported
System Requirements:
Feature Support:
Build Instructions:
cd linux
cmake .
make
Web Remote Desktop & Multi-Master Sharing Enhancement
New Features:
Improvements:
Bug Fixes:
Multi-Tier FRP Architecture & UI Branding
New Features:
Bug Fixes:
Improvements:
Network Security & Stability Enhancement
New Features:
Bug Fixes:
Improvements:
Email Notification & Remote Audio
V2 File Transfer Protocol
Remote Desktop Toolbar Rewrite
Adaptive Quality Control & Linux Client
For complete update history, see: history.md
This project originated from technical learning and personal interest. The author will update irregularly based on spare time. If this project has been helpful to you, please consider sponsoring:
If you like this project, please give it a ⭐ Star!
| Category | Features |
|---|
| Remote Desktop | Real-time screen control, multi-monitor support, H.264 encoding, adaptive quality |
| File Management | Bi-directional transfer, resumable uploads, C2C transfer, SHA-256 verification |
| Terminal | Interactive shell, ConPTY/PTY support, modern web terminal |
| System Management | Process/service/window management, registry browsing, session control |
| Media Capture | Webcam monitoring, audio listening, keylogging |
| Networking | SOCKS proxy, FRP tunneling, port forwarding |
| RTT Latency | Quality Level | FPS | Resolution | Compression | Use Case |
|---|
| < 30ms | Ultra | 25 FPS | Original | DIFF | LAN office |
| 30-80ms | High | 20 FPS | Original | RGB565 | General office |
| 80-150ms | Good | 20 FPS | ≤1080p | H.264 | Cross-network/Video |
| 150-250ms | Medium | 15 FPS | ≤900p | H.264 | Cross-network office |
| 250-400ms | Low | 12 FPS | ≤720p | H.264 | Poor network |
| > 400ms | Minimal | 8 FPS | ≤540p | H.264 | Very poor network |
| Layer | Measures |
|---|
| Transport Encryption | AES-256 data encryption with configurable IV |
| Authentication | Signature verification + HMAC authentication |
| Authorization Control | Serial number binding (IP/domain), multi-level authorization |
| File Verification | SHA-256 integrity verification |
| Session Isolation | Session 0 independent handling |
| Library | Version | Purpose |
|---|
| zlib | 1.3.1 | General compression |
| zstd | 1.5.7 | High-speed compression |
| x264 | 0.164 | H.264 encoding |
| libyuv | 190 | YUV conversion |
| HPSocket | 6.0.3 | Network I/O |
| jsoncpp | 1.9.6 | JSON parsing |
| Feature | Description |
|---|
| Hierarchical Control | Super user manages any master, supports unlimited tiers |
| Complete Isolation | Different Layer-1 users have isolated licenses, data, and clients |
| Independent Operation | Layer-1 users can set pricing, issue licenses, build their brand |
| Horizontal Scaling | Single master supports 10,000+ clients, multi-layer scales to millions |
| Offline Support | V2 license supports full offline verification, no upstream dependency |
TestRun.exe + ServerDll.dll |
| Separate loading, supports in-memory DLL loading |
| Windows Service | Background operation, supports lock screen control |
| Linux Client | Cross-platform support (v1.2.5+) |
| Feature | Status | Implementation |
|---|
| Remote Desktop | ✅ | X11 screen capture, mouse/keyboard control |
| Remote Terminal | ✅ | PTY interactive shell |
| File Management | ✅ | Bi-directional transfer, large file support |
| Process Management | ✅ | Process list, terminate processes |
| Heartbeat/RTT | ✅ | RFC 6298 RTT estimation |
| Daemon Process | ✅ | Double fork daemonization |
| Clipboard | ⏳ | In development |
| Session Management | ⏳ | In development |
| Channel | Link |
|---|
| 962914132 | |
| Telegram | @doge_grandfather |
| [email protected] | |
| wishyuanqi | |
| Issues | Report Issues |
| PR | Contribute |
