Skip to content

Grabs the dominant color or a representative color palette from an image. Uses javascript and canvas.

Notifications You must be signed in to change notification settings

lemmalearning/color-thief

 
 

Repository files navigation

Color Thief

A script for grabbing the color palette from an image. Uses Javascript and the canvas tag to make it happen.

See a Demo | Read more on my blog

How to use

Get the dominant color from an image

var colorThief = new ColorThief();
colorThief.getColor(sourceImage);
getColor(sourceImage[, quality])
returns {r: num, g: num, b: num}

Build a color palette from an image

In this example, we build an 8 color palette.

var colorThief = new ColorThief();
colorThief.getPalette(sourceImage, 8);
getPalette(sourceImage[, colorCount, quality])
returns [ [num, num, num], [num, num, num], ... ]

Node.js

Install the module via npm

npm install color-thief

And use it:

var ColorThief = require('color-thief');

Node Tests

Run the node tests via npm test

Credits and license

Author

by Lokesh Dhakar
lokeshdhakar.com
twitter.com/lokesh

Thanks

  • Nick Rabinowitz - For creating quantize.js.
  • John Schulz - For clean up and optimization. @JFSIII
  • Nathan Spady - For adding drag and drop support to the demo page.

License

Licensed under the Creative Commons Attribution 2.5 License

  • Free for use in both personal and commercial projects.
  • Attribution requires leaving author name, author homepage link, and the license info intact.

About

Grabs the dominant color or a representative color palette from an image. Uses javascript and canvas.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 61.6%
  • CSS 32.1%
  • HTML 6.3%