← Selected work

Python · networking · security

Packet Sniffer

A Python and Scapy packet-analysis CLI with BPF filtering, protocol inspection, detailed views, and PCAP export.

StatusPublic learning project with terminal and text output.
CaptureLive interface
FilteringBPF
ViewsSummary and detail
OutputTerminal or text

01 / Problem

Why this system exists

Network debugging requires a focused way to capture relevant traffic and move between quick summaries and packet-level detail.

02 / Architecture

How state moves

  1. 01Network interface
  2. 02Scapy capture
  3. 03BPF filter
  4. 04Packet callback
  5. 05Protocol inspection
  6. 06Terminal, text, or PCAP

03 / Decisions

Engineering choices

  • Use BPF filtering at capture time to reduce irrelevant traffic.
  • Support both compact summaries and detailed inspection.
  • Write incrementally to text when persistent output is requested.
  • Document privilege and responsible-use requirements.

04 / Boundaries

What this does not claim

  • Packet capture and PCAP export require authorization on the network being inspected and may require elevated privileges.
  • Encrypted payloads remain encrypted; this tool does not bypass transport security.

See the code and documentation.

View repository ↗