README.md

Network scanner

A small project that I wrote on the fly for (IT351) Computer Networks University Course to identify and label the devices in my networks and open ports.

Technical Points

• Built using python3 and for
  • main.py file that used socket library for TCP Scanning which used three-way handshake (ACK-SYN)
  • main-scapy.main file that used scapy library for ARP Scanning which sends broadcast ARP message
• Built GUI with PyQt5 library

How to use

Getting started

1. clone or download the project and cd into the project folder
2. install dependencies
   1. pip install -r requirements.txt

How to run

1. run: python main.py, python main-scapy.py or from IDE like PyCharm
2. input network to scan: e.g. 192.168.1.1

Scanning could take a little while (around 20sec - 2min is normal). In addition, it may have to be run several times to get all devices.

Demo or What you will get

1. For running main.py file which scanning network using built in library socket

2. For running main-scapy.py file which scanning network using library scapy

Contributing

This is a very small project that arose out of a quick need. So I keep it as simple as possible. If you are motivated to improve it, you can simply fork the project and make a pull request with your changes.

Show your support

Give a ⭐️ if you found this project interested and helped you!