Monitorian项目命令行操作完全指南：条件/定时/热键命令详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00443/article/details/148552438

Monitorian项目命令行操作完全指南：条件/定时/热键命令详解

Monitorian A Windows desktop tool to adjust the brightness of multiple monitors with ease 项目地址: https://gitcode.com/gh_mirrors/mo/Monitorian

Monitorian是一款强大的显示器亮度管理工具，除了基本的图形界面操作外，还提供了丰富的命令行功能。本文将详细介绍Monitorian的三种高级命令功能：条件命令、定时命令和热键命令，帮助用户实现自动化显示器管理。

一、条件命令（Conditional Commands）

条件命令允许用户设置当特定显示器达到指定亮度时自动执行的操作，非常适合需要多显示器协同工作的场景。

1.1 核心概念

条件命令由三个关键要素组成：

条件设备ID：作为触发条件的显示器设备ID
条件值：触发命令执行的亮度值（0-100）
执行命令：满足条件后要执行的操作列表

1.2 使用方式

条件命令需要通过JSON文件配置后加载，基本命令格式为：

monitorian /load conditional "JSON文件路径"

1.3 技术要点

互斥执行：当条件命令正在执行时，其他条件/定时/热键命令会被暂时阻止
同步模式限制：如果条件显示器处于同步模式，命令不会执行
完全替换：加载新命令会替换所有现有条件命令

1.4 JSON配置详解

示例配置展示了两种典型场景：

当显示器1亮度为50时，将显示器2亮度设为100，对比度设为50
当显示器1亮度为0时，将所有显示器亮度设为0

[
  {
    "ConditionalDeviceInstanceId": "显示器1设备ID",
    "ConditionalValue": 50,
    "Commands": [
      {
        "Option": "SetBrightness",
        "DeviceInstanceId": "显示器2设备ID",
        "IsAll": false,
        "Value": 100
      },
      {
        "Option": "SetContrast",
        "DeviceInstanceId": "显示器2设备ID",
        "IsAll": false,
        "Value": 50
      }
    ]
  }
]

二、定时命令（Time Commands）

定时命令让用户可以按照每日固定时间自动调整显示器设置，适合规律性工作环境。

2.1 核心参数

触发时间：小时(0-23)和分钟(0-59)
持续时间：命令有效时长(1-1439分钟)
执行命令：要执行的操作列表

2.2 延迟执行机制

定时命令设计了智能延迟执行机制：

如果系统在触发时间后启动（但在持续时间内），命令仍会执行
超过持续时间后启动系统，命令将不会执行

2.3 JSON配置示例

[
  {
    "DueTimeHours": 9,
    "DueTimeMinutes": 0,
    "DurationMinutes": 60,
    "Commands": [
      {
        "Option": "SetBrightness",
        "DeviceInstanceId": "显示器1设备ID",
        "IsAll": false,
        "Value": 40
      }
    ]
  }
]

三、热键命令（Key Commands）

热键命令为用户提供了快速调整显示设置的快捷键方案。

3.1 热键组成

按键组合：修饰键(Alt/Ctrl/Shift/Windows)与普通键的组合
描述信息：可选的热键说明
执行命令：按键触发的操作列表

3.2 特殊功能支持

除了亮度和对比度调整外，热键命令还支持：

输入源切换：可快速切换显示器输入源(如HDMI/DP)
获取输入源值：使用/get input命令查询设备支持的输入源值

3.3 常见输入源值参考

| 值 | 输入源类型 | |----|------------| | 15 | DisplayPort 1 | | 17 | HDMI 1 |

3.4 JSON配置示例

[
  {
    "KeyGesture": "Ctrl+Alt+O",
    "Description": "设置显示器1亮度为60",
    "Commands": [
      {
        "Option": "SetBrightness",
        "DeviceInstanceId": "显示器1设备ID",
        "IsAll": false,
        "Value": 60
      }
    ]
  }
]