Utility to test color capabilities of terminal.
Python Makefile
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


My goal in writing this script was to provide all the functionality of all the various perl/sh scripts found around the web in one place with some additional bells and whistles.

It automatically detects 8, 16, 88, 256 color capabilities (via ncurses) and displays the appropriate color charts. It can display the colors as blocks or (2d) cubes optionally with color values overlaid in int or hex values. It can show the full rgb text string as well. It can also show the display with a vertical (default) or horizontal orientation or have additional padding.

It also works as a utility for converting between 256 and 88 color values.


In Debian (and childred) you can install this via... $ apt-get install colortest-python http://packages.debian.org/source/colortest-python

Otherwise pip works... $ pip install terminal-colors

Help output:

Usage: colortest-python [options]

  -b, --block          Display as block format (vs cube) [default].
  -c, --cube-slice     Display as cube slices (vs block).
  -f, --foreground     Use color for foreground text.
  -l, --rgb            Long format. RGB values as text.
  -n, --numbers        Include color escape numbers on chart.
  -o, --basiccodes     Display 16 color chart with SGR ANSI escape codes.
  -p, --padding        Add extra padding (helps discern colors).
  -v, --vertical       Display with vertical orientation [default].
  -x, --hex            Include hex color numbers on chart.
  -z, --horizontal     Display with horizontal orientation.
  --version            show program's version number and exit
  -h, --help           show this help message and exit

  Conversion options:
    -r N, --256to88=N  Convert (reduce) 256 color value N to an 88 color
    -e N, --88to256=N  Convert (expand) 88 color value N to an 256 color


default numbered long padding