# KimiNewt/pyshark

Python wrapper for tshark, allowing python packet parsing using wireshark dissectors

Repository: https://github.com/KimiNewt/pyshark
Canonical: https://ross.abutalabs.com/products/pyshark
Language: Python
License: MIT
License Family: permissive
Topics: tshark, python, packet-capture, capture-packets, wireshark
Last push: 2026-03-22T14:39:09+00:00

## Health v2 (maintenance only)
Score: 56/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 73, release rhythm 8, longevity 100
- inputs: {"age_days": 4631, "days_push": 164, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2496, forks 451 (observed 2026-08-28T04:06:56.664175+00:00)

## What it is
A Python wrapper around tshark that lets you parse packets from capture files or live captures using all installed Wireshark dissectors. It delegates parsing to tshark's XML export rather than parsing packets itself.

## Use cases
- parse pcap files in python
- analyze network packets with wireshark dissectors
- capture live traffic programmatically
- filter packets with wireshark display filters
- extract protocol fields from packet captures
- inspect network traffic for debugging

## When to choose
- you need Wireshark's full protocol dissector coverage from Python
- you want to script analysis of pcap files or live captures
- you prefer delegating parsing to tshark instead of a pure-Python parser

## When to avoid
- you need a pure-Python parser with no tshark/Wireshark dependency
- you need very high-performance packet processing
- you need a project with active maintenance and quick fixes

## Facets
- artifact type: library
- maturity: maintenance
- function: parser, networking, developer-tools
- domain: networking, developer-tools, security
- platform: python, windows, cli
- tags: tshark, wireshark, packet-capture, packet-parsing, pcap, network-analysis, linux, macos

## Member repositories
- KimiNewt/pyshark (main) score 56

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:56.664175+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:27:09.409961+00:00, confidence not recorded.
  - readme: https://github.com/KimiNewt/pyshark (fetched 2026-08-28T04:06:56.664175+00:00, sha c2c1fbb6f17b)
  - registry_pypi: https://pypi.org/pypi/pyshark/json (fetched 2026-08-29T10:09:37.127192+00:00, sha 72a9f7434347)
- Data as of 2026-08-30T08:39:29.467469+00:00.