google/ios-webkit-debug-proxy
Ios Webkit Debug Proxy
ios-webkit-debug-proxy is a command-line proxy that bridges Chrome DevTools to Safari Web Inspector on iOS devices, enabling remote debugging of web content over USB. It translates WebKit remote debugging protocol messages into Chrome DevTools Protocol over persistent WebSocket connections, allowing developers to use Chrome DevTools, Safari Web Inspector, or Firefox DevTools to inspect and debug web content in MobileSafari and UIWebViews on real and simulated iOS devices.
The proxy discovers and communicates with iOS devices over USB using the libimobiledevice library without requiring iTunes. It handles multiple iOS devices simultaneously by assigning each connected device a stable TCP port number that persists across reconnections until the proxy restarts. A JSON API and web interface at a configurable port enumerates all attached iOS devices and their debuggable browser tabs, enabling programmatic querying and inspection.
The proxy accepts runtime configuration through command-line flags, including the ability to specify a custom DevTools frontend source from a local or remote URL. It serves a RESTful JSON endpoint listing connected devices and their debuggable web views, and opens a DevTools frontend for any specific tab by navigating to its page listing or connecting via WebSocket.
Features
- WebKit to Chrome Protocol Bridges - Translates WebKit remote debugging protocol messages into Chrome DevTools Protocol over persistent WebSocket connections.
- iOS WebView Debugging Bridges - A command-line proxy that bridges Chrome DevTools to Safari Web Inspector on iOS devices for remote debugging over USB.
- Browser DevTools Inspections - Open a DevTools frontend for a specific tab on a connected iOS device by navigating to its page listing or connecting via websocket.
- iOS Safari Web Inspectors - Accessing and controlling Safari's web inspector on iOS devices through a proxy that translates WebKit commands.
- Device Debugging Endpoints - Serves a RESTful JSON endpoint listing connected devices and their debuggable web views for programmatic discovery.
- iOS - Serves a RESTful JSON endpoint listing connected devices and their debuggable web views for programmatic querying.
- Device Port Mappings - Maintains a persistent in-memory mapping from device identifiers to fixed TCP ports across reconnections.
- iOS Device Discovery - Discovers and communicates with iOS devices over USB using the libimobiledevice library without requiring iTunes.
- iOS USB Communication - Uses the libimobiledevice library to discover, connect to, and communicate with iOS devices over USB without iTunes.
- iOS USB Transport - Discovers and communicates with iOS devices over USB using the libimobiledevice library without iTunes dependency.
- Stable Device-Port Assignments - Assign a unique port to each attached iOS device on a first-come-first-served basis, preserving assignments across reconnections.
- iOS - Managing simultaneous debugging sessions across multiple iOS devices with stable port assignments that persist across reconnections.
- iOS WebView Tab Inspectors - Open a DevTools frontend for any debuggable tab on a connected iOS device to inspect and debug its content.
- Remote Web Inspector Proxies - Debugging web content on iOS Safari and UIWebViews from a desktop browser using Chrome DevTools or other Web Inspector frontends.
- Web Content Debugging - Proxy WebKit inspector commands over a websocket connection to MobileSafari and UIWebViews on real and simulated iOS devices.
- Protocol Translation Bridges - Translates WebKit remote debugging protocol messages into Chrome DevTools Protocol over persistent WebSocket connections.
- Stable Device Port Assignments - A proxy that assigns stable TCP ports to each connected iOS device and exposes a JSON API for listing debuggable tabs.
- Debuggable Tab Enumerators - Provide a JSON API and a web interface at localhost:9221 that enumerates all attached iOS devices and their debuggable tabs.
- Debuggable Tab Enumerators - Listing all attached iOS devices and their debuggable browser tabs through a JSON API at a configurable port.
- Custom Frontend Sources - Accept a custom URL or local path for the DevTools UI to use Chrome DevTools, Safari Web Inspector, or Firefox DevTools.
- Custom Frontend Sources - Specify a custom DevTools UI source through a command-line argument, choosing local or remote inspector HTML files.
- First-Come-First-Served Port Allocations - Allocate a unique port per attached iOS device on a first-come-first-served basis, preserving assignments across reconnections.
- Fixed Device Port Assignments - Assign each connected iOS device a fixed port number and keep that mapping stable across reconnections until the proxy restarts.
- Debuggable Tab Queries - Query devices programmatically through JSON APIs and websocket endpoints to list devices, enumerate tabs, and inspect pages from custom clients.
- iOS and macOS Utilities - DevTools proxy for iOS Safari remote inspection.
- Legacy Projects - Exposes iOS web views via the protocol.
