colors.h

colors.h lets you use colors and other text styles in your terminal. Just add the colors.h header to your C/C++ project. For documentation, just read through the dead-simple header file for a list of self-explanatory names and the occasional comment. For the C_256() macro, see this wikipedia page for a table of colors, or use the C_RGB() macro.

Example

Print " aloha " in dark red text (color 52 in 256-color mode), with a bright yellow background, and make it both bold and blinking text.

#include <stdio.h>
#include "colors.h"

int main() {
       printf(C_256(52) C_BG_BR_YELLOW SGR_BOLD SGR_BLINK" aloha \n"
               SGR_RESET);
       return 0;
}

Output:

Documentation

There is no official documentation. Instead, you should read the header's source code. However, the behavior of all the macros can be inferred from their names. Any macro prefixed by SGR is a Select Graphic Rendition code and modifies how your terminal displays text, while any macro prefixed by C is a color code. Colors can be prefixed by two other abbreviations: BG to set the background color (the default is to set the foreground color) and BR to use a bright version of the color. If both BG and BR are used, BG always comes first.

License

colors.h is licensed under the ISC License. The license is also at the top of the colors.h header file. If you copy colors.h into your project's source code, do not remove the license from the header file.