Skip to content

Instantly share code, notes, and snippets.

@fawkesley
Last active March 6, 2024 11:56
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save fawkesley/15286cf43263427f406f3d7a2f907a07 to your computer and use it in GitHub Desktop.
Save fawkesley/15286cf43263427f406f3d7a2f907a07 to your computer and use it in GitHub Desktop.

Install system dependencies

sudo apt-get install autoconf automake libusb-dev libusb-1.0-0-dev libtool libssl-dev

Download source dependencies

mkdir -p ~/Downloads/ios-safari-remote-debug-kit
cd ~/Downloads/ios-safari-remote-debug-kit


git clone https://github.com/libimobiledevice/libplist
git clone https://github.com/libimobiledevice/libimobiledevice-glue
git clone https://github.com/libimobiledevice/libusbmuxd
git clone https://github.com/libimobiledevice/libimobiledevice
git clone https://github.com/libimobiledevice/usbmuxd

git clone https://github.com/google/ios-webkit-debug-proxy.git

Compile & install dependencies into /opt/ios-safari-remote-debug-kit

export PKG_CONFIG_PATH=/opt/ios-safari-remote-debug-kit/lib/pkgconfig

cd ~/Downloads/ios-safari-remote-debug-kit/libplist
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit && make && sudo make install

cd ~/Downloads/ios-safari-remote-debug-kit/libimobiledevice-glue
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit && make && sudo make install

cd ~/Downloads/ios-safari-remote-debug-kit/libusbmuxd
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit && make && sudo make install

cd ~/Downloads/ios-safari-remote-debug-kit/libimobiledevice
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit && make && sudo make install

cd ~/Downloads/ios-safari-remote-debug-kit/usbmuxd
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit && make && sudo make install

cd ~/Downloads/ios-safari-remote-debug-kit/ios-webkit-debug-proxy
./autogen.sh --prefix=/opt/ios-safari-remote-debug-kit

Test that iOS devices are recognised

Plug in an iPhone, it should appear in Pop OS desktop.

Download & configure ios-safari-remote-debug-kit

cd $HOME/repo/

git clone https://github.com/HimbeersaftLP/ios-safari-remote-debug-kit

Read the docs - set up iPhone

https://github.com/HimbeersaftLP/ios-safari-remote-debug-kit

Then, probably:

cd ios-safari-remote-debug-kit/src/
./generate.sh

# when promted for iOS version I chose 16.4 (phone has 16.7)

Modify ~/.bashrc

Add these lines:

alias ,iosdebug='$HOME/repo/ios-safari-remote-debug-kit/src/start.sh'
export PATH=${PATH}:/opt/ios-safari-remote-debug-kit/bin

Run debugger

,iosdebug

It should show a URL. Open it with chromium.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment