chuanjianghe1024-cmd / FluentControl
git clone https://github.com/chuanjianghe1024-cmd/FluentControl.git
v0.3.140 · 3d ago
Windows 多屏聚合控制:DDC/CI 亮度与显示器配置、系统音量和输入、鼠标、桌面组件。Fluent desktop controls for monitors, audio and mouse.
+0
stars, 24h · #35,066
+~0
stars, 7 days · #35,541
+112
stars, 30 days · #4,638
113
★ total
11
forks · 1 open issues
Star history (as recorded here)
LanguageC#
LicenseMIT
Created2026-10-08 (14d ago)
Last push1d ago
Watchers0
OwnerUser
GitHub topics
brightness-controlcsharpddc-cidesktop-widgetdotnetfluent-designmonitor-controlmulti-monitorvolume-controlwindowswindows-11windows-utilitywinui3
Links
- GitHub: github.com/chuanjianghe1024-cmd/FluentControl
- Homepage: https://github.com/chuanjianghe1024-cmd/FluentControl/releases/latest
- Releases · Issues · Hacker News mentions
README excerpt
# FluentControl · 聚合控制 **多屏、声音、麦克风与鼠标,一个面板就够。** **Your displays, audio, microphone and mouse — in one panel.** Windows 11 风格 · Windows x64 · 离线 Setup / MSI 安装 · 8 种界面语言 简体中文 · English · 下载 / Download · 使用手册 / Wiki · 更新记录 / Changelog · 反馈 / Issues ## 让桌面设备跟上你的使用场景 FluentControl 是一款面向 Windows 的 **DDC/CI 显示器亮度与多屏控制工具**,同时提供系统音量、输入和鼠标调节。把分散在显示器实体按键、系统声音设置和鼠标设置中的常用操作,放进统一的 Fluent 风格界面。 从办公切换到游戏、从白天切换到夜间,保存一套配置后就能再次调用。多台显示器可以一起调,也可以分别调;常用控制还能留在桌面上,减少反复打开窗口和寻找菜单的操作。 ### 它解决什么问题 | 你遇到的情况 | FluentControl 的做法 | | --- | --- | | 多块屏幕亮度不同,逐台按按钮很麻烦 | 整体或单独调节,并为每屏设置亮度映射 | | 办公、游戏、夜间需要重复调整设备 | 保存显示器、声音、麦克风和鼠标的总配置,随时切换 | | 好用的显示器参数难以整理、迁移和复用 | 按型号管理预设,支持批量导入、导出与兼容性检查 | | 常用控制分散在多个系统窗口 | 用主面板、托盘、快捷键和半透明桌面面板快速操作 | ### 主要功能 - **显示器控制**:在硬件支持时调节亮度、对比度、色温预设、RGB、Gamma、饱和度、显示模式、输入源和屏幕音量等。 - **系统色温与 HDR**:每屏独立调整 SDR 画面冷暖、恢复原颜色,并按 Windows 能力切换 HDR;HDR 下明确提示亮度、对比度等可能受限。 - **跨型号多屏联动**:不同型号也能整体调节;只向支持对应功能和选项的屏幕发送设置,并标明部分支持的情况。 - **总配置与型号预设**:总配置保存整套设备状态,型号预设保存可复用的单屏参数。更新时保留离线设备参数,修改库中预设不会悄悄改变已有总配置。 - **声音、麦克风与鼠标**:调节声音和输入的音量与静音、鼠标速度和指针大小。音频简化为「音量」「输入」两项,自动跟随 Windows 当前默认选择;虚拟声卡同样通过系统控制,不需要在 FC 中重新选择或绑定。 - **桌面面板与快捷操作**:半透明、可移动和缩放;双击立即解锁并前置,失焦或 Esc 锁定;支持 Win+D 显示桌面、托盘驻留和全局快捷键。 - **每屏软件菜单与诊断**:通过 FC 屏幕菜单集中调节当前屏幕,采集只读诊断信息,为具体型号适配提供依据。 - **手动更新与分类设置**:设置按常规、显示器、快捷键、桌面面板、准星、关于与更新分类;主动检查 GitHub 正式版,下载校验后自行选择安装。 - **离线使用与多语言**:本地配置和 JSON 分享文件无需在线账户;支持简体中文、繁體中文、English、日本語、한국어、Deutsch、Français、Español。 ### 下载与开始使用 **v0.3.140 新增 USB 设备管理、C3 配网参考程序与认证 Wi-Fi 光照订阅**,并提供跟随应用主题的 Fluent 托盘菜单。包含 Windows WMI 内屏亮度与自动调节;实体传感器联动和笔记本仍需实测。提供 Windows x64 离线 Setup.exe 与 MSI。 **下载新版 Setup(推荐)** · MSI / 校验文件 · **v0.3.140** · 版本说明 1. 下载并运行 Setup。新安装可选择有写入权限的本地目录,并决定是否随 Windows 启动;成功后点击“启动 FluentControl”。支持离线安装,无需管理员权限,单独 MSI 也继续提供。升级沿用原目录;迁移目录时先卸载再安装,个人配置保留。 2. 在外接显示器的实体菜单中开启 **DDC/CI**,连接后读取设备。 3. 为屏幕命名,选择整体或单独控制,保存第一套配置。 4. 按需开启桌面面板、快捷键和开机自启动。 主要面向 **Windows 11 x64**。升级前请从托盘彻底退出旧版本;升级和卸载均保留个人配置。当前正式安装包未做代码签名,Windows 可能显示“发布者未知”。开发分支的后续修复见 更新记录,测试安装包见 Windows build。 ### 兼容性与当前进展 **v0.3.92 新增系统色温(软件)**:按屏调整画面冷暖,一键恢复原曲线,可保存到本机总配置;适用于接口可用的 SDR 内屏或外屏。HDR/自动颜色管理下暂不使用此兼容接口,提供 Windows 夜间模式入口。范围与使用说明。 **v0.3.92 新增每屏 Windows HDR 开关**:切换后重新检测显示器控制项;与 DDC/CI 独立,Windows 支持 HDR 的内屏也可使用。WMI 笔记本亮度与厂商专有功能尚未接入,实体屏幕切换待本机验证。控制范围与使用说明。 显示器可用功能取决于型号、固件、连接方式和当前模式。HDR、节能模式、转接器及扩展坞可能限制调节;带有音频输出也不一定支持显示器硬件音量遥控。FC 软件菜单已提供,**直接打开和导航显示器原厂 OSD 仍需经过验证的型号适配**。v0.3.92 提供实验性的本地 OSD 配对助手:自动列出已声明的未知指令,逐次试发并按观察到的效果绑定遥控,支持部分配对和可选文件分享,无需上传。 **本地预设、JSON 导入导出已可用。** 配置分享站与在线型号适配库尚未部署,在线查询及报告提交暂不可用。计划域名为 fctrl.app,配套网站独立维护于 FluentControl-Web。 ### 后续方向 | 方向 | 目标 | | --- | --- | | 更好的显示器兼容性 | 持续验证色温、场景模式、HDR 和原厂菜单控制,积累可靠的型号适配 | | 配置分享与适配库 | 上线型号预设分享、适配查询、诊断提交及审核流程 | | 更自然的多设备使用 | 改善插拔识别、离线设备管理、外部按键调节后的状态同步 | | 按场景自动调节 | 探索应用联动、定时配置和更多快捷操作 | 以上是后续方向,未承诺发布时间。详细开发任务和验收条件维护在 agent.md。 ### 参考项目与参与方式 以下项目为显示器控制与适配研究提供参考,具体功能仍以 FC 对相应硬件的验证为准。 | 项目 | 参考内容 | | --- | --- | | Twinkle Tray | 分阶段检测、隔离通信和显示器兼容处理 | | ddcutil | DDC/CI 控制、能力处理与自定义功能定义 | | ddccontrol-db | 按型号维护显示器控制描述的数据库 | | msigd | MSI 显示器 USB/HID 控制与型号差异处理 | | ddc-mode-switcher | 特定 ASUS 型号