SUPPORT · KESTREL SIGHT

Kestrel Sight
support & FAQ.

Common questions about the paid edition — unlimited packets, raw-data search, analyst bookmarks, and audit logging with SHA-256 evidence hashing. 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?
Two strategies based on size. Under 1 GB loads fully for complete analysis with automatic TCP stream reassembly. At or above 1 GB, Kestrel streams from disk — packet headers are parsed up front and payload is read on demand. TCP reassembly disables automatically above 1 GB to protect device memory; packets, flows, hosts, DNS, and timeline remain fully functional.
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. Live capture on the Mac is what Kestrel Talon is for.
────── 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). Raw payload search (raw=password). Space-separated terms are AND-combined.
How does TCP reassembly handle retransmissions?
Segments are ordered by TCP sequence number. Overlapping ranges caused by retransmissions are deduplicated. Payloads concatenate into continuous byte streams. HTTP transactions — method lines, status lines, chunked-transfer encoding — are identified automatically.
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 will be reported as salted SHA-256 fingerprints so raw credential values never touch disk, and any preview display in the UI will mask interior characters until tapped to reveal. Kestrel Sight and Lite do not include a credential scanner.
What’s the difference between Sight and Lite?
Lite caps display at the first 50,000 packets per file. Sight removes that cap and adds analyst bookmarks, raw-payload search, enhanced IPv6 display, and refined PDF reports. Everything else — dashboard, packets, flows, hosts, DNS, streams, timeline, and audit log with SHA-256 evidence hashing — is identical. Anomaly detection, sensitive-data scanning, and file carving are Pro features (in development). Upgrade to Sight from in-app.
────── PRIVACY ──────
00000030 · PRIVACY

Privacy and data.

What the app touches, what it never does.

Does Kestrel send my data anywhere?
No. Every byte is processed on-device. Kestrel makes no outbound connections, sends no analytics, and contacts no external services. Read the full privacy policy for specifics.
Where are my files stored?
Files you open stay where you opened them — Kestrel reads from your file providers (Files, iCloud Drive, etc.) without copying. Session state (filters, marked packets, notes) lives in the app’s sandboxed container and is removed if you delete the app.
Does Kestrel require an account?
No. No sign-in, no cloud sync, no identity. The in-app upgrade to Sight goes through the App Store and is tied to your Apple ID, 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.
Files over a gigabyte parse headers only; payload reads are on-demand. TCP reassembly disables automatically above 1 GB. The filter debounces at 300 ms — give it a moment after typing. If something is genuinely hung, force-quit and reopen. Tell me what happened.
My in-app purchase didn’t activate.
Go to Settings · Restore Purchases. Make sure you’re signed in with the Apple ID that made the purchase. If it still doesn’t restore, send me your purchase 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 within forty-eight hours.

support@tracivex.com