Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PsyCalibrator

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.2 Club score Visit github.com

What PsyCalibrator is

PsyCalibrator is a free, open-source package for measuring display luminance and color and calibrating gamma. It uses a Spyder5, SpyderX, or SpyderX2 instrument to measure a display and return CIE 1931 xyY coordinates. Its correction workflow makes the relationship between RGB intensity and luminance linear, for grayscale or individual color channels. The fitting workflow incorporates Mcalibrator2 and uses cubic spline interpolation as its main method. Users can apply gamma correction with a color lookup table and restore the display to its uncorrected state. The package supports Windows, macOS, and Linux and is described for use in research workflows. Getting started requires MATLAB or GNU Octave, Psychtoolbox, and one of the supported Spyder instruments. The tutorial says Windows users need a photometer driver, while Linux and Mac users do not. SpyderX and SpyderX2 can use built-in Windows 10 or 11 drivers with Psychtoolbox 3.0.19 or later. For accurate measurement, the tutorial advises keeping ambient light consistent and ensuring the sensor area is smaller than the target stimulus.

Who it suits

PsyCalibrator suits research workflows involving display luminance and color measurement or monitor correction. Users need the listed Spyder instrument, MATLAB or GNU Octave, and Psychtoolbox.

Good to know, and what to watch

  • Measures luminance and color with CIE 1931 xyY output.
  • Supports grayscale or individual channel correction.
  • Gamma correction uses a color lookup table.
  • Available for Windows, macOS, and Linux.
  • Requires MATLAB or GNU Octave and Psychtoolbox.
  • Requires a Spyder5, SpyderX, or SpyderX2 instrument.
  • Windows users need a photometer driver.

PsyCalibrator

Free

Free plan

Getting started

  1. Open the PsyCalibrator GitHub repository
  2. Install MATLAB or GNU Octave and Psychtoolbox
  3. Connect a Spyder5, SpyderX, or SpyderX2 instrument
  4. Install a photometer driver when using Windows
  5. Follow the tutorial for display measurement and calibration
  6. Keep ambient light constant and position the sensor area smaller than the target stimulus

Limits to check

The free package requires MATLAB or GNU Octave, Psychtoolbox, and a Spyder5, SpyderX, or SpyderX2 instrument. Windows requires a photometer driver; SpyderX/X2 built-in Windows 10/11 drivers require Psychtoolbox 3.0.19 or later.

The Club's review

PsyCalibrator is an open-source package for measuring display luminance and color, then correcting gamma for controlled visual experiments. It suits researchers who already have a supported Spyder instrument and MATLAB or GNU Octave with Psychtoolbox. The main trade-off is a focused calibration workflow that depends on specific hardware and software.

Overview

PsyCalibrator measures luminance and color through Spyder5, SpyderX, or SpyderX2 hardware and returns CIE 1931 xyY coordinates. Its calibration target is a linear relationship between RGB intensity and luminance, either across individual color channels or for gray, making it useful when experimental displays need repeatable, quantified output.

The fitting workflow incorporates Mcalibrator2 and uses cubic-spline interpolation as its primary method. A color lookup table (LUT) applies gamma correction, and users can restore the display to its uncorrected state. Multi-monitor calibration is supported, which is useful for laboratories managing more than one display, but the workflow is not self-contained: MATLAB or GNU Octave, Psychtoolbox, and compatible Spyder hardware are all required.

Key features

  • Luminance and color measurement: Spyder5, SpyderX, and SpyderX2 sensors provide CIE 1931 xyY readings. The measurement guidance emphasizes constant ambient light and keeping the sensor area smaller than the stimulus target, conditions that matter when readings must reflect the intended display region.
  • Gamma calibration: The package linearizes the RGB-intensity-to-luminance relationship for separate channels or gray. That makes it a good fit for vision and perception experiments where stimulus intensity needs a controlled response, rather than for casual desktop color adjustment.
  • Spline-based fitting: Mcalibrator2 is part of the fitting workflow, with cubic-spline interpolation as the main approach. Users get a defined measurement-to-correction process instead of a generic display preset.
  • LUT control: A color lookup table applies the correction, and the display can be returned to its uncorrected state. This gives researchers a reversible way to switch between calibrated and baseline conditions.
  • Multi-monitor support: Calibration can cover multiple monitors, useful when an experiment spans displays that need consistent treatment.

Pricing

PsyCalibrator: free. The free package includes LUT calibration and multi-monitor calibration. It requires MATLAB or GNU Octave, Psychtoolbox, and a Spyder5, SpyderX, or SpyderX2 instrument, so the software price does not remove the cost or setup burden of the surrounding research stack. There are no paid tiers, seat charges, quotas, renewal terms, or trial limits described for this package.

Platforms

PsyCalibrator supports Windows, macOS, and Linux. Windows users need a photometer driver, while the instructions say Linux and Mac users do not. SpyderX and SpyderX2 can use built-in Windows 10 or 11 drivers with Psychtoolbox 3.0.19 or later. In every operating system, the MATLAB or GNU Octave and Psychtoolbox dependencies remain part of the setup.

