# mouse-tracker

**Repository Path**: gys1987/mouse-tracker

## Basic Information

- **Project Name**: mouse-tracker
- **Description**: 一个按键提醒鼠标位置的应用
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mouse Tracker

一款轻量级工具，通过动画视觉效果帮助定位鼠标光标。

![演示](demo.gif)

## 功能特性

- 按住Ctrl键时在鼠标位置显示动画视觉效果
- 通过快速摇晃鼠标触发替代方式
- 17种视觉效果：圆环、烟花、喷泉、螺旋、脉冲波、雷达扫描、星爆、闪烁圆点、闪电闪烁、旋转方块、极光波动、网格扩散、光束汇聚、彩虹漩涡、几何图案、音波效果和星座连线
- 可调节的动画尺寸、速度和颜色
- 轻量级，不使用时无后台进程
- 支持X11和兼容环境
- 系统托盘GUI便于配置
- 可自定义触发灵敏度和动画参数

## 架构设计

该应用程序分为两个组件：

1. **后端服务** (`mouse-tracker-service`) - 作为systemd用户服务运行，监控键盘和鼠标事件并触发动画
2. **前端GUI** (`mouse-tracker-gui`) - 提供系统托盘界面，用于控制服务和调整具有广泛自定义选项的设置

## 安装说明

### 从DEB包安装

```bash
sudo dpkg -i mouse-tracker.deb
# 或者
sudo apt install ./mouse-tracker.deb
```

安装完成后，需要启动服务：

```bash
systemctl --user start mouse-tracker.service
```

### 从源码编译

#### 依赖项

- Qt5 (Core, Widgets, Gui)
- X11开发库
- CMake 3.10或更高版本
- 支持C++11的GCC
- libxtst-dev (用于全局键处理)

在Debian/Ubuntu上：
```bash
sudo apt install cmake qtbase5-dev libx11-dev libxtst-dev g++
```

#### 构建

```bash
./build.sh
```

这将在`build/`目录中创建两个可执行文件：
- `mouse-tracker-service` - 后端服务
- `mouse-tracker-gui` - 前端GUI

#### 安装

```bash
cd build
sudo make install
```

或者构建DEB包：
```bash
./build-package.sh
```

## 使用方法

### 启动服务

作为systemd用户服务：
```bash
systemctl --user start mouse-tracker.service
```

或在登录时自动启动：
```bash
systemctl --user enable mouse-tracker.service
```

### 使用GUI

运行GUI前端：
```bash
mouse-tracker-gui
```

这将创建一个系统托盘图标，允许您：
- 启动/停止后端服务
- 打开具有广泛自定义选项的设置对话框
- 检查服务状态
- 从17种不同的动画效果中选择
- 调整动画参数，包括尺寸、速度和颜色
- 配置鼠标摇晃检测灵敏度

### 控制方式

1. 按住`Ctrl`键在鼠标位置显示动画
2. 快速左右摇晃鼠标触发动画（可配置灵敏度）
3. 按`Ctrl+Alt+M`使用替代触发方式
4. 通过系统托盘GUI访问高级设置

### 设置选项

通过GUI或运行以下命令访问设置：
```bash
mouse-tracker-gui --settings
```

设置包括：
- 动画尺寸、速度和倍数
- 视觉效果选择（17种不同效果：圆环、烟花、喷泉、螺旋、脉冲波、雷达扫描、星爆、闪烁圆点、闪电闪烁、旋转方块、极光波动、网格扩散、光束汇聚、彩虹漩涡、几何图案、音波效果、星座连线和随机）
- 多种颜色模式，包括白色、红色、彩虹和自定义颜色
- 可调节距离、窗口和交替参数的摇晃检测灵敏度
- 启用/禁用动画和摇晃触发选项

## License

MIT