PsyCalibrator
github.com
- Free plan
- Windows
- macOS
- Linux
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.
Plans
Every plan and pricePsyCalibrator
Free plan
Getting started
- Open the PsyCalibrator GitHub repository
- Install MATLAB or GNU Octave and Psychtoolbox
- Connect a Spyder5, SpyderX, or SpyderX2 instrument
- Install a photometer driver when using Windows
- Follow the tutorial for display measurement and calibration
- 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.