Skip to content

bitkeyhash/Async-Port-Scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

๐Ÿœ Async Port Scanner ๐Ÿœ

Welcome to the Async Port Scanner, a blazing-fast, lightweight, and deliciously simple port scanner built with Python and asyncio! ๐Ÿš€ This project is designed to help you scan ports asynchronously with up to 1000 parallel tasks at once. It's like ordering 1000 pizzas ๐Ÿ• at the same timeโ€”efficient and satisfying! ๐Ÿ˜„

๐Ÿฅก Features

  • Asynchronous Scanning: Uses Python's asyncio for super-fast port scanning. Think of it as cooking multiple dishes at once! ๐Ÿณ
  • Customizable Port Range: Specify the starting and ending ports to scan exactly what you need. ๐ŸŽฏ
  • Efficient Task Management: Limits to 1000 parallel tasks at a time to avoid overloading your system. ๐Ÿ› ๏ธ
  • User-Friendly Input: Interactive prompts guide you through entering the target IP and port range. ๐Ÿง‘โ€๐Ÿณ
  • No Dependencies: Uses only Python's standard libraryโ€”no extra ingredients required! ๐Ÿฅ•

๐Ÿฅ– How to Use

1๏ธโƒฃ Clone the Repository

git clone https://github.com/bitkeyhash/Async-Port-Scanner.git && cd Async-Port-Scanner

2๏ธโƒฃ Install Requirements

Make sure you have Python 3.8 or higher installed. Then install dependencies (if any):

pip install -r requirements.txt

Note: This script uses only Python's standard library, so no additional libraries are required! ๐ŸŽ‰

3๏ธโƒฃ Run the Script

Fire up the scanner by running:

python aps.py

You'll be prompted to enter:

  • The target IP address (e.g., 192.168.1.1)
  • The starting port (e.g., 1)
  • The ending port (e.g., 65535)

The script will then scan all ports in the specified range and display which ones are open! ๐Ÿ›ณ๏ธ


๐Ÿฅ— Example Output

Welcome to the Async Port Scanner!
Enter the target IP address: 192.168.1.1
Enter the starting port (e.g., 1): 20
Enter the ending port (e.g., 100)

Scanning IP: 192.168.1.1 from port 20 to 100...

[OPEN] Port 22 is open on 192.168.1.1
[OPEN] Port 80 is open on 192.168.1.1

Scan complete!

๐ŸŒฎ Requirements

This script requires Python 3.8+.

Install Python dependencies (if needed) using:

pip install -r requirements.txt

๐Ÿฉ How It Works (Under the Hood)

Hereโ€™s how this tasty scanner operates:

  1. Asynchronous Magic:

    • Uses asyncio to handle multiple connections simultaneously.
    • Limits concurrency to 200 tasks using a semaphore (asyncio.Semaphore)โ€”like having only so many burners on your stove! ๐Ÿ”ฅ
  2. Port Scanning:

    • Attempts to connect to each port in the specified range.
    • If successful, it reports the port as "open." Otherwise, it silently skips closed ports.
  3. Interactive Input:

    • Prompts you for the target IP address and port range.
    • Validates inputs to ensure everything is within proper limits (ports between 1-65535).

๐Ÿง Why Use This?

  • You're hungry for speed โšก.
  • You want something lightweight with no unnecessary dependencies ๐Ÿฅ—.
  • You love Python and want an easy-to-understand script ๐Ÿ.
  • You need a quick tool for network troubleshooting or ethical hacking ๐Ÿ•.

๐Ÿ” Contributing

Got some spicy ideas ๐ŸŒถ๏ธ? Found a bug ๐Ÿž? Feel free to contribute!

  1. Fork this repository ๐Ÿด.
  2. Create a new branch (git checkout -b feature/my-feature).
  3. Commit your changes (git commit -m "Add my feature").
  4. Push your branch (git push origin feature/my-feature).
  5. Open a pull request ๐Ÿš€.

โ˜• License

This project is licensed under the MIT Licenseโ€”because sharing is caring! โค๏ธ Feel free to use, modify, and distribute this script as you like.


๐Ÿฃ A Final Note

This tool is intended for ethical purposes only ๐Ÿ™โ€”always ensure you have permission before scanning any network or device.

Now go ahead and scan responsibly... Bon appรฉtit! ๐Ÿฝ๏ธ


Let me know if you'd like me to tweak anything further or add more flair! ๐Ÿ˜Š


Releases

No releases published

Packages

 
 
 

Contributors

Languages