IPSW-OTA-EXTRACT(1)

NAME
ipsw-ota-extract - Extract OTA payload files

SYNOPSIS
ipsw ota extract [FILENAME] [flags]

DESCRIPTION
Extract OTA payload files

OPTIONS
-y, --confirm[=false]
    Skip prompt and search payloadv2 files (requires --pattern or --dyld)

-c, --cryptex=""
    Extract cryptex as DMG (requires full OTA)

-x, --decomp[=false]
    Decompress pbzx files

-d, --dyld[=false]
    Extract dyld_shared_cache files

-a, --dyld-arch=[]
    dyld_shared_cache architecture(s) to extract (requires --dyld)

-f, --flat[=false]
    Do NOT preserve directory structure when extracting

-h, --help[=false]
    help for extract

-j, --json[=false]
    Output a single JSON dyld_shared_cache extraction report to stdout (requires --dyld)

-k, --kernel[=false]
    Extract kernelcache

-o, --output=""
    Output folder

-p, --pattern=""
    Regex pattern to match files

-r, --range=""
    Regex pattern to limit payloadv2 files searched (requires --pattern or --dyld)

OPTIONS INHERITED FROM PARENT COMMANDS
--color[=false]
    colorize output

--config=""
    config file (default is $HOME/.config/ipsw/config.yaml)

--insecure[=false]
    Allow insecure connections when fetching AEA keys

--key-db=""
    Path to AEA keys JSON database (auto-lookup by filename)

--key-val=""
    Base64 encoded AEA symmetric encryption key

--no-color[=false]
    disable colorize output

-V, --verbose[=false]
    verbose output

EXAMPLE
    # Extract the dyld_shared_cache files from an OTA
    ❯ ipsw ota extract OTA.zip --dyld --output ./out
    # Same, but non-interactive with a machine-readable report on stdout
    ❯ ipsw ota extract OTA.zip --dyld --json --output ./out > report.json
    # Extract only arm64e cache-family files
    ❯ ipsw ota extract OTA.zip --dyld --dyld-arch arm64e --output ./out
    # Extract the kernelcache, flattening the output directory structure
    ❯ ipsw ota extract OTA.zip --kernel --flat --output ./out
    # Extract every file matching a regex, limited to some payloadv2 members
    ❯ ipsw ota extract OTA.zip --pattern 'AppleH1[0-9]CameraInterface' --range 'payload.0[0-3]\d' --confirm

SEE ALSO
ipsw-ota(1)

HISTORY
5-Aug-2026 Auto generated by spf13/cobra