# 拾取窗中流光-博客状态推送（Windows）

**Repository Path**: adnaan/light-capture

## Basic Information

- **Project Name**: 拾取窗中流光-博客状态推送（Windows）
- **Description**: 一个轻量级的Windows系统托盘工具，可以监控你正在使用的软件和音乐播放状态，并推送到Web API。
- **Primary Language**: Python
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python

## README

# ✨ 拾取窗中流光

> 现代化窗口状态监控工具，实时捕获并推送应用程序状态  
> 作者：adnaan

![输入图片说明](image.png)

## 🌟 项目特色

- **🎨 诗意简约 UI**：使用 ttkbootstrap 打造的优雅界面，与博客风格媲美
- **📊 实时监控**：智能监控 Windows 应用程序切换
- **🎵 智能识别**：自动识别编辑器、浏览器、音乐播放器等应用
- **⚡ Socket.IO 推送**：低延迟实时状态推送
- **📋 实时日志**：完整的操作日志系统
- **🔧 现代化配置**：图形化配置界面，简单易用

## 🚀 快速开始

### 方式一：直接运行（推荐）

1. **安装依赖**

   ```bash
   # 双击运行安装脚本
   install.bat
   ```

2. **启动程序**
   ```bash
   # 双击运行启动器
   run.py
   ```

### 方式二：打包版本

1. **生成可执行文件**

   ```bash
   cd scripts
   python build_fast.py
   ```

2. **运行程序**
   ```bash
   # 在dist目录下找到 LightCapture.exe
   ./dist/LightCapture.exe
   ```

## 📖 使用说明

### 基本使用

1. 启动程序后，会在系统托盘显示图标
2. 右键托盘图标，选择"打开控制面板"
3. 在"连接设置"中配置 Webhook URL
4. 点击"开始监控"即可开始使用

### 配置说明

- **Webhook URL**：接收状态推送的服务器地址
- **监控选项**：可选择监控应用程序或音乐播放器
- **音乐播放器**：支持 Spotify、网易云音乐、QQ 音乐等

## 🔧 技术架构

### 核心技术

- **Python 3.8+**：主要开发语言
- **ttkbootstrap**：现代化 GUI 框架，诗意简约设计
- **Socket.IO**：实时通信协议
- **pystray**：系统托盘集成
- **psutil**：系统进程监控

### 项目结构

```
拾取窗中流光/
├── src/                    # 源代码目录
│   ├── main.py            # 主程序文件
│   └── icon.ico           # 应用图标
├── scripts/               # 打包脚本
│   └── build_fast.py      # cx_Freeze打包脚本
├── docs/                  # 文档目录
├── requirements.txt       # 依赖包列表
├── config.ini            # 配置文件
├── install.bat           # 安装脚本
└── run.py                # 启动器
```

## 📊 功能特性

### 监控功能

- ✅ 应用程序切换监控
- ✅ 音乐播放状态监控
- ✅ 智能防抖动机制
- ✅ 实时状态推送

### 界面特性

- ✅ 诗意简约的现代化设计
- ✅ 深色主题，护眼舒适
- ✅ 图形化配置界面
- ✅ 实时日志查看
- ✅ 系统托盘集成
- ✅ Toast 通知提示

### 技术特性

- ✅ Socket.IO 实时通信
- ✅ 自动重连机制
- ✅ 错误处理与恢复
- ✅ 便携版打包支持

## 🛠 开发指南

### 环境要求

- Python 3.8+
- Windows 7/8/10/11
- 2GB+ 内存

### 依赖安装

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

### 开发调试

```bash
# 直接运行源码
python src/main.py

# 使用启动器（推荐）
python run.py
```

### 打包发布

```bash
# 使用cx_Freeze打包
cd scripts
python build_fast.py
```

## 📝 配置文件

```ini
[API]
webhook_url = http://localhost:3001/api/status
update_interval = 5

[MONITOR]
track_apps = true
track_music = true

[MUSIC]
monitored_players = ["spotify.exe", "netease.exe", "qqmusic.exe"]
```

## 🤝 贡献指南

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 开源协议

本项目采用 MIT 协议 - 查看 [LICENSE](LICENSE) 文件了解详情

## 👤 作者信息

**adnaan**

- 项目主页：[拾取窗中流光](https://gitee.com/adnaan/blog-status-push---windows)
- 问题反馈：[Issues](https://gitee.com/adnaan/blog-status-push---windows/issues)

## 🙏 致谢

感谢所有为此项目做出贡献的开发者们！

---

**⭐ 如果这个项目对你有帮助，请给它一个星标！**