
Turn HDR on or off for external displays on macOS, from Raycast.
Disable HDR — LG HDR 4K when HDR is on, Enable HDR — … when it is off.macOS 13 or later, Raycast, and an HDR-capable external display.
No helper app, no paid license, and no permissions: no Accessibility, no Screen Recording, no Automation.
Assign a hotkey to Toggle HDR in Raycast → Settings → Extensions → External HDR.
HDR Displays lives in the menu bar. Its icon is filled when the target display is in HDR, hollow when it is not, and shows an exclamation mark when no HDR display is connected. Refresh it with ⌘R; it also refreshes every ten minutes.
HDR on Connect lists your HDR-capable displays. Pick one and choose Apply HDR on When Connected or Apply HDR off When Connected. The rule is applied immediately and again whenever that display reconnects.
Raycast schedules the reconnection checks at one-minute intervals through the Apply HDR Rules command. That schedule starts after you open Apply HDR Rules once, or after you enable Background Refresh for it in Raycast → Settings → Extensions → External HDR. While no rule exists, nothing runs.
macOS has no public API for HDR. The extension includes a small Swift package (swift/) that calls the private MonitorPanel framework's setPreferHDRModes: — the same call BetterDisplay and DisplaySync use — and exposes it to the extension through Raycast's official Swift bridge. Raycast compiles the package at build time, so no binary is shipped.
It needs no SIP changes, entitlements, administrator rights, or TCC permissions, and it never changes the display mode itself.
MonitorPanel is private and undocumented. A future macOS could remove it; there is no public replacement.| Symptom | Fix |
|---|---|
| "No external HDR-capable display is connected" | Check the cable and port; HDR needs DisplayPort 1.4 or HDMI 2.0 bandwidth. |
| "… is not connected" | The Target Display preference names a display that is not plugged in. Connect it or clear the preference. |
| HDR does not switch | The panel did not reach the requested state. Retry; some docks swallow the mode change. |
| A rule does not apply on reconnect | Open Apply HDR Rules once, and confirm Background Refresh is enabled for it in the extension preferences. |
| The menu-bar icon is stale | It refreshes every ten minutes and after any toggle made from it. |
Open HDR on Connect and choose Clear All Rules, then remove the extension from Raycast. Rules and connection history live in Raycast's support folder for this extension and are removed with it.
MIT.
Flip high dynamic range for your external display
See and change HDR state from the menu bar
Choose which displays get HDR applied automatically when connected
Applies saved HDR rules when a display connects. Open once to enable its background refresh.