SUPPORT · KESTREL SIGHT

Kestrel Sight
support & FAQ.

Common questions about the paid edition — no packet cap, raw payload text search, analyst bookmarks, and audit logging. If your answer isn’t here, write me directly — I read every email.

────── GETTING STARTED ──────
00000010 · BASICS

Getting started.

The essentials of opening, analyzing, and moving files.

How do I open a capture file?
Three ways. One — tap Open on the welcome screen and pick from Files, iCloud Drive, or any file provider. Two — share a PCAP from Mail, Messages, or any app that accepts Files, and pick Kestrel from the share sheet. Three — AirDrop a file from your Mac straight to Kestrel.
What file formats does Kestrel support?
PCAP (libpcap, magic 0xA1B2C3D4, native and byte-swapped) and PCAPNG (section-header-block format). These are the outputs of Wireshark, tcpdump, tshark, and every other standard capture tool.
How large a file can I open?
Under 1 GB, the current Lite and Sight builds use the standard analysis path with automatic TCP stream reassembly. At or above 1 GB, Kestrel switches to a streaming/header-first path and disables TCP reassembly to protect device memory. Packets, flows, hosts, DNS, and timeline remain available; raw payload text search has reduced coverage because it uses the indexed packet region rather than every byte of the on-disk payload. Kestrel also creates a protected sandbox working copy, so free space roughly equal to the capture size is required in addition to normal system headroom.
How does file hashing work in the current Lite and Sight builds?
For captures up to 500 MB, Kestrel computes SHA-256 over the capture contents. Above 500 MB, the current shipping build uses a SHA-256 value derived from file size, filename, and modification date as a session identifier; that larger-file value is not a content evidence hash. This is a current implementation limitation, not a claim about SHA-256 itself.
Can Kestrel capture live traffic on iPhone?
No. iOS does not expose the equivalent of Berkeley Packet Filter to third-party apps — this is an Apple platform restriction, not a Kestrel limitation. Kestrel analyzes capture files generated elsewhere with a tool such as Wireshark or tcpdump.
────── ANALYSIS ──────
00000020 · ANALYSIS

Filtering and analysis.

Getting to the packets, streams, and anomalies you care about.

What filter syntax does the search bar accept?
Free text (matches IP, port, protocol, info, flags). CIDR (192.168.1.0/24). Protocol name (TCP, DNS). Port number (443 or :8080). Directional IP (src=10.0.0.1, dst=8.8.8.8). Sight adds raw payload text search with raw=password. At 1 GB and above, raw search uses the indexed packet region rather than the full on-disk payload. Space-separated terms are AND-combined.
How does TCP reassembly handle retransmissions?
Segments are ordered by TCP sequence number and overlapping retransmitted ranges are deduplicated. In the current shipping Lite/Sight core, captures with missing TCP segments can be represented approximately during reconstruction, so reconstructed bytes that cross capture gaps should not be treated as forensic ground truth. HTTP transaction markers such as method and status lines are identified where the required bytes are present.
Will credentials be masked when Pro ships?
The Pro credential scanner (in development) will find exposed secrets across common protocols. Masking will be the responsible default — findings are intended to be reported as salted SHA-256 fingerprints. Raw detected values are not intended to be persisted as findings or written into reports, and preview display in the UI masks interior characters until explicitly revealed. Kestrel Sight and Lite do not include a credential scanner.
What’s the difference between Sight and Lite?
Lite and Sight share the same current shipping analysis core: dashboard, packets, flows, hosts, DNS, streams, timeline, and audit logging. Lite caps display at the first 50,000 packets per file. Sight removes that cap and adds analyst bookmarks, raw payload text search, enhanced IPv6 display, and refined PDF reports. Anomaly detection, sensitive-data scanning, and file carving are Pro features in development. Sight is available on the App Store.
────── PRIVACY ──────
00000030 · PRIVACY

Privacy and data.

What the app touches, what it never does.

Does Kestrel send my data anywhere?
Analysis happens on-device. Kestrel contains no application endpoints or analysis code that initiate network connections, no cloud-analysis service, no telemetry, and no third-party analytics SDK. Anything that leaves the device does so because you exported it — Files, AirDrop, Share Sheet, or a PDF report. Read the full privacy policy for specifics.
Where are my files stored?
Kestrel accesses the capture you select through the system file picker and creates a protected working copy inside its own sandbox, stored with NSFileProtectionComplete. Kestrel does not write to your original file. App-local working copies and session state remain in the sandbox and are removed if you delete the app; files you explicitly export are controlled by the destination you selected. Plan on needing free space roughly equal to the capture size for the working copy.
Does Kestrel require an account?
No. No sign-in, no cloud sync, no identity. Purchases go through the App Store and are tied to your Apple Account, not to any Tracivex account.
────── TROUBLESHOOTING ──────
00000040 · FIXES

Troubleshooting.

When something isn’t working as expected.

A file won’t open or shows zero packets.
Make sure the file is actually a PCAP or PCAPNG — some apps export capture metadata in JSON or CSV that shares nothing with the binary format. Open the file in Wireshark on another machine to confirm. If it opens there but not in Kestrel, send me the file details (size, source tool) by email.
The app feels slow on a large capture.
At 1 GB and above, the current Lite/Sight build uses its streaming/header-first path and disables TCP reassembly. Packet density matters as much as file size because packet metadata still scales with packet count. Raw payload text search also has reduced coverage in this mode. If something is genuinely hung, force-quit, reopen, and tell me the capture size, approximate packet count if known, device model, and iOS version.
I paid for Sight but it isn’t active.
First make sure you’re signed in with the Apple Account that made the purchase. In-app purchases can be restored from Settings · Restore Purchases; a separately purchased app can be reinstalled from your App Store purchase history. If neither works, send me your receipt and I’ll help directly.
How do I report a bug?
Email me with device model, iOS version, app version (Settings · About), and what you were doing when the bug happened. A reproduction case — even “I tapped X then Y and saw Z” — is worth ten vague descriptions. Please don’t attach PCAP files without asking first; they often contain sensitive data.
────── STILL STUCK ──────
WRITE

If your question isn’t answered here, email directly. Bugs, feature requests, licensing, press — one inbox, one human, reply usually within forty-eight hours on weekdays.

support@tracivex.com