# WireRemote

**Repository Path**: dreamszhu/WireRemote

## Basic Information

- **Project Name**: WireRemote
- **Description**: WireRemote 是一款极简、轻量的局域网远程控制小工具。它把手机浏览器变成一个线框图风格的控制面板，通过 HTTP/WebSocket 实时操控电脑的鼠标和键盘。
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WireRemote

> 用手机网页"提线"控制电脑——纯 HTTP 协议，线框美学，无需安装 App。

📱→🖥️ 局域网内用手机网页遥控电脑 · 线框图界面 · HTTP/WebSocket · 轻量跨平台

WireRemote 是一款极简、轻量的局域网远程控制小工具。它把手机浏览器变成一个线框图风格的控制面板，通过 HTTP/WebSocket 实时操控电脑的鼠标和键盘。

## 项目定位

- 📱 **纯网页操控**：手机扫码或输入网址即用，零安装
- 🖱️ **鼠标/键盘远程控制**：滑动触摸板移动指针，点击发送点击、滚轮、文本和特殊键
- 🗺️ **桌面预览（minimap）**：线框图风格实时呈现电脑窗口布局与鼠标位置，所见即所控
- 🎨 **线框图极简 UI**：科技感轮廓线设计，只保留控制功能本身
- ⚡ **低延迟**：基于 WebSocket 实时通信，操作跟手
- 🔒 **局域网即用**：不经任何第三方服务器，数据全在你自己的网络内

## 技术栈

`Python` · `Flask-SocketIO` · `PyAutoGUI` · `PyGetWindow` · `HTML5 Canvas` · `WebSocket`

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 启动服务

```bash
python run.py
```

启动后控制台会打印类似信息：

```
Server running on http://0.0.0.0:5000
```

### 3. 手机连接

1. 确保手机与电脑处于**同一局域网/Wi-Fi**
2. 在电脑上查看本机 IP（如 `ipconfig` / `ifconfig`）
3. 用手机浏览器访问 `http://<电脑IP>:5000`
4. 打开线框图控制面板，开始遥控

## 使用说明

| 操作 | 效果 |
| --- | --- |
| 桌面缩略图（minimap） | 线框图实时显示窗口布局与鼠标位置（仅展示） |
| 触摸板滑动 | 移动鼠标指针 |
| 触摸板轻触 | 左键点击 |
| LEFT / RIGHT | 鼠标左键 / 右键 |
| ▲ / ▼ SCROLL | 向上 / 向下滚动 |
| ENTER / BACKSPACE / TAB | 发送对应特殊键 |
| 文本框 + SEND | 输入并发送文本 |

> 桌面状态采用分层推送：鼠标位置 ~20Hz 实时更新保证跟手，窗口布局 ~2Hz 低频刷新节省带宽。

## 适合场景

- 躺在床上临时控制电脑播片/翻页
- 调试时不想来回跑到电脑前
- DIY 智能家居/媒体中心的小遥控器
- 教学演示时远程辅助操作

## 安全提示

- WireRemote 默认监听 `0.0.0.0`，**仅建议在可信的局域网内使用**
- 任何人只要能访问到该地址即可操控你的电脑，请在公共网络下关闭服务
- 出于跟手体验，默认关闭了 PyAutoGUI 的 FAILSAFE 角角保护；如需安全保护可在配置中重新开启

## 项目结构

```
WireRemote/
├── README.md
├── requirements.txt          # Python 依赖
├── run.py                    # 启动入口
├── app/                      # 应用主包
│   ├── __init__.py
│   ├── server.py             # Flask + SocketIO 实例与路由、后台推送
│   ├── config.py             # 配置（灵敏度、端口等）
│   ├── control.py            # PyAutoGUI 控制逻辑
│   ├── desktop.py            # 桌面信息采集（屏幕/窗口/鼠标）
│   └── socket_handlers.py    # WebSocket 事件处理
├── templates/                # Jinja2 模板
│   └── index.html
└── static/                   # 前端静态资源
    ├── css/
    │   └── style.css
    └── js/
        ├── control.js        # 触摸板与按钮交互
        └── minimap.js        # 桌面缩略图渲染
```

## License

MIT