15 releases (8 breaking)

0.9.0 Jan 14, 2024
0.8.0 Oct 31, 2023
0.7.0 Oct 16, 2023
0.5.1 Dec 15, 2022
0.3.1 Nov 26, 2021

#22 in No standard library

Download history 7149/week @ 2024-01-03 10162/week @ 2024-01-10 12743/week @ 2024-01-17 9576/week @ 2024-01-24 9806/week @ 2024-01-31 11094/week @ 2024-02-07 9615/week @ 2024-02-14 8798/week @ 2024-02-21 10147/week @ 2024-02-28 10529/week @ 2024-03-06 10515/week @ 2024-03-13 11840/week @ 2024-03-20 10755/week @ 2024-03-27 9605/week @ 2024-04-03 10127/week @ 2024-04-10 9004/week @ 2024-04-17

41,374 downloads per month
Used in 75 crates (3 directly)

MIT license

135KB
3.5K SLoC

MIT Latest Version docs Chat on Miaou

Definition of ANSI, RGB and HSL color types and all the conversions between them.

There are many other color conversion crates. This one is no-std and pure-rust and may be useful when you're interested into

  • variations of an ANSI color for your TUI application, for example fading, lightening, darkening, with compatibility with terminals that don't support RGB.
  • translations of color schemes
  • automatic downgrading of RGB color schemes for non RGB terminals
  • automated building of harmonious color schemes with guarantees of contrast
  • etc.

Coolor is used in SafeCloset to dynamically fade the background behind a dialog:

img

Be warned that the ANSI range is intrinsically limited to 240 colors and that not all intuitive operations will give good results.

Coolor doesn't contain functions to print on the terminal, but the colors can be used in other crates. There's an optional feature for conversion from and into Crossterm colors. You'll see it used in the included examples.

Included Examples

ansi-variations

Luminosity and saturation variations of all 240 ANSI colors, with all variants still ANSI colors.

ansi-variations

ansi-mix

Several ways to mix colors

ansi-mix

rgb-to-ansi

Finding the nearest ANSI color from a RGB one

rgb-to-ansi

Dependencies

~0–6MB