This tutorial is going to demonstrate how we can quickly capture the HTTPS Response and identify the bugs 🐞 on macOS, iPhone and iOS Simulator with Proxyman.

We hope Proxyman can boost your debugging productivity 👏.

1. Download Proxyman

First of all, we could download the latest Proxyman at https://proxyman.io or update directly from your current version by navigating to “Proxyman -> Check for Update…”

2. Proxyman dashboard

Proxyman is designed by the way. There are three essential parts.

  • Source List (Left Panel) is where all apps and domains are listed.
  • Flow List (Middle Panel): All flows from the selected Source.
  • Flow Content (Right Panel) is where you can see all Request/Response content.

As soon as you start the Proxyman, Proxyman will

  • Automatically override the Wifi Proxy in Network Preference. It’s super convenience for you 👏. However, you can opt-out by navigating to Proxyman -> Preference… -> Uncheck the “Auto override the Proxy Config”
  • Proxying all out-going requests from your mac, iPhone and iOS Simulators.

3. Search and Pin your app/domain

You could quickly search your app / domains by using “Ctrl+Shift+F” then selecting the “Pin” in the right menu.

Search and Pin your app/domain by Ctrl+Shift+F

We choose Product Hunt as the best example to demonstrate.

Distraction-free is a integral feature of Proxyman since all other domains are entirely ignored. You won’t get lost by the flooding of additional requests. That’s cool 👏

4. HTTPS Request & Response

We can quickly start viewing the HTTPS Response by

  1. Select your desired domains or app

  2. Select Enable SSL on Right-Panel

By enabling SSL for particular apps or domains, Proxyman doesn’t significantly affect the Internet Connections. Therefore, the speed connection is still maintained over 80%, and all SSL-Pining domains are still alive. This is great because we don’t want your Google Analytic or Dropbox’s connections are completely dropped during debugging with Proxyman ⚡️

5. Proxyman Certificate

We understand that this process is so complicated ❌ in other tools, so we dedicated re-design in order to simplify it. There are two options to do it.

  • Automatic: It’s the useful approach for installing and trusting the Proxyman Certificate.
  • Manual: You can install and trust manually. It’s your choice if you’re a super-user 👍

Install Proxyman Certificate panel

6. HTTPS Request and Response

After installing the Proxyman Certificate, it’s a perfect time to debug 😋. Proxyman is now capable of intercepting the HTTPS request & response and automatically display in pretty-JSON viewers.

From Flow-Content panel (Right-Panel), you can navigate too

  • Header, Query, Cookies and JSON response

All content viewers are built-in with a native search bar. So you can manipulate or search the content by pressing Ctrl-F as usual 😺

Alternatively, even with your favorited Editor apps ❤️

7. Debug with different params

Proxyman is built-in with the useful collection of debugging tools:

  • Repeat and Edit the requestRepeat: Repeat your request with current parameters => It’s super easy to try out your API, to make sure it works or not
  • Edit & Repeat: Start editing the parameters => Test new context quickly. It’s useful when you want to know how the Backend responses with new request.

Try out new params

8. Export your current Session

You can export your current Proxyman Session and share with your teammates or QA team ❤️ From there, your co-workers could open and reproduce the bugs/issues immediately.

Or directly attach the log session to any Project Management like Jira, Trello.

9. Multiple Tabs

Proxyman take advantages of Cocoa Document-Based app, so you can working in different tab efficiently. More interesting, all tab hot-keys are consistent with Google Chrome and Safari, so you can increase your productivity significantly 🚀

  • Ctrl+T to open a new Tab.
  • Ctrl+Shift+ [ or ] to navigate tab forward or backward.
  • Ctrl+1, 2, 3 (number) to quickly open specific tabs.

10. Where to Go From Here?

If you have any question or feature requests, don’t hesitate to open the ticket in our Github.

Follow us at Twitter, Github or send us a “Hi” 💌 to nghia@proxyman.io


Proxyman is a high-performance macOS app, which enables developers to view HTTP/HTTPS requests from apps and domains on iOS device, iOS Simulator and Android devices. Get it at https://proxyman.io/