---
id: mozcrash
version: "2.2.1"
license: MPL
license_treatment: copyleft
maintenance: dormant
---

# mozcrash — Library for printing stack traces from minidumps left behind by crashed processes

License: copyleft · Maintenance: dormant · Downloads: 231.9K/mo

## What it is and what it does

mozcrash is a utility library for parsing and displaying stack traces extracted from minidump files—binary crash dumps left by processes that have crashed. It is part of Mozilla's mozbase suite and is primarily used in Firefox automated testing and crash reporting workflows to convert raw minidump data into human-readable stack traces.

The package depends on mozfile and mozlog for file handling and logging. It is a thin wrapper around Mozilla's stackwalk tool and is designed for developers and test infrastructure that need to analyze crash data from Firefox or other Mozilla projects. The library has been stable since 2012 but is currently dormant, meaning new features or bug fixes are unlikely without community contribution.

Use it for:

- Analyze Firefox crash dumps in automated test suites to extract stack traces for debugging.
- Parse minidump files from CI/CD pipelines to identify which code paths led to process crashes.
- Generate human-readable crash reports from binary minidump data in Mozilla testing infrastructure.
- Debug intermittent crashes in Firefox or other Mozilla applications by extracting symbolic stack traces.

## Worth the install?

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

Extracts and formats stack traces from minidump files generated by crashed processes, primarily for Firefox and Mozilla testing workflows.

Yes, if you are working with Mozilla Firefox crash data or testing infrastructure that relies on minidump analysis. The low install friction and lack of known vulnerabilities make it safe to add. However, the dormant maintenance status means you should verify that it works with your Python version and that the underlying stackwalk binary is available in your environment before relying on it for production crash analysis.

## Install

pip install mozcrash
uv add mozcrash
poetry add mozcrash

## Installing mozcrash

Before you install: Low install friction with a pure-Python wheel. The package is dormant (606 days since last release) but remains in use; maintenance status suggests it may not receive updates for new issues, though it has been stable since its 2012 inception.

License in practice: Licensed under MPL (copyleft), which requires derivative works to disclose source and license under the same terms; acceptable for most internal and open-source use but may constrain proprietary redistribution.

Quickstart:

pip install mozcrash

from mozcrash import stackwalk
stacktrace = stackwalk.get_stack_trace(minidump_path)

Requires a minidump file as input; the stackwalk module's exact API and availability of the underlying stackwalk binary depend on your Mozilla build environment.

Verify before relying:

- Whether the package works with Python versions beyond 2.7 and 3.5 (classifiers are dated; requires_python is unspecified).
- Current state of the stackwalk binary dependency and whether it is bundled or must be sourced separately.
- Whether the package is actively maintained by Mozilla or considered legacy for historical Firefox crash analysis only.

## Package facts

- License: MPL (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 231.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

minidump stack trace parser, crash dump analysis, mozilla crash reporting, process crash debugging, minidump extraction tool, crash-analysis, mozilla-tools, testing-infrastructure

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