whatisgithub

What is one-key-hidpi?

xzhih/one-key-hidpi — explained in plain English

Analysis updated 2026-06-24

10,851ShellAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A Mac shell script that unlocks sharper HiDPI display mode for external monitors by patching display metadata that macOS normally restricts to Apple's own Retina screens.

Mindmap

mindmap
  root((one-key-hidpi))
    What it does
      Enables HiDPI
      Patches display metadata
      Unlocks Retina scaling
    How to run
      Terminal command
      ZIP download
      EDID patch option
    Recovery
      Recovery mode
      Disable script
      Manual folder delete
    Limitations
      macOS only
      Simulated scaling
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

Enable sharp HiDPI scaling on an external monitor connected to a Mac to reduce blurry text.

USE CASE 2

Fix sleep/wake display issues on an external monitor using the EDID patching option.

USE CASE 3

Recover a Mac that won't boot normally after running the script using the built-in disable path.

What is it built with?

Shell

How does it compare?

xzhih/one-key-hidpijnmetacode/agency-agents-zhbtbn/ffmpeg-builds
Stars10,85110,84010,884
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity2/51/51/5
Audiencegeneralvibe coderdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS, no documented version compatibility, and recovery mode access may be needed if the display override prevents normal boot.

So what is it?

This is a small shell script that enables HiDPI display mode on macOS for monitors that do not natively support it. HiDPI makes text and interface elements appear sharper by rendering at a higher resolution and then scaling down. On Apple's Retina displays this happens automatically, but most external monitors do not qualify. The script fakes the required display metadata to unlock the HiDPI option in System Preferences, giving users a "Native" scaled setting that would otherwise be hidden. Running it requires either pasting a single command into the Mac Terminal to fetch and execute the script directly from the internet, or downloading the ZIP file, extracting it, and double-clicking the included command file. During setup the script presents a few options, including a second choice that patches the display's EDID data, which can help if your monitor has trouble waking from sleep after HiDPI is enabled. If something goes wrong and your Mac cannot boot normally after running the script, there is a recovery path. You can restart into macOS Recovery mode, open Terminal from there, navigate to your user folder, and run a hidden disable script that was placed there during setup. Alternatively, you can manually delete the display override folder the script created under the system Library directory. The README is brief and mostly covers the two run modes and the recovery steps. It does not document which macOS versions are supported, which display resolutions work best, or what side effects to expect beyond a note that scaled logos may look blurry because the higher resolution is simulated rather than native.

Copy-paste prompts

Prompt 1
I have a 4K external monitor connected to my Mac and text looks blurry. Walk me through using one-key-hidpi to enable HiDPI mode, including which option to pick during setup.
Prompt 2
My Mac won't boot after running one-key-hidpi. What are the exact steps to recover using macOS Recovery mode Terminal?
Prompt 3
Explain what EDID patching does in one-key-hidpi and when I should choose that option over the default mode.
Prompt 4
How do I manually undo the changes made by one-key-hidpi by deleting the display override folder it created?

Frequently asked questions

What is one-key-hidpi?

A Mac shell script that unlocks sharper HiDPI display mode for external monitors by patching display metadata that macOS normally restricts to Apple's own Retina screens.

What language is one-key-hidpi written in?

Mainly Shell. The stack also includes Shell.

How hard is one-key-hidpi to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is one-key-hidpi for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.