Writing a small command line tool, it would be nice to output in different colours. Is this possible?
14 Answers
Yes. See this article. Here's an example from there:
Console.BackgroundColor = ConsoleColor.Blue;
Console.ForegroundColor = ConsoleColor.White;
Console.WriteLine("White on blue.");
-
7
-
@RollRoll not in the default cmd.exe. You can try using a Console emulator though, which supports background image tweaking, but still, it cannot be done programatiaclly anyway. Mar 2, 2019 at 18:23
class Program
{
static void Main()
{
Console.BackgroundColor = ConsoleColor.Blue;
Console.ForegroundColor = ConsoleColor.White;
Console.WriteLine("White on blue.");
Console.WriteLine("Another line.");
Console.ResetColor();
}
}
Taken from here.
Above comments are both solid responses, however note that they aren't thread safe. If you are writing to the console with multiple threads, changing colors will add a race condition that can create some strange looking output. It is simple to fix though:
public class ConsoleWriter
{
private static object _MessageLock= new object();
public void WriteMessage(string message)
{
lock (_MessageLock)
{
Console.BackgroundColor = ConsoleColor.Red;
Console.WriteLine(message);
Console.ResetColor();
}
}
}
-
19Writing from multiple threads without synchronisation will result in garbled output even if there are no color changes: it's not just changing colors that causes a race condition– JoeJul 5, 2017 at 9:41
-
10@Joe A single
Write
call will not be garbled. See stackoverflow.com/questions/4812508/…. It's just the order of the write-calls which is not "safe". Oct 17, 2017 at 9:29 -
But what about if other processes are writing to the same console? They won't be using your lock object. Is there any truly atomic way to change the color, write to the console, and then change the color back? Sep 1, 2020 at 18:52
-
1They won't be using the console writer if you don't choose to use the console writer. The implication here is that you use this object for all writes to the console. I suppose you could do some tricky wrapper on the Console.Write command, but that sees a bit overkill. Sep 3, 2020 at 17:41
-
It feels to me like the
WriteMessage
method - or maybe even the whole class - should be static.– StewartDec 22, 2022 at 17:46
I've created a small plugin (available on NuGet) that allows you to add any (if supported by your terminal) color to your console output, without the limitations of the classic solutions.
It works by extending the String
object and the syntax is very simple:
"colorize me".Pastel("#1E90FF");
Both foreground and background colors are supported.
-
3I believe this library uses those ANSI escape color codes, which appears to be what Microsoft.Extensions.Logging.Console is also using.– PangOct 16, 2020 at 3:01
-
2@Pang Microsoft.Extensions.Logging.Console is a logging library, whereas Pastel can be used for printing directly to the console; also it seems to be supporting a limited subset of colors from what I can derive from the source code.– silkfireOct 16, 2020 at 8:38
-
1@Pang that library does not implement all foreground colors for some reason. I tend to go with Microsoft solutions but the Pastel solution is more complete.– Tono NamJan 19, 2022 at 23:26
Here is a simple method I wrote for writing console messages with inline color changes. It only supports one color, but it fits my needs.
// usage: WriteColor("This is my [message] with inline [color] changes.", ConsoleColor.Yellow);
static void WriteColor(string message, ConsoleColor color)
{
var pieces = Regex.Split(message, @"(\[[^\]]*\])");
for(int i=0;i<pieces.Length;i++)
{
string piece = pieces[i];
if (piece.StartsWith("[") && piece.EndsWith("]"))
{
Console.ForegroundColor = color;
piece = piece.Substring(1,piece.Length-2);
}
Console.Write(piece);
Console.ResetColor();
}
Console.WriteLine();
}
-
-
Are you asking for me to comment the code? I thought it was fairly self-explanatory. The function scans the string named
message
for text wrapped in square-brackets and sets theConsole.ForegroundColor
property to print out yellow text, writes the text to the console, then it resets the text to the default ForegroundColor. I don't believe an SO answer necessitates so much detail. For me, the primary purpose of an answer is to solve the questions problem, not to educate the asking developer. Apr 19 at 21:56 -
I vote up the answer, but the main idea of SO is a clear answer to explain to others than OP. In this case, the answer is fine but is not related to what the OP asks. What means "pieces", ie., words? letters? what does the regular expression? etc Apr 19 at 22:10
Yes, it's easy and possible. Define first default colors.
Console.BackgroundColor = ConsoleColor.Black;
Console.ForegroundColor = ConsoleColor.White;
Console.Clear();
Console.Clear()
it's important in order to set new console colors. If you don't make this step you can see combined colors when ask for values with Console.ReadLine()
.
Then you can change the colors on each print:
Console.BackgroundColor = ConsoleColor.Black;
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine("Red text over black.");
When finish your program, remember reset console colors on finish:
Console.ResetColor();
Console.Clear();
Now with netcore we have another problem if you want to "preserve" the User experience because terminal have different colors on each Operative System.
I'm making a library that solves this problem with Text Format: colors, alignment and lot more. Feel free to use and contribute.
https://github.com/deinsoftware/colorify/ and also available as NuGet package
The easiest way I found to colorize fragments of the console output is to use the ANSI escape sequences in the Windows console.
public static int Main(string[] args)
{
string NL = Environment.NewLine; // shortcut
string NORMAL = Console.IsOutputRedirected ? "" : "\x1b[39m";
string RED = Console.IsOutputRedirected ? "" : "\x1b[91m";
string GREEN = Console.IsOutputRedirected ? "" : "\x1b[92m";
string YELLOW = Console.IsOutputRedirected ? "" : "\x1b[93m";
string BLUE = Console.IsOutputRedirected ? "" : "\x1b[94m";
string MAGENTA = Console.IsOutputRedirected ? "" : "\x1b[95m";
string CYAN = Console.IsOutputRedirected ? "" : "\x1b[96m";
string GREY = Console.IsOutputRedirected ? "" : "\x1b[97m";
string BOLD = Console.IsOutputRedirected ? "" : "\x1b[1m";
string NOBOLD = Console.IsOutputRedirected ? "" : "\x1b[22m";
string UNDERLINE = Console.IsOutputRedirected ? "" : "\x1b[4m";
string NOUNDERLINE = Console.IsOutputRedirected ? "" : "\x1b[24m";
string REVERSE = Console.IsOutputRedirected ? "" : "\x1b[7m";
string NOREVERSE = Console.IsOutputRedirected ? "" : "\x1b[27m";
Console.WriteLine($"This is {RED}Red{NORMAL}, {GREEN}Green{NORMAL}, {YELLOW}Yellow{NORMAL}, {BLUE}Blue{NORMAL}, {MAGENTA}Magenta{NORMAL}, {CYAN}Cyan{NORMAL}, {GREY}Grey{NORMAL}! ");
Console.WriteLine($"This is {BOLD}Bold{NOBOLD}, {UNDERLINE}Underline{NOUNDERLINE}, {REVERSE}Reverse{NOREVERSE}! ");
}
The output:
The NOBOLD
code is really "normal intensity". See the "SGR (Select Graphic Rendition) parameters" section on the linked wikipedia page for details.
The redirection test avoids outputting escape sequences into a file, should the output be redirected. If the user has a color scheme other than white-on-black, it won't get reset but you could maybe use the Console functions to save/restore the user's color scheme at the beginning and end of the program if that matters.
-
In Windows 10 (C# Console Application) it produces a non colored output "This is ←[91mRed←[39m, ←[92mGreen←[39m, ←[93mYellow←[39m, ←[94mBlue←[39m". Do you know what might be the reason why it does not interpret the codes? May 17 at 5:19
-
I have not encountered any issues. However, this page might help. How-to: Use ANSI colors in the terminal: ss64.com/nt/syntax-ansi.html . It mentions that Windows versions 1511 through to 1903 require a registry setting. It suggests calling SetConsoleMode API with the ENABLE_VIRTUAL_TERMINAL_PROCESSING flag, or (less desirable) making a registry entry. Try the SetConsoleAPI call from your C# app and post back if that helps. May 18 at 15:10
-
I've also had some programs disable the ANSI output -- specifically, some GNU apps on Windows like UNZIP.EXE, especially when they crash or I use Ctrl+Break while running. Guessing they might modify the way the console works and not always restore it when finished. May 18 at 15:13
Just to add to the answers above that all use Console.WriteLine
: to change colour on the same line of text, write for example:
Console.Write("This test ");
Console.BackgroundColor = bTestSuccess ? ConsoleColor.DarkGreen : ConsoleColor.Red;
Console.ForegroundColor = ConsoleColor.White;
Console.WriteLine((bTestSuccess ? "PASSED" : "FAILED"));
Console.ResetColor();
A sample method to color multiple words at the same time.
private static void WriteColor(string str, params (string substring, ConsoleColor color)[] colors)
{
var words = Regex.Split(str, @"( )");
foreach (var word in words)
{
(string substring, ConsoleColor color) cl = colors.FirstOrDefault(x => x.substring.Equals("{" + word + "}"));
if (cl.substring != null)
{
Console.ForegroundColor = cl.color;
Console.Write(cl.substring.Substring(1, cl.substring.Length - 2));
Console.ResetColor();
}
else
{
Console.Write(word);
}
}
}
Usage:
WriteColor("This is my message with new color with red", ("{message}", ConsoleColor.Red), ("{with}", ConsoleColor.Blue));
Output:
I developed a small fun class library named cConsole for colored console outputs.
Example usage:
const string tom = "Tom";
const string jerry = "Jerry";
CConsole.WriteLine($"Hello {tom:red} and {jerry:green}");
It uses some functionalities of C# FormattableString, IFormatProvider and ICustomFormatter interfaces for setting foreground and background colors of text slices.
You can see cConsole source codes here
-
-
Don't be concerned. Everyone can use it in anywhere without blaming me for future issues that may occur in production usage Apr 21, 2022 at 16:39
-
I honestly don't know why this isn't upvoted a hundred times! This is really great, a nice elegant solution. May 3, 2022 at 20:35
Yes, it is possible as follows. These colours can be used in a console application to view some errors in red, etc.
Console.BackgroundColor = ConsoleColor.Blue;
Console.ForegroundColor = ConsoleColor.White;//after this line every text will be white on blue background
Console.WriteLine("White on blue.");
Console.WriteLine("Another line.");
Console.ResetColor();//reset to the defoult colour
Here's an elegant implementation using the new string interpolation feature for dotnet.
[InterpolatedStringHandler]
public ref struct ConsoleInterpolatedStringHandler
{
private static readonly Dictionary<string, ConsoleColor> colors;
private readonly IList<Action> actions;
static ConsoleInterpolatedStringHandler() =>
colors = Enum.GetValues<ConsoleColor>().ToDictionary(x => x.ToString().ToLowerInvariant(), x => x);
public ConsoleInterpolatedStringHandler(int literalLength, int formattedCount)
{
actions = new List<Action>();
}
public void AppendLiteral(string s)
{
actions.Add(() => Console.Write(s));
}
public void AppendFormatted<T>(T t)
{
actions.Add(() => Console.Write(t));
}
public void AppendFormatted<T>(T t, string format)
{
if (!colors.TryGetValue(format, out var color))
throw new InvalidOperationException($"Color '{format}' not supported");
actions.Add(() =>
{
Console.ForegroundColor = color;
Console.Write(t);
Console.ResetColor();
});
}
internal void WriteLine() => Write(true);
internal void Write() => Write(false);
private void Write(bool newLine)
{
foreach (var action in actions)
action();
if (newLine)
Console.WriteLine();
}
}
To use it, create a class, such as ExtendedConsole
:
internal static class ExtendedConsole
{
public static void WriteLine(ConsoleInterpolatedStringHandler builder)
{
builder.WriteLine();
}
public static void Write(ConsoleInterpolatedStringHandler builder)
{
builder.Write();
}
}
Then, use it like:
var @default = "default";
var blue = "blue";
var green = "green";
ExtendedConsole.WriteLine($"This should be {@default}, but this should be {blue:blue} and this should be {green:green}");
I did want to just adjust the text color when I want to use Console.WriteLine();
So I had to write
Console.ForegroundColor = ConsoleColor.DarkGreen;
Console.WriteLine("my message");
Console.ResetColor();
every time that I wanted to write something
So I invented my WriteLine()
method and kept using it in Program class instead of Console.WriteLine()
public static void WriteLine(string buffer, ConsoleColor foreground = ConsoleColor.DarkGreen, ConsoleColor backgroundColor = ConsoleColor.Black)
{
Console.ForegroundColor = foreground;
Console.BackgroundColor = backgroundColor;
Console.WriteLine(buffer);
Console.ResetColor();
}
and to make it even easier I also wrote a Readline()
method like this:
public static string ReadLine()
{
var line = Console.ReadLine();
return line ?? string.Empty;
}
so now here is what we have to do to write or read something in the console:
static void Main(string[] args) {
WriteLine("hello this is a colored text");
var answer = Readline();
}
With this simple C# code you can demonstrate all possible output colors and choose what you want.
Type type = typeof(ConsoleColor);
Console.ForegroundColor = ConsoleColor.White;
foreach (var name in Enum.GetNames(type))
{
Console.BackgroundColor = (ConsoleColor)Enum.Parse(type, name);
Console.WriteLine(name);
}
Console.BackgroundColor = ConsoleColor.Black;
foreach (var name in Enum.GetNames(type))
{
Console.ForegroundColor = (ConsoleColor)Enum.Parse(type, name);
Console.WriteLine(name);
}