NameThatColor

Find human-readable color names for hex values


Keywords
color, colors, webcolor, hex, css, html, hue, saturation, lightness, red, green, blue
License
Other
Install
pip install NameThatColor==1.0.3

Documentation

NameThatColor

Provides a utility for retrieving the closest known "human readable" name for a color specified as a hex string. It does this by using an algorithm ported from ntc.js.

There are 3 different sets of color definitions to choose from:

css3 is a superset of html4.

The user can also supply their own colorfile to use. It should be comma separated hex,name pairs, and should include the leading #. Commas are allowed in names.

Currently two output formats are supported -- json, and raw.

Usage:

As a command-line utility:

$ namethatcolor aabbcc
{"hex_value": "#B0C4DE", "name": "lightsteelblue"}
$ namethatcolor --color-set resene aabbcc
{"hex_value": "#ADBED1", "name": "Casper"}

#same as above
$ namethatcolor -s resene aabbcc

#specify your own color file
$ namethatcolor -c path/to/color/file aabbcc

As a library:

>>> from namethatcolor import NameThatColor
>>> Namer = NameThatColor()
>>> Namer.name('aabbcc')
Match('#B0C4DE', 'lightsteelblue', False, '#AABBCC')
>>> resene_filename = NameThatColor.color_sets['resene']
>>> resene_colors = NameThatColor.get_color_file(resene_filename)
>>> Namer = NameThatColor(color_file=resene_colors)
>>> Namer.name('aabbcc')
Match('#ADBED1', 'Casper', False, '#AABBCC')