macOS CLI tool to configure multi-display resolutions and arrangements

displayplacer

PRs Welcome
macOS command line utility to configure multi-display resolutions and arrangements. Essentially XRandR for macOS.

Install via Homebrew with brew tap jakehilborn/jakehilborn && brew install displayplacer or visit the releases tab.

Usage:

Show current screen info and possible resolutions: displayplacer list

Apply screen config (hz & color_depth are optional): displayplacer "id: res:x hz: color_depth: scaling: origin:(,) degree:<0/90/180/270>"

Apply screen config using mode: displayplacer "id: mode: origin:(,) degree:<0/90/180/270>"

Apply screen config with mirrored screens: displayplacer "id:+<1stMirrorScreenId>+<2ndMirrorScreenId> res:x scaling: origin:(,) degree:<0/90/180/270>"

Example w/ all features: displayplacer "id:18173D22-3EC6-E735-EEB4-B003BF681F30+F466F621-B5FA-04A0-0800-CFA6C258DECD res:1440x900 scaling:on origin:(0,0) degree:0" "id:4C405A05-8798-553B-3550-F93E7A7722BB res:768x1360 hz:60 color_depth:8 scaling:off origin:(1440,0) degree:90" "id:A46D2F5E-487B-CC69-C588-ECFD519016E5 mode:3 origin:(-1440,0) degree:270"

Instructions:

  1. Manually set rotations 1st*, resolutions 2nd, and arrangement 3rd. For extra resolutions and rotations read ‘Notes’ below.
    • Open System Preferences -> Displays
    • Choose desired screen rotations (use displayplacer for rotating internal MacBook screen).
    • Choose desired resolutions (use displayplacer for extra resolutions).
    • Drag the white bar to your desired primary screen.
    • Arrange screens as desired and/or enable mirroring. To enable partial mirroring hold the alt/option key and drag a display on top of another.
  2. Use displayplacer list to print your current layout’s args so you can create profiles for scripting/hotkeys with Automator, BetterTouchTool, etc.

Notes:

  • *displayplacer list and system prefs only show resolutions for the screen’s current rotation.
  • Use an extra resolution shown in displayplacer list by executing displayplacer "id: mode:"
  • Rotate your internal MacBook screen by executing displayplacer "id: degree:<0/90/180/270>"
  • The screen set to origin (0,0) will be set as the primary screen (white bar in system prefs).
  • 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.
  • hz and color_depth are optional. If left out, the highest hz and then the highest color_depth will be auto applied.
  • Persistent screen ids always stay the same. Contextual screen ids change when switching GPUs or when switching ports. It’s recommended to use persistent screen ids. In some rare cases, you may need to use contextual screen ids since the modes list changes when macOS switches GPUs.

Feedback:

Please create a GitHub Issue for any feedback, feature requests, bugs, Homebrew issues, etc. Happy to accept pull requests too!

Read More
Buffy Fleishman

Latest

Indian companies tap stock market for record ₹2.3 lakh crore despite global turmoil

Indian companies raised a record ₹2.3 lakh crore through IPOs, FPOs and rights issues in FY26, with strong retail investor participation helping India remain the world's busiest IPO market despite global uncertainty. 3 Min Read India's primary market recorded a historic surge in public equity fundraising during 2025-26, with capital raised through initial public offerings

XRP Leads Top Undervalued Altcoins to Watch in 2026

Despite months of weak price action across the crypto market, some analysts believe several large-cap altcoins are trading below their long-term value. The analysis highlights Solana (SOL), Chainlink (LINK), and XRP, citing continued development, institutional interest, and growing network activity despite the broader market downturn. Solana Still Drawing Institutional Demand Among the three, Solana is

How Bank Money Learned to Move Like Crypto: Open Banking, Instant Payments and Finland in 2026

Ask anyone who has actually used crypto and they will tell you the appeal was never speculation but settlement: value that moves in seconds, at any hour, with no card number typed in and no three-day wait. For most of the last decade that experience stopped at the wallet. In 2026 it no longer does.

CLARITY Act Runs Out of Time, Will Congress Extend The Recess?

Clarity Act has just two working days left before the August recess starts. Senate Majority Leader John Thune did not file the required cloture motion, putting the bill at risk. Meanwhile, Republican Sen. Josh Hawley has become the first GOP senator to oppose the bill over banking concerns. Despite this, some senator belive that a

Newsletter

Don't miss

Indian companies tap stock market for record ₹2.3 lakh crore despite global turmoil

Indian companies raised a record ₹2.3 lakh crore through IPOs, FPOs and rights issues in FY26, with strong retail investor participation helping India remain the world's busiest IPO market despite global uncertainty. 3 Min Read India's primary market recorded a historic surge in public equity fundraising during 2025-26, with capital raised through initial public offerings

XRP Leads Top Undervalued Altcoins to Watch in 2026

Despite months of weak price action across the crypto market, some analysts believe several large-cap altcoins are trading below their long-term value. The analysis highlights Solana (SOL), Chainlink (LINK), and XRP, citing continued development, institutional interest, and growing network activity despite the broader market downturn. Solana Still Drawing Institutional Demand Among the three, Solana is

How Bank Money Learned to Move Like Crypto: Open Banking, Instant Payments and Finland in 2026

Ask anyone who has actually used crypto and they will tell you the appeal was never speculation but settlement: value that moves in seconds, at any hour, with no card number typed in and no three-day wait. For most of the last decade that experience stopped at the wallet. In 2026 it no longer does.

CLARITY Act Runs Out of Time, Will Congress Extend The Recess?

Clarity Act has just two working days left before the August recess starts. Senate Majority Leader John Thune did not file the required cloture motion, putting the bill at risk. Meanwhile, Republican Sen. Josh Hawley has become the first GOP senator to oppose the bill over banking concerns. Despite this, some senator belive that a

IMAX CEO sends strong words to investors and praises Nolan

Please enable JS and disable any ad blocker

The business of football

Mar­i­ano Browne The FI­FA World Cup is the largest sin­gle-event sport­ing com­pe­ti­tion in the world. No sin­gle sport­ing event match­es the sin­gu­lar, world­wide fo­cus and tele­vi­sion view­er­ship of the World Cup. The 2026 ver­sion is es­ti­mat­ed to have reached over 5 bil­lion peo­ple, out of the world’s 8.3 bil­lion. It is the most pop­u­lar sport

‘Sabah is open for business’: Hajiji courts investors with promise of sustainable growth, carbon‑negative credentials

Sabah is pitching itself as an Asia-Pacific hub for impact investing, betting that its forests, biodiversity and natural resources can become drivers of economic growth as it seeks private capital for sustainable development. — Picture by Firdaus Latif By Julia Chan First Published: Monday, 13 Jul 2026 11:44 AM MYT KOTA KINABALU, July 13 —

Want Your Business to Be Seen Everywhere? Meet Tonia Ryan, Creator of Fix Your Search

Some people are good at their jobs. Then there is Tonia Ryan, who has turned “getting found online” into something close to magic. She is the creator of Fix Your Search, and if you have ever wondered why some businesses pop up everywhere while others seem invisible...