---
id: pycrashreport
version: "2.0.0"
license: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record)
license_treatment: copyleft
maintenance: active
---

# pycrashreport — Pure python3 for parsing Apple's crash reports

License: copyleft · Maintenance: active · Downloads: 317.8K/mo

## What it is and what it does

pycrashreport is a command-line tool that transforms Apple crash reports (.ips files) from iOS and macOS into a cleaner, more readable format. It extracts the essential debugging information—exception type, exception subtype, CPU registers, and stack frames—while stripping away the verbose metadata like thread listings and loaded image tables that clutter the original reports. The tool is built on typer for CLI handling and supports both user-mode and kernel-mode crashes; other crash types are parsed for basic metadata only.

The package is intended for developers and QA engineers who need to quickly understand what went wrong in a crash without wading through Apple's default verbose output. It runs as a standalone command-line utility and is actively maintained with support for modern Python versions (3.9 through 3.14).

Use it for:

- Quickly review iOS app crashes from TestFlight or App Store Connect without opening Xcode
- Automate crash report triage in CI/CD pipelines by parsing .ips files to extract key failure data
- Archive and search crash reports in a normalized, human-readable format for post-mortem analysis
- Extract register state and stack frames from macOS kernel panics for debugging system-level issues

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses Apple crash reports (iOS, macOS) into a readable format, extracting exception type, registers, and stack frames while filtering out noise like thread listings and loaded images.

Yes, if you regularly work with Apple crash reports and want a lightweight, GPL-compatible tool to parse them. The low install friction, active maintenance, and lack of known vulnerabilities make it safe to adopt. The copyleft license is a blocker only if you need to embed it in proprietary closed-source software.

## Install

pip install pycrashreport
uv add pycrashreport
poetry add pycrashreport

## Installing pycrashreport

Before you install: Low install friction with a single lightweight dependency (typer). Actively maintained as of 2026-03-30 with recent commits; marked Production/Stable.

License in practice: GPLv3+ copyleft license requires that any modifications or derivative works be released under the same license. Suitable for internal tools and open-source projects; unsuitable for proprietary closed-source software.

Quickstart:

pip install pycrashreport
pycrashreport /path/to/crash.ips

Requires Python 3.9 or later; designed as a command-line tool via typer, not a library API.

Verify before relying:

- Whether the package supports parsing symbolicated crash reports or only non-symbolicated ones
- Performance characteristics on large or complex crash reports
- Whether kernel mode crash parsing includes full register and frame detail or only basic metadata

## Package facts

- License: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record) (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 317.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

apple crash report parser, ios crash dump analyzer, macos crash log parser, parse ips files, crash report formatter, crash-analysis, apple-debugging

[View on SkillFed](https://skillfed.io/packages/pycrashreport) · [View on PyPI](https://pypi.org/project/pycrashreport/)