Skip to content
A JavaScript script to create a 3-color palette based on an image. Inspired by iTunes 11.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



A JavaScript script to pick 3 colors from an image to create a palette for background and text colors. Inspired by iTunes 11.


Hosted example showing album info generated from users' Try it with your own username for different results.

How to Use

var url = '',
	// You will need a image hosted under the same domain as the script
	albumColors = new AlbumColors(url);

albumColors.getColors(function(colors) {
	// Result: [[254, 254, 254], [2, 138, 14], [4, 171, 21]]


The algorithm is simple.

  1. Load image from URL into canvas and get the color array by pixels (AlbumImage)

  2. Find n (default 10) major colors from the pixel array (AlbumColors)

    2.1. Divide color spectrum into 64 buckets

    2.2. Add each color into one of the bucket with a simple approximation

    2.3. Take the 10 buckets with the largest number of colors in them

    2.4. Averaging the colors in the dominating buckets to get the presenting color for the buckets

  3. Among the 10 major colors, pick out 3 (colorChooser)

    3.1. Color distance is simply defined as the Euclidean distance

    3.2. The most dominating color (ColorA) will be the background

    3.3. The color that is most distanced from ColorA, ColorB, will be text color 1

    3.4. The color that is second distanced form ColorA, ColorC, will be text color 2


Images are loaded through canvas, therefore we are limited to the same origin rule. In the example, a simple image proxy is included to bypass the issue.


University of Illinois / NCSA

You can’t perform that action at this time.