# Install displayplacer with Homebrew, MacPorts Utility to configure multi-display resolutions and arrangements. Version 1.4.0 via Homebrew; verified from local package data. Also installable with macports: sudo port install displayplacer. ## 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 - **Version:** 1.4.0 - **Source summary:** Utility to configure multi-display resolutions and arrangements - **Homepage:** - **Repository:** - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - displayplacer (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 1.4.0 ## 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 ## 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 ## Combined YAML source View the package source record on GitHub. [combined/displayplacer.yml](https://github.com/mxcl/pkgdb/blob/main/combined/displayplacer.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph