It's sometimes helpful to color-coordinate your log messages. For example, you may want your error messages to print in red so they stick out.
This is possible with DDTTYLogger and XcodeColors.
XcodeColors is a simple plugin for Xcode.
It allows you to use colors in the Xcode debugging console.
Full installation instructions can be found on the XcodeColors project page:
But here's a summary:
All it takes is one extra line of code to enable colors in Lumberjack:
// Standard lumberjack initialization [DDLog addLogger:[DDTTYLogger sharedInstance]]; // And we also enable colors [[DDTTYLogger sharedInstance] setColorsEnabled:YES];
The default color scheme (if you don't customize it) is:
However, you can fully customize the color schemes however you like!
In fact, you can customize the foreground and/or background colors.
And you can specify any RGB value you'd like.
// Let's customize our colors. // DDLogInfo : Pink #if TARGET_OS_IPHONE UIColor *pink = [UIColor colorWithRed:(255/255.0) green:(58/255.0) blue:(159/255.0) alpha:1.0]; #else NSColor *pink = [NSColor colorWithCalibratedRed:(255/255.0) green:(58/255.0) blue:(159/255.0) alpha:1.0]; #endif [[DDTTYLogger sharedInstance] setForegroundColor:pink backgroundColor:nil forFlag:LOG_FLAG_INFO]; DDLogInfo(@"Warming up printer"); // Prints in Pink !
You may occasionally notice that colors don't work when you're debugging your app in the simulator. And you may also notice that your colors never work when debugging on the actual device. How do I fix it so it works everywhere, all the time?
You can fix it in a few seconds. Here's how.
Your colors should now work on the simulator and on the device, every single time.
The XcodeColors plugin is automatically loaded by Xcode when Xcode launches. When XcodeColors runs, it sets the environment variable "XcodeColors" to "YES". Thus the Xcode application itself has this environment variable set.
It is this environment variable that Lumberjack uses to detect whether XcodeColors is installed or not. Because if Lumberjack injects color information when XcodeColors isn't installed, then your log statements have a bunch of garbage characters in them.
Now any application that Xcode launches inherits the environment variables from Xcode. So if you hit build-and-go, and Xcode launches the simulator for you automatically, then the colors will work. But if you manually launch the simulator, then it doesn't inherit environment variables from Xcode (because Xcode isn't the process' parent in this case). It's a similar problem when debugging on the actual device.
If you ever do any debugging in the Terminal, then you're in luck! DDTTYLogger supports color in terminals as well.
If your shell supports color, the DDTTYLogger will automatically map your requested colors to the closest supported color by your shell. In most cases your terminal will be "xterm-256color", so your terminal will support 256 different colors, and you'll get a close match for whatever RGB values you configure.
Last edited by Robbie Hanson,