Metadata-Version: 2.1
Name: netsour
Version: 0.1.0
Summary: A packet analyzer with enhanced features like Nmap scanning and geolocation
Home-page: https://github.com/thegoodduck/NetSour
Author: thegoodduck
Author-email: your.email@example.com
License: GPL-3.0
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: scapy
Requires-Dist: python-nmap
Requires-Dist: requests

# 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
[![asciicast](https://asciinema.org/a/AWJUNdcp7HW1bAnN13fjkkMLA.svg)](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



