1.0.0 Latest release released

Build Status Version License

Term Colors

Term_colors is a library containing color manipulation routines for term/console applications.

Terminal apps can use 5 different palettes:

  1. Monochrome (2-color)
  2. Low color (8-color)
  3. ANSI / XTerm color (16-color)
  4. High color (256-color)
  5. TrueColor (16M-color/24-bit color)

This module provides color-related functions for the first 4 types. TrueColor is not supported yet.


Add the dependency to shard.yml:

    github: crystallabs/term_colors
    version: 1.0.0

Available functions

# Takes color value and returns index of the nearest/closest
# matching color in the current palette.
  def match( r1 : String)
  def match( r1 : Array)
  def match( r1 : Tuple)
  def match(r1, g1, b1)

# Calculates color distance.
  def color_distance(r1, g1, b1, r2, g2, b2)

# Converts RGB to hex color value (#color).
  def rgb_to_hex(r : Array)
  def rgb_to_hex(r : Colorize::ColorRGB)
  def rgb_to_hex(r, g, b)

# Converts number to hex value with 2 places.
  def to_hex2(n)

# Converts number to hex value with 4 places.
  def to_hex4(n)

# Converts hex color value (#col or #color) to {r,g,b}.
  def hex_to_rgb(hex : String)

# Mixes colors.
  def mix_colors(c1, c2, alpha=0.5)

# Blends two attributes together, taking into account alpha/transparency value.
  def blend(attr, attr2, alpha)

# Converts color into lower/smaller color space.
  def reduce(color, total)

# Converts color to index in the current palette.
  def convert(color : Int)
  def convert(color : String)
  def convert(color : Array)
  def convert(color)


Run crystal spec as usual.


Run crystal docs as usual.


  • All the fine folks on FreeNode IRC channel #crystal-lang and on Crystal's Gitter channel https://gitter.im/crystal-lang/crystal

Other projects

List of interesting or similar projects in no particular order:


  • https://crystal-lang.org/api/master/Colorize.html - Crystal's built-in module Colorize
  • https://github.com/veelenga/rainbow-spec - Rainbow spec formatter for Crystal
  • https://github.com/watzon/cor - Make working with colors in Crystal fun!
  • https://github.com/icyleaf/terminal - Terminal output styling
  • https://github.com/ndudnicz/selenite - Color representation convertion methods (rgb, hsv, hsl, ...) for Crystal
  • https://github.com/jaydorsey/colorls-cr - Crystal toy app for colorizing LS output


  • https://github.com/crystallabs/terminfo - Library for parsing standard and extended terminfo files
  • https://github.com/crystallabs/tput - Low-level component for building term/console applications
  • https://github.com/crystallabs/term_app - Functional term/console app environment
  • https://github.com/crystallabs/crysterm - Console / terminal GUI toolkit for Crystal
  github: crystallabs/term_colors
  version: ~> 1.0.0
License AGPLv3
Crystal 1.0.0


Dependencies 0

Development Dependencies 0

Dependents 1

Last synced .
search fire star recently