DisplayCAL Quickstart: From Download to First Calibration
If you just want your monitor to show accurate color, this is the guide. In five steps you will install DisplayCAL, connect your colorimeter, choose sensible calibration targets, and finish your first real calibration — no color science degree required. Budget about an hour for the first run: most of that is the software measuring your screen while you do something else.
These steps assume the current community release, DisplayCAL-py3 3.9.19, with ArgyllCMS 3.5.0 as its measurement engine. If you have not downloaded anything yet, start at the download page. For background on the engine itself, see our ArgyllCMS overview.
What You Need Before You Start
- A colorimeter or spectrophotometer. DisplayCAL measures your display with real hardware; it cannot calibrate by eye. Any instrument supported by ArgyllCMS 3.5.0 works, including the Calibrite ColorChecker family and the Datacolor Spyder X2 (support added in DisplayCAL-py3 3.9.18). See Choosing the Right Sensor below if you still need to buy one.
- DisplayCAL and ArgyllCMS installed. DisplayCAL is the graphical front end; ArgyllCMS is the engine that talks to your instrument and builds profiles. You need both.
- Administrator rights on your computer, at least for the driver installation step on Windows.
- A warmed-up display. Turn your monitor on at least 30 minutes before measuring. Backlight output drifts as the panel warms up, and calibrating a cold display bakes that drift into your profile.
Step 1 — Download and Install DisplayCAL
- Go to the download page and grab the installer for your platform: Windows, macOS (Intel and Apple Silicon builds), or Linux (including the AppImage and Flatpak options added in 3.9.19).
- Windows: Run the installer and accept the defaults. DisplayCAL installs to
C:\Program Files\DisplayCALunless you choose otherwise. - macOS: Open the disk image and drag DisplayCAL to
/Applications. Then — this part matters — open Terminal and run:xattr -dr com.apple.quarantine /Applications/DisplayCAL.app
This clears the quarantine flag macOS puts on downloaded apps; without it, DisplayCAL may refuse to start or crash on its first measurement (a crash that 3.9.19 specifically fixed for first-time launches, but the quarantine step is still required). - Linux: If you use the AppImage, make it executable (
chmod +x) and run it; the Flatpak is available from Flathub. Distribution packages work too.
Step 2 — Install ArgyllCMS and Point DisplayCAL at It
On the very first launch, DisplayCAL asks where ArgyllCMS lives. This is the step most beginners stumble on, so here it is in detail:
- Install ArgyllCMS 3.5.0 from the download page (or from argyllcms.com). On Windows this is a zip you extract; on macOS a disk image; on Linux your package manager or the official scripts.
- Launch DisplayCAL. A dialog asks for the location of the ArgyllCMS executables — the
binfolder inside the ArgyllCMS installation. - Browse to that folder and confirm. DisplayCAL verifies the tools and shows the detected ArgyllCMS version in its main window status bar.
- If you skipped this dialog or pointed at the wrong folder, fix it later under the DisplayCAL settings/preferences: look for the ArgyllCMS executables path and set it to the
bindirectory.
If DisplayCAL reports “ArgyllCMS not found” after you set the path, double-check that you selected the bin folder itself and not its parent. This single mistake accounts for a large share of first-launch support questions — see the troubleshooting guide if it persists.
Step 3 — Connect Your Colorimeter
Plug the instrument into a USB port directly on the computer (not a passive hub) before starting DisplayCAL, then pick your platform below.
Windows: Install the Instrument Driver
- In DisplayCAL, go to Tools > Instrument > Install ArgyllCMS instrument drivers.
- Follow the prompts and let it finish, then unplug the instrument and plug it back in.
- DisplayCAL’s instrument dropdown should now list your colorimeter.
If the automatic install fails, the proven fallback is Zadig: run it as administrator, select your instrument from the device list, and install the libusb-win32 driver for it. Then restart DisplayCAL. Full details are in the troubleshooting guide.
macOS: Permissions
- After the quarantine command in Step 1, launch DisplayCAL from Applications (right-click > Open the very first time if macOS still hesitates).
- If macOS shows a permission prompt (screen recording or input monitoring), grant it — DisplayCAL needs to draw its measurement patches full-screen.
- Plug in the instrument. macOS needs no extra driver for the common colorimeters; select yours from the instrument dropdown.
Linux
The ArgyllCMS install scripts handle device permissions. If the instrument is not detected, re-run the ArgyllCMS installer and make sure your user account is in the right device-access group, then log out and back in.
Step 4 — Set Your Calibration Targets
Before measuring, tell DisplayCAL what “correct” means for your display. For a first calibration, these defaults are right for almost everyone:
- White point: D65 (6500 K) — the standard for general photo, video, and design work.
- Tone curve: Gamma 2.2 — the standard for SDR displays. (If you do broadcast video work you may prefer BT.1886; you can experiment later.)
- White level: around 120 cd/m² for a dim editing room; higher (140–160) for a bright office. DisplayCAL will guide the adjustment.
- Black point: leave at the display’s native black unless you have a reason to lift it.
In the main DisplayCAL window, choose the Calibration tab and set these values. Keep the default testchart for your first run — a moderate patch count finishes faster and is plenty accurate while you learn the workflow. You can move to larger testcharts once you are comfortable.
Step 5 — Run the Calibration and Install the Profile
- Hang the colorimeter on the screen over the measurement area, counterweight behind the monitor. Close other applications and disable your screensaver and any night-mode / blue-light filter — they fight the calibration.
- Click Calibrate & profile. DisplayCAL first walks you through interactive display adjustment: it shows live readings while you adjust the monitor’s own brightness (and RGB gains, if your monitor has them) to hit your targets.
- Then the automated measurement starts. Patches flash on screen while the instrument reads them. A first run typically takes 10–30 minutes depending on patch count and instrument speed.
- When profiling finishes, DisplayCAL builds the ICC profile and offers to install it. Say yes — this makes the profile the system default for that display.
- Make sure the DisplayCAL Profile Loader is enabled so the calibration (the video-card curves part) loads at every login. On Windows, check that no other calibration loader is fighting it.
That is it. Your display is now calibrated and profiled. Open a photo you know well — skin tones and neutral grays are the telltales — and compare against your memory of the uncalibrated screen. If something looks wrong, the troubleshooting guide covers the usual suspects: profile loader not applying, measurements taken at high display scaling, and the false “Errors in …” warning on Windows (fixed in 3.9.19).
Choosing the Right Sensor
Disclosure: the links below are affiliate links (sponsored). If you buy through them, this site may earn a commission at no extra cost to you.
Any of these three will serve a DisplayCAL user well; the differences are speed, low-light sensitivity, and price:
- Calibrite ColorChecker Display Plus — the enthusiast favorite: fast readings, good low-light accuracy, and the best match for wide-gamut displays. The safe default pick if you only buy one instrument.
- Datacolor Spyder X2 — the budget-friendly option, and DisplayCAL-py3 3.9.18 added explicit SpyderX2 support. A sensible choice for a first colorimeter.
- X-Rite i1Display Pro — the long-time workhorse of the calibration world (now sold under the Calibrite brand). Still fully supported and widely available second-hand.
Whichever you choose, keep it in its case away from heat and dust — a dirty sensor lens is a classic cause of drifting readings.
Frequently Asked Questions
Do I need ArgyllCMS to use DisplayCAL?
Yes. DisplayCAL is the graphical front end; ArgyllCMS is the engine that drives the instrument, takes the measurements, and builds the profiles. DisplayCAL cannot measure anything without it. Install ArgyllCMS 3.5.0 and point DisplayCAL at its bin folder on first launch.
How long does a first calibration take?
Plan for 10–30 minutes of automated measurement with the default testchart, plus a few minutes of interactive adjustment at the start. Larger testcharts and slower instruments take longer; speed is one reason people upgrade their colorimeter.
Can I use DisplayCAL without a colorimeter?
Partially. You can install other people’s profiles and generate 3D LUTs from existing measurements (see our 3D LUT guide), but measurement-based calibration — the main event — requires a real instrument. There is no reliable way to calibrate a display by eye.
How often should I recalibrate?
For color-critical work, every two to four weeks; for general use, once a month or two is fine. Backlights drift with age and temperature, and a quick re-profile with a smaller testchart takes only minutes once the workflow is set up.
