# Install displayplacer with Homebrew, MacPorts Utility to configure multi-display resolutions and arrangements. Version 1.4.0 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:displayplacer ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install displayplacer ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install displayplacer ``` Evidence: MacPorts ports tree: sysutils/displayplacer/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:displayplacer - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.4.0 - **Source summary:** Utility to configure multi-display resolutions and arrangements - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - displayplacer (cli) - displayplacer (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.4.0 - Local data: ok - Upstream repository: https://github.com/jakehilborn/displayplacer - Upstream latest detected: v1.4.0 (current) - info: No package-manager update timestamp was available. ## Project history and usage displayplacer is a macOS command-line utility for configuring multi-display resolutions, arrangements, mirroring, rotation, refresh rate, color depth, and enabled state. Upstream describes it as essentially an XRandR-like tool for macOS, which explains its strong appeal to users who script workstation layouts. ### Project history The GitHub repository was created in June 2015, with the first GitHub release listed as v1.0.0 in November 2018. Later releases include v1.4.0 in June 2023, when the README notes a backward-compatibility concern around changed `displayplacer list` output. ### Adoption history The README leads with Homebrew installation and release downloads, while the input package metadata also records MacPorts. Its adoption is tightly tied to macOS automation culture: shell scripts, hotkeys, Automator, BetterTouchTool, and repeatable monitor profiles. ### How it is used Users commonly run `displayplacer list` to print the current layout and supported modes, then reuse generated arguments in scripts to restore a known display arrangement. The README spends unusual space on screen ID stability because macOS can expose changing identifiers when external displays wake or reconnect. ### Why package nerds care displayplacer is a package-nerd favorite because it fills a native-platform gap with a single CLI. It turns GUI display state into reproducible command arguments, making macOS monitor layouts manageable by dotfiles, launchers, and package-installed tooling. ### Timeline - 2015-06: GitHub repository created - 2018-11: v1.0.0 release published - 2023-06: v1.4.0 release published ### Related projects - Related tools and workflows include XRandR on Linux, macOS Displays settings, Automator, BetterTouchTool, and user scripts that compensate for changing monitor identifiers. ### Sources - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** displayplacer - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** macos - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - MacPorts - displayplacer: normalized package name match | MacPorts ports tree: sysutils/displayplacer/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [m1ddc](https://www.automicvault.com/pkg/brew/m1ddc/) - Shares av.db curated category or tags: cli, display-management, macos, system. - [brightness](https://www.automicvault.com/pkg/brew/brightness/) - Shares av.db curated category or tags: cli, display, macos, system. - [ddcctl](https://www.automicvault.com/pkg/brew/ddcctl/) - Shares av.db curated category or tags: cli, macos, monitor, system. - [screenresolution](https://www.automicvault.com/pkg/brew/screenresolution/) - Shares av.db curated category or tags: cli, display, macos, system. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, macos, system. - [augeas](https://www.automicvault.com/pkg/brew/augeas/) - Shares av.db curated category or tags: cli, configuration, system. - [bluetoothconnector](https://www.automicvault.com/pkg/brew/bluetoothconnector/) - Shares av.db curated category or tags: cli, macos, system. - [blueutil](https://www.automicvault.com/pkg/brew/blueutil/) - Shares av.db curated category or tags: cli, macos, system. ## Combined YAML source View the package source record on GitHub. [combined/displayplacer.yml](https://github.com/automic-vault/db/blob/main/combined/displayplacer.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph