Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A super easy console highlighter. Text goes in, color comes out.

Project Description

A super easy console highlighter. Text goes in, color comes out. rad can be used to process the output of commands, or to highlight single files.

How it works

rad will read the file given with --file/-f, or stdin if omitted.

Highlighting is specified with re-usable colorer files. Colorer files are written in YAML. They contain a collection of rules like this:

    fore: green
    back: black
    style: normal

or this:

regex: {fore: red, back: white, style: bright}

and are stored in ~/.rad/ by default. The simplest way to use rad is to give it the names of one or more colorers, like so:

$ echo "this is a test" | rad colorer1 colorer2

and all rules in the colorers ~/.rad/colorer1.yaml and ~/.rad/colorer2.yaml will be applied to the input text in order!

rad can also make these files for you interactively, using the --new/-n option:

$ rad -n
Colorer name for this rule: logs
Pattern to match: ERROR
Foreground color [white]: red
Background color [black]:
Style [bright]:

$ tail -f log.txt | rad logs

Colorer files will be appended to, so you can quickly build a colorer with a bunch of rules by running this a few times.


I plan on supporting the following in future releases of rad, while trying to keep the usage and syntax super-simple at the same time:

  • Multi-line highlighting, using start and stop regexes (e.g. highlight between HTML script tags or in tracebacks)
  • Support for syntax highlighting using Pygments by giving a lexer/formatter for a multi-line rule
  • Support for 256 colors (using Fabulous…?)
  • Other awesome stuff depending on how people want to use it
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
rad-0.1.2-py2.6.egg (10.1 kB) Copy SHA256 Checksum SHA256 2.6 Egg Oct 25, 2010
rad-0.1.2.tar.gz (4.9 kB) Copy SHA256 Checksum SHA256 Source Oct 25, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting