Extract colors from GIF, PNG, JPG, and SVG images
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test Buffer Support Dec 20, 2016
.travis.yml add travis for node 4, 6, 7 Dec 20, 2016
index.js Buffer Support Dec 20, 2016
package.json update repository url Apr 14, 2018
readme.md update repository url Apr 14, 2018



Extract colors from images. Supports GIF, JPG, PNG, and even SVG!

example color palette


npm install get-image-colors --save

This package is intended for use in node environments. It won't work in a browser because it has node-specific dependencies.


const path = require('path')
const getColors = require('get-image-colors')

getColors(path.join(__dirname, 'double-rainbow.png')).then(colors => {
  // `colors` is an array of color objects

You can also use a buffer as an input source.

const fs = require('fs')
const buffer = fs.readFileSync(path.join(__dirname, 'double-rainbow.gif'))
const getColors = require('get-image-colors')

getColors(buffer, 'image/gif').then(colors => {
  // `colors` is an array of color objects

colors is an array of chroma.js color objects. chroma.js objects have methods that lets you pick the color format you want (RGB hex, HSL, etc), and give you access to powerful color manipulation features:

colors.map(color => color.hex())
// => ['#FFFFFF', '#123123', '#F0F0F0']

// => 'rgb(0,128,128)''

If you don't like promises, you can use node-style callbacks too:

getColors(filename, function (err, colors) {
  if (err) throw err
  // ...

How it Works

get-image-colors uses get-pixels to create a pixel array, then extracts a color palette with get-rgba-palette, which uses quantize under the hood.

Colors are converted from get-rgba-palette's flat array format into chroma.js color instances.


npm install
npm test


  • chroma-js: JavaScript library for color conversions
  • get-pixels: Reads the pixels of an image as an ndarray
  • get-rgba-palette: gets a palette of prominent colors from an array of pixels
  • get-svg-colors: Extract stroke and fill colors from SVG files

Dev Dependencies

  • mocha: simple, flexible, fun test framework