explaingit

waydabber/betterdisplay

Analysis updated 2026-06-20

31,566Audience · generalComplexity · 1/5LicenseSetup · easy

TLDR

BetterDisplay is a macOS app that unlocks display settings Apple hides, fixing blurry external monitors with HiDPI scaling, enabling full brightness on HDR screens, and letting you control monitor settings via keyboard.

Mindmap

mindmap
  root((betterdisplay))
    What it does
      Unlocks hidden macOS display settings
      HiDPI for any external monitor
      DDC brightness control
    Tech Stack
      macOS binary
      Closed source
      Apple Silicon and Intel
    Use Cases
      Fix blurry monitors
      Keyboard brightness control
      HDR brightness unlock
      Headless Mac virtual screen
    Audience
      Mac power users
      Remote workers
      Developers with external monitors
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Fix a blurry external monitor on a Mac by enabling HiDPI scaling for displays macOS doesn't recognize as Retina-capable.

USE CASE 2

Control monitor brightness, contrast, and input source via keyboard shortcuts using DDC without touching physical buttons.

USE CASE 3

Push an XDR or HDR display past macOS's 100% brightness cap to its true hardware maximum.

USE CASE 4

Create a virtual screen on a headless Mac so remote desktop sessions have a proper display to connect to.

How does it compare?

waydabber/betterdisplaypear-devs/pear-desktopalpinejs/alpine
Stars31,56631,57931,526
LanguageTypeScriptHTML
Setup difficultyeasymoderateeasy
Complexity1/53/52/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Download the binary from GitHub releases and install like any macOS app, most advanced features require purchasing the Pro version.

Closed-source binary, free tier available with basic features, advanced features require a paid Pro license.

In plain English

BetterDisplay is a macOS application that extends and overrides the display configuration options that Apple exposes through System Settings, enabling capabilities that are either locked out or not available through the standard interface. The primary language is listed as unknown, consistent with this being a closed-source binary distributed via GitHub releases rather than source code. The tool addresses several common frustrations Mac users have with external displays. Many monitors connected to Macs do not offer proper HiDPI scaling, meaning text and UI elements look blurry or too small. BetterDisplay enables flexible HiDPI scaling for any connected display, including those that macOS would not normally treat as Retina-capable. It also allows XDR and HDR displays to go beyond 100% brightness to their maximum hardware capability, which macOS caps by default. Other features include DDC control, which is a standard protocol that lets software change a monitor's brightness, contrast, and input directly through the video cable without needing a physical button. The app supports creating virtual screens, displaying a real screen as a picture-in-picture window, disconnecting and reconnecting monitors on demand, EDID overrides (EDID is the data a monitor sends to the computer to describe its capabilities), and color mode controls. You would use BetterDisplay when you have an external monitor that looks blurry on your Mac, want to control a display's brightness via keyboard shortcuts, need to create virtual screens for remote access on a headless Mac, or want access to display settings that macOS intentionally hides. It runs on macOS Ventura, Sonoma, and Sequoia, and supports both Apple Silicon and Intel Macs. A paid Pro version unlocks most advanced features beyond the basics.

Copy-paste prompts

Prompt 1
I'm using waydabber/betterdisplay on a Mac with a 4K external monitor that looks blurry. How do I enable HiDPI scaling for it and what resolution should I pick?
Prompt 2
Using waydabber/betterdisplay, how do I set up a keyboard shortcut to control my monitor's brightness via DDC without using the physical buttons?
Prompt 3
I have a Pro Apple XDR Display and want to go above 100% brightness in macOS. How does waydabber/betterdisplay unlock this and what are the risks?
Prompt 4
I'm setting up a headless Mac mini as a remote server. How do I use waydabber/betterdisplay to create a virtual screen so I can remote desktop into it at full resolution?
Prompt 5
Using waydabber/betterdisplay, how do I override the EDID data for a monitor that macOS misidentifies, so it gets the correct resolution and color profile?

Frequently asked questions

What is betterdisplay?

BetterDisplay is a macOS app that unlocks display settings Apple hides, fixing blurry external monitors with HiDPI scaling, enabling full brightness on HDR screens, and letting you control monitor settings via keyboard.

What license does betterdisplay use?

Closed-source binary, free tier available with basic features, advanced features require a paid Pro license.

How hard is betterdisplay to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is betterdisplay for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub waydabber on gitmyhub

Verify against the repo before relying on details.