# RemoteMaster

**Repository Path**: asascoder/RemoteMaster

## Basic Information

- **Project Name**: RemoteMaster
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-29
- **Last Updated**: 2025-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RemoteMaster - 远程桌面软件

RemoteMaster 是一个基于 C++ 和 Qt 框架开发的跨平台远程桌面软件，支持多显示器显示并能够排除任务栏区域实现真正的全屏体验。

## 功能特性

- **多显示器支持**: 能够识别并利用多个显示器进行远程桌面显示
- **任务栏排除**: 自动检测任务栏区域，实现真正的全屏显示（不被任务栏遮挡）
- **跨平台**: 支持 Windows、Linux 和 macOS 操作系统
- **VNC协议支持**: 兼容标准VNC协议
- **高性能渲染**: 使用Qt Graphics View框架进行高效渲染

## 技术架构

- **语言**: C++17
- **框架**: Qt 6
- **构建系统**: CMake
- **图形渲染**: Qt Graphics View + 硬件加速支持
- **网络协议**: VNC/RDP (可扩展)

## 编译构建

### 环境要求

- C++17 编译器 (MSVC 2019+/GCC 7+/Clang 5+)
- Qt 6.2 或更高版本
- CMake 3.16 或更高版本

### Windows 构建步骤

```bash
# 克隆项目
git clone <项目地址>
cd RemoteMaster

# 创建构建目录
mkdir build
cd build

# 配置项目
cmake .. -DCMAKE_PREFIX_PATH=<Qt安装路径>

# 构建项目
cmake --build . --config Release
```

### Linux/macOS 构建步骤

```bash
# 克隆项目
git clone <项目地址>
cd RemoteMaster

# 创建构建目录
mkdir build
cd build

# 配置项目
cmake .. -DCMAKE_PREFIX_PATH=<Qt安装路径>

# 构建项目
make -j$(nproc)
```

## 使用说明

1. 启动 RemoteMaster 应用程序
2. 输入远程主机地址、端口和密码
3. 点击连接按钮
4. 应用将自动进入排除任务栏的全屏模式

## 核心模块

### ScreenManager (屏幕管理器)
负责检测和管理多显示器环境，能够：
- 获取所有连接的显示器
- 检测每个显示器的可用区域（排除任务栏）
- 提供虚拟桌面的几何信息

### RemoteDesktop (远程桌面)
负责远程桌面显示和交互：
- 全屏显示远程桌面内容
- 处理鼠标和键盘事件转发
- 管理VNC连接

### VncClient (VNC客户端)
VNC协议客户端实现：
- 连接和断开VNC服务器
- 接收和解码远程桌面帧
- 发送用户输入事件

## 扩展功能

### 计划支持的功能
- RDP协议支持（集成FreeRDP）
- 剪贴板同步
- 文件传输功能
- 音频重定向
- 打包脚本（Windows Installer/MSI, macOS DMG, Linux AppImage）

### 自定义协议
项目设计支持轻松集成其他远程桌面协议，只需实现相应的客户端接口即可。

## 目录结构

```
RemoteMaster/
├── src/                 # 源代码目录
│   ├── main.cpp         # 程序入口点
│   ├── mainwindow.*     # 主窗口类
│   ├── remotedesktop.*  # 远程桌面显示类
│   ├── screenmanager.*  # 屏幕管理器类
│   └── vncclient.*      # VNC客户端实现
├── CMakeLists.txt       # CMake构建脚本
├── README.md            # 项目说明文档
└── LICENSE              # 许可证文件
```

## 贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 许可证

本项目采用 MIT 许可证，详情请见 [LICENSE](LICENSE) 文件。