Skip to content

Repository files navigation

Candela app icon

Candela

Candela protects your displays from burn-in and wear.
Panel health, a checkup for defects, and the monitor controls macOS leaves out (brightness, volume, HiDPI scaling).
Free and open source, for macOS.

Download Candela for macOS   Install with Homebrew   Visit candela.fyi

macOS 14 or later Apple silicon Signed and notarized MIT license

Find Candela useful? Star this repository to support the project.

Candela: the headline The display software Apple forgot to ship, beside a display's page, the Health pane, the heat map, and the menu-bar controls

Other display apps adjust settings in the moment. Candela protects your panel over the years you own it: adaptive, real-time burn-in defense, a health record of the hours and light the panel has seen, and settings that survive sleep and replugs. A diagnostic checkup identifies defects and wear on any display, alongside a full suite of monitor controls that should have been built into macOS in the first place.

What it does

The Health pane and its exposure heat map

Health

A map of where an enrolled panel has been lit, kept as a coarse grid so nothing on your screen is stored. Turn on measurement and it fills in from real readings. Panel hours and per-app time come with it, and the whole record exports as one integrity-checked file.
OLED Care: an enrolled panel with its exposure thumbnail, and the menu bar and Dock auto-hide switches

Protection

Adaptive, real-time burn-in defense: Candela watches what the screen is showing and eases down bright regions that sit unchanged, while live content stays at full brightness. Alongside it, one-click auto-hide for the menu bar and Dock, dimming when you step away or lock the Mac, and display settings that survive replugs and reboots.
A checkup report: one line per check, each graded by how the result was known

Checkup

A guided diagnostic for any display, new or years in: it looks for defects and wear, checks what the monitor claims against what it does, and ends in a report you keep. Every result is graded (observed, refused, not observed, self-reported).
Brightness and volume sliders for every display in the menu bar

Controls

Brightness, contrast and volume for external displays over DDC/CI, from the menu bar, media keys and a HUD. Software dimming below the hardware floor, an HDR toggle, every resolution the panel can show including HiDPI sizes macOS hides, plus arrangement, mirroring, rotation and virtual displays.

Guided setup recommending a sharper size for a display

It configures itself to your setup. On first launch Candela finds every display, asks each what it can do, and builds the controls around the answers; a sharper size is offered where the panel supports one.

Install

Download the notarized build from the latest release or candela.fyi, open the disk image, and drag Candela to Applications. Or with Homebrew:

brew install --cask rydersel/tap/candela

Candela checks for updates on its own and asks before installing one. Updates are signed, and a build whose signature does not match is refused.

Requirements

  • macOS 14 or later, on Apple silicon.
  • For hardware brightness, contrast and volume: a monitor that supports DDC/CI over the cable you are using. Most do. Write-only panels, which accept writes but answer every read with zeros, are supported and tracked by the last value sent.
  • Accessibility, only if you want the keyboard media keys to drive an external display.
  • Screen Recording, only if you opt into measured exposure sampling. Nothing else asks for it.

A note on private APIs

Some features (mode switching, virtual displays, the HDR toggle, menu-bar auto-hide) use macOS interfaces Apple does not document. They are what other tools cannot offer, and they can break when a new macOS ships. A built-in conformance check detects that, and fixes land in the open.

Tested hardware

Every release is tested on as many different displays, connections and Macs as we can get our hands on, but no two setups are alike. If something misbehaves on yours, open an issue with your Mac, macOS version, monitor model and how it is connected, and we will look at it as soon as we can. A working setup is worth reporting too: it goes into the tested hardware table.

Documentation

  • User guides: OLED care, checkup, resolutions, the Diagnostics page, and advanced settings.
  • Advanced settings: the defaults write keys behind the escape hatches.
  • Tested hardware: the monitors, connections and Macs Candela has been used on, one row per report.
  • Contributing: building from source, running the suites, and what a change is expected to state about its own verification.

Credits

License

MIT.

About

Candela protects your displays from OLED burn-in and wear: panel health history, a checkup for defects, and the controls macOS leaves out for external monitors (brightness, volume, contrast, custom resolutions, HiDPI scaling). Free and open source.

Topics

Resources

Contributing

Security policy

Stars

29 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages