Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kissssu/network-scanner
Python script that identifies live devices on a network and gathers their MAC addresses and vendor information.
https://github.com/kissssu/network-scanner
network python3 scanning
Last synced: 4 days ago
JSON representation
Python script that identifies live devices on a network and gathers their MAC addresses and vendor information.
- Host: GitHub
- URL: https://github.com/kissssu/network-scanner
- Owner: kissssu
- Created: 2024-12-29T07:51:52.000Z (12 days ago)
- Default Branch: main
- Last Pushed: 2024-12-29T10:10:55.000Z (12 days ago)
- Last Synced: 2024-12-29T11:18:43.485Z (12 days ago)
- Topics: network, python3, scanning
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Network Scanner
A Python-based script that scans a network for live hosts, retrieves their MAC addresses, and identifies their vendors. This tool is helpful for network administrators and penetration testers to gain insights into devices in a network.
---
## Features
- Sends ARP requests to detect live hosts in the network.
- Displays the IP address, MAC address, and vendor information of detected hosts.
- User-friendly output in a tabular format using PrettyTable.
---
## Requirements
1. **Python 3.6+**
2. Install the required libraries:
```bash
pip install scapy prettytable mac-vendor-lookup
```
## Usage
1. Run the Script:
```bash
python3 network_scanner.py --h 192.168.1.0/24
```
2. Example Output:
```
+-----------------+-------------------+------------------+
| IP | MAC | VENDOR |
+-----------------+-------------------+------------------+
| 192.168.1.1 | 00:1A:2B:3C:4D:5E| Cisco Systems |
| 192.168.1.10 | 00:1E:AA:BB:CC:DD| Dell Inc. |
+-----------------+-------------------+------------------+
```
## Arguments
- ```--h``` or ```--hosts```: Specify one or more hosts or a subnet to scan.
Example:
```bash
python3 network_scanner.py --h 192.168.1.0/24 192.168.1.10
```
## How It Works
- **ARP Request**: Sends ARP requests to the specified hosts/subnet.
- **Response Handling**: Identifies live hosts based on ARP replies.
- **MAC Address Lookup**: Resolves the MAC addresses to their corresponding vendors using the mac-vendor-lookup library.
- **Tabular Output**: Displays the results in a table format.
## Limitations
- Requires administrator privileges to send ARP packets.
- Only works on networks where ARP requests can be sent and responses can be received.
## Disclaimer
This tool is for **educational and authorized network auditing purposes only.** Unauthorized use is strictly prohibited.
## License
This project is licensed under the MIT License. See LICENSE for details.