Skip to content
HTTPGlass Docs

Your first capture

With the certificate trusted, you’re one click from reading traffic.

Pick the app

Section titled “Pick the app”

A new window asks What are you debugging? and shows a grid of apps: the ones already making requests, and the others that are running. Click the app you’re working on. HTTPGlass starts capturing if it isn’t already, decrypts everything that app sends, and shows only its traffic. Use the app, and its requests appear as they happen.

If you’d rather see everything, click Capture Everything Instead.

More on this, including what Free and Pro allow, on Pick the app you’re debugging.

The window

Section titled “The window”
  • Sidebar — All Traffic, then each app that has made requests, Sessions, the rule editors, Certificate, and each domain at the bottom. A number next to an app or domain is its request count; an orange number on a domain counts its errors.
  • Traffic table — one row per request: app, status, method, host, path, protocol, type, size, and time. Right-click a column header to show, hide, or reorder columns.
  • Inspector — select a row to see the request and the response side by side. It sits to the right of the table or under it; switch with View → Toggle Inspector Position (⌥⌘I).

The toolbar holds Start / Stop, the capture status, the app you’re debugging, and Clear (⌘K).

Details on Inspecting traffic.

Reading a row

Section titled “Reading a row”

The Status column shows the HTTP status code, colour-coded, or a word when there isn’t one:

Status Meaning
Encrypted HTTPS that HTTPGlass passed through without reading — the app and host aren’t being decrypted
Untrusted The app refused HTTPGlass’s certificate because your Mac doesn’t trust the root yet
Pinned The app refused HTTPGlass’s certificate even though the root is trusted
Blocked Stopped by your Block List
Paused Held on a breakpoint
Failed The request ended without a response; hover for why

Select an Encrypted, Untrusted, or Pinned row and the inspector explains what happened and offers the fix — usually one button.

Less noise by default

Section titled “Less noise by default”

A Mac is never quiet. All Traffic hides two kinds of rows at first: HTTPS connections that weren’t decrypted (only a host name to show), and macOS background services such as iCloud, Spotlight, and software update. The filter button at the right of the filter bar shows how many rows are hidden, and switches either kind back on.

If nothing shows up

Section titled “If nothing shows up”