displayplacer

macOS命令行工具，用于配置多显示器分辨率和排列。本质上是macOS版的XRandR。

下载：

通过Homebrew安装：brew install displayplacer，或访问releases页面。

使用方法：

显示当前屏幕信息和可用分辨率：displayplacer list

应用屏幕配置（hz和color_depth为可选项）：displayplacer "id:<screenId> res:<width>x<height> hz:<num> color_depth:<num> scaling:<on/off> origin:(<x>,<y>) degree:<0/90/180/270>"

使用模式应用屏幕配置：displayplacer "id:<screenId> mode:<modeNum> origin:(<x>,<y>) degree:<0/90/180/270>"

应用带镜像屏幕的配置：displayplacer "id:<mainScreenId>+<1stMirrorScreenId>+<2ndMirrorScreenId> res:<width>x<height> scaling:<on/off> origin:(<x>,<y>) degree:<0/90/180/270>"

使用quiet选项来屏蔽每个屏幕的错误：displayplacer "id:<screenId> mode:<modeNum> origin:(<x>,<y>) degree:0 quiet:true"

禁用屏幕：displayplacer "id:<screenId> enabled:false"

使用说明：

手动设置顺序：先旋转*，再分辨率，最后排列。更多分辨率和旋转选项请参阅下方"注意事项"。
- 打开系统偏好设置 -> 显示器
- 选择所需的屏幕旋转（使用displayplacer旋转内置MacBook屏幕）。
- 选择所需的分辨率（使用displayplacer获取额外分辨率）。
- 将白条拖到您想要的主屏幕上。
- 按需排列屏幕和/或启用镜像。要启用部分镜像，请按住alt/option键并将一个显示器拖到另一个上面。
使用displayplacer list打印当前布局的参数，以便使用Automator、BetterTouchTool等创建用于脚本/快捷键的配置文件。

屏幕ID切换：

不幸的是，当外部屏幕以不确定的顺序唤醒时出现竞争条件，macOS有时会更改持久性屏幕ID。如果以下屏幕ID选项都不适用于您的设置，请在GitHub Issues中搜索相关讨论。许多人已经编写了shell脚本来解决这个问题。推荐的讨论有一、二、三、四、五、六。

您可以在设置中混合使用不同类型的屏幕ID。

持久性屏幕ID通常保持不变。推荐用于大多数情况。
上下文屏幕ID在切换GPU或电缆切换端口时会变化。如果发现持久性屏幕ID经常变化，可尝试使用上下文屏幕ID。
序列号屏幕ID与显示器硬件相关联。如果所有显示器的序列号屏幕ID都是唯一的，请使用这些。

注意事项：

*displayplacer list和系统偏好设置只显示当前屏幕旋转的分辨率。
通过执行displayplacer "id:<screenId> mode:<modeNum>"使用displayplacer list中显示的额外分辨率。列出的某些分辨率可能不起作用。如果选择了不起作用的分辨率，displayplacer将默认使用另一个可用的分辨率。
通过执行displayplacer "id:<screenId> degree:<0/90/180/270>"旋转内置MacBook屏幕。
如果禁用屏幕，可能需要拔插以重新启用。但在某些设置中，可以通过displayplacer "id:<screenId> enabled:true"重新启用。
设置为原点(0,0)的屏幕将被设为主屏幕（系统偏好设置中的白条）。
镜像设置中的第一个屏幕ID将成为系统偏好设置中的"针对...进行优化"屏幕。只能为"针对...进行优化"屏幕选择分辨率。如果需要某个镜像分辨率但找不到，请尝试将不同的屏幕ID设为集合中的第一个。
hz和color_depth为可选项。如果未指定，将自动应用最高的hz，然后是最高的color_depth。
如果只有一个屏幕，screenId是可选的。经验法则是displayplacer期望每个屏幕都有完整的配置文件，所以这可能会有bug。