Time
Colors In Terminal

If you use terminal on a daily basis I bet you played with some color settings at least once. Colorizing ls output, shell prompt, git logs - those are very common tasks. And it’s not surprising as color helps us parse information faster, pay attention to important parts and generally makes things prettier. Everybody loves pretty things, especially the ones you have to look at every day.

This post is an attempt to gather in one place and structure things I know about colors in terminal.

Escape sequences

You’ve probably seen things like \e[32m or \x1b[1;31m. These are ANSI escape codes used for defining a color. All ANSI escape sequences start with, well, ESC. There’re several ways of encoding an ESC:

Shell \e
ASCII Hex \0x1B
ASCII Oct \033

So \x1b[31;4m, \e[31;4m and \033[31;4m are different ways to write the same sequence. Let’s look at the structure of this sequence.

Part of the CSI Finishing symbol \x1b [ 31;4 m ESC character in Hex ASCII Color codes

\x1b[ is a Control Sequence Introducer that consists of hexadecimal ASCII ESC character code and a [.

31;4 is a list of instructions separated by ;. Usually this list is formatted as follows:

1
[<PREFIX>];[<COLOR>];[<TEXT DECORATION>]

For example 31;4 means “no prefix, color - red, underline”. <PREFIX> is used for 256 color mode. More on color modes later.

Finally m indicates the end of control sequence so terminal would know not to interpret text after m as a color code.

The following command should print “hello” in red underscore text:

1
> echo "\x1b[31;4mHello\x1b[0m"

\x1b[0m means “reset all attributes”.

Color codes

Back in the old days terminals were different. Some of them could display only 16 colors and some of them went as far as 256. Now you probably work with a terminal emulator that runs on a machine that could display more than 16 million colors. But as terminal applications emulate older terminals, they usually support far less colors. For example a terminal app could be set up with 16 colors support or 256 colors support. The exact values of those colors depend on a terminal’s settings.

To list all available colors in 16-color mode run:

1
2
3
4
5
6
7
> for code in {30..37}; do \
echo -en "\e[${code}m"'\\e['"$code"'m'"\e[0m"; \
echo -en "  \e[$code;1m"'\\e['"$code"';1m'"\e[0m"; \
echo -en "  \e[$code;3m"'\\e['"$code"';3m'"\e[0m"; \
echo -en "  \e[$code;4m"'\\e['"$code"';4m'"\e[0m"; \
echo -e "  \e[$((code+60))m"'\\e['"$((code+60))"'m'"\e[0m"; \
done

You should see something like this:

\e[30m \e[31m \e[32m \e[33m \e[34m \e[35m \e[36m \e[37m \e[30;1m \e[31;1m \e[32;1m \e[33;1m \e[34;1m \e[35;1m \e[36;1m \e[37;1m \e[30;3m \e[31;3m \e[32;3m \e[33;3m \e[34;3m \e[35;3m \e[36;3m \e[37;3m \e[30;4m \e[31;4m \e[32;4m \e[33;4m \e[34;4m \e[35;4m \e[36;4m \e[37;4m \e[30m \e[91m \e[92m \e[93m \e[94m \e[95m \e[96m \e[97m

Or, in fact, something completely different! You can set up red to look like blue but I wouldn’t recommend such a deception as it probably mess up some color themes in bash, zsh or anything else that runs in a terminal.

As you can see from command’s output there are several sets of color codes:

Basic 8 colors 30..37
Basic "high contrast" colors 90..97
xterm-256 colors 0..255

And a set of text decoration indicators that should be placed right after the color code:

Bold 1
Underscore 4
Background 3

If color code is prefixed by 38;5 it is interpreted as one of 256 colors. E.g. \e[38;5;91m will color following text purple, while \e[91m will indicate bright red.

There’re several 256 color palettes out there. For example, a couple of the popular ones are Web safe colors and X11 colors. And though they’re both include 256 colors, they’re two different palettes!

To enable 256 colors support, you have to set up your terminal as xterm-256color (in iTerm2 go to Preferences > Profiles > Terminal > Report Terminal Type and put xterm-256color into the field). The set of colors you’ll get is xterm-256 pallete. In some places, like Mac OSX default color picker, this palette is called “emacs”, though it doesn’t have anything to do with Emacs.

To list all colors available in 256 color mode with their codes run

1
2
3
> for code in {0..255}
    do echo -e "\e[38;5;${code}m"'\\e[38;5;'"$code"m"\e[0m"
  done

Bonus: To list all colors available in Emacs run M-x list-colors-display.