8 releases

0.3.4 May 5, 2023
0.3.3 Oct 14, 2022
0.3.2 Jul 22, 2022
0.3.1 Jun 7, 2022
0.1.0 Jun 1, 2021

#818 in Command line utilities

37 downloads per month


840 lines


Build Status crates.io

A command-line tool for playing with color gradients.



  • Lots of preset gradients.
  • Custom gradient.
  • Read gradients from SVG & GIMP gradient (ggr) file.
  • Display gradient in the terminal.
  • Get colors from gradient.


Pre-compiled binaries for Linux, macOS and Windows is avaliable on release page.


gradient can be installed with cargo.

cargo install gradient


On NetBSD, a pre-compiled binary is available from the official repositories. To install it, simply run:

pkgin install gradient


gradient [OPTIONS]


  • -W, --width <NUM> : Gradient display width (default: terminal width)
  • -H, --height <NUM> : Gradient display height (default: 2)
  • -b, --background <COLOR> : Background color (default: checkerboard)
  • --cb-color <COLOR> <COLOR> : Checkerboard color
  • -s, --sample <FLOAT>... : Get color(s) at specific position
  • -t, --take <NUM> : Get N colors evenly spaced across gradient
  • -o, --format <FORMAT> : Output color format (default: hex) [hex, rgb, rgb255, hsl, hsv, hwb]
  • -a, --array : Print colors as array

Preset gradient

  • -p, --preset <NAME> : Using the preset gradient
  • -l, --list-presets : Lists all available preset gradient names

Custom gradient

  • -c, --custom <COLOR>... : Create custom gradient
  • -m, --blend-mode <MODE> : Custom gradient blending mode (default: oklab) [rgb, linear-rgb, hsv, oklab]
  • -i, --interpolation <MODE> : Custom gradient interpolation mode (default: catmull-rom) [linear, basis, catmull-rom]
  • -P, --position <FLOAT>... : Custom gradient color position

Gradient file

  • -f, --file <FILE>... : Read gradient from SVG or GIMP gradient (ggr) file(s)
  • --ggr-fg <COLOR> : GGR foreground color (default: black)
  • --ggr-bg <COLOR> : GGR background color (default: white)
  • --svg-id <ID> : Pick one SVG gradient by ID

COLOR can be specified using CSS color format.

Usage Examples

Get 100 colors (evenly spaced accross gradient domain) from rainbow preset gradient.

gradient -p rainbow -t 100

Display all gradients from svg file.

gradient -f file.svg

Create custom gradient.

gradient -c gold ff4700 'rgb(90,230,170)' 'hsl(340,50%,50%)' 'hsv(270,60%,70%)' 'hwb(230,50%,0%)'

TODO add more examples


~170K SLoC