Twinkle Tray 技术文档

Twinkle Tray 技术文档

twinkle-tray Easily manage the brightness of your monitors in Windows from the system tray 项目地址: https://gitcode.com/gh_mirrors/tw/twinkle-tray

Twinkle Tray 是一个便捷的亮度调节工具，专为解决Windows系统在管理多显示器亮度时的不足而设计。通过在系统托盘添加图标，提供即时访问所有兼容显示设备的亮度控制滑块。本文档将指导您完成安装、使用以及了解其API特点。

安装指南

直接下载安装

您可以从官方网站 twinkletray.com 或 GitHub 的 Releases 页面 下载最新版本的安装程序并执行。

包管理器安装

对于喜欢命令行操作的用户，可以通过以下包管理器进行安装：

• Windows Package Manager:

  winget install xanderfrangos.twinkletray
  

• Chocolatey (非官方):

  choco install twinkle-tray
  

• Scoop (非官方):

  首先添加Scoop的Extras桶，然后安装Twinkle Tray。

  scoop bucket add extras
  scoop install extras/twinkle-tray
  

请注意，通过包管理器安装的Twinkle Tray的维护可能不在该项目的直接责任范围内。

使用说明

1. 完成安装后，系统启动时Twinkle Tray会自动运行，并在系统托盘显示图标。
2. 点击托盘图标，会出现亮度调节面板，允许即刻调整亮度。
3. 右键点击图标可选择退出程序。
4. 您还可以通过设置界面绑定快捷键来快速调整特定或所有显示器的亮度。

项目API使用文档

自v1.13.0起，Twinkle Tray支持通过命令行参数调整亮度，但不适用于Windows Store版本。

支持的命令行参数示例：

• 调整指定显示器亮度（例如第1个显示器减亮30）:

  "%LocalAppData%\Programs\twinkle-tray\Twinkle Tray.exe" --MonitorNum=1 --Offset=-30
  

• 列出所有连接的显示器（需要v1.14.0及以上版本）:

  "%LocalAppData%\Programs\twinkle-tray\Twinkle Tray.exe" --List
  

• 设置所有显示器的亮度至95%:

  "%LocalAppData%\Programs\twinkle-tray\Twinkle Tray.exe" --All --Set=95
  

注意事项:

• 必须在Twinkle Tray运行时使用这些命令。
• 使用--VCP选项可以发送DDC/CI代码和值到显示器，但需要准确知道所使用的代码和对应的显示器支持。

项目安装方式回顾

此部分已包含在上述安装指南中，主要涉及直接下载安装、利用包管理器（如winget, Chocolatey, Scoop）进行安装等方法。

---

通过以上步骤，您可以轻松地安装和利用Twinkle Tray来优化您的多显示器环境下的亮度管理体验。对于开发者和高级用户，掌握API的使用也能带来更灵活的自动化控制选项。记得查看最新的文档和GitHub页面以获取更新信息。

twinkle-tray Easily manage the brightness of your monitors in Windows from the system tray 项目地址: https://gitcode.com/gh_mirrors/tw/twinkle-tray