OpenDisplay

<p align="center"> <img src="AppIcon.iconset/icon_256x256.png" width="120" alt="OpenDisplay"/> </p> <h1 align="center">OpenDisplay</h1> <p align="center"> Open-source macOS display manager. Free alternative to BetterDisplay.<br> <a href="https://sahilmishra0012.github.io/OpenDisplay/">Website</a> · <a href="https://github.com/sahilmishra0012/OpenDisplay/releases/latest">Download</a> · <a href="#install">Install</a> </p> <p align="center"> <a href="https://github.com/sahilmishra0012/OpenDisplay/releases/latest"><img src="https://img.shields.io/github/v/release/sahilmishra0012/OpenDisplay?style=for-the-badge&color=4da6ff&labelColor=1a1a24" alt="Release"></a> <img src="https://img.shields.io/badge/macOS_14+-1a1a24?style=for-the-badge&logo=apple&logoColor=white" alt="macOS"> <img src="https://img.shields.io/badge/Apple_Silicon-native-00c9a7?style=for-the-badge&labelColor=1a1a24" alt="Apple Silicon"> <a href="https://github.com/sahilmishra0012/OpenDisplay/blob/main/LICENSE"><img src="https://img.shields.io/github/license/sahilmishra0012/OpenDisplay?style=for-the-badge&color=1a1a24&labelColor=1a1a24" alt="License"></a> <a href="https://github.com/sahilmishra0012/OpenDisplay/stargazers"><img src="https://img.shields.io/github/stars/sahilmishra0012/OpenDisplay?style=for-the-badge&color=1a1a24&labelColor=1a1a24&logo=github" alt="Stars"></a> </p>

---

Features

| | Feature | Details | |---|---|---| | 🖥 | DDC/CI Control | Brightness, contrast, volume, sharpness, input switching, power on/off | | 🎛 | Resolution | All modes including hidden HiDPI, refresh rate switching, display arrangement | | 🌙 | Night Shift | Scheduled color temperature, gamma & overlay dimming, dim to black | | ☀️ | HDR Brightness | Unlock XDR/HDR up to 1600 nits on supported displays | | 🪟 | Window Tiling | Edge snapping, corners, grid layouts (2×2, 3×2), auto-tile all windows | | 📋 | Profiles | Save/load display settings, auto-apply when a monitor connects | | ⌨️ | CLI & Automation | Full CLI, URL scheme (opendisplay://), global hotkeys, Shortcuts-ready | | 🔆 | Smart Sync | Ambient light sensor sync, multi-display brightness sync | | 🪶 | Lightweight | Native Swift, under 1MB, menu bar app, no Electron |

---

Install

Homebrew

brew tap sahilmishra0012/opendisplay
brew install --cask opendisplay

Direct Download — latest release (DMG or ZIP)

Build from source

git clone https://github.com/sahilmishra0012/OpenDisplay.git
cd OpenDisplay && swift run

---

Usage

CLI

opendisplay --list                           # List displays
opendisplay --display 0 --brightness 70      # Set brightness
opendisplay --display 0 --input hdmi1        # Switch input
opendisplay --display 0 --resolution 2560x1440
opendisplay --help                           # All commands

URL Scheme — works with Raycast, Shortcuts, Alfred

opendisplay://brightness/80?display=0
opendisplay://input/hdmi1
opendisplay://tile/left
opendisplay://profile/MyProfile

Menu Bar — left-click opens the full UI, right-click for quick brightness presets and profiles.

---

Known Limitations

| Issue | Workaround | |---|---| | HDMI on Apple Silicon doesn't support DDC | Connect via USB-C/Thunderbolt, or use gamma dimming fallback | | Some monitors have partial DDC support | Depends on monitor firmware — not all features work on all monitors | | Window tiling needs Accessibility permission | System Settings → Privacy & Security → Accessibility | | After brew upgrade, tiling may stop working | Re-add OpenDisplay to Accessibility (macOS resets permission when binary changes) |

---

Contributing

PRs welcome! Some ideas: virtual displays, keyboard shortcut config UI, LG webOS TV control, Picture-in-Picture, localization.

Support

If OpenDisplay is useful to you, consider sponsoring the project ❤️

<a href="https://github.com/sponsors/sahilmishra0012"><img src="https://img.shields.io/badge/Sponsor-EA4AAA?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="Sponsor"></a>

License

MIT