# Install xcbeautify with Homebrew, MacPorts, Nix

Little beautifier tool for xcodebuild. Version 3.2.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:xcbeautify
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install xcbeautify
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install xcbeautify
```

  Evidence: MacPorts ports tree: devel/xcbeautify/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#xcbeautify
```

  Evidence: nixpkgs package indexes: pkgs/by-name/xc/xcbeautify/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:xcbeautify
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/xcbeautify>
- **Version:** 3.2.1
- **Source summary:** Little beautifier tool for xcodebuild
- **Homepage:** <https://github.com/cpisciotta/xcbeautify>
- **Repository:** <https://github.com/cpisciotta/xcbeautify>
- **Upstream docs:** <https://github.com/cpisciotta/xcbeautify#readme>
- **License:** MIT
- **Source archive:** <https://github.com/cpisciotta/xcbeautify/archive/refs/tags/3.2.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- xcbeautify (cli)
- xcbeautify (alias)

## Uses from macOS

- libxml2

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.2.1
- Local data: ok
- Upstream repository: https://github.com/cpisciotta/xcbeautify
- Upstream latest detected: 3.2.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

xcbeautify is a Swift command-line formatter for xcodebuild output. Its README presents it as a faster alternative to xcpretty, with colored human-readable output and support for modern Xcode, Swift Package Manager, and CI rendering workflows.

### Project history

The GitHub release history shows xcbeautify releases from 0.3.6 in December 2018 to the 3.x series in 2026. The project has remained focused on parsing and presenting Apple's verbose build and test output while tracking changes in Xcode behavior.

The README emphasizes being written in Swift and compiling to a static binary, reducing Ruby dependence in development and CI environments compared with xcpretty. Later features include JUnit report generation and dedicated renderers for GitHub Actions, TeamCity, and Azure DevOps Pipeline.

### Adoption history

xcbeautify's adoption is most visible in the iOS and macOS CI ecosystem. fastlane's xcodebuild formatter documentation says fastlane 2.201.0 and later can select an xcodebuild_formatter, defaults to xcbeautify when it is installed, and describes xcbeautify as the recommended formatter.

The same fastlane documentation explains the transition context: xcpretty had historically been tightly integrated with fastlane as a RubyGem dependency, while xcbeautify became preferred for new build-system output, parallel testing output, Swift Package Manager formatting, and speed.

### How it is used

The basic usage is to pipe xcodebuild output into xcbeautify. The README also recommends `set -o pipefail` in CI so the pipeline preserves xcodebuild's exit status, and shows unbuffered/combined output for parallel or concurrent destination testing.

CI users can select specialized renderers, such as `--renderer github-actions`, so warnings, errors, and test results appear directly in the CI provider interface instead of only in raw logs.

### Why package nerds care

xcbeautify is important in Apple-platform packaging because xcodebuild is unavoidable but noisy. It provides a small CLI layer that makes Xcode builds readable in terminal and CI logs without tying the workflow to Ruby.

Its role is also a good example of ecosystem succession: a Swift-native formatter increasingly replacing or supplementing xcpretty in places where Xcode's newer build and parallel-test output needed better handling.

### Timeline

- 2018: GitHub release history includes xcbeautify 0.3.6.
- 2022: fastlane 2.201.0 and later document xcodebuild_formatter support and default to xcbeautify when installed.
- 2023: 1.0.1 is published in the release stream.
- 2024: 2.0.1 is published in the release stream.
- 2026: 3.2.1 is released with fixes and additional CLI test coverage.

### Related projects

- xcbeautify is directly related to xcodebuild, Swift Package Manager, fastlane scan/gym/snapshot, and xcpretty.

### Sources

- <https://docs.fastlane.tools/best-practices/xcodebuild-formatters/>
- <https://github.com/cpisciotta/xcbeautify/releases>
- <https://github.com/xcpretty/xcpretty>
- <https://raw.githubusercontent.com/cpisciotta/xcbeautify/main/README.md>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals
- **Approval gate rules:** 2

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** xcbeautify
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - xcbeautify: normalized package name match | nixpkgs package indexes: pkgs/by-name/xc/xcbeautify/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - xcbeautify: normalized package name match | MacPorts ports tree: devel/xcbeautify/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [xclogparser](https://www.automicvault.com/pkg/brew/xclogparser/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode, xcodebuild.
- [xcode-build-server](https://www.automicvault.com/pkg/brew/xcode-build-server/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, swift, xcode.
- [xcodegen](https://www.automicvault.com/pkg/brew/xcodegen/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, swift, xcode.
- [xcdiff](https://www.automicvault.com/pkg/brew/xcdiff/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcenv](https://www.automicvault.com/pkg/brew/xcenv/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcode-kotlin](https://www.automicvault.com/pkg/brew/xcode-kotlin/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcodes](https://www.automicvault.com/pkg/brew/xcodes/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcsift](https://www.automicvault.com/pkg/brew/xcsift/) - Shares av.db curated category or tags: cli, developer-tools, swift, xcode, xcodebuild.

## Combined YAML source

View the package source record on GitHub. [combined/xcbeautify.yml](https://github.com/automic-vault/db/blob/main/combined/xcbeautify.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- approval-gate seed metadata
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
