📱 App Network Debugger

5 phút đọc•/app-network-debugger

# 📱 App Network Debugger

**Real-time HTTP/HTTPS & Mobile Analytics Inspector for iOS & Android**

A lightweight, standalone desktop proxy and network debugging tool designed specifically for mobile developers. Capture, inspect, and analyze live HTTP/HTTPS traffic, WebSockets, and native binary analytics payloads (Firebase & Branch) in real-time.

[![Release](https://img.shields.io/badge/release-v0.1.9-blue.svg)](https://github.com/hdz1210/Debug-Mobile/releases)
[![Platform](https://img.shields.io/badge/platform-Windows%20x64-lightgrey.svg)](https://github.com/hdz1210/Debug-Mobile/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

</div>

---

## ✨ Key Features

| ⚡ **Smart Analytics Inspector** | 📱 **Zero-Config Mobile Proxy** |
| :--- | :--- |
| • **Firebase Native Protobuf Decoding**: Automatically parses binary analytics payloads into human-readable events. • **E-Commerce & Items Breakdown**: Inspect `view_item`, `add_to_cart`, `begin_checkout` with nested product items, SKU, price, and category. • **Hero Parameter Chips**: Key metadata (`Screen`, `Category`, `Location`, `Currency`, `Value`) spotlighted at a glance. • **Real-time Event Search**: Filter events instantly by name or parameter value. | • **Auto IP Detection**: Automatically finds your computer's local LAN IP for seamless mobile proxy configuration. • **1-Tap Certificate Setup**: Scan a local QR code on your phone or visit `http://mitm.it` to install the SSL certificate. • **Pause Mode**: Temporarily pause recording without disconnecting proxy forwarding, keeping your phone online. • **Persistent CA**: Reuses a private per-installation CA so you don't have to reinstall certs across app restarts. |

| 📦 **HAR 1.2 Export & Replay** | 🛡️ **Privacy & Local-First** |
| :--- | :--- |
| • **Standard HAR 1.2 Format**: Export selected or all captured flows into `.har` archives. • **Tool Interoperability**: Re-open exported archives in **Chrome DevTools**, **Postman**, or **Charles**. • **Session History**: Automatically persists captured sessions locally in SQLite to review past debugging sessions. • **Full Fidelity**: Preserves duplicate headers, query strings, Base64 payloads, timings, and WebSocket frames. | • **Automatic Redaction**: Mask passwords, bearer tokens, cookies, and sensitive headers before displaying or exporting. • **100% Local**: No captured packets or mobile analytics are ever transmitted to any third-party cloud servers. • **Standalone Desktop App**: Everything is bundled into a single desktop package—no separate Python or mitmproxy installations required. |

---

## 📸 Interface Showcase

### 🌐 Network Traffic & Headers Inspection
Inspect complete HTTP/HTTPS requests, status codes, query strings, headers, and timing in real time.

### ⚡ Native Firebase Analytics Decoding
Automatically unpacks binary Protobuf streams into color-coded event cards, hero parameter chips, and structured e-commerce items.

---

## 🔍 How It Works

1. **Proxy Capture**: Your mobile phone sends HTTP/HTTPS/WebSocket traffic through the local proxy server running on your computer.
2. **Real-time Inspection**: The desktop interface captures URLs, methods, headers, status codes, payload bodies, and timing in real time.
3. **Analytics Engine**: The built-in analyzer inspects binary Protobuf streams (Firebase Analytics / Google Analytics) and surfaces structured events into interactive cards.

---

> [!TIP]
> ### 💡 Pro-Tip: Real-time Firebase Analytics Debugging on Mobile
>
> By default, the Firebase Mobile SDK buffers events locally and flushes them in batches every 1 hour to save battery. To see events appear in real-time as you tap on the phone:
>
> - **Android**: Connect via USB and run:
> ```bash
> adb shell setprop debug.firebase.analytics.app <your.app.package.id>
> ```
> - **iOS**: Pass `-FIRDebugEnabled` in Xcode launch arguments.
> - **Quick Flush**: Simply swipe the app to the Background (Home screen); Firebase SDK will immediately flush its queued events to the desktop debugger!

---

## 🚀 5-Step Quick Start

1. **Connect to Same Wi-Fi**: Ensure your mobile device and computer are on the same Wi-Fi network.
2. **Start Capture**: Open App Network Debugger, choose **LAN devices**, and click **Start capture**.
3. **Set Mobile Proxy**: In your phone's Wi-Fi settings, set **Proxy** to **Manual**. Enter the **Host / IP** and **Port** (`8080`) shown on the desktop app.
4. **Install Certificate**: Click **Certificate** on desktop and scan the QR code (or open `http://mitm.it` in mobile Safari) to install the CA certificate.
   - **Step 4a (Install Profile)**: Open **Settings → VPN & Device Management** (or *Profile Downloaded*) → select **mitmproxy** → tap **Install**.
   - **Step 4b (Enable Full Trust)**: Open **Settings → General → About → Certificate Trust Settings** → toggle **Enable Full Trust for Root Certificates** for **mitmproxy**.
5. **Inspect Live Traffic**: Open the mobile app you want to test and watch requests and analytics stream in!

---

> [!NOTE]
> Some applications ignore system proxies or implement SSL certificate pinning. This debugger is designed for authorized testing of your own applications and development builds.

---

## 📥 Download & Installation

### Windows (x64)

> [!NOTE]
> **Windows SmartScreen Prompt**: The installer is an open-source tool and is not yet code-signed with a paid Microsoft certificate. On first launch, if Windows SmartScreen appears, click **More info** → **Run anyway** to start.

---

## 📄 License

MIT © [hdz1210](https://github.com/hdz1210)

Live Preview•🟡 Bản nháp

📱 App Network Debugger

Real-time HTTP/HTTPS & Mobile Analytics Inspector for iOS & Android A lightweight, standalone desktop proxy and network debugging tool designed specifically for...

📱 App Network Debugger

Real-time HTTP/HTTPS & Mobile Analytics Inspector for iOS & Android

✨ Key Features

⚡ Smart Analytics Inspector 📱 Zero-Config Mobile Proxy

• Firebase Native Protobuf Decoding: Automatically parses binary analytics payloads into human-readable events.
• E-Commerce & Items Breakdown: Inspect view_item, add_to_cart, begin_checkout with nested product items, SKU, price, and category.
• Hero Parameter Chips: Key metadata (Screen, Category, Location, Currency, Value) spotlighted at a glance.
• Real-time Event Search: Filter events instantly by name or parameter value. • Auto IP Detection: Automatically finds your computer's local LAN IP for seamless mobile proxy configuration.
• 1-Tap Certificate Setup: Scan a local QR code on your phone or visit http://mitm.it to install the SSL certificate.
• Pause Mode: Temporarily pause recording without disconnecting proxy forwarding, keeping your phone online.
• Persistent CA: Reuses a private per-installation CA so you don't have to reinstall certs across app restarts.

⚡ Smart Analytics Inspector	📱 Zero-Config Mobile Proxy
• Firebase Native Protobuf Decoding: Automatically parses binary analytics payloads into human-readable events. • E-Commerce & Items Breakdown: Inspect `view_item`, `add_to_cart`, `begin_checkout` with nested product items, SKU, price, and category. • Hero Parameter Chips: Key metadata (`Screen`, `Category`, `Location`, `Currency`, `Value`) spotlighted at a glance. • Real-time Event Search: Filter events instantly by name or parameter value.	• Auto IP Detection: Automatically finds your computer's local LAN IP for seamless mobile proxy configuration. • 1-Tap Certificate Setup: Scan a local QR code on your phone or visit `http://mitm.it` to install the SSL certificate. • Pause Mode: Temporarily pause recording without disconnecting proxy forwarding, keeping your phone online. • Persistent CA: Reuses a private per-installation CA so you don't have to reinstall certs across app restarts.

📦 HAR 1.2 Export & Replay 🛡️ Privacy & Local-First

• Standard HAR 1.2 Format: Export selected or all captured flows into .har archives.
• Tool Interoperability: Re-open exported archives in Chrome DevTools, Postman, or Charles.
• Session History: Automatically persists captured sessions locally in SQLite to review past debugging sessions.
• Full Fidelity: Preserves duplicate headers, query strings, Base64 payloads, timings, and WebSocket frames. • Automatic Redaction: Mask passwords, bearer tokens, cookies, and sensitive headers before displaying or exporting.
• 100% Local: No captured packets or mobile analytics are ever transmitted to any third-party cloud servers.
• Standalone Desktop App: Everything is bundled into a single desktop package—no separate Python or mitmproxy installations required.

📦 HAR 1.2 Export & Replay	🛡️ Privacy & Local-First
• Standard HAR 1.2 Format: Export selected or all captured flows into `.har` archives. • Tool Interoperability: Re-open exported archives in Chrome DevTools, Postman, or Charles. • Session History: Automatically persists captured sessions locally in SQLite to review past debugging sessions. • Full Fidelity: Preserves duplicate headers, query strings, Base64 payloads, timings, and WebSocket frames.	• Automatic Redaction: Mask passwords, bearer tokens, cookies, and sensitive headers before displaying or exporting. • 100% Local: No captured packets or mobile analytics are ever transmitted to any third-party cloud servers. • Standalone Desktop App: Everything is bundled into a single desktop package—no separate Python or mitmproxy installations required.

📸 Interface Showcase

🌐 Network Traffic & Headers Inspection

Inspect complete HTTP/HTTPS requests, status codes, query strings, headers, and timing in real time.

Inspect HTTP/HTTPS request headers and payloads

⚡ Native Firebase Analytics Decoding

Automatically unpacks binary Protobuf streams into color-coded event cards, hero parameter chips, and structured e-commerce items.

Firebase Analytics Protobuf decoding with event cards and items breakdown

🔍 How It Works

Traffic flows from the mobile device through App Network Debugger to the API server

Proxy Capture: Your mobile phone sends HTTP/HTTPS/WebSocket traffic through the local proxy server running on your computer.
Real-time Inspection: The desktop interface captures URLs, methods, headers, status codes, payload bodies, and timing in real time.
Analytics Engine: The built-in analyzer inspects binary Protobuf streams (Firebase Analytics / Google Analytics) and surfaces structured events into interactive cards.

[!TIP]

💡 Pro-Tip: Real-time Firebase Analytics Debugging on Mobile

By default, the Firebase Mobile SDK buffers events locally and flushes them in batches every 1 hour to save battery. To see events appear in real-time as you tap on the phone:

Android: Connect via USB and run:

bash
adb shell setprop debug.firebase.analytics.app <your.app.package.id>

iOS: Pass -FIRDebugEnabled in Xcode launch arguments.
Quick Flush: Simply swipe the app to the Background (Home screen); Firebase SDK will immediately flush its queued events to the desktop debugger!

🚀 5-Step Quick Start

Five-step onboarding: same Wi-Fi, start capture, set proxy, install certificate, inspect requests

Connect to Same Wi-Fi: Ensure your mobile device and computer are on the same Wi-Fi network.
Start Capture: Open App Network Debugger, choose LAN devices, and click Start capture.
Set Mobile Proxy: In your phone's Wi-Fi settings, set Proxy to Manual. Enter the Host / IP and Port (8080) shown on the desktop app.
Install Certificate: Click Certificate on desktop and scan the QR code (or open http://mitm.it in mobile Safari) to install the CA certificate.
- Step 4a (Install Profile): Open Settings → VPN & Device Management (or Profile Downloaded) → select mitmproxy → tap Install.
- Step 4b (Enable Full Trust): Open Settings → General → About → Certificate Trust Settings → toggle Enable Full Trust for Root Certificates for mitmproxy.
Inspect Live Traffic: Open the mobile app you want to test and watch requests and analytics stream in!

[!NOTE] Some applications ignore system proxies or implement SSL certificate pinning. This debugger is designed for authorized testing of your own applications and development builds.

📥 Download & Installation

Windows (x64)

File	Type	Link
Setup Installer (Recommended)	`.exe`	Download App-Network-Debugger_0.1.9_windows-x64-setup.exe
Enterprise MSI Package	`.msi`	Download App-Network-Debugger_0.1.9_windows-x64.msi
Checksum Verification	`.txt`	Verify SHA256SUMS.txt
All Releases	GitHub	View GitHub Releases Page

[!NOTE] Windows SmartScreen Prompt: The installer is an open-source tool and is not yet code-signed with a paid Microsoft certificate. On first launch, if Windows SmartScreen appears, click More info → Run anyway to start.