# BeautifulMouse

**Repository Path**: yimol/beautiful-mouse

## Basic Information

- **Project Name**: BeautifulMouse
- **Description**: Beautiful Mouse是一个基于JavaFX开发的桌面应用程序，通过全局鼠标事件监听，实现了多种炫酷的鼠标特效。用户可以根据个人喜好选择不同的特效样式，并且可以实时调整特效的参数，如颜色、大小、速度等。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-08-22
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 **BeautifulMouse 🖱️** 

 **介绍 📖** 
Beautiful Mouse是一个基于JavaFX开发的桌面应用程序，通过全局鼠标事件监听，实现了多种炫酷的鼠标特效。用户可以根据个人喜好选择不同的特效样式，并且可以实时调整特效的参数，如颜色、大小、速度等。

 **项目展示**

![项目展示](%E9%A1%B9%E7%9B%AE%E5%B1%95%E7%A4%BA.png)

 **软件架构 🏗️** 
```
beautifulMouse/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/bm/beautifulmouse/
│   │   │       ├── MainApplication.java          # 程序主入口
│   │   │       ├── controller/                   # 控制器层
│   │   │       │   └── EffectController.java     # 特效控制器
│   │   │       ├── effect/                       # 特效实现层
│   │   │       │   ├── Effect.java              # 特效接口
│   │   │       │   ├── StarEffect.java          # 星星特效
│   │   │       │   ├── RainbowTrailEffect.java  # 彩虹尾巴特效
│   │   │       │   ├── ParticleEffect.java      # 粒子特效
│   │   │       │   ├── SnowEffect.java          # 雪花特效
│   │   │       │   ├── HeartEffect.java         # 心形特效
│   │   │       │   └── FirecrackerEffect.java   # 爆竹特效
│   │   │       └── model/                       # 模型层
│   │   │           └── EffectConfig.java        # 特效配置类
│   │   └── resources/
│   │       ├── css/
│   │       │   ├── effect-style.css             # 特效样式
│   │       │   └── style.css                    # 全局样式
│   │       ├── fxml/
│   │       │   ├── main.fxml                    # 主界面布局
│   │       │   └── effect-view.fxml             # 特效控制面板布局
│   │       └── images/                          # 图片资源
│   └── test/                                    # 测试目录
│       └── java/
│           └── com/bm/beautifulmouse/
│               └── effect/
│                   └── EffectTest.java          # 特效测试类
├── .gitignore                                   # Git忽略文件
├── LICENSE                                      # 开源协议
├── README.md                                    # 项目说明
└── pom.xml                                      # Maven配置文件
```
 **技术栈** 
核心框架
- Java 17
- JavaFX：用于构建桌面GUI应用
- FXML：用于UI布局设计
- CSS：用于界面样式设计

项目管理
- Maven：项目构建和依赖管理

系统集成
- JNA：实现与操作系统的底层交互
- JNativeHook：实现全局鼠标事件监听


 **安装教程 🚀** 
1. 环境准备

```
   # 确保安装了Java 17
   java -version
   
   # 确保安装了Maven
   mvn -version
```
2. 克隆项目

```
   git clone https://gitee.com/xiongwenhao6/beautifulMouse.git
   cd beautifulMouse
```
3. 编译运行

```
   # 编译项目
   mvn clean package
   
   # 运行应用
   项目打包后生成target/BeautifulMouse/BeautifulMouse.exe项目，切换到exe文件所在目录，双击运行BeautifulMouse.exe即可

   #说明
   生成的BeautifulMouse目录下的jre，lib，libs是环境配置，beautifulMouse.exe是可执行程序，beautifulMouse.ico是图标
```

 **使用说明 📝** 
1. 源码获取
```
# 克隆项目
git clone https://gitee.com/xiongwenhao6/beautifulMouse.git
```
2. IDE运行配置（IntelliJ IDEA）
```
配置VM选项
--module-path "项目路径/src/main/resources/lib" --add-modules javafx.controls,javafx.fxml
具体步骤：
1.打开 "Run/Debug Configurations"
2.选择 "Application" 配置
3.在 "VM options" 中添加以上参数
4.确保 "Main class" 设置为 com.bm.beautifulmouse.MainApplication
```
3. 生成exe可执行文件

```
# 1. 清理项目
mvn clean

# 2. 打包项目
mvn package
项目打包后会在targer目录下会生成BeautifulMouse目录，然后切换到这个目录执行BeautifulMouse.exe文件

#命令行运行
#切换到指定目录下
cd target/BeautifulMouse
#执行命令运行程序
.\BeautifulMouse.exe
```
 **🤝 参与贡献** 

如果你对我们的开源项目感兴趣，欢迎加入我们！🎉

参与贡献之前请先阅读[贡献指南](https://gitee.com/opentiny/tiny-engine/blob/refactor/develop/CONTRIBUTING.zh-CN.md)。

添加微信 revivewaves，加入技术交流群
加入邮件列表 xiongjava@163.com