Colorize your output using RegEx
Project description
ChromaTerm
A tool for colorizing the output of a terminal.
About
ChromaTerm (ct
) reads from standard input and colors it according to user-configurable rules.
Think of ChromaTerm like grep
; just pipe things into it. However, unlike other programs which line-buffer, ct
works with interactive applications, like ssh
. In fact, I have ssh() { /usr/bin/ssh $* | ct; }
in my .bash_profile
to give my sessions color.
Here's an example using the rules in the default configuration file:
Installation
pip3 install chromaterm
If you have the legacy version of ChromaTerm, be sure to uninstall it first.
# If installed using HomeBrew brew uninstall chromaterm # If installed from source git clone -b legacy git@github.com:hSaria/ChromaTerm.git cd ChromaTerm--/src/ && ./configure && make uninstall
Usage
By default, ChromaTerm reads .chromaterm.yml
in your home directory. As an example, run the following:
echo "Jul 14 12:28:19: Message from 1.2.3.4" | ct
During installation, the default config file was copied to home directory.
Highlight Rules
All of the highlight rules are placed under the rules
array in the configuration file. Here's an example config file:
rules:
- description: My first rule colors the foreground
regex: hello.+world
color: f#ff0000
- description: Background this time, but just for "there"
regex: Hey (there), buddy
color: b#ff0000
group: 1
Description
Optional. It's purely for your sake.
RegEx
The RegEx engine used is Python's re.
Color
The color is a hex string prefixed by b
for background (e.g. b#123456
) and f
for foreground (e.g. f#abcdef
).
You can color the foreground and background by separating them with a space, like b#123456 f#abcdef
.
Group
Optional. By default, the entire match is colored. That can be changed to a specific group in the regex
.
Help
If you've got any questions or suggestions, please open up an issue (always appreciated).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for chromaterm-0.3.97.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 64f027263eb27222902e93ea0a99951f5c42f621bf8b0586241a2f46acbb31de |
|
MD5 | 1526caa6e02791d117ab8aa543195474 |
|
BLAKE2b-256 | e8cc315ac3e6f0338459e83beac36da02f950448b48b3456e1366ea48251ad02 |