# rgb-theme-controller

**Repository Path**: graywolf_lv/rgb-theme-controller

## Basic Information

- **Project Name**: rgb-theme-controller
- **Description**: 🎨 自动同步Windows主题色到RGB设备 | Automatically sync Windows theme color to RGB devices
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-09
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RGB主题色控制器

> 自动同步Windows 11主题色到RGB设备，让你的PC灯光与系统主题完美融合

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Python](https://img.shields.io/badge/python-3.12+-brightgreen.svg)
![Platform](https://img.shields.io/badge/platform-Windows%2011-lightgrey.svg)

## ✨ 特性

- 🎨 **实时同步** - 自动读取Windows主题色并应用到所有RGB设备
- 🌙 **智能熄屏** - 显示器关闭时自动关闭RGB，唤醒时恢复
- 🎯 **颜色优化** - 智能颜色简化和饱和度增强，解决RGB设备色差问题
- ⚡ **高性能** - 基于注册表监听，CPU占用接近0%
- 🚀 **开机自启** - 一键设置开机启动，后台静默运行
- 📱 **系统托盘** - 原生高DPI支持，清晰的托盘图标和菜单

## 📸 截图

```
托盘菜单：
┌─────────────────────────┐
│ 当前颜色: RGB(0,120,215)│
├─────────────────────────┤
│ ✓ 启用颜色简化          │
│ ✓ 增强饱和度            │
├─────────────────────────┤
│ ✓ 开机自启动            │
├─────────────────────────┤
│ 刷新颜色                │
│ 重新连接OpenRGB         │
├─────────────────────────┤
│ 退出                    │
└─────────────────────────┘
```

## 🎯 工作原理

```mermaid
graph LR
    A[Windows主题色] --> B[注册表监听]
    B --> C[颜色处理]
    C --> D[颜色简化]
    C --> E[饱和度增强]
    D --> F[OpenRGB SDK]
    E --> F
    F --> G[主板RGB]
    F --> H[内存RGB]
    F --> I[机箱风扇]
    
    J[显示器状态] --> K[电源管理监听]
    K --> L{显示器关闭?}
    L -->|是| M[RGB全黑]
    L -->|否| N[恢复主题色]
```

## 📦 依赖项

### 必需软件
- **Windows 11** (64位)
- **OpenRGB** ([下载](https://openrgb.org))
- **Python 3.12+** (仅开发模式需要)

### Python库 (仅开发模式)
- `pywin32` - Windows API访问
- `openrgb-python` - OpenRGB SDK接口
- `pyinstaller` - 打包成EXE

## 🚀 快速开始

### 方式一：使用打包好的EXE（推荐）

1. **安装OpenRGB**
    - 下载：https://openrgb.org
    - 安装并运行

2. **启用OpenRGB SDK服务器**
   ```
   OpenRGB → 设置 → SDK服务器
   ✓ 启动服务器
   ✓ 程序启动时启动服务器
   ```

3. **运行RGB主题色控制器**
    - 双击 `RGB主题色控制器.exe`
    - 托盘会出现RGB图标 🎨

4. **设置开机启动**（可选）
   ```
   右键托盘图标 → 勾选"开机自启动"
   ```

### 方式二：从源码运行

1. **克隆仓库**
   ```bash
   git clone https://github.com/VictoriqueDeBlois/rgb-theme-controller.git
   cd rgb-theme-controller
   ```

2. **安装依赖**
   ```bash
   uv sync
   ```

3. **运行程序**
   ```bash
   python rgb_controller_full.py
   ```

## 🛠️ 从源码构建

### 打包成EXE

```bash
# 基础打包
pyinstaller build.spec
```

生成的文件：`dist/RGB主题色控制器.exe`

## ⚙️ 功能说明

### 颜色处理模式

#### 🎨 颜色简化
将Windows主题色量化到最近的标准RGB颜色，解决不同RGB设备显色不一致的问题。

**标准色表：**
- 红色 (255, 0, 0)
- 橙色 (255, 127, 0)
- 黄色 (255, 255, 0)
- 绿色 (0, 255, 0)
- 青色 (0, 255, 255)
- 蓝色 (0, 0, 255)
- 紫色 (127, 0, 255)
- 品红 (255, 0, 255)
- 粉色 (255, 0, 127)
- 白色 (255, 255, 255)

**示例：**
```
原始主题色: RGB(100, 140, 180)
       ↓ 颜色简化
标准蓝色: RGB(0, 0, 255)
```

#### ✨ 饱和度增强
增强颜色饱和度20%，让RGB设备显示更鲜艳。

```
原色: RGB(128, 128, 200)
  ↓ 饱和度增强
增强: RGB(102, 102, 230)
```

### 使用场景

| 场景 | 推荐设置 |
|------|---------|
| RGB设备显色一致 | 颜色简化 ❌  饱和度增强 ❌ |
| RGB设备偏淡 | 颜色简化 ❌  饱和度增强 ✅ |
| RGB设备色差大 | 颜色简化 ✅  饱和度增强 ✅ |
| 追求极致鲜艳 | 修改代码参数 |

## 🎮 支持的设备

通过OpenRGB支持的所有RGB设备：
- ✅ 华硕 Aura Sync (主板、显卡)
- ✅ 微星 Mystic Light
- ✅ 技嘉 RGB Fusion
- ✅ 海盗船 iCUE
- ✅ 罗技 G Hub
- ✅ 雷蛇 Razer Chroma
- ✅ RGB内存条（芝奇、海盗船、金士顿等）
- ✅ RGB风扇和灯条

完整支持列表：https://openrgb.org/devices.html

## ⚡ 性能

```
CPU占用：     <0.1%
内存占用：    30-50 MB
响应延迟：    <100ms
启动时间：    2-3秒
```

## 🔧 高级配置

### 调整颜色处理参数

编辑 `rgb_controller_full.py`：

```python
# 颜色量化阈值（0-255）
# 数值越小，越容易归类到标准色
ColorQuantizer.quantize_to_nearest(r, g, b, threshold=80)

# 饱和度增强倍数
# 1.0 = 不变, 1.2 = 增强20%, 1.5 = 增强50%
ColorQuantizer.adjust_saturation(r, g, b, saturation_boost=1.2)
```

### 自定义标准色表

```python
ColorQuantizer.STANDARD_COLORS = {
    'red': (255, 0, 0),
    'green': (0, 255, 0),
    'blue': (0, 0, 255),
    # 添加你的自定义颜色
    'custom_purple': (180, 0, 255),
}
```

## 🐛 故障排查

### RGB不亮？

**检查清单：**
- [ ] OpenRGB是否运行？
- [ ] SDK服务器是否启动？
- [ ] 设备是否被OpenRGB识别？

**解决：**
```
1. 打开OpenRGB
2. 设置 → SDK服务器 → 启动服务器
3. 右键托盘 → 重新连接OpenRGB
```

### 颜色不准确？

**尝试：**
- 启用"颜色简化" - 统一到标准色
- 启用"增强饱和度" - 让颜色更鲜艳
- 调整阈值参数

### 开机启动失败？

**原因：** 移动了exe位置

**解决：**
```
1. 右键托盘 → 取消勾选"开机自启动"
2. 重新勾选"开机自启动"
```

### 托盘图标模糊？

**系统要求：** Windows 10 1703+

**解决：**
- 程序已支持Per-Monitor DPI V2
- 如果还模糊，右键exe → 属性 → 兼容性
- 高DPI缩放替代 → "应用程序"

## 📁 文件结构

```
rgb-theme-controller/
├── rgb_controller_full.py     # 主程序
├── icon.ico                   # 程序图标
├── pyproject.toml             # Python依赖
├── build.spec                 # PyInstaller配置
├── README.md                  # 本文件
└── dist/
    └── RGB主题色控制器.exe     # 打包后的程序
```

## 🤝 贡献

欢迎提交Issue和Pull Request！

### 开发环境设置

```bash
git clone https://github.com/VictoriqueDeBlois/rgb-theme-controller.git
cd rgb-theme-controller
uv sync
python rgb_controller_full.py
```

### 代码规范

- 使用中文注释
- 遵循PEP 8
- 添加详细的文档字符串

## 📝 更新日志

### v1.0.0 (2025-10-09)
- ✨ 初始版本发布
- 🎨 Windows主题色实时同步
- 🌙 显示器开关检测
- 🎯 颜色简化和饱和度增强
- 🚀 开机自启动支持
- 📱 原生高DPI托盘图标

### v1.0.1 (2025-10-09)
- 🐛 在运行前会设置设备为Direct模式，解决部分设备无法应用颜色的问题

## 📄 许可证

MIT License

## 🙏 致谢

- [OpenRGB](https://openrgb.org) - 优秀的开源RGB控制软件
- [PyWin32](https://github.com/mhammond/pywin32) - Windows API Python绑定

## 💬 联系方式

- 问题反馈：[GitHub Issues](https://github.com/VictoriqueDeBlois/rgb-theme-controller/issues)
- 功能建议：[Discussions](https://github.com/VictoriqueDeBlois/rgb-theme-controller/discussions)

## ⭐ Star History

如果这个项目对你有帮助，请给个Star ⭐

---

**享受你的RGB灯光与Windows主题的完美融合！** 🎨✨