Skip to content

Uncrustify utility and documentation browser for Mac OS X


Notifications You must be signed in to change notification settings


Repository files navigation



Uncrustify utility and documentation browser for Mac OS X


UncrustifyX aims to make it easier to browse the hundreds of options available for the Uncrustify utility. The documentation browser categorizes the options and provides easy searching and filtering. It can also show a live preview of applying an option on a code sample.

Additionally, UncrustifyX allows importing and exporting of Uncrustify .cfg files, and provides a GUI to run a configuration set on a list of files, or direct source code input.


2-Sentence Manual

Drag options from the documentation panel into the main window's option table. Drag source files (.h, .m etc.) onto the dock icon, or into the main window's file table.

No preset configuration files are currently included. Here is a good starting point for an Objective-C configuration.


Prebuit binaries and source are available on the releases page, and tagged releases can be easily updated to via Sparkle in-app updates.

Building Project

Git checkout the project including its submodules. Xcode 4.5+, 10.8+ required. Install mogenerator. Install NSLogger to view debug logging.


I welcome contributors to this project. Raise any bugs/suggestions/feature requests within the Issues tab. File bugs on uncrustify at the project's SourceForge or Github home.

Configuration Set Contribution

I plan to add some default config files in the future. If you have a particulary fine-tuned config file for a language, please get in touch.

Xcode Integration

The best way to use your uncrustify configuration from within Xcode is by using BBUncrustifyPlugin-Xcode. This is bundled with UncrustifyX and you can install it from the Preferences window.


UncrustifyX is licenced under a modified BSD License. Please don’t upload this code directly to the App Store as is, without making substantial improvements. In other words, please don’t be a jerk.


Uncrustify utility and documentation browser for Mac OS X







No packages published