RomanNum3ral
/
Cybersecurity-Projects
mirror of https://github.com/CarterPerez-dev/Cybersecurity-Projects.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Cybersecurity-Projects/PROJECTS/beginner/network-traffic-analyzer/python
History
Carter Perez 928d9ee68d
Merge pull request #163 from CarterPerez-dev/dependabot/uv/PROJECTS/beginner/network-traffic-analyzer/python/pillow-12.2.0 
chore(deps): bump pillow from 12.1.1 to 12.2.0 in /PROJECTS/beginner/network-traffic-analyzer/python
 		2026-04-15 07:02:54 -04:00
..
learn add: cpp version, moved code to separate directories 2026-02-22 13:38:02 +01:00
src/netanal feat: did a couple things idk 2026-02-28 14:08:36 -05:00
tests feat: did a couple things idk 2026-02-28 14:08:36 -05:00
.gitignore add learn folder, move hidden files, update root readme, add learn folder, add clang tidy, and format 2026-02-26 00:38:55 -05:00
.style.yapf add learn folder, move hidden files, update root readme, add learn folder, add clang tidy, and format 2026-02-26 00:38:55 -05:00
LICENSE add: cpp version, moved code to separate directories 2026-02-22 13:38:02 +01:00
README.md add: cpp version, moved code to separate directories 2026-02-22 13:38:02 +01:00
justfile add: cpp version, moved code to separate directories 2026-02-22 13:38:02 +01:00
pyproject.toml add: cpp version, moved code to separate directories 2026-02-22 13:38:02 +01:00
uv.lock Merge pull request #163 from CarterPerez-dev/dependabot/uv/PROJECTS/beginner/network-traffic-analyzer/python/pillow-12.2.0 2026-04-15 07:02:54 -04:00

README.md 

███╗   ██╗███████╗████████╗ █████╗ ███╗   ██╗ █████╗ ██╗
████╗  ██║██╔════╝╚══██╔══╝██╔══██╗████╗  ██║██╔══██╗██║
██╔██╗ ██║█████╗     ██║   ███████║██╔██╗ ██║███████║██║
██║╚██╗██║██╔══╝     ██║   ██╔══██║██║╚██╗██║██╔══██║██║
██║ ╚████║███████╗   ██║   ██║  ██║██║ ╚████║██║  ██║███████╗
╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝

Cybersecurity Projects Python License: AGPLv3 PyPI

Network traffic capture and analysis CLI with protocol distribution, top talkers, and bandwidth visualization.

This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.

What It Does

  • Capture live network traffic on any interface with configurable packet counts
  • Real-time protocol distribution analysis with percentage breakdowns
  • Top talkers identification showing most active IP addresses by traffic volume
  • Bandwidth calculation with bytes sent/received per endpoint
  • Verbose mode displays individual packet flow with source/destination details
  • Built on Scapy for deep packet inspection and protocol parsing

Quick Start

uv tool install netanal
sudo netanal capture -i eth0 -c 100

[!TIP] This project uses just as a command runner. Type just to see all available commands.

Install: curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin

Commands

Command Description
netanal capture Live packet capture with protocol analysis, top talkers, and bandwidth stats

Learn

This project includes step-by-step learning materials covering security theory, architecture, and implementation.

Module Topic
00 - Overview Prerequisites and quick start
01 - Concepts Security theory and real-world breaches
02 - Architecture System design and data flow
03 - Implementation Code walkthrough
04 - Challenges Extension ideas and exercises

License

AGPL 3.0