Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

My goal in writing this script was to provide all the functionality of all the various terminal color displaying 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 children) you can install this via...

$ apt-get install colortest-python

Otherwise pip works...

$ python3 -m pip install terminal-colors

Help output:

Usage: terminal-colors [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