Skip To Content


Open Source Development · (2017-2019)

Build StatusGoDocGo Report Card

View the project on Github.

Utility that finds the N most frequent colors in a picture, approximated to CSS3 color names. Palitra is available both as a plain library, and as a CLI tool (which also supports input from stdin, via pipe). It requires Go 1.8.


You can download the library with go get:

$ go get

If you want to use the CLI tool, then you can type the following to install it in your environment.

$ go install



This guide assumes that palitra is installed globally.

Here’s how palitra --help looks like:

Usage of palitra:
-img string
the name of the image file to get colors from
-n int
the number of the most dominant CSS3 colors to extract (default 3)
-r uint
the resized width to process the image quicker (default 75)

If you’re ok with the default values, then you can simply pipe an image to palitra. Example:

$ cat ./test_images/venice.jpg | palitra

The result should look like the following:

1) lightpink: 10.48%
2) lightslategrey: 9.97%
3) dimgrey: 9.61%

Completed in 679.7955ms ✨

If not, you can manually specify the parameters as you like:

$ palitra -img ./test_images/venice.jpg -n 5 -r 50

The result should look like the following:

1) lightpink: 10.34%
2) dimgrey: 10.04%
3) lightslategrey: 9.93%
4) silver: 9.15%
5) darkslategrey: 8.81%

Completed in 290.7805ms ✨


For the library usage, please refer to You can import the library in the following way:

import ""


$ go test -v -bench=.


The MIT License (MIT). Please see License File for more information.