DisplayDawn

DisplayDawn is a local-first Windows utility that automatically adjusts the brightness of an Apple Studio Display XDR from ambient-light readings or a time-based curve.

DisplayDawn 是一款本地运行的 Windows 自动亮度工具，可根据 Apple Studio Display XDR 的环境光传感器读数或时间曲线自动调节亮度。

The project is open source and under active development. No official signed binary release is available yet; build from source only if you understand the driver note below.

本项目已开源并仍在开发中。目前尚无正式签名的二进制版本；请在理解下方驱动说明后 再从源码构建。

Features / 功能

• Ambient-light automatic brightness with an editable response curve.
• Time-based brightness with editable day and night curves.
• Solar timing based on location, date, and time zone.
• Tray controls, pause/resume, light and dark themes, and Chinese/English UI.
• Local settings and rotating diagnostic logs; no accounts, analytics, telemetry, or cloud synchronization.

---

• 使用可编辑响应曲线，根据环境光自动调节亮度。
• 使用可编辑的昼夜曲线，按时间自动调节亮度。
• 根据位置、日期和时区计算太阳时刻。
• 提供托盘控制、暂停/继续、明暗主题和中英文界面。
• 设置和滚动诊断日志仅保存在本机，不含账号、分析、遥测或云同步。

Requirements / 环境要求

• Windows 11 x64
• Apple Studio Display XDR connected over USB
• .NET SDK 10.0.302 for building from source

The app can use time-based brightness without the ambient-light component. Ambient-light mode requires binding the display's MI_08 interface to WinUSB and therefore requires administrator approval.

应用可在不安装环境光组件的情况下使用时间曲线模式。环境光模式需要把显示器的 MI_08 接口绑定到 WinUSB，因此安装时需要管理员确认。

Driver notice / 驱动说明

Normal source builds do not embed or install a sensor driver. Maintainers can explicitly opt into the self-signed, libwdi-generated development package with -p:EnableDevelopmentDriver=true. That package targets only the display's MI_08 ambient-light interface; it does not target the camera, speakers, microphone, or brightness-control interface. It is intended for controlled development and testing, not public distribution.

普通源码构建不会内置或安装传感器驱动。维护者可通过 -p:EnableDevelopmentDriver=true 显式启用由 libwdi 生成并自签名的开发驱动包。 该驱动包仅面向显示器的 MI_08 环境光接口，不会绑定摄像头、扬声器、麦克风或亮度 控制接口；它仅供受控开发和测试，不用于公开分发。

Before installing a development build, create a restore point and make sure you know how to restore the original device driver in Windows Device Manager. Driver installation always deserves the same care as other system-level changes.

安装开发构建前，建议创建系统还原点，并确认能够在 Windows 设备管理器中恢复原始 设备驱动。驱动安装属于系统级改动，请谨慎操作。

The opt-in development package adds its self-signed certificate to the local machine's trust stores before installing the driver. Do not enable it on a general-purpose or production system.

显式启用的开发驱动会在安装前把自签名证书加入本机信任存储。不要在通用工作电脑或 生产环境中启用。

Build and test / 构建与测试

Run these commands from the repository root on Windows:

在 Windows 的仓库根目录运行：

dotnet restore tests/XdrAutoBrightness.Tests/XdrAutoBrightness.Tests.csproj
dotnet build tests/XdrAutoBrightness.Tests/XdrAutoBrightness.Tests.csproj --configuration Release --no-restore
dotnet run --project tests/XdrAutoBrightness.Tests/XdrAutoBrightness.Tests.csproj --configuration Release --no-build

To start the app from source:

从源码启动应用：

dotnet run --project src/XdrAutoBrightness.App/XdrAutoBrightness.App.csproj --configuration Release

The repository pins the exact SDK in global.json. The test project is a self-contained executable test harness; a successful run exits with code 0 and prints the passed test count.

仓库通过 global.json 固定 SDK 版本。测试项目是独立的可执行测试 入口；全部通过时退出码为 0，并输出通过数量。

Privacy / 隐私

DisplayDawn runs locally and does not send settings or sensor readings over the network. See legal/PRIVACY.txt for the complete bilingual privacy notice.

DisplayDawn 仅在本机运行，不会通过网络发送设置或传感器读数。完整中英文说明见 legal/PRIVACY.txt。

Contributing / 参与贡献

Bug reports, focused feature proposals, documentation improvements, and pull requests are welcome. Please read CONTRIBUTING.md before starting. For a possible security issue, follow SECURITY.md instead of opening a public issue.

欢迎提交缺陷报告、聚焦的功能建议、文档改进和 Pull Request（拉取请求）。开始前请 阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告，不要创建公开 Issue（议题）。

License / 许可证

Original DisplayDawn code is available under the MIT License. Bundled third-party material remains under its original license; details are in legal/THIRD-PARTY-NOTICES.txt.

DisplayDawn 原创代码采用 MIT 许可证。仓库内的第三方材料继续适用其原始 许可证，详见 legal/THIRD-PARTY-NOTICES.txt。

Apple, Studio Display, and related marks are trademarks of Apple Inc. DisplayDawn is an independent project and is not affiliated with, endorsed by, or sponsored by Apple Inc.