[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-6637":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},6637,"displayplacer","jakehilborn\u002Fdisplayplacer","jakehilborn","macOS command line utility to configure multi-display resolutions and arrangements. Essentially XRandR for macOS.","",null,"C",4447,163,26,95,0,1,10,31,6,68.74,"MIT License",false,"master",true,[],"2026-06-12 04:00:29","\u003Ca href=\"#\">\u003Cimg align=\"right\" src=\"animation.gif\">\u003C\u002Fa>\n\n## displayplacer\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg)](https:\u002F\u002Fgithub.com\u002Ffirstcontributions\u002Ffirst-contributions)  \nmacOS command line utility to configure multi-display resolutions and arrangements. Essentially XRandR for macOS.\n\n#### Download:\n\nInstall via Homebrew with `brew install displayplacer` or visit the [releases](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Freleases) tab.\n\n#### Usage:\n\nShow current screen info and possible resolutions: `displayplacer list`\n\nApply screen config (hz & color_depth are optional): `displayplacer \"id:\u003CscreenId> res:\u003Cwidth>x\u003Cheight> hz:\u003Cnum> color_depth:\u003Cnum> scaling:\u003Con\u002Foff> origin:(\u003Cx>,\u003Cy>) degree:\u003C0\u002F90\u002F180\u002F270>\"`\n\nApply screen config using mode: `displayplacer \"id:\u003CscreenId> mode:\u003CmodeNum> origin:(\u003Cx>,\u003Cy>) degree:\u003C0\u002F90\u002F180\u002F270>\"`\n\nApply screen config with mirrored screens: `displayplacer \"id:\u003CmainScreenId>+\u003C1stMirrorScreenId>+\u003C2ndMirrorScreenId> res:\u003Cwidth>x\u003Cheight> scaling:\u003Con\u002Foff> origin:(\u003Cx>,\u003Cy>) degree:\u003C0\u002F90\u002F180\u002F270>\"`\n\nSilence errors per-screen using quiet: `displayplacer \"id:\u003CscreenId> mode:\u003CmodeNum> origin:(\u003Cx>,\u003Cy>) degree:0 quiet:true\"`\n\nDisable a screen: `displayplacer \"id:\u003CscreenId> enabled:false\"`\n\n#### Instructions:\n1. Manually set rotations 1st*, resolutions 2nd, and arrangement 3rd. For extra resolutions and rotations read 'Notes' below.\n    - Open System Preferences -> Displays\n    - Choose desired screen rotations (use displayplacer for rotating internal MacBook screen).\n    - Choose desired resolutions (use displayplacer for extra resolutions).\n    - Drag the white bar to your desired primary screen.\n    - Arrange screens as desired and\u002For enable mirroring. To enable partial mirroring hold the alt\u002Foption key and drag a display on top of another.\n2. Use `displayplacer list` to print your current layout's args, so you can create profiles for scripting\u002Fhotkeys with [Automator](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F13), BetterTouchTool, etc.\n\n#### ScreenIds Switching:\nUnfortunately, macOS sometimes changes the persistent screenIds when there are race conditions from external screens waking up in non-determinisic order. If none of the screenId options below work for your setup, please search around in the GitHub Issues for conversation regarding this. Many people have written shell scripts to work around this issue. Recommended discussions are [one](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F80), [two](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F30), [three](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F89), [four](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F77), [five](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fissues\u002F100), [six](https:\u002F\u002Fgithub.com\u002Fjakehilborn\u002Fdisplayplacer\u002Fpull\u002F96).\n\nYou can mix and match screenId types across your setup.\n- Persistent screenIds usually stay the same. They are recommended for most use cases.\n- Contextual screenIds change when switching GPUs or when cables switch ports. If you notice persistent screenIds switching around, try using the contextual screenIds.\n- Serial screenIds are tied to your display hardware. If the serial screenIds are unique for all of your monitors, use these.\n\n#### Notes:\n- *`displayplacer list` and system prefs only show resolutions for the screen's current rotation.\n- Use an extra resolution shown in `displayplacer list` by executing `displayplacer \"id:\u003CscreenId> mode:\u003CmodeNum>\"`. Some of the resolutions listed do not work. If you select one, displayplacer will default to another working resolution.\n- Rotate your internal MacBook screen by executing `displayplacer \"id:\u003CscreenId> degree:\u003C0\u002F90\u002F180\u002F270>\"`\n- If you disable a screen, you may need to unplug\u002Freplug it to bring it back. However, on some setups, you can re-enable it with `displayplacer \"id:\u003CscreenId> enabled:true\"`\n- The screen set to origin (0,0) will be set as the primary screen (white bar in system prefs).\n- The first screenId in a mirroring set will be the 'Optimize for' screen in the system prefs. You can only choose resolutions for the 'Optimize for' screen. If there is a mirroring resolution you need but cannot find, try making a different screenId the first of the set.\n- hz and color_depth are optional. If left out, the highest hz and then the highest color_depth will be auto applied.\n- screenId is optional if there is only one screen. Rule of thumb is that displayplacer is expecting the entire profile config per screen though, so this may be buggy.\n\n#### Backward Compatability:\n`displayplacer list` output changed slightly in v1.4.0. If this broke your scripts, use `displayplacer list --v1.3.0`.\n\n#### Feedback:\nPlease create a GitHub Issue for any feedback, feature requests, bugs, Homebrew issues, etc. Happy to accept pull requests too!\n","displayplacer 是一个 macOS 命令行工具，用于配置多显示器的分辨率和排列。其核心功能包括显示当前屏幕信息、可能的分辨率，并允许用户通过命令行设置特定的分辨率、刷新率、颜色深度、缩放比例、屏幕位置及旋转角度等参数。该工具还支持镜像屏幕以及禁用屏幕等功能。displayplacer 采用 C 语言编写，适用于需要频繁切换多显示器配置或希望通过脚本自动化管理显示设置的场景，如开发环境搭建、演示文稿准备等。",2,"2026-06-11 03:07:59","top_language"]