GRC(1)

👑 GRC — the girlies' guide to the generic colouriser frontend 💅

okay so bestie, welcome to GRC(1), a General Commands Manual page, section 1, and honestly? she's iconic. grc is a frontend for the generic colouriser grcat(1), and she's about to make your terminal output look so much cuter. no cap. ✨

🌸 NAME 🌸

grc — frontend for generic colouriser grcat(1)

like... she's the pretty face, grcat is the brains. they're a duo. a power couple. 🫶

✨ SYNOPSIS ✨

grc [options] command [args]

that's it. that's the whole vibe. options, then a command, then whatever args you wanna hand her. 🎀

💖 DESCRIPTION 💖

so here's the tea, bestie: grc will execute command with its optional parameters [args], and she pipes that command's stdout or stderr into grcat, using the appropriate configuration file. it's giving glow-up, but for text. 🔥

now, which configuration file does she use? that's decided by the /etc/grc.conf file. periodt.

the format of /etc/grc.conf goes like this: each entry is made up of 2 lines, and between entries you can have literally any number of empty lines, or lines that begin with # (those are comments, bestie, they're just for you 💜).

• First line → a regular expression.
• Second line → the name of the configuration file for grcat.

and here's the main character moment: the configuration file from the first regular expression that matches command [args] is the one that gets passed to grcat as its configuration file. first match wins, no take-backs. 👑

🎀 OPTIONS 🎀

• --help — shows you a summary of the options. your little cheat sheet, iykyk.
• --version — displays the version. say hi to her properly. 💅
• -e, --stderr — redirects error output. but heads up bestie: unless -s is selected as well, this cancels the redirection of standard output via grcat. so don't come crying if your stdout stops being cute. 😭
• -s, --stdout — redirects standard output. this one is used to redirect standard output together with the --stderr option. they're a package deal, fr fr.
• --colour=x — where x is one of on off auto:
  • --colour=on — will colourise. this is the default, because obviously. 🌈
  • --colour=off — will just execute command without colourising. plain. unseasoned. but sometimes that's the mood.
  • --colour=auto — will test if standard output is a tty, and colourise only when it is. she's checking the vibe first. smart girlie. 🧚

🦋 SEE ALSO 🦋

• grcat(1)

go say hi to her sister. she's the one doing all the actual colourising. 💜

💜 AUTHOR 💜

Written by Radovan Garabík <garabik @ kassiopeia.juls.savba.sk>

and that's the whole page, bestie!! 🎉 this came from the General Commands Manual, section 1, and the footer line on the original was literally just GRC(1) — no version, no date, just her name in lights. iconic behaviour, honestly. now go colourise something. ✨💅🌸