# Install xclogparser with Homebrew

Tool to parse the SLF serialization format used by Xcode. Version 0.2.49 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:xclogparser
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install xclogparser
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:xclogparser
- **Package manager:** Homebrew
- **Version:** 0.2.49
- **Source summary:** Tool to parse the SLF serialization format used by Xcode
- **Homepage:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **Repository:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **Last updated:** 2026-07-07T20:35:03Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- xclogparser (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.2.49
## Project history and usage

XCLogParser is a Swift command-line tool for parsing Xcode and `xcodebuild` logs stored as compressed `.xcactivitylog` files in Apple's SLF format. Its README presents it as a way to turn opaque build and test logs into JSON, HTML, Chrome trace, issue, and summary reports.

### Project history

The project came from Spotify's Apple-platform build tooling work and later moved under the Mobile Native Foundation organization. Its README points to Erick Camacho's AltConf 2019 talk about the `.xcactivitylog` format, and Spotify's later XCMetrics writing explains that XCLogParser was created to extract human-readable data from Xcode build logs.

XCLogParser's scope expanded from dumping raw logs to producing structured reports for build times, warnings, errors, unit-test results, Swift compiler timings, linker statistics, and Clang time-trace data. The GitHub releases page shows ongoing maintenance through v0.2.48 in June 2026, including parser updates for newer Xcode activity-log sections.

### Adoption history

The most visible downstream adoption is XCMetrics, Spotify's build-metrics system. Spotify and XCMetrics documentation state that XCMetrics is built on top of XCLogParser and has used it to collect large-scale build metrics across Spotify iOS applications, turning the parser from a standalone CLI into an engine for continuous developer-productivity measurement.

### How it is used

Typical use is either `xclogparser dump` for raw JSON or `xclogparser parse` with a reporter such as `json`, `flatJson`, `summaryJson`, `chromeTracer`, `issues`, or `html`. The README documents locating logs by project, workspace, xcodeproj, explicit file, or DerivedData path.

The README also documents Xcode integration through a post-scheme build action, plus a caveat that since Xcode 11, command-line `xcodebuild` only generates `.xcactivitylog` build logs when `-resultBundlePath` is supplied. That detail is central to using the tool reliably in CI.

### Why package nerds care

XCLogParser is significant because `.xcactivitylog` files are not pleasant text logs: they are gzipped binary SLF data in DerivedData. The tool gives package, CI, and build-performance nerds a stable way to mine Xcode's hidden build graph and timing data without depending on the Xcode UI.

### Timeline

- 2019: README points users to an AltConf 2019 talk about the Xcode activity-log format.
- 2020: Spotify introduces XCMetrics as a system built on top of XCLogParser for continuous build metrics.
- 2026-06-09: GitHub releases list v0.2.48 with parser updates for newer Xcode activity logs.

### Related projects

- XCMetrics is the major related project and uses XCLogParser as its log-parsing foundation.
- xcbeautify and similar xcodebuild log tools address console output readability, while XCLogParser focuses on `.xcactivitylog` and structured build telemetry.

### Sources

- <https://engineering.atspotify.com/introducing-xcmetrics-our-all-in-one-tool-for-tracking-xcode-build-metrics>
- <https://github.com/MobileNativeFoundation/XCLogParser#readme>
- <https://github.com/MobileNativeFoundation/XCLogParser/blob/master/docs/Xcactivitylog%20Format.md>
- <https://github.com/MobileNativeFoundation/XCLogParser/releases>
- <https://xcmetrics.io/docs/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/xclogparser.yml](https://github.com/mxcl/pkgdb/blob/main/combined/xclogparser.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph