Docs

Getting started

From a pcap to a shareable, masked ladder in four steps.

1. Open a capture

PacketLens reads .pcap and .pcapng files.

  • iPhone and iPad: tap a capture in Files, Mail or Messages and choose PacketLens, or open it from inside the app.
  • Mac: double-click the file, drag it onto the app, or use File › Open.

The packet list appears after a quick initial pass. Tap a packet to see its full decode tree and hex. Use the filter bar to narrow the list by protocol, address or field.

PacketLens packet list of a mixed signalling capture (Diameter, SIP, DNS, GTP, MAP) with the filter bar above it.
The packet list with the filter bar

No capture to hand? The app ships with a small synthetic sample, so you can try every view before opening your own.

2. Find a subscriber

Open the Trace tab. Choose Subscribers or Hosts, then search by IMSI, MSISDN, IMEI, IP, MAC or host name. MSISDNs match in any common format (+41 79…,0041 79…, 079…).

Rows with a failure (attach reject, GTP cause not accepted, Diameter error, SIP 4xx–6xx, unanswered request) are flagged so you can start with the trouble. Tap View trace to open the subscriber’s story: an identity header (IMSI, MSISDN, IMEI, GUTI, UE IP, APN), then every procedure across the capture.

Trace Subscribers list: test IMSIs with MSISDN, protocol badges and one failed call highlighted in red.
Trace: Subscribers, one failed call flagged

Tap any identity to see how it was linked. After NAS security is set up, messages are usually ciphered: they stay in the trace marked NAS (ciphered), and continuity comes from the S1AP UE IDs.

3. Read the ladder

Switch a trace or flow to the ladder view. Each lane is a network node; each arrow is a message in time order.

Subscriber ladder diagram: attach, S6a, Create Session, IMS registration and a call rejected with 486 Busy Here in red.
A subscriber ladder: attach, sessions, IMS and a rejected call
Example ladder: an attach with an authentication request and answer, a session creation, then a rejected callUE/eNBMMEHSSSGWAttach requestAIR (S6a)AIA 2001Create Session RequestCreate Session Response · cause 64 (example)0.0000.012+18 ms
  • Blue: requests. Teal: responses.
  • Amber: provisional answers. Red: failures.
  • Times and deltas sit on every arrow; tap an arrow to open that frame’s decode.

4. Export safely

From a trace, open the export sheet and pick a format:

  • Ladder as PDF or PNG (paper size picked automatically, or choose one).
  • Procedures as CSV or HTML.
  • Frames as a filtered pcap.

Mask identities is on by default. IMSI, MSISDN and IMEI appear as 40401******486in images, CSV, HTML and file names. You can also pseudonymise network addresses.

Export sheet for a subscriber trace with Mask identities switched on.
The export sheet, Mask identities on

A pcap can’t be masked. Its packet bytes are the original data, so only its file name is masked. Share a filtered pcap only with people who are allowed to see that subscriber’s data. For tickets and slides, prefer the masked PDF, PNG or HTML.

Files go out through the share sheet (Mail, AirDrop, Files). Nothing is uploaded by PacketLens itself.

Stuck? See Support.

Coming soon

PacketLens isn’t on the App Store yet. Leave your email and we’ll tell you when it launches.

One email at launch, then your address is deleted. Privacy