https://github.com/thegoodduck/netsour
CLI based packet reader in Python.
https://github.com/thegoodduck/netsour
cli curses packet-capture packet-sniffer python3 scapy tui
Last synced: over 1 year ago
JSON representation
CLI based packet reader in Python.
- Host: GitHub
- URL: https://github.com/thegoodduck/netsour
- Owner: thegoodduck
- License: agpl-3.0
- Created: 2024-07-17T22:46:45.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-29T23:03:18.000Z (almost 2 years ago)
- Last Synced: 2025-02-23T22:16:06.872Z (over 1 year ago)
- Topics: cli, curses, packet-capture, packet-sniffer, python3, scapy, tui
- Language: Python
- Homepage:
- Size: 70.3 KB
- Stars: 101
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# NetSour
NetSour is a network packet sniffer and analyzer tool built with Python and Scapy.
## Features
- Real-time packet capture and display
- Packet analysis and hexdump view
- DoS (Denial of Service) attack detection
- Support for various protocols (TCP, UDP, ARP, etc.)
- Interactive curses-based user interface
## Requirements
- Python 3.x
- Scapy
- Root/Administrator privileges (for packet sniffing)
## Installation
1. Clone this repository
2. Install the required dependencies:
pip install -r requirements.txt
## Usage
Run the script with root privileges:
sudo python main.py
[](https://asciinema.org/a/AWJUNdcp7HW1bAnN13fjkkMLA)
1. Enter the network interface name when prompted
2. Use arrow keys to navigate through captured packets
3. Press 'a' to analyze a specific packet
4. Press 'q' to quit the application
## Functions
- `is_root()`: Checks if the script is running with root privileges
- `process_packet()`: Extracts and formats packet information
- `sniff_packets()`: Captures network packets using Scapy
- `detect_dos()`: Identifies potential DoS attacks
- `display_packets()`: Manages the main user interface
- `analyze_packet()`: Provides detailed analysis of a selected packet
## Note
This tool is for educational and network administration purposes only. Always obtain proper authorization before monitoring network traffic.
## License
Gpl V3