Colors text received over standard input based on regular expression patterns.
- .NET 6.0 or later
Recolor is available as a .NET Core tool for installation:
dotnet tool install -g recolor
recolor COLOR1=REGEX1 COLOR2=REGEX2 ... COLORN=REGEXN
Each line read over standard input is tested against each regular expression
pattern (REGEX) in turn. Those that match are used to highlight the matched
portion of the text in the corresponding color (COLOR). The regular
expression patterns are tested on each line only once unless a start-equal
(*=) instead just an equal (=) is used to separate the color from the
regular expression pattern specification.
Any command-line argument of the form @FILE is expanded with the contents of
the response file identified by FILE. A response file specifies command-line
arguments, one per line. Blank lines or lines in the response file starting
with pound/hash (#) are ignored. More than one response file can be given.
If FILE starts with (~) and is not a path (i.e. contains no directory
separators) then either ~/.recolor/FILE.rsp or ~/.recolor/FILE will be
sought and used as the response file instead (where ~ is the user home).
Processing of all arguments begins after expanding all response files to form
a single command-line.
A color is specified in one of three formats:
- FOREGROUND
- FOREGROUND/BACKGROUND
- HEX
Format 1 sets only the foreground color of the text whereas format 2 sets the foreground and background colors (separated by a forward-slash to mean foreground over background). FOREGROUND can be omitted to set just the background. The colors themselves are specified using the names listed below. In format 3, the colors are specified by two hex digits: the first corresponds to the background and the second the foreground. If only a single hex digit is given then it sets the foreground color. The color corresponding to each hex digits is shown below.
| Hex | Color Name |
|---|---|
| 0 | Black |
| 1 | DarkBlue |
| 2 | DarkGreen |
| 3 | DarkCyan |
| 4 | DarkRed |
| 5 | DarkMagenta |
| 6 | DarkYellow |
| 7 | Gray |
| 8 | DarkGray |
| 9 | Blue |
| A | Green |
| B | Cyan |
| C | Red |
| D | Magenta |
| E | Yellow |
| F | White |
For REGEX syntax, see Regular Expression Language Quick Reference.
The .NET Core SDK is the minimum requirement.
To build just the binaries on Windows, run:
.\build.cmd
On Linux or macOS, run instead:
./build.sh
To build the binaries and the NuGet packages on Windows, run:
.\pack.cmd
On Linux or macOS, run instead:
./pack.sh