Ah, September, when the sysadmins turn colors and fall off the trees....

Dave van Domelen


This Perl module is a simple and convenient interface to the ANSI terminal escape sequences for color (from ECMA-48, also included in ISO 6429). The color sequences are provided in two forms, either as constants for each color or via a function that takes the names of colors and returns the appropriate escape codes or wraps them around the provided text. The non-color text style codes from ANSI X3.64 (bold, dark, underline, and reverse, for example), which were also included in ECMA-48 and ISO 6429, are also supported. Also supported are the extended colors used for sixteen-color and 256-color emulators.

This module is very stable, and I've used it in a wide variety of applications. It has been included in the core Perl distribution starting with version 5.6.0, so you don't need to download and install it yourself unless you have an old version of Perl or need a newer version of the module than comes with your version of Perl. I continue to maintain it as a separate module, and the version included in Perl is resynced with mine before each release.

The original module came out of a discussion in comp.lang.perl.misc and is a combination of two approaches, one with constants by Zenin and one with functions that I wrote. I offered to maintain a combined module that included both approaches.


Term::ANSIColor is written in pure Perl and has no module dependencies that aren't found in Perl core. It should work with any version of Perl after 5.6, although it hasn't been tested with old versions in some time.

In order to actually see color, you will need to use a terminal window that supports the ANSI escape sequences for color. Any recent version of xterm, most xterm derivatives and replacements, and most telnet and ssh clients for Windows and Macintosh should work, as will the MacOS X Terminal application (although Terminal.app reportedly doesn't support 256 colors). The console windows for Windows NT and Windows 2000 will not work, as they do not even attempt to support ANSI X3.64.

For a complete (to my current knowledge) compatibility list, see the documentation. If you have any additions to the table in the documentation, please send them to me.

The module test suite requires some additional modules to run all of the tests, although tests will be skipped if those prerequisites aren't available. See the README file for a complete list of test suite requirements.


The distribution:

Term::ANSIColor 4.05 2016-03-21 tar.gz (PGP signature) tar.xz (PGP signature)

An archive of older releases is also available.

Term::ANSIColor is maintained using the Git version control system. To check out the current development tree, clone:


You can also browse the current development source.



Copyright 1996 Zenin
Copyright 1996-1998, 2000-2002, 2005-2007, 2009-2016 Russ Allbery <rra@stanford.edu>
Copyright 2012 Kurt Starsinic <kstarsinic@gmail.com>

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself. This means that you may choose between the two licenses that Perl is released under: the GNU GPL and the Artistic License. Please see your Perl distribution for the details and copies of the licenses.

PUSH/POP support submitted 2007 by openmethods.com voice solutions.

Last modified and spun 2016-03-21