Swiftpack.co - Package - thii/xcbeautify

xcbeautify Build Status

xcbeautify is a little beautifier tool for xcodebuild.

Similar to xcpretty, but faster.


  • [x] 2x faster than xcpretty.
  • [x] Human-friendly and colored output.
  • [x] Supports the new build system's output.
  • [x] Supports Xcode 10's parallel testing output.
  • [x] Supports formatting Swift Package Manager output.
  • [x] Supports macOS & Linux.
  • [x] Written in Swift: xcbeautify compiles to a static binary which you can bring anywhere. This also means less Ruby-dependant in your development environment and CI.

Note: xcbeautify does not support generating JUnit or HTML test reports. In fact, you shouldn't rely on xcodebuild's output to generate test reports. We suggest using trainer or XCTestHTMLReport to generate test reports from xcodebuild's generated TestSummaries.plist files.

Fun fact

xcbeautify uses itself to format its CI build logs.


If you use macOS 10.14.3 or earlier, install Swift 5 Runtime Support for Command Line Tools first:

brew cask install thii/swift-runtime/swift-runtime


brew tap thii/xcbeautify https://github.com/thii/xcbeautify.git
brew install xcbeautify


swift brew install thii/xcbeautify


mint install thii/xcbeautify


pod 'xcbeautify'

The xcbeautify binary will be installed at Pods/xcbeautify/xcbeautify

Build from source

git clone https://github.com/thii/xcbeautify.git
cd xcbeautify
make install


xcodebuild [flags] | xcbeautify

If you want xcbeautify to exit with the same status code as xcodebuild (e.g. on a CI):

set -o pipefail && xcodebuild [flags] | xcbeautify

For parallel and concurrent destination testing, it helps to use unbuffered I/O for stdout and to redirect stderr to stdout.

NSUnbufferedIO=YES xcodebuild [flags] 2>&1 | xcbeautify

Future work

  • [ ] Write more tests


To release a new version, say x.y.z:

make release version=x.y.z


Just send a PR! We don't bite ;)

Don't have a GitHub account or prefer old-school patching via email? Send your patch to the project's mailing list.




Stars: 151
Help us keep the lights on


0.7.0 - Dec 9, 2019


  • Fixed parsing of Xcode 11.1 and above's outputs (#24) @thii
  • Fixed log parsing for certain outputs for SwiftPM CLI on Linux (#21) @cyberbeni
  • Bumped Swift tools version to 5.0 (#21) @cyberbeni

0.6.0 - Sep 16, 2019


  • Parallel & Concurrent Destination Testing (#16) @chriszielinski

0.5.0 - Jul 27, 2019


  • Display a banner and warning or error in the quiet mode (#15) @greensky01
  • Support filtering out ouput that aren't warnings and errors (#14) @thii

0.4.4 - Jun 29, 2019


  • Remove backslashes before whitespaces in script build phases (#12) @guillaumealgis

0.4.3 - Jun 16, 2019

  • Fix bottling error on macOS High Sierra.