Type something to search...
to navigateto selectESC to close

OverRec CLI 参考

OverRec 内置无界面 CLI 模式，支持脚本化和自动化操作。

OverRec.exe cli <命令> [选项]

monitors — 列出显示器

OverRec.exe cli monitors [--all]

不带 --all 时，输出精简的 ID/分辨率列表。 带 --all 时，输出完整详情：分辨率、绝对位置、缩放比例、刷新率、旋转角度及是否为主显示器。

示例输出（--all）：

ID    Resolution      Abs Position      Scale   Hz        Rot    Primary
0     1920x1080       (0, 0)            1       60        0°     yes
1     2560x1440       (1920, 0)         1       144       0°

window — 按标题关键词查找窗口

OverRec.exe cli window [--all] [<关键词...>]

列出标题包含所有给定关键词的可见窗口（不区分大小写）。输出的 WindowID 用于 snap 命令。

不带 --all 时，输出精简的 ID/标题列表。 带 --all 时，还会显示显示器编号、位置和尺寸。最大化或最小化的窗口位置显示为 max 或 min。

示例：

OverRec.exe cli window chrome
OverRec.exe cli window visual studio
OverRec.exe cli window --all note

默认输出示例：

WindowID        Title
------------------------------------------------------------
657846          Google Chrome
329812          Visual Studio Code

--all 输出示例：

WindowID        Mon   Location          Size          Title
--------------------------------------------------------------------------------
657846          0     0,0               1920x1080     Google Chrome
329812          0     max               1920x1080     Visual Studio Code
131070          1     1920,0            1280x720      Notepad

提示：不带关键词运行 OverRec.exe cli window 可列出所有可见窗口。

snap — 移动并调整窗口大小

OverRec.exe cli snap --windowid ID --location X,Y --size WxH [--monitor ID]

将 --windowid 指定的窗口移动并调整至给定位置和尺寸。DWM 阴影边距会自动修正，确保可见窗口框架精确落在指定坐标处。

选项说明
--windowid ID来自 OverRec.exe cli window 的窗口句柄
--location X,Y左上角像素坐标
--size WxH宽度 × 高度（像素）
--monitor ID可选。以指定显示器左上角为原点偏移 --location

示例：

# 对齐到屏幕绝对坐标
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1920x1080

# 对齐到显示器 1 的左上四分之一区域
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1280x720 --monitor 1

draw — 显示覆盖矩形

OverRec.exe cli draw --location X,Y --size WxH [--color COLOR] [--timeout SECS] [--monitor ID]

打开全屏透明覆盖层并绘制矩形。持续显示直至窗口关闭或超时。

选项说明
--location X,Y相对于显示器的左上角坐标
--size WxH宽度 × 高度（像素）
--color COLOR边框颜色：red、green、blue、yellow、white、black 或 #RRGGBB（默认：blue）
--timeout SECSN 秒后自动关闭
--monitor ID绘制所在显示器（默认：0）

示例：

OverRec.exe cli draw --location 100,100 --size 800x600
OverRec.exe cli draw --location 0,0 --size 1920x1080 --color "#FF4400" --timeout 3
OverRec.exe cli draw --location 200,200 --size 400x300 --monitor 1

screenshot — 截取区域到文件或剪贴板

OverRec.exe cli screenshot --location X,Y --size WxH [--output path.png] [--no-clipboard] [--monitor ID]

截取指定屏幕区域。默认将图像复制到剪贴板；使用 --output 可保存为文件（也可同时保存）。

选项说明
--location X,Y相对于显示器的左上角坐标
--size WxH宽度 × 高度（像素）
--output path.png保存为文件（必须以 .png 结尾）
--no-clipboard不复制到剪贴板
--monitor ID截取所在显示器（默认：0）

示例：

# 复制到剪贴板
OverRec.exe cli screenshot --location 0,0 --size 1920x1080

# 仅保存到文件
OverRec.exe cli screenshot --location 100,200 --size 800x600 --output capture.png --no-clipboard

# 保存并复制
OverRec.exe cli screenshot --location 0,0 --size 1280x720 --output shot.png

典型工作流

# 1. 列出显示器
OverRec.exe cli monitors --all

# 2. 查找要对齐的窗口
OverRec.exe cli window chrome

# 3. 将其对齐到显示器 0 的左半部分
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 960x1080

# 4. 可选：绘制参考矩形以验证区域
OverRec.exe cli draw --location 0,0 --size 960x1080 --timeout 2

# 5. 截取该区域截图
OverRec.exe cli screenshot --location 0,0 --size 960x1080 --output left-half.png