Quick start

From download to your first decrypted request in about five minutes, on Mac, iPhone, iPad or Android.

Mac iPhone and iPad Android

WireLens shows you what your apps send and receive, and lets you change it. Here is the shortest path to your first decrypted request on each platform.

On the Mac#

  1. Install. Download WireLens, drag it to Applications and open it. You need a Mac with Apple silicon and macOS 14 or later.
  2. Allow the helper. The Setup Assistant opens. On Helper, click Install… and confirm with Touch ID or your password. Capture then starts without a password.
  3. Trust the certificate. On Certificate, click Install… and confirm again. This is what lets WireLens read inside HTTPS.
  4. Start capture. On Start, click Start Capture, or press ⌘R at any time.
  5. Decrypt a host. Open a website or the app you are working on. Right-click one of its rows and choose Enable SSL Proxying for followed by the host name, then make the request again.
  6. Read it. Select the new row. The request and the response, headers and bodies, are in the inspector.

Every step with screenshots: Install WireLens for Mac.

On iPhone and iPad#

  1. Install WireLens from the App Store and open it. You need iOS 17 or later.
  2. Allow the VPN when iOS asks. It runs on the phone: your apps' traffic goes through WireLens on the phone and straight on to the servers.
  3. Download the certificate profile and tap Allow.
  4. Install it in Settings ▸ Profile Downloaded, then switch WireLens on in Settings ▸ General ▸ About ▸ Certificate Trust Settings.
  5. Decrypt a host. Use the app you want to look at, then long-press its host in Traffic and choose Enable SSL Proxying.

The setup guide in WireLens shows each iOS screen before you see it. Every step with screenshots: Set up WireLens on iPhone and iPad. After setup: Using WireLens on iPhone and iPad.

On Android#

  1. Install WireLens from Google Play and open it. You need Android 10 or later.
  2. Install the certificate. In the Setup Guide, tap Save to Downloads, then install WireLens-CA.crt in Android Settings as a CA certificate.
  3. Allow the VPN and notifications when the Setup Guide asks.
  4. Start capture with the round button on Traffic, then use the app you want to look at.
  5. Decrypt a host. Long-press it and choose Enable SSL Proxying.

Every step with screenshots: Install WireLens for Android. After setup: Using WireLens on Android.

Where to go next#

Something here is unclear, or wrong for your setup? Contact support or write to support@wirelens.app.