This Python script allows you to scan a network and discover devices within a specified IP range. It uses Scapy, a powerful packet manipulation library, to send ARP request packets and capture responses from devices in the network. The script retrieves the IP address, MAC address, and hostname or vendor information for each discovered device.

Prerequisites

• Python 3.x
• Required Python packages can be installed using the following command:

pip install scapy requests

Usage

1. Clone the repository or download the script to your local machine git clone https://github.com/SaherMuhamed/arp-ping-scanner.git
2. Open a terminal or command prompt and navigate to the directory where the script is located.
3. Run the script with the following command:

python3 arp-ping.py --range <IP_range>

4. Replace <IP_range> with the IP range you want to scan, e.g., 192.168.1.0/24.

Output

The script generates a table displaying the following information for each discovered device:

Interface: eth0, MAC: 00:0c:29:0f:c4:d0, IPv4: 10.20.14.5
Starting arp-ping v2.1.0 with 256 hosts (https://github.com/SaherMuhamed/arp-ping-scanner)
10.20.14.1     00:50:56:c0:00:08   VMware, Inc.
10.20.14.2     00:50:56:ff:8f:89   VMware, Inc.
10.20.14.254   00:50:56:f8:eb:7c   VMware, Inc.

3 packets received by filter, 253 packets dropped by kernel
Ending arp-ping v2.1.0: 256 hosts scanned in 1.309 seconds (195.62 hosts/sec). 3 responded

• IP address
• MAC address
• Hostname or vendor information (obtained from an OUI lookup)

Example output:

Updates

• v1.0.1 - 27/12/2023 adding Size and improve scanning functionality
• v1.1.0 - 11/11/2024 adding --json or -j optional switch to import the scan result into JSON format / increase scanning speed
• v2.1.0 - 17/01/2025 huge changes, rename the project from network scanner => arp-ping also convert the project into OOP for further updating and releases & improve scanning functionality