# FPV 操作显示工具

**Repository Path**: slimeabc/FPV_stick_monitor

## Basic Information

- **Project Name**: FPV 操作显示工具
- **Description**: FPV 模拟器遥控器摇杆操作可视化工具，实时显示悬浮窗，支持多手柄配置、摇杆校准与映射，适用于 FPV 模拟器录制与教学演示
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FPV Stick Monitor / FPV 操作显示工具

[![Author](https://img.shields.io/badge/Author-Slime-blue)](https://space.bilibili.com/1754908723)
[![Version](https://img.shields.io/badge/Version-1.1-green)]()
[![Python](https://img.shields.io/badge/Python-3.13-yellow)]()
[![PyQt6](https://img.shields.io/badge/PyQt6-6-orange)]()

一个 FPV 模拟器遥控器摇杆操作可视化工具，实时显示悬浮窗，支持多手柄配置、摇杆校准与映射，适用于 FPV 模拟器录制与教学演示分析

![screenshot](screenshot.png)
*悬浮窗实时显示摇杆状态*

## ✨ 功能特点

- **实时悬浮窗**：无边框置顶窗口，半透明背景
- **多控制器支持**：支持保存多组手柄配置，一键切换不同遥控器，支持游戏手柄
- **校准功能**：可视化摇杆校准，自动识别物理轴映射，支持方向反转
- **油门模式切换**：支持"遥控器模式"和"手柄模式"
- **个性化设置**：
  - 透明度调节（10%-100%）
  - 深浅色主题切换
  - 悬浮窗帧率调节（24-120 FPS）
  - 窗口位置锁定
- **配置持久化**：自动保存配置到 `config.json`，下次启动自动恢复


## 🚀 快速开始

### 下载运行（推荐）
1. 前往 [Release](https://gitee.com/slimeabc/FPV_stick_monitor/releases) 下载最新版 `FPV 操作显示工具.exe`
2. 连接你的遥控器（需被系统识别为游戏手柄/Joystick）
3. 运行 exe 文件即可

### 首次使用
1. 运行程序后，悬浮窗会自动出现
2. 点击"控制设置" → "校准摇杆映射"，按提示推动摇杆完成校准
3. 如果摇杆方向相反，勾选对应通道的"反转"选项
4. 在未锁定情况下拖动悬浮窗可将悬浮窗定位到屏幕合适位置

> **提示**：程序会在同目录下生成 `config.json` 配置文件，用于保存你的设置和校准数据。

<details>
<summary>直接运行源码</summary>

### 环境要求
- Python 3.13+
- Windows / Linux / macOS（主要测试于 Windows）

### 安装依赖
```bash
pip install PyQt6 pygame
```

### 运行
```bash
python main.py
```

</details>