Skip to content

Instantly share code, notes, and snippets.

@XVilka

XVilka/TrueColour.md

Last active March 6, 2026 10:14
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save XVilka/8346728 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save XVilka/8346728 to your computer and use it in GitHub Desktop.
Download ZIP
True Colour (16 million colours) support in various terminal applications and terminals
Raw
TrueColour.md

Colours in terminal

It's a common confusion about terminal colours... Actually we have this:

  • plain ascii
  • ansi escape codes (16 colour codes with bold/italic and background)
  • 256 colour palette (216 colours + 16 ansi + 24 gray) (colors are 24bit)
  • 24bit true colour ("888" colours (aka 16 milion))
printf "\x1b[${bg};2;${red};${green};${blue}m\n"

The 256 colour palete is configured at start, and it's a 666 cube of colours, each of them defined as a 24bit (888 rgb) colour.

This means that current support can only display 256 different colours in the terminal, while truecolour means that you can display 16 milion different colours at the same time.

Truecolour escape codes doesn't use a colour palette. They just specify the colour itself.

Here's a test case:

printf "\x1b[38;2;255;100;0mTRUECOLOR\x1b[0m\n"

awk 'BEGIN{
    s="/\\/\\/\\/\\/\\"; s=s s s s s s s s;
    for (colnum = 0; colnum<77; colnum++) {
        r = 255-(colnum*255/76);
        g = (colnum*510/76);
        b = (colnum*255/76);
        if (g>255) g = 510-g;
        printf "\033[48;2;%d;%d;%dm", r,g,b;
        printf "\033[38;2;%d;%d;%dm", 255-r,255-g,255-b;
        printf "%s\033[0m", substr(s,colnum+1,1);
    }
    printf "\n";
}'

Keep in mind that it is possible to use both ';' and ':' as parameters delimiter.

According to Wikipedia[1], this is only supported by xterm and konsole.

[1] https://en.wikipedia.org/wiki/ANSI_color

Since ncurses-6.0-20180121 terminfo started to support 24-bit truecolor capability under the name of "RGB" - you need to use the "setaf" and "setab" commands to set foreground and background correspondingly.

Detection

There's no reliable way until the new release of terminfo/ncurses. After that the "RGB" flag should be available for detection. S-Lang author added a check for $COLORTERM containing either "truecolor" or "24bit" (case sensitive). In turn, VTE, Konsole and iTerm2 set this variable to "truecolor" (it's been there in VTE for a while, it's relatively new and maybe still git-only in Konsole and iTerm2).

This is obviously not a reliable method, and is not forwarded via sudo, ssh etc. However, whenever it errs, it errs on the safe side: does not advertise support whereas it's actually supported. App developers can freely choose to check for this same variable, or introduce their own method (e.g. an option in their config file), whichever matches better the overall design of the given app. Checking $COLORTERM is recommended though, since that would lead to a more unique desktop experience where the user has to set one variable only and it takes effect across all the apps, rather than something separately for each app.

Here are terminals discussions:

Now supporting truecolour

But there are bunch of libvte-based terminals for GTK2 so they are listed in the another section.

Also, while this one is not exactly a terminal, but a terminal replayer, it still worth mentioning:

Improper support for true colors

Parsing ANSI colour sequences, but approximating them to 256 palette

Note about colour differences: a) RGB axes are not orthogonal, so you cannot use sqrt(R^2+G^2+B^2) formula, b) for colour differences there is more correct (but much more complex) CIEDE2000 formula (which may easily blow up performance if used blindly) [2].

[2] neovim/neovim#793 (comment)

Terminal multiplexers

  • tmux - starting from version 2.2 (support since 427b820...)
  • screen - has support in 'master' branch, need to be enabled (see 'truecolor' option)
  • pymux - tmux clone in pure Python (to enable truecolour run pymux with --truecolor option)
  • dvtm - not yet supporting True Colour martanne/dvtm#10

NOT supporting truecolour

Here are another console programs discussions:

Supporting True Colour:

Not supporting True Colour:

@DaVince
Copy link

DaVince commented Jul 21, 2020

Aw damn, thanks for the information though!

@arlusf
Copy link

arlusf commented Aug 13, 2020

screen is about to have truecolor/direct color support, preview like this:
gnu screen 4.99 master (screen 5.xxx has not been released yet)
compile with bool truecolor=1 instead of 0
~/.screenrc truecolor on (did not find where truecolor is set in code at this point)
TERM=xterm-256color
COLORTERM=24bit

blink, overline and undercurl did not work as applied with test in khamer's comment above. (bash)
screencap

