Co(lor) di(fference/stance)

Color perception difference algorithms and utilities.

If you've ever wanted (nobody ever wanted) to use only named html colors in development, but didn't know how to find the color closest to #123456 that has html name, then this is the repository for you.

Motivation

We can't just use the Euclidean distance between two RGB colors because the RGB color space is not "perceptually uniform". To understand more, I recommend reading the article "Perceptually uniform color spaces".

The primary motivation was to find the closest color that has an html name, but since there are many algorithms for this (because there is no correct answer for this question), why not implement all of them and compare results yourself.

Example

Installation

Rust (cargo)

cargo install --git https://github.com/woojiq/codi --locked

Nix (flake) without installation

nix run 'github:woojiq/codi?dir=nix'

Usage

Usage:
    codi <color>

Args:
    <color> Hex color, e.g. "#000000" or "ffffff"

Options:
    --help                  Prints help information
    --version               Prints version
    --all-html              Displays all named html color

$ codi A1A2A3               # pass hex color with or without "#" symbol
$ hyprpicker | xargs codi   # run picker that returns hex color
$ codi --all-html           # print all named html colors

Keep in mind that your terminal must support true colors to get exact color output, otherwise you will have inaccurate color representation in the terminal. For example, instead of skyblue you will see blue.

Developing

$ git clone https://github.com/woojiq/codi

# Build the project
$ cargo build

# If you have nix package manager
$ nix develop ./nix # devShell
$ direnv allow # direnv with devShell
$ nix flake check ./nix # run CI locally