NPM version Build Status Code Climate Dependency Status devDependency Status



Apply filters to colors to simulate things like color blindness and night vision. This library tries to simulate the behavior of the svg filter effect feColorMatrix.

It comes in 2 formats: a node.js library and a command line tool.


Usage and output examples can be found here:

Node.js Library

Getting Started

Install the module with: npm install color-matrix

var ColorMatrix = require('color-matrix').ColorMatrix;
var matrix = new ColorMatrix();
// simulate color-blindness
matrix.transform([222, 0, 173, 255], 'deuteranopia'); // returns [139, 155, 121, 1]

NOTE: For a better "color blindness" library, see: color-blind. This library is just a port of the old "color matrix" code for use in node. It does allow you to pass in custom filters (which is why I published it, instead of throwing it away).

API Documentation

Read the API Docs by using this link:

Command Line Tool


The color-matrix tool can be installed globally by running:

npm install -g color-matrix


  Usage: color-matrix [options] <inputColor>


    -h, --help                 output usage information
    -V, --version              output the version number
    -i, --input <imageFile>    input image file
    -o, --output <imageFile>   output image file
    -f, --filter <filterName>  filter name to use
    -v, --value <value>        value for the selected operation type
    -l, --list                 list all the filter names

See Also


Copyright (c) 2014 skratchdot
Licensed under the MIT license.