Flows-first PCAP TUI (case files, gorgeous UX). Do do do do.
Flows-first PCAP TUI (case files, gorgeous UX). Do do do do.
Wireshark made easy (in your terminal).
Babyshark is a PCAP TUI that helps you answer:
Status: v0.3.0 (alpha).
.pcap / .pcapng viewing works without Wiresharktshark (Wireshark CLI)Overview is the “start here” dashboard. It summarizes the capture and suggests what to do next.
tshark).How to use it:
D to jump to Domains (hostnames-first).W to jump to What’s weird? (curated detectors).F (or f) to jump to Flows (raw).Domains groups traffic by hostname so you can start from names instead of 5‑tuples.
How to use it:
s to change the sort mode.c to clear an active subset filter.What’s weird? is a curated set of detectors meant to answer “what looks broken/slow?” without needing deep Wireshark knowledge.
How to use it:
1–9 to jump-select) and press Enter.c to clear an active subset filter.Expand / Explain (?) gives plain-English context for what you’re looking at.
? to open Explain.Tip: press h for help and g for glossary.
Grab a binary from GitHub Releases:
git clone https://github.com/vignesh07/babyshark
cd babyshark/rust
cargo install --path . --force
babyshark --help.pcap / .pcapng and browse:n / N navigationDL/UL suffix in flow list + download-heavy/upload-heavy/balanced in details (falls back to A>B/B>A when local side is ambiguous)T):Download a prebuilt binary:
Prereqs:
tsharkgit clone https://github.com/vignesh07/babyshark
cd babyshark/rust
cargo install --path . --force
babyshark --helpcargo install --git https://github.com/vignesh07/babyshark --bin babysharktshark (required for --live)tshark is the official Wireshark CLI.
# macOS (Homebrew)
brew install wiresharkDebian/Ubuntu:
sudo apt-get update
sudo apt-get install -y tsharkFedora:
sudo dnf install -y wireshark-cliArch:
sudo pacman -S wireshark-cliVerify:
tshark --version
tshark -DPermissions note: live capture may require elevated permissions (sudo, dumpcap caps, or being in the wireshark group). If babyshark prints a permission error, follow the guidance it outputs.
babyshark updated in git but my command still runs old behaviorIf you installed with cargo install, you need to reinstall after pulling:
cd babyshark/rust
cargo install --path . --forceTry running with sudo:
sudo babyshark --live en0If that works, you likely need to configure capture permissions (dumpcap, wireshark group, etc.) on your OS.
ips=0 for everythingThis often happens when DNS answers aren’t visible (DoH/DoT or cached). Babyshark will still show Observed IPs (from flows) using TLS SNI / HTTP Host hints when available.
babyshark --pcap ./capture.pcapbabyshark --list-ifacesbabyshark --live en0babyshark --live en0 --dfilter "tcp.port==443"babyshark --live en0 --write-pcap /tmp/live.pcapngThese are text-only examples of what you’ll see in the TUI. IPs/domains are anonymized.
…Domains (Enter show flows, s sort (conn/bytes/fail), c clear, Esc back)
1 wikipedia.com conn=9 bytes=21.0KB q=9 r=6 fail=0 ips=2
❯ 2 chat.openai.com conn=5 bytes=28.2KB q=5 r=3 fail=0 ips=2
Domain details
chat.openai.com
queries=5 responses=3 failures=0
Observed IPs (from flows):
10.0.0.6
198.51.100.42
Tip: Enter applies a subset filter (prefers observed IPs; DNS IPs if available).……Timeline is the visual story of your capture. It shows when each connection started, what phases it went through (handshake, TLS, data transfer, close), and how they overlap.
Flows [LIVE en0] (63.8 pps) (Enter packets, / filter, t/u toggles, b bookmark, E export, o overview) subset=domain:chat.openai.com
● 1 UDP 510 10.0.0.6:59175 ↔ 203.0.113.123:443 DL
❯● 2 TCP 32 10.0.0.6:57608 ↔ 198.51.100.42:443 DL
Details
TCP 10.0.0.6:57608 ↔ 198.51.100.42:443
A→B: 14 pkts / 1386 bytes
B→A: 26 pkts / 26307 bytes
Direction: download-heavy
Handshake RTT: 12.450ms
Server think: 3.200ms
Data transfer: 89.100ms
TLS version: TLS 1.2
bookmarks: 1Top-level:
o overviewD domainsW weird stuffF flowsT timeline (Gantt + Scatter)h helpg glossaryq quitIn views:
Enter drill down (domains/weird → flows, flows → packets)Esc backc clear active subset filter? explain selected flowx dismiss onboarding hint (Overview)Flows view:
↑/↓ or j/k move/ filtert / u toggle TCP / UDPb bookmark flowE export reportTimeline view:
Tab / Shift-Tab switch Gantt / Scatter↑/↓ or j/k movePgUp/PgDn pageEnter drill into PacketsPackets view:
f follow streamStream view:
/ searchn / N next / prev matchTab / Shift-Tab cycle stream direction↑/↓ scrollWhen you bookmark/export, babyshark writes next to the PCAP in a hidden directory:
.babyshark/case.json — bookmarks.babyshark/report.md — latest report (overwritten).babyshark/report-YYYYMMDD-HHMMSS.md — versioned reports--bpf capture filter pass-through for live modeMIT © 2026 Vignesh Natarajan
No open issues yet, or sync has not completed.