Network Scanner Project

Project Overview

This Python-based network scanner discovers active devices on your local network using ARP (Address Resolution Protocol) requests. It provides detailed information about discovered devices and exports results to a CSV file.

Key Features

Scans local network for active devices
Displays IP and MAC addresses of discovered devices
Exports results to CSV format
Includes timestamp for each discovered device
Configurable scan timeout and IP range
Command-line interface for easy usage

Installation

1. Install required dependencies:

pip install scapy

2. Run the scanner (requires administrator privileges):

python network_scanner.py

Sample Output

Network Scanner Starting...
Scanning network range: 192.168.1.1/24

Found Devices:
------------------------------------------------------------
IP Address      MAC Address         Timestamp           
------------------------------------------------------------
192.168.1.1     00:11:22:33:44:55  2024-02-20 14:30:15
192.168.1.5     11:22:33:44:55:66  2024-02-20 14:30:15
192.168.1.10    22:33:44:55:66:77  2024-02-20 14:30:15

Results exported to scan_results.csv

Custom Usage

You can customize the scan with command-line arguments:

python network_scanner.py --ip-range 192.168.0.1/24 --timeout 3 --output results.csv

CSV Output Format

The scanner generates a CSV file with the following columns:

IP,MAC,Timestamp
192.168.1.1,00:11:22:33:44:55,2024-02-20 14:30:15
192.168.1.5,11:22:33:44:55:66,2024-02-20 14:30:15
192.168.1.10,22:33:44:55:66:77,2024-02-20 14:30:15

Important Notes

⚠️ This script requires administrative/root privileges to perform ARP scanning.

⚠️ Use this tool only on networks you own or have permission to scan.

⚠️ Network scanning may be detected by security systems.