Installation

How to install ipsw locally, and start a parsing IPSWs in no time.

macOS

Via homebrew

brew install blacktop/tap/ipsw --with-git-delta

info

--with-git-delta is optional and will install git-delta for better looking diffs.

Install frida version

brew install blacktop/tap/ipsw-frida

Via MacPorts

sudo port install ipsw

Install development version

git clone https://github.com/blacktop/ports ~/.config/macports/blacktop

Add the following to the sources.conf file:

sudo echo "file://$HOME/.config/macports/blacktop [default]" >> /opt/local/etc/macports/sources.conf
sudo port selfupdate

Then install ipsw:

sudo port install ipsw

Via binary from the releases page

wget https://github.com/blacktop/ipsw/releases/download/v3.1.199/ipsw_3.1.199_macOS_universal.tar.gz
tar xzf ipsw_3.1.199_macOS_universal.tar.gz

Extras Version

Want to use the ipsw dyld emu (w/ unicorn emulator) or the ipsw idev cmds that require libusb ? (grab the extras version from the releases page)

wget https://github.com/blacktop/ipsw/releases/download/v3.1.220/ipsw_3.1.221_macOS_arm64_extras.tar.gz
tar xzf ipsw_3.1.221_macOS_arm64_extras.tar.gz

info

The extras version is what is installed via homebrew by default.

Frida Version

Want to use the ipsw frida cmd to trace ObjC methods ? (grab the frida version from the releases page)

wget https://github.com/blacktop/ipsw/releases/download/v3.1.221/ipsw_3.1.221_macOS_arm64_frida.tar.gz
tar xzf ipsw_3.1.221_macOS_arm64_frida.tar.gz

caution

The extras and frida versions of ipsw only support macOS for now. (Please let the author know if you want them supported on your platform)

Linux

Via snapcraft

sudo snap install ipsw

Via deb/rpm/apk debian packages in the releases page

wget https://github.com/blacktop/ipsw/releases/download/v3.1.199/ipsw_3.1.199_linux_x86_64.deb
sudo dpkg -i ipsw_3.1.199_linux_x86_64.deb

Install archlinux package from AUR

pacman -U ipsw-bin

Install nix package from NUR

See github:blacktop/nur

Via binary from the releases page

wget https://github.com/blacktop/ipsw/releases/download/v3.1.199/ipsw_3.1.199_linux_x86_64.tar.gz
tar xzf ipsw_3.1.199_linux_x86_64.tar.gz

Docker

Download docker image

$ docker pull blacktop/ipsw

NOTE: the docker image also includes apfs-fuse which allows you to extract dyld_shared_caches from the APFS dmgs in the ipsw(s) pre iOS16.x

Create alias to use like a binary

$ alias ipsw='docker run -it --rm -v $(pwd):/data blacktop/ipsw'

Windows

Via scoop

scoop bucket add blacktop https://github.com/blacktop/scoop-bucket.git 
scoop install blacktop/ipsw

Via binary from the releases page

wget https://github.com/blacktop/ipsw/releases/download/v3.1.199/ipsw_3.1.199_windows_x86_64.tar.gz
tar xzf ipsw_3.1.199_windows_x86_64.tar.gz