Home

Awesome

Remote Debugging iOS Safari on Windows and Linux

Using this project you can debug your websites and web applications running in iOS Safari from a PC running Windows or Linux.

It provides a free and up-to-date alternative to the discontinued remotedebug-ios-webkit-adapter by RemoteDebug and is the spiritual successor to the abandoned webkit-webinspector by Arty Gus. It is a free and open source alternative to inspect.dev.

The setup scripts (generate.sh or generate.ps1) download the latest version of WebKit's built-in WebInspector and patch it to work with the WebSocket ios-webkit-debug-proxy provides and to be compatible with Chromium based browsers.

If you are looking for a more modern, self-contained tool built in Go, check out Hazel's ios-safari-remote-debug.

Requirements for running

Requirements for setup

Instructions

Setup

  1. Clone this repository to your PC
  2. On Windows, run generate.ps1. On Linux, run generate.sh.

This will result in the folder WebKit being created inside src. It contains the WebInspector files.

Running

  1. Plug your iOS device into your PC via USB
  2. On Windows, open iTunes and mark the iOS device as trusted (pop-up asks for confirmation the first time you connect a new device)
  3. On the iOS device, confirm that you trust the connection if asked
  4. Go to Settings->Safari->Advanced->Web Inspector and enable it
  5. Open the website you want to debug in Safari
  6. On Windows, run start.ps1. On Linux, run start.sh. Make sure your iOS device's screen is unlocked.
  7. The ios-webkit-debug-proxy will show your iOS device's name as connected.
  8. Then open the Chromium or WebKit based browser of your choice with the following URL: http://localhost:8080/Main.html?ws=localhost:9222/devtools/page/1
    • If you have mutliple pages open or extensions installed, refer to http://localhost:9222/ for the page number that is at the end of the URL
  9. You should be greeted with the WebInspector and can now debug to your heart's content.

Troubleshooting

Exiting

Windows

Linux

Known Issues

Notes

If you want to see details about how this was made, you can read a detailed explanation in HOW_IT_WORKS.md (note that this document only describes how the very first version of this tool was created and might not be completely up-to-date).

Attribution