HTTPGlass documentation

HTTPGlass is an HTTP and HTTPS debugging proxy for macOS, iPhone, iPad and Android. It shows the requests your Mac’s apps and command-line tools make, decrypts HTTPS so you can read it, and names the app behind every request. This section covers installing it, the one-time certificate step, how it changes and restores your network settings, and the tools that change traffic: rules, breakpoints, Map Local, Map Remote, Rewrite, scripting, and throttling.

Start here

Using HTTPGlass on an iPhone or iPad? Go to the iPhone & iPad guide first. On Android? Go to the Android guide first. The rest of the docs describe the Mac app, and the tools (rules, breakpoints, Map Local and the others) work the same way on iOS and Android, with the certificate step done differently on each.

What is HTTPGlass — the short version of how it works
Install — download the app and run the Setup Assistant
How capture works — what HTTPGlass changes on your Mac, and how it puts it back
Root certificate — the one-time trust step HTTPS decryption needs
First capture — pick the app you’re debugging and watch its requests come in

iPhone and iPad

Install — the App Store download and the first-launch permissions
The VPN profile — why iOS needs one, and how to remove it
Root certificate — trust HTTPGlass CA so HTTPS can be decrypted
First capture · App Lock · Free vs Pro

Android

Install — the Google Play download and the first-launch permissions
The VPN service — why Android needs one, and how to remove it
Root certificate — install it by hand in Settings, and which apps it actually decrypts
First capture · Battery and background · Free vs Pro

Reading traffic

Pick the app you’re debugging — decrypt one app on every host it talks to
Inspecting traffic — the table, filters, search, and the inspector
Command-line tools and other trust stores — curl, Node, Python, Java, Firefox

Changing traffic

Rule syntax — the one pattern syntax every list shares
Breakpoints — pause one message and edit it by hand
Map Local — answer a request without asking the server
Map Remote — point a request at a different server
Rewrite — automatic header, body, status, and query edits
Scripting — onRequest / onResponse in JavaScript
Network Condition — throttle to 3G, GPRS, or your own numbers