ipsw
iOS/macOS Research Swiss Army Knife
## What is `ipsw` 🤔 - IPSW downloader/exploder - OTA downloader/exploder - macho parser - ObjC class-dump - Swift class-dump 🚧 - dyld_shared_cache parser - kernelcache parser - img4 parser/decrypter - device-tree parser - ARM v9-a disassember - research tool ## Install ### macOS ```bash brew install blacktop/tap/ipsw ``` ### Linux ```bash sudo snap install ipsw ``` ### Windows ```bash scoop bucket add blacktop https://github.com/blacktop/scoop-bucket.git scoop install blacktop/ipsw ``` ## Getting Started ``` ❯ ipsw Download and Parse IPSWs (and SO much more) Usage: ipsw [command] Available Commands: appstore Interact with the App Store Connect API class-dump ObjC class-dump a dylib from a DSC or MachO device-list List all iOS devices diff Diff IPSWs download Download Apple Firmware files (and more) dtree Parse DeviceTree dyld Parse dyld_shared_cache ent Search IPSW filesystem DMG or Folder for MachOs with a given entitlement extract Extract kernelcache, dyld_shared_cache or DeviceTree from IPSW/OTA help Help about any command iboot Dump firmwares idev USB connected device commands img4 Parse Img4 info Display IPSW/OTA Info kernel Parse kernelcache macho Parse MachO mdevs List all MobileDevices in IPSW mount Mount DMG from IPSW ota Parse OTAs plist Dump plist as JSON pongo PongoOS Terminal sepfw Dump MachOs ssh SSH into a jailbroken device swift-dump 🚧 Swift class-dump a dylib from a DSC or MachO symbolicate Symbolicate ARM 64-bit crash logs (similar to Apple's symbolicatecrash) update Download an ipsw update if one exists version Print the version number of ipsw watch Watch Github Commits Flags: --color colorize output --config string config file (default is $HOME/.config/ipsw/config.yaml) -h, --help help for ipsw --no-color disable colorize output -V, --verbose verbose output Use "ipsw [command] --help" for more information about a command. ``` ## Documentation - [https://blacktop.github.io/ipsw](https://blacktop.github.io/ipsw) ```mermaid graph TD A[Download] --> B[Extract] B --> C[Parse] C --> D[Dump] D --> E[Search] E --> F[Symbolicate] ``` ## `ipsw` Diffs A collection of `ipsw` diffs can be found here: -