Twinkle Tray 安装和配置指南

1. 项目基础介绍和主要编程语言

Twinkle Tray 是一个开源项目，旨在帮助 Windows 用户轻松管理多个显示器的亮度。该项目的主要编程语言是 JavaScript，使用了 Node.js 和 Electron 框架来构建桌面应用程序。Twinkle Tray 通过 DDC/CI 协议与显示器通信，允许用户从系统托盘中直接调整显示器的亮度。

2. 项目使用的关键技术和框架

Twinkle Tray 使用了以下关键技术和框架：

• Node.js: 一个基于 Chrome V8 引擎的 JavaScript 运行时，用于构建服务器端和桌面应用程序。
• Electron: 一个使用 Web 技术（HTML、CSS、JavaScript）构建跨平台桌面应用程序的框架。
• React: 一个用于构建用户界面的 JavaScript 库，Twinkle Tray 使用 React 来创建系统托盘中的亮度控制界面。
• DDC/CI: 显示数据通道命令接口，用于与显示器通信，控制亮度、对比度等参数。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 Twinkle Tray 之前，请确保您的系统满足以下要求：

• 操作系统: Windows 10 或 Windows 11。
• 硬件: 支持 DDC/CI 协议的显示器。大多数现代显示器都支持此协议，但可能需要手动启用。
• 软件: 确保您的系统已安装最新版本的 Node.js 和 npm（Node.js 的包管理器）。

安装步骤

1. 下载项目:

   • 打开命令提示符（CMD）或 PowerShell。
   • 使用以下命令克隆 Twinkle Tray 的 GitHub 仓库：

     git clone https://github.com/xanderfrangos/twinkle-tray.git
     

2. 安装依赖:

   • 进入项目目录：

     cd twinkle-tray
     

   • 安装项目依赖：

     npm install
     

3. 构建项目:

   • 使用以下命令构建项目：

     npm run build
     

   • 构建完成后，您将在项目目录中找到生成的可执行文件。

4. 运行项目:

   • 使用以下命令运行 Twinkle Tray：

     npm start
     

   • 如果一切正常，您将在系统托盘中看到 Twinkle Tray 的图标。

5. 配置显示器:

   • 右键点击系统托盘中的 Twinkle Tray 图标，选择“设置”。
   • 在设置中，您可以配置每个显示器的亮度、对比度等参数。
   • 您还可以设置自动亮度调整，根据时间或系统活动自动调整显示器亮度。

常见问题

• 显示器不支持 DDC/CI: 如果您的显示器不支持 DDC/CI，Twinkle Tray 可能无法正常工作。请查阅显示器的用户手册，确保启用了 DDC/CI 功能。
• AMD Radeon Control Panel 干扰: 如果您的系统安装了 AMD Radeon Control Panel，请确保“自定义颜色”选项未启用，以避免与 Twinkle Tray 冲突。

通过以上步骤，您应该能够成功安装和配置 Twinkle Tray，并享受轻松管理多个显示器亮度的便利。