displayplacer

displayplacer

macOS多显示器配置命令行工具

displayplacer是一款macOS命令行工具,用于配置多显示器的分辨率、排列和旋转。它能列出当前屏幕信息、应用屏幕配置、设置镜像显示和管理屏幕状态。该工具可通过Homebrew安装,支持创建脚本和热键配置文件,方便快速切换显示器布局。为解决macOS中屏幕ID变化问题,displayplacer提供了多种屏幕ID识别选项。

macOS显示器配置命令行工具分辨率屏幕排列Github开源项目

<a href="#"><img align="right" src="https://yellow-cdn.veclightyear.com/835a84d5/cbbabb62-8684-4f6f-85d8-a080989a4e7e.gif"></a>

displayplacer

欢迎PR
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"

使用说明:

  1. 手动设置顺序:先旋转*,再分辨率,最后排列。更多分辨率和旋转选项请参阅下方"注意事项"。
    • 打开系统偏好设置 -> 显示器
    • 选择所需的屏幕旋转(使用displayplacer旋转内置MacBook屏幕)。
    • 选择所需的分辨率(使用displayplacer获取额外分辨率)。
    • 将白条拖到您想要的主屏幕上。
    • 按需排列屏幕和/或启用镜像。要启用部分镜像,请按住alt/option键并将一个显示器拖到另一个上面。
  2. 使用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。

向后兼容性:

displayplacer list的输出在v1.4.0中略有变化。如果这破坏了您的脚本,请使用displayplacer list --v1.3.0

反馈:

请为任何反馈、功能请求、错误、Homebrew问题等创建GitHub Issue。也欢迎提交pull请求!

编辑推荐精选

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

Refly.AI

Refly.AI

最适合小白的AI自动化工作流平台

无需编码,轻松生成可复用、可变现的AI自动化工作流

酷表ChatExcel

酷表ChatExcel

大模型驱动的Excel数据处理工具

基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。

AI工具酷表ChatExcelAI智能客服AI营销产品使用教程
TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
AIWritePaper论文写作

AIWritePaper论文写作

AI论文写作指导平台

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

AI辅助写作AI工具AI论文工具论文写作智能生成大纲数据安全AI助手热门
博思AIPPT

博思AIPPT

AI一键生成PPT,就用博思AIPPT!

博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。

AI办公办公工具AI工具博思AIPPTAI生成PPT智能排版海量精品模板AI创作热门
潮际好麦

潮际好麦

AI赋能电商视觉革命,一站式智能商拍平台

潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。

iTerms

iTerms

企业专属的AI法律顾问

iTerms是法大大集团旗下法律子品牌,基于最先进的大语言模型(LLM)、专业的法律知识库和强大的智能体架构,帮助企业扫清合规障碍,筑牢风控防线,成为您企业专属的AI法律顾问。

SimilarWeb流量提升

SimilarWeb流量提升

稳定高效的流量提升解决方案,助力品牌曝光

稳定高效的流量提升解决方案,助力品牌曝光

Sora2视频免费生成

Sora2视频免费生成

最新版Sora2模型免费使用,一键生成无水印视频

最新版Sora2模型免费使用,一键生成无水印视频

下拉加载更多