Skip to content
HTTPGlass Docs

HTTPGlass documentation

HTTPGlass is an HTTP and HTTPS debugging proxy for macOS, and for iPhone and iPad. 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

Section titled “Start here”

Using HTTPGlass on an iPhone or iPad? Go to the iPhone & iPad 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.

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

iPhone and iPad

Section titled “iPhone and iPad”

Reading traffic

Section titled “Reading traffic”

Changing traffic

Section titled “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

Stuck on something specific

Section titled “Stuck on something specific”