Skip to main content

Generic Coloriser

Project description

Generic Colorizer

strec allows you to colorize (even transform) shell output.


The original grc

Available at

While the original grc is a bit smarter with subprocesses, this rewrite focuses on ease of use (including Installation, Configuration and source-code access).

Installation should also honour the Linux FHS

sed or awk

sed and awk are extremely powerful tools, and can certainly do what strec does. They will certainly perform better on large streams. It’s their intended use afterall. However, they both use an archaic and arcane syntax for their scripts. Additionally, if you would like to colorize your output with these, you need to work with ANSI escape sequences. strec aims to simplify this by having a more readable Configuration syntax, and by hiding the ANSI escape sequences.

See the installation document for more information.


Read lines from stdin and emit modified/colorized lines on stdout


<some_process> | strec -c <config>


tail -f /var/log/apache2/access.log | strec -c apache_access
  • Only the stream you are sending to strec is affected.

  • No known side-effects

  • As strec only sees a stream, it cannot determine what application is emitting the stream. You have to specify the config manually.

Spawn a subprocess, capture it’s output


strec <some_procss>


strec aptitude search python
  • Much less to type

  • Can auto-detect the config by using the sub-process application name.

  • Spawning a subprocess and interacting with it’s IO is non-trivial on a TTY/PTY. To simplify the code, strec uses pexpect to do the IO magic.

  • stdout and stderr of the subprocess are combined into one stream, which is then emitten on strec’s stdout. [1]

  • The output may not use all of the available terminal width. [1]


strec searches three locations for configuration files in order:

  • ~/.strec/conf.d/<confname>.yml

  • /etc/strec/conf.d/<confname>.yml

  • /usr/share/strec/conf.d/<confname>.yml

The first matching config file wins. This means, you can override any system-wide configs with your own concoctions.


strec uses YAML as config syntax. Comparing to .ini and json files (both included in the Python stdlib), this syntax lends itself much better to the requirements of this application.

Basic structure

  • The config file is separated into sections (contexts). It has to have at least the root context.

  • Each context has a list of rules. These rules fire if a line contains a given regular expresssion. The first matching rule wins.

  • The line will then be replaced with the string contained in the replace value. You can use back-refs if you used capture groups in your regular expressions. Colours can be insterted using ${t.color_name}. You should always insert a ${t.normal} after using a color, to reset to the terminal default. The colors are provided by the package blessings. The t variable is a reference to a blessings terminal instance so you should be able to use it as it is documented on the blessings homepage.

  • Rules may define, that processing should not stop using the continue: yes flag. In that case, the same line will be matched with the following rule as well.

  • Additionally, rules may “push” another context onto the stack. If that’s the case, the rule will be processed, and all following lines will be matched against rules contained in the context named by the push value.

  • If in a non-root context, a rule may “pop” the current context from the stack using the pop: yes action.

See Config Reference for more details.

Annotated Example

# the primary context. This section must exist!
    - match: '^(running)(.*)'
      # demonstrating replacements /and/ colorizing
      replace: '*** ${}\1${t.normal}\2'

    - match: '^(writing)(.*)'
      replace: '>>> ${t.yellow}\1${t.normal}\2'

    - match: '^(reading)(.*)'
      replace: '<<< ${}\1${t.normal}\2'

    - match: '^(Processing dependencies for)(.*)'
      replace: '${}\1${t.normal}\2'
      # switch to the "dependencies" context
      push: dependencies

    - match: '^(Installing.*)'
      replace: '>>> ${}\1${t.normal}'

# the "dependencies" context
    - match: '^(Finished processing dependencies for)(.*)'
      replace: '${}\1${t.normal}\2'
      # Revert back to the "root" context
      pop: yes

    - match: '^(Searching for )(.*)$'
      replace: '\1${}\2${t.normal}'
      # switch to the "dependency" context
      push: dependency

# the "dependency" context
    # Let's prepend all lines with a small indent and pipe.
    # To do this, we specify a "match-all" regex, replace the line, and
    # specify that we will continue with the next matching rule using
    # "continue"
    - match: '(.*)'
      replace: ' | \1'
      continue: yes

    # Note that after the above rule, all lines are prepended with
    # additional text. We need to include this in the regex!
    - match: '^ \| (Installing.*)'
      replace: ' | >>> ${}\1${t.normal}'

    - match: '^ \| (Running.*)'
      replace: ' | ${}\1${t.normal}'

    - match: '^ \| (Best match.*)'
      replace: ' | ${}\1${t.normal}'

    - match: '^ \| (WARNING|warning)'
      replace: ' | ${t.yellow}\1${t.normal}'

    - match: '^ \| Installed(.*)'
      replace: ' | Installed\1\n'
      pop: yes

Config Reference

Main Level


Specifies the primary context

All other keys represent a context you pushed somewhere.


A context is simply a list of rules



Type: string

A python regular expression. If this matches somewhere in the input line, all occurrences will be replaced with the string specified in replace.


Type: string

If continue is false (the default), this string will be emitted to stdout. Otherwise, this string will be passed to the next matching rule. Not that the following rule sees the modified string!


Type: boolean

If true, don’t write the string yet to stdout. Instead, pass it on to the next matching rule.


Type: string

Pushes a new context onto the stack. All following lines from stdin will be matched agains rules in the new context.


Type: boolean

If this is set to true, then return to the previous context after this rule has been processed. If in the root context, this is a no-op.


A python setup session





Simple aptitude search





Apache access_log






Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

strec-1.0.0.post2.tar.gz (272.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page