Who it's for

This is aimed at research workflows that measure luminance and color and then correct a monitor for controlled stimuli. It is a sensible choice for a lab with one of the supported Spyder devices and an existing MATLAB, GNU Octave, or Psychtoolbox environment. It is a poor fit for someone seeking calibration without dedicated hardware, or for a general user who wants an all-in-one desktop utility.

Pros and cons

Pros

  • Precise measurement output: CIE 1931 xyY coordinates give color and luminance data in a form suited to quantitative experiments.
  • Reversible LUT correction: Researchers can apply gamma correction and restore the uncorrected display when a study requires both states.
  • Multi-monitor capability: Multiple displays can be included in a calibration workflow.
  • Broad desktop coverage: Windows, macOS, and Linux are supported, with platform-specific driver guidance.

Cons

  • Hardware dependency: Only Spyder5, SpyderX, and SpyderX2 are named as supported instruments, limiting sensor choice.
  • Software stack requirement: MATLAB or GNU Octave plus Psychtoolbox is necessary, adding installation and maintenance work before calibration begins.
  • Setup-sensitive measurements: Ambient light and sensor placement must be controlled for accurate readings, so casual, uncontrolled use is unsuitable.

Alternatives

For a wider comparison, see Display Calibration Software.

  • ColourSpace is the better choice when paid software and a free trial are acceptable; its free ZRO plan handles manual calibration and verification but has no LUT capability.
  • EIZO ColorNavigator 7 suits users with compatible EIZO ColorEdge monitors who want a free download rather than a Spyder- and Psychtoolbox-based workflow.
  • Microsoft Quick Assist is a free support utility for Windows, macOS, and web interactions, not a substitute for display calibration.
  • QUBYX OS Tools is worth considering when auditable, adaptable GNU-licensed software is the priority.
  • PatternSpace fits macOS users who want ready-made patterns and reference presets, with a free tier and a one-time Pro upgrade.
  • ArgyllCMS is a free, open-source command-line toolkit for users comfortable with terminal-driven calibration and its AGPLv3 licensing terms.
  • Buddi is budgeting software, so it does not address display measurement or gamma correction.
  • DisplayCAL is a free GPLv3-or-later option for users who want general display-calibration software across Windows, macOS, and Linux.

Verdict

Choose PsyCalibrator if your research workflow needs measured CIE 1931 xyY data, reversible LUT gamma correction, and multi-monitor support, and you already have a supported Spyder sensor with MATLAB or GNU Octave and Psychtoolbox. Look elsewhere if you need broader instrument compatibility, a self-contained setup, or a general-purpose calibration interface without research-oriented dependencies.

The verdict

PsyCalibrator provides measurement and gamma correction for users with the required software and Spyder hardware. Its setup and measurement guidance make those dependencies central to deciding whether it fits a research workflow.

Questions people ask

Is PsyCalibrator free?

Yes. The PsyCalibrator package is listed as free and is open source.

Which operating systems are supported?

PsyCalibrator supports Windows, macOS, and Linux.

What hardware is required?

The tutorial names Spyder5, SpyderX, or SpyderX2 measurement instruments.

What software dependencies are required?

The tutorial requires MATLAB or GNU Octave and Psychtoolbox.

Can it calibrate multiple monitors?

Yes. Multi-monitor calibration is listed as supported.

What does the package measure?

It measures display luminance and color and returns CIE 1931 xyY coordinates.

What the maker publishes

Authors
The repository lists Zhicheng Lin, Qi Ma, and Yang Zhang as authors and gives their university affiliations in China. source
Compatibility limit
SpyderX/X2 can use built-in Windows 10/11 drivers with Psychtoolbox 3.0.19 or later, according to the tutorial. source
Correction control
Users can apply gamma correction with a color lookup table and restore the display to its uncorrected state. source
Data fitting
Its fitting workflow incorporates Mcalibrator2 and describes cubic spline interpolation as its main fitting method. source
Display correction
It calibrates displays so the relationship between RGB intensity and luminance is linear, including individual color channels or gray. source
Hardware requirement
The tutorial names Spyder5, SpyderX, or SpyderX2 as the supported measurement instruments. source
Intended users
The tutorial describes using the package for luminance and color measurement and monitor correction in research workflows. source
Measurement
It uses Spyder5, SpyderX, or SpyderX2 hardware to measure luminance and color and returns CIE 1931 xyY coordinates. source
Measurement guidance
The tutorial advises keeping ambient light constant and ensuring the sensor area is smaller than the target stimulus for accurate measurement. source
Operating systems
The instructions discuss Windows, Linux, and Mac; they say Windows users need a photometer driver while Linux and Mac users do not. source
Purpose
PsyCalibrator is an open-source package for display gamma calibration and luminance and color measurement. source
Software dependencies
The tutorial requires MATLAB or GNU Octave and Psychtoolbox. source

Checked against the maker's pages on 8 Oct 2026.