# wuchangming/spy-debugger

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/wuchangming-spy-debugger).**

7,620 stars · 831 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/wuchangming/spy-debugger
- awesome-repositories: https://awesome-repositories.com/repository/wuchangming-spy-debugger.md

## Topics

`debug` `spy-debugger` `wechat` `weinre`

## Description

spy-debugger is an HTTP proxy debugging tool designed for intercepting and analyzing network traffic from mobile devices, WebViews, and mobile browsers. It functions as a network packet capture tool and a remote browser inspector, allowing users to monitor HTTP and HTTPS requests wirelessly without the need for USB cables.

The project distinguishes itself by using script injection to enable remote debugging. It injects JavaScript into HTTP response bodies, providing the ability to inspect HTML and CSS elements and perform live page content editing directly on the mobile screen. Additionally, it includes a workflow to bypass SSL pinning by selectively filtering WebView traffic from native application traffic.

The tool covers broader capabilities in traffic management and UI inspection. It can route intercepted network traffic to external proxy tools for deep packet inspection and provides configuration settings to manage HTTP caching and request interception for mobile browser compatibility.

## Tags

### Networking & Communication

- [HTTP Proxies](https://awesome-repositories.com/f/networking-communication/http-proxies.md) — Acts as an HTTP proxy to intercept and analyze network traffic from mobile devices and WebViews.
- [Packet Capture Utilities](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/packet-capture-utilities.md) — Provides utilities to capture and analyze HTTP and HTTPS network traffic from mobile devices and WebViews. ([source](https://github.com/wuchangming/spy-debugger#readme))
- [Traffic Interception](https://awesome-repositories.com/f/networking-communication/traffic-interception.md) — Intercepts network traffic by acting as a middleman between mobile devices and remote servers.
- [SSL Pinning Bypasses](https://awesome-repositories.com/f/networking-communication/cross-origin-networking/webview-cross-origin-bypasses/ssl-pinning-bypasses.md) — Isolates WebView traffic from native app traffic to capture HTTPS data without triggering SSL pinning blocks.
- [Traffic Proxying](https://awesome-repositories.com/f/networking-communication/traffic-proxying.md) — Routes intercepted mobile network traffic to external proxy tools for advanced deep packet inspection. ([source](https://github.com/wuchangming/spy-debugger/blob/master/README_EN.md))
- [HTTP Proxy Forwarders](https://awesome-repositories.com/f/networking-communication/traffic-tunneling/http-tunneled-socks-proxies/http-proxy-forwarders.md) — Forwards intercepted HTTP and HTTPS connections to secondary proxy tools for deep packet inspection.

### Part of an Awesome List

- [HTTP Traffic Analysis](https://awesome-repositories.com/f/awesome-lists/data/http-traffic-analysis.md) — Intercepts and analyzes HTTP and HTTPS network requests from mobile devices to debug API calls.
- [Packet Capture Tools](https://awesome-repositories.com/f/awesome-lists/devtools/packet-capture-tools.md) — Captures mobile web traffic and routes it to external tools for detailed packet analysis.

### Development Tools & Productivity

- [Remote Debugging](https://awesome-repositories.com/f/development-tools-productivity/application-debugging/remote-debugging.md) — Connects to and inspects mobile browser pages and WebViews via a remote network connection. ([source](https://github.com/wuchangming/spy-debugger/blob/master/README.md))
- [Remote Browser Inspectors](https://awesome-repositories.com/f/development-tools-productivity/remote-browser-inspectors.md) — Provides a wireless interface to analyze layout and behavior of websites on mobile devices in real time.
- [Remote Debugger Connectivity](https://awesome-repositories.com/f/development-tools-productivity/remote-debugger-connectivity.md) — Establishes wireless network connections to enable remote debugging without physical USB cables.
- [Mobile Web Debugging Suites](https://awesome-repositories.com/f/development-tools-productivity/web-development-utilities/mobile-web-debugging-suites.md) — Troubleshoots and profiles web applications in mobile browsers by injecting debugging scripts. ([source](https://github.com/wuchangming/spy-debugger#readme))

### Mobile Development

- [WebView DevTools Access](https://awesome-repositories.com/f/mobile-development/hybrid-app-debugging-workflows/webview-devtools-access.md) — Enables runtime inspection and styling of HTML pages inside mobile WebViews via network-based devtools.
- [Mobile Application Debugging](https://awesome-repositories.com/f/mobile-development/mobile-application-debugging.md) — Provides a remote utility for inspecting UI hierarchies and network traffic in mobile WebViews.
- [Live UI Editing](https://awesome-repositories.com/f/mobile-development/mobile-capabilities/mobile-presentation-editing/live-ui-editing.md) — Allows real-time modification of visual elements directly on a mobile screen to test design changes.

### Web Development

- [Response Interception Injections](https://awesome-repositories.com/f/web-development/custom-page-frameworks/page-content-injections/script-injections/response-interception-injections.md) — Injects JavaScript into HTTP response bodies to enable DOM inspection and editing on remote pages.
- [Dynamic DOM Manipulation](https://awesome-repositories.com/f/web-development/dynamic-dom-manipulation.md) — Provides tools for modifying DOM elements in real-time to adjust visual layouts on mobile pages.

### Content Management & Publishing

- [Live Front-End Editing](https://awesome-repositories.com/f/content-management-publishing/authoring-editorial-interfaces/content-authoring-editing/live-front-end-editing.md) — Enables real-time modification of visual elements by making the page body content editable. ([source](https://github.com/wuchangming/spy-debugger#readme))

### Security & Cryptography

- [Certificate Pinning Bypasses](https://awesome-repositories.com/f/security-cryptography/certificate-pinning-bypasses.md) — Implements workflows to disable strict certificate validation, allowing the capture of HTTPS traffic.

### System Administration & Monitoring

- [WebView Traffic Isolation](https://awesome-repositories.com/f/system-administration-monitoring/traffic-filtering/webview-traffic-isolation.md) — Isolates WebView-originated HTTPS traffic from native app traffic to bypass SSL pinning during packet capture. ([source](https://github.com/wuchangming/spy-debugger/blob/master/README.md))