Massive color dictionary ๐ŸŒˆ
Clone or download
Pull request Compare This branch is 108 commits behind meodai:master.
Fetching latest commitโ€ฆ
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
scripts
src
.editorconfig
.eslintrc.json
.gitignore
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
README.md
package-lock.json
package.json

README.md

16706 color-names

GitHub release npm version npm Travis license color count Buy Me a Coffee at ko-fi.com

A handpicked list of 16706 unique color names from various sources and thousands of user submissions. Try it yourself or read the full list.

The names of color function like a thread attached to a frightfully slender needle, capable of stitching together our most delicate emotions and memories. When the needle hits the target, we feel either pleasure or emathy. Kenya Hara โ€“ White

About ๐Ÿ“‹

The aim of this project is to create as large a list as possible of color names. We've merged various lists, modified the names when there were duplicates with different hex values, and shifted the colors a bit when there were identical colors with different names.

Submit a color via form ๐ŸŒˆ / or twitter ๐Ÿฆ

Make sure to read the naming rules before you contribute.

color count: 16706 ๐ŸŽ‰

(~0.0010% of all RGB Colors)

Color distribution ๐Ÿ›ฐ

When coming up with new color names, it is vital to know what spots in a certain color-space are crowded and where there is still room for new colors. For example; Our API returns the closest RGB color to a given HEX value. To avoid that to many colors snap to the same name, we aim to distribute the colors evenly in the color space: Visualization PS: you can choose between different color spaces on the bottom right.

Usage ๐Ÿ“–

Installation Node.js ๐Ÿ“ฆ

npm install color-name-list --save

or yarn add color-name-list

CDN ๐ŸŒ JSON / CSV / YML /JS

API (v1) ๐Ÿƒ

https://color-names.herokuapp.com/v1/{{hexvalue without the #}},{{more comma separated values}}

Single Color

curl https://color-names.herokuapp.com/v1/212121

{
  "colors": [{
    "name": "Lead",
    "hex": "#212121",
    "rgb": {"r":33, "g":33, "b":33},
    "distance": 0, // its an exact match
    "requestedHex": "#212121"
  }]
}

Multiple Colors

curl https://color-names.herokuapp.com/v1/212121,060606,ff0012,550055,123456

All Named Colors

curl https://color-names.herokuapp.com/v1/

In this case colors is not an object but an array of objects sorted by color-name

Usage JS โŒจ

Exact Color

import namedColors from 'color-name-list';

let someColor = namedColors.find(color => color.hex === '#ffffff');
console.log(someColor.name); // => white

let someNamedColor = namedColors.find(color => color.name === 'Eigengrau')
console.log(someColor.hex); // => #16161d

Closest Named Color

Since there are 16581375 possible RGB colors, you might use a library to help you find the the closest named color.

import namedColors from 'color-name-list';
import nearestColor from 'nearest-color';

// create Object needed for
let colors = {};

namedColors.forEach(color => {
  colors[color.name] = color.hex
});

nearestColorName = nearestColor.from(colors);

// get closest named color
nearestColorName('#f1c1d1'); // => Fairy Tale

Note: In this example we are using nearest-color. it is not the most accurate method, but by far the quickest since it looks for the nearest RGB neighbor. If you are looking for something visually more accurate, you might use a library returning the color with the closest DeltaE based on the Lab color-space.

Building ๐Ÿ”จ

npm install && npm run build

See package.json for more.

Sources ๐Ÿ—’

Sources: Names ๐Ÿ“‡

Sources: Color ๐ŸŽจ

Contributors ๐Ÿฆ‘

Disclaimer ๐Ÿ‘ฎ๐Ÿพโ€

In the process we try to remove all names that are offensive or racist, as well as protect brandnames. As some of the color names come from other lists, it might happen that some bad ones slip in. Please report them, they will be removed as quickly as possible.