awk rainbow test works with dash and bash.

@laanwj
Copy link

laanwj commented Sep 24, 2020 •
edited
Loading

I think weston-terminal does not support true color.

It still doesn't in version 8.0.0 that was released this year, unfortunately. Worse, it doesn't parse and ignore \e[38;2;<R>;<G>;<B>m sequences (or map them to the allowed color space like Linux terminal does) but sees everything after 2 as a new SGR parameter.

Code here: https://github.com/wayland-project/weston/blob/master/clients/terminal.c#L1581

@lllisteu
Copy link

lllisteu commented Nov 14, 2020

IOS terminal apps that support true color:

  • Secure ShellFish (my favourite)
  • Blink Shell

IOS terminal apps that do NOT support true color:

  • Prompt (a.k.a. "Prompt 2")

@mintty
Copy link

mintty commented Nov 14, 2020

mintty: delimiter semicolon or colon; also supporting CMY and CMYK colour models

@Egyptorium
Copy link

Egyptorium commented Nov 16, 2020 •
edited
Loading

Right now have been tested on KDE Plasma's Konsole, and it supports true color.
konsole_truecolor

@xmine64
Copy link

xmine64 commented Nov 26, 2020

cmd.exe, Windows PowerShell, and PowerShell Core are using same Console. These apps are just shells, the actual console window is conhost.exe.

@Kr1ss-XD
Copy link

Kr1ss-XD commented Nov 28, 2020

Thank you very much for sharing this @XVilka, it's really helpful ! 👍

Would you consider adding delta (a syntax-highlighting diff-viewer/-formatter) to the list of apps supporting 24bit colors ?

@Delta456
Copy link

Delta456 commented Nov 28, 2020

I would to add mine in this list too.

@kurahaupo
Copy link

kurahaupo commented Feb 26, 2021

A small nit: please remove the word Introducer from the following:

… it is possible to use both ';' and ':' as Control Sequence Introducer delimiters

A Control Sequence Introducer is just the initial 1B 5B or 9B bytes of a whole Control Sequence. It is the latter which may contain delimiters.

(Hide this comment once that's done.)

@kurahaupo
Copy link

kurahaupo commented Mar 9, 2021 •
edited
Loading

Another nit: "delimiter" is related to "limit" rather than "meter", and is spelled accordingly. (This seems to have started with commit 507d2c2.)

Or just pull the changes from my repo clone of this gist.

You might also like to pull patches from the forks by CaninoDev, JohnMorales, and tizee.

(Although there doesn't seem to be a way to do this using the gist web interface, it's certainly possible using a local git repo on your own machine: you can pull from multiple gists as "remotes", and you can push to your own gist with changes merged from someone else's gist. See the instructions for cloning a gist as a repo for details.)

(As before, hide this comment once that's done.)

@jasikpark
Copy link

jasikpark commented May 18, 2021

Edex-UI seems to support TrueColor - oculd it be added to the list of supported terminals?
https://github.com/GitSquared/edex-ui
image
It's kinda a joke terminal emulator, but it's still managed to do it

@anpavlov
Copy link

anpavlov commented Jul 28, 2021 •
edited
Loading

urxvt Debian users may want to manually downgrade rxvt-unicode to 9.22-5 as it contains 24bit color patch. It was reverted in next version as it caused bugs as mentioned in 9.22-6 changelog. So use it with caution:

rxvt-unicode (9.22-6) unstable; urgency=medium

  • Revert the 24bit colour patch. Though no issues seem to arise when using
    the default resource values, it seems to cause many issues if changes are
    made to resources related to colour.
    (Closes: #922268, #922289, #922297, #922298, #922299)

-- Ryan Kavanagh rak@debian.org Thu, 14 Feb 2019 12:00:54 -0500

@kurahaupo
Copy link

kurahaupo commented Jul 30, 2021

@anpavlov The original patch to rxvt was pretty buggy:

  • It crashes when run as urxvt -pe tabbed
  • It doesn't cope with the terminal being in reverse video mode (it hides the cursor)
  • It introduces several other cosmetic defects

The first item on its own is a good enough reason to revert the patch. Clearly there needs to be more work done before it's ready for inclusion in a large-scale distribution.

@kurahaupo
Copy link

kurahaupo commented Jul 30, 2021

It seems this gist has become moribund, as @XVilka has neither commented nor applied any patches since October 2019.

It's become big enough that it really ought to be an actual project that accepts pull requests and has a bug tracker.

To that end, I suggest any further follow-up occur at https://github.com/kurahaupo/about-terminals/commits/kurahaupo/TrueColour.md

I'm happy to grant push access as required, especially to XVilka if they return.

@XVilka
Copy link
Author

XVilka commented Jul 30, 2021

@kurahaupo: I made repo some time ago - feel free to send PRs, issues, etc https://github.com/termstandard/colors

@kurahaupo
Copy link

kurahaupo commented Jul 30, 2021 •
edited
Loading

@XVilka Great, I'm glad not to have to maintain my own.

(And this also explains why things have been so quiet here.)

People will keep coming here because this gist has 2200 stars and 147 forks - twenty times more links than your repo - so search results are naturally going to rank it higher than your repo.

I searched for the URL you just posted and can now see that it's referenced in the top line "Most updated version is always available", which is great, but it's very easy to miss or ignore: at first glance it just looks like the kind of link that's on every GitHub.io website, that simply points back that the very page you're already reading; it's not obvious that it's pointing at a different repo without carefully reading the URL. (Indeed it's so unobvious that I went ahead and made my own repo, thinking that none existed.)

This gist also hundreds of comments, so it's not easy to find the other links to your repo either.

To make sure that people do actually go to your new repo, instead of commenting here, I suggest starting with something like:

THIS GIST IS OBSOLETE

See termstandard/colors instead.

And to make it even more obvious, remove all the other content.

@XVilka
Copy link
Author

XVilka commented Sep 30, 2021 •
edited
Loading

I updated the repository, thanks for the @kurahaupo's PR, also syncronized this gist with the repository, and added the link.

@clort81
Copy link

clort81 commented Oct 23, 2021

xterm no-longer approximates truecolor rgb to a palette, afaict.

@mintty
Copy link

mintty commented Feb 23, 2022

About Querying the Terminal: the response should actually look like ...;48:2::1:2:3m - note the double colon which allows a position for the optional color space value.

@wendajiang
Copy link

wendajiang commented Mar 3, 2022

I want to know why MacOS built-in terminal not support true color?

@JoshMerlino
Copy link

JoshMerlino commented Mar 15, 2022

echo -ne \e[1;3;4:3;5;53;38;2;255;127;0;58;2;0;48;255;48;2;255;0;{0..255..8}mX \e[0m\n

windows terminal was not a fan of this one
image

@kurahaupo
Copy link

kurahaupo commented Mar 15, 2022 •
edited
Loading

@khamer @JoshMerlino what is the 4:3 supposed to do in the middle of that escape sequence, before the 38 and 48 "extended" colour codes?

@kurahaupo
Copy link

kurahaupo commented Mar 15, 2022

@mintty @wendajiang @JoshMerlino - please note that this gist is no longer maintained. Please add your comments to the standardterm repo instead.

@XVilka - this is why I suggested that the entire content of this gist should be deleted except for the link to the repo. It would also help to mark all the comments as "hidden".

@coolmian
Copy link

coolmian commented May 11, 2022 •
edited
Loading

After my confirmation. Xshell6/7 support truecolor. But you must set "Tools-Options..-Advanced" check the "Use true color*"

@kurahaupo
Copy link

kurahaupo commented May 11, 2022

@coolmian would you mind please adding your notes as an issue on the standardterm repo ? (Preferably create a PR with a fix.)

@kurahaupo
Copy link

kurahaupo commented May 11, 2022 •
edited
Loading

Reminder to future readers who want to make a comment but didn't notice the warning at the top of this page.

It's now a full-blown git repo so please write your comments there, or clone the repo and suggest changes via a Pull Request:

git clone git+ssh://github.com/termstandard/colors truecolor

THIS GIST HAS MOVED
so any comments made here will be ignored!

@XVilka
Copy link
Author

XVilka commented May 11, 2022

@kurahaupo yes, should have made this a long time ago. Now it's done.

@coolmian
Copy link

coolmian commented May 13, 2022

@coolmian would you mind please adding your notes as an issue on the standardterm repo ? (Preferably create a PR with a fix.)

OK, I've done it now

@kurahaupo
Copy link

kurahaupo commented Oct 27, 2024

Just repeating this so that it's visible at the bottom of this conversation; please don't reply - the whole point is that this should be the last comment, to make it plainly visible when someone is about to hit "reply".

Reminder to future readers who want to make a comment but didn't notice the warning at the top of this page.

It's now a full-blown git repo so please write your comments there, or clone the repo and suggest changes via a Pull Request:

git clone git+ssh://github.com/termstandard/colors truecolor

THIS GIST HAS MOVED
so any comments made here will be ignored!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment