hp-colorcal

hp-colorcal [OPTIONS] [PRINTER]

-g, --gui
    Launch graphical user interface for calibration.

-d<level>, --debug[=<level>]
    Enable debug output; level 1-9 (default 4).

-l<level>, --log-level[=<level>]
    Set log level: debug, info, warn, error, fatal (default warn).

-p<printer>, --printer=<printer>
    Specify printer name or device URI.

-m<model>, --model=<model>
    Printer model (used with -s).

-s, --symlink
    Symlink calibration file to /usr/share/hplip/colorcal/.

-r, --recommended
    Use recommended calibration settings.

-h, --help
    Display full usage help.

The hp-colorcal command is part of the HPLIP (HP Linux Imaging and Printing) software suite, designed to calibrate color accuracy on supported HP inkjet printers. It generates precise color profiles by printing test patterns on special glossy paper, which the user then scans back using a flatbed scanner—typically the printer's own scanner if it's an all-in-one model.

The process improves color reproduction by analyzing scanned patches for density and hue variations, creating a custom ICC profile or calibration file applied during printing. This is essential for professional photo printing or color-critical work. The tool supports both command-line and GUI modes, making it accessible for different user preferences.

Usage requires a compatible printer, HPLIP installed, and optionally a scanner. It handles multi-pass printing for accuracy and supports symlink installation of profiles for system-wide use. Always check printer model support via hp-probe.

Requires HPLIP package, supported HP inkjet models only, glossy paper, and flatbed scanner. Interactive process needs user monitoring; not for non-color printers. Root may be needed for some operations.

HPLIP ≥ 3.18.5; USB/PJDL/JetDirect connection; admin privileges.

hp-colorcal -g -p HP_LaserJet_Pro
Starts GUI calibration for specified printer.

Developed by HP as part of HPLIP project since 2005; evolved with printer firmware support. Maintained by open-source community via GitHub.

hp-setup(1), hp-probe(1), hp-check(1), hp-print(1)