#command-line #command-line-tool #color-space #rgb #hsl #analyze #generate

bin+lib pastel

A command-line tool to generate, analyze, convert and manipulate colors

10 releases (5 breaking)

0.9.0 May 26, 2022
0.8.1 Jul 11, 2021
0.8.0 Jun 5, 2020
0.7.1 Mar 3, 2020
0.4.0 Aug 25, 2019

#1288 in Command line utilities

Download history 2638/week @ 2024-02-26 2647/week @ 2024-03-04 3022/week @ 2024-03-11 2192/week @ 2024-03-18 2348/week @ 2024-03-25 2034/week @ 2024-04-01 3295/week @ 2024-04-08 3008/week @ 2024-04-15 3650/week @ 2024-04-22 2961/week @ 2024-04-29 5024/week @ 2024-05-06 4115/week @ 2024-05-13 3906/week @ 2024-05-20 2729/week @ 2024-05-27 4894/week @ 2024-06-03 3242/week @ 2024-06-10

14,781 downloads per month
Used in umpire




Build Status

pastel is a command-line tool to generate, analyze, convert and manipulate colors. It supports many different color formats and color spaces like RGB (sRGB), HSL, CIELAB, CIELCh as well as ANSI 8-bit and 24-bit representations.

In action

pastel in action


Getting help

pastel provides a number of commands like saturate, mix or paint. To see a complete list, you can simply run


To get more information about a specific subcommand (say mix), you can call pastel mix -h or pastel help mix.


Many pastel commands can be composed by piping the output of one command to another, for example:

pastel random | pastel mix red | pastel lighten 0.2 | pastel format hex

Specifying colors

Colors can be specified in many different formats:

'rgb(119, 136, 153)'
'hsl(210, 14.3%, 53.3%)'

Colors can be passed as positional arguments, for example:

pastel lighten 0.2 orchid orange lawngreen

They can also be read from standard input. So this is equivalent:

printf "%s\n" orchid orange lawngreen | pastel lighten 0.2

You can also explicitly specify which colors you want to read from the input. For example, this mixes red (which is read from STDIN) with blue (which is passed on the command line):

pastel color red | pastel mix - blue

Use cases and demo

Converting colors from one format to another

pastel format hsl ff8000

Show and analyze colors on the terminal

pastel color "rgb(255,50,127)"

pastel color 556270 4ecdc4 c7f484 ff6b6b c44d58

Pick a color from somewhere on the screen

pastel pick

Generate a set of N visually distinct colors

pastel distinct 8

Get a list of all X11 / CSS color names

pastel list

Name a given color

pastel format name 44cc11

Print colorized text from a shell script

fg="$(pastel textcolor "$bg")"

pastel paint "$fg" --on "$bg" "well readable text"
pastel paint -n black --on red --bold "   ERROR!   "
echo " A serious error"

pastel paint -n black --on yellow --bold "  WARNING!  "
echo " A warning message"

pastel paint -n black --on limegreen --bold "    INFO    "
echo -n " Informational message with a "
echo -n "highlighted" | pastel paint -n default --underline
echo " word"


On Debian-based systems

You can download the latest Debian package from the release page and install it via dpkg:

wget "https://github.com/sharkdp/pastel/releases/download/v0.8.1/pastel_0.8.1_amd64.deb"
sudo dpkg -i pastel_0.8.1_amd64.deb

On Arch Linux

You can install pastel from the Community repositories:

sudo pacman -S pastel

On Nix

You can install pastel from the Nix package:

nix-env --install pastel

On MacOS

You can install pastel via Homebrew

brew install pastel

On Windows

You can install pastel via Scoop

scoop install pastel

Via snap package

Get it from the Snap Store:

sudo snap install pastel


Using the package manager:

pkgin install pastel

From source:

cd /usr/pkgsrc/graphics/pastel
make install

On other distributions

Check out the release page for binary builds.

Via cargo (source)

If you do not have cargo, install using rust's installation documentation.

If you have Rust 1.43 or higher, you can install pastel from source via cargo:

cargo install pastel

Alternatively, you can install pastel directly from this repository by using

git clone https://github.com/sharkdp/pastel
cargo install --path ./pastel


Interesting Wikipedia pages:

Color names:

Maximally distinct colors:

Other articles and videos:


Licensed under either of

at your option.


~230K SLoC