Karasowl/linux-rig-tools
GitHub: Karasowl/linux-rig-tools
为缺乏原生 Linux 支持的电竞 PC 硬件提供风扇、RGB、LED 显示屏控制及 CPU/GPU 性能配置的模块化工具集。
Stars: 0 | Forks: 0
# linux-rig-tools
**适用于目前仍缺乏原生支持的电竞 PC 硬件的 Linux 工具。**
🇪🇸 [Léeme en español](README.es.md)
现代主板、AIO 散热器、机箱和外围设备越来越倾向于将其风扇曲线、水泵控制、RGB 效果和 LED 矩阵显示屏隐藏在仅限 Windows 的应用程序之后（如 NZXT CAM、Cooler Master MasterCTRL 以及无名的机箱套件）。
在 Linux 上，你只能使用 BIOS 暴露出来的有限功能。
这个 monorepo 收集了**小型、独立的工具** —— 你只需安装你的主机需要的工具即可。这里没有任何东西依赖于该仓库中的其他内容。
## 工具
| 工具 | 功能描述 | 状态 |
|------|--------------|--------|
| [`rig-diagnose`](tools/rig-diagnose/) | 盘点你的 RGB/风扇/散热控制器，并报告在 Linux 上（未）受支持的情况。只读，零依赖。 | ✅ 目前可用 |
| [`rig-profiles`](tools/rig-profiles/) | 在无需厂商软件的情况下，为 CPU（governor + EPP）和 NVIDIA GPU（功耗限制）提供 `quiet` / `balanced` / `performance` 配置。 | ✅ 目前可用 |
| [`nzxt-n9`](tools/nzxt-n9/) | 用于内置于 NZXT N9 主板（`1e71:2023`，N9 Z890）的控制器的风扇曲线、水泵接口和 RGB 控制。 | 🔬 逆向工程 |
| [`cm-nex-digital`](tools/cm-nex-digital/) | 用于 Cooler Master MasterLiquid Core Nex Digital AIO（`2516:0232`）的水泵、风扇、数字显示屏和 ARGB 控制。 | 🔬 逆向工程 |
| [`chassis-ledmatrix`](tools/chassis-ledmatrix/) | 用于通用机箱 LED 矩阵控制器（`ff00:020c` 等）的效果（沙漏、时钟、动画……）。 | 🔬 逆向工程 |
已经拥有良好上游支持（如 OpenRGB、liquidctl）的设备已被**上游收录，不再在此重复** —— 请参阅[路线图](docs/ROADMAP.md)。
## 安装
每种方法都只会安装你选择的工具。
**任何发行版（Arch/CachyOS、Debian/Ubuntu、Fedora、openSUSE 等）：**
```
git clone https://github.com/Karasowl/linux-rig-tools.git
cd linux-rig-tools
sudo ./install.sh # interactive menu
sudo ./install.sh --all # everything installable
sudo ./install.sh --uninstall
```
**Arch / CachyOS / Manjaro** — [`packaging/arch/`](packaging/arch/) 中的 PKGBUILD
（一旦首批驱动程序发布，计划推出 AUR 软件包）：
```
cd packaging/arch/rig-profiles && makepkg -si
```
**Debian / Ubuntu / Mint / Pop!_OS** — 构建 .deb 软件包：
```
./packaging/debian/build-debs.sh # produces dist/*.deb
sudo apt install ./dist/rig-profiles_*_all.deb
```
**Fedora / openSUSE** — 目前请使用 `install.sh`；计划支持 COPR/OBS。
## 参考硬件
首个目标主机的详细信息已完整记录在 [docs/HARDWARE.md](docs/HARDWARE.md) 中：NZXT N9 Z890、Intel Core Ultra 7 270K、Zotac RTX 5060 Ti、Cooler Master MasterLiquid Core Nex Digital、机箱 LED 矩阵显示屏。如果你拥有这些设备中的任何一个，我们极其欢迎你提供[抓取数据与报告](docs/CAPTURE-GUIDE.md)。
## 贡献
运行 `rig-diagnose` 并将其输出附加到你的 issue 中 —— 这是你目前能做的最有用的一件事。要帮助解码协议，请阅读[抓取指南](docs/CAPTURE-GUIDE.md)。更多信息请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
[GPL-3.0-or-later](LICENSE)。
标签：Cutter, RGB控制, 散热管理, 游戏PC, 硬件驱动, 系统工具, 逆向工具