Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Color console logging for log4j and jdk


  • Download the latest color-loggers jar from releases or build them yourself
  • Download jansi-1.18.jar - optional, see below
    (jansi-1.18 is the latest one at this time, but I use nothing fancy, so I don't expect surprises with other versions)
  • Make sure the jar(s) mentioned above are somewhere in the classpath (whatever method you are using for your project)

On Mac OS X, Linux, UNIX, most (all?) the consoles support ANSI escapes.

ANSI escapes work out of the box in Windows 10.

On older Windows versions you can use the ConEmu console, or the standard Windows console with ansicon and the AnsiColorConsole* flavors of the loggers. But if you want the standard Windows console without ansicon, then you should use JAnsiColorConsole* and you also need jansi.

There are pros and cons for each option, I hope to write an article when I have some time.

JDK (or JUL, java.util.logging)

In the java logging configuration file (default in $JAVA_HOME/lib/ use com.mihnita.colorlog.jdk.AnsiColorConsoleHandler or com.mihnita.colorlog.jdk.JAnsiColorConsoleHandler as handler.

They work the same as java.util.logging.ConsoleHandler.

See an example in src/test/resources/


In (or whatever config file you use for log4j) use com.mihnita.colorlog.log4j.AnsiColorConsoleAppender or com.mihnita.colorlog.log4j.JAnsiColorConsoleAppender as appender.

They work the same as org.apache.log4j.ConsoleAppender.

See an example in src/test/resources/ or src/test/resources/log4j.xml


Logback already allows for colored output using jansi, but does not allow configuring the colors. But now, with java-color-loggers, you can.

In logback.xml (or whatever config file you use for Logback) find the appender that uses ch.qos.logback.core.ConsoleAppender, find the encoder element, and add a class attribute with the value of com.mihnita.colorlog.logback.ColorPatternLayoutEncoder.

And as children of the encoder element you can add the following elements to configure the colors:


The values should be valid ANSI escape sequences, without the {esc}[ and without the final m.

See an example in src/test/resources/logback.xml

Log4j 2

Log4j 2 supports colors out of the box, see


Nothing special about it, you configure the logger “underneath it” (jdk or log4j or logback).


Build: Build Status

DepShield: DepShield Status


mvn clean install

But maven (or maybe junit?) “hijacks” the output of the test. So not all the lines that would normally be colored are colored in the maven test. The best way to try things is to run the tests in as a normal application against the final jar (with the 3rd party jars in “the right place”).