---
id: ipsw-parser
version: "1.7.3"
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
---

# ipsw-parser — python3 utility for parsing and extracting data from IPSW

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

## What it is and what it does

ipsw-parser is a command-line and Python library tool for reading and extracting data from iOS IPSW (iPhone Software) firmware files. It exposes commands to parse basic metadata from an IPSW archive, extract its contents into a filesystem layout, and decode embedded resources like sandbox profiles from the kernelcache. The tool is built on construct for binary parsing, coloredlogs for output formatting, typer for CLI scaffolding, and pyimg4 for IMG4 container handling.

The package is designed for developers and security researchers who need to inspect iOS firmware structure, extract device support files, or analyze firmware components programmatically. It can optionally integrate with the blacktop/ipsw tool for enhanced DSC (Dyld Shared Cache) extraction. Dependencies include requests for remote operations and remotezip2 for efficient remote archive access.

Use it for:

- Extract device support directories from IPSW files for iOS development or testing environments.
- Parse firmware metadata and analyze iOS firmware structure for security research or reverse engineering.
- Decode sandbox profiles embedded in the kernelcache to understand iOS security policies.
- Automate firmware extraction workflows in CI/CD pipelines for iOS tooling or testing.
- Access firmware components remotely without downloading entire IPSW files using remotezip2 integration.

## Worth the install?

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

Parses and extracts data from iOS IPSW firmware files, providing command-line tools to read metadata, extract filesystem contents, and decode embedded resources.

Yes, if you need to work with iOS IPSW firmware files. The package is actively maintained, has no known vulnerabilities, supports current Python versions, and installs cleanly. The GPLv3+ license is a hard constraint only if you plan to distribute proprietary software; for internal tools, research, or open-source projects it poses no barrier.

## Install

pip install ipsw-parser
uv add ipsw-parser
poetry add ipsw-parser

## Installing ipsw-parser

Before you install: Low install friction with a pure-Python wheel and active maintenance. Last release was 60 days ago; repository is not archived and has recent commits.

License in practice: GPLv3+ copyleft license requires that any derivative work or distribution must also be licensed under GPLv3 or later. Suitable for internal tools and open-source projects, but not for proprietary software without source disclosure.

Quickstart:

pip install ipsw-parser

from ipsw_parser import IPSWParser
parser = IPSWParser('path/to/firmware.ipsw')
info = parser.info()

Requires Python 3.9 or later; IPSW file path must be accessible on the local filesystem.

Verify before relying:

- Whether the package requires the optional blacktop/ipsw tool for full DSC extraction functionality, or if that is purely additive.
- Performance characteristics when parsing large IPSW files or handling concurrent extraction operations.
- Exact Python version support boundaries (requires >=3.9 but classifiers list through 3.14).

## 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: 324.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ipsw parser, ios firmware extraction, ipsw file reader, ios firmware analysis, ipsw cli tool, firmware parsing python, ios device support, ios-firmware, binary-parsing, cli-tool

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