This is a simple async scanner that uses Python 3.11 high-level asyncio API. The project has not dependancies and be run on versions 3.10 and 3.11. Earlier versions aren't supported nor tested.
- Clone the repository:
git clone https://github.com/your-username/your-repository.git
To run the application, execute the following command:
python src/main.py
The application will perform the following steps:
- For each hostname or IP provided the range of ports provided will be scanned
- Printing results will be in a simple tabular format
- Print order isn't guranteed
- Unresolvable hosts will be silently skipped
If the Python version is less than 3.11, the user will be prompted for confirmation before proceeding.
usage: main.py [-h] [-p PORTS] [--open] host
positional arguments:
host hostname or ip to scan, or a comma/space separated list thereof
options:
-h, --help show this help message and exit
-p PORTS, --ports PORTS
List of ports to scan eg: 1-443,444,500-600
$ py ./main.py scanme.nmap.org -p 1-100,443 --open
Host Port State Reason Service
scanme.nmap.org 22 open syn/ack ssh
scanme.nmap.org 80 open syn/ack http
Total execution time: 0.38 seconds
Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
This project is licensed under the MIT License.