SocketSherlock

SocketSherlock is a powerful, fast and user-friendly port scanning tool designed to help network administrators, security professionals, and enthusiasts investigate open ports on target IP addresses.

Features

Here're some of the project's best features:

• Scan multiple IP addresses simultaneously
• Customizable port range scanning
• Fast and efficient multi-threaded scanning
• Detailed output with port status and associated services
• Option to save results in JSON format
• User-friendly command-line interface
• Run directly from the terminal

Installation Steps:

1. Clone the repository :

git clone https://github.com/Aniket-mon/SocketSherlock.git

2. Navigate to the project directory:

cd SocketSherlock

3. Install the required dependencies

pip install -r requirements.txt

Usage

Basic usage:

python SocketSherlock.py <target ip>

Advanced Usage:

python SocketSherlock.py <target ip> [arguments]

Options

• -p, --ports: Specify port range to scan (e.g., 1-1000 or 80,443,8080)
• -t, --timeout: Set timeout for each port scan (default: 1.0s)
• -o, --output: Specify output file for JSON results
• -h, --help: Show help message and exit

Examples

1. Scan a single IP address with default settings - scans the first 1000 ports:

   python socketsherlock.py 192.168.1.1
   

2. Scan multiple IP addresses with specific ports:

   python socketsherlock.py 192.168.1.1,10.0.0.1 -p 80,443,8080
   

3. Scan an IP address with a custom port range and timeout:

   python socketsherlock.py 192.168.1.1 -p 1-1000 -t 0.5
   

4. Save scan results to a JSON file:

   python socketsherlock.py 192.168.1.1 -o results.json
   
   

Contribution Guidelines:

Please contribute using GitHub Flow. Create a branch. Add commits. Create a pull request.

Built with

Technologies used in the project:

Language :

• Python

Libraries :

• sys
• socket
• typing
• ipaddress
• prettytable
• agrparse
• concurrent.futures - ThreadPoolExecutor
• tqdm
• json

License:

This project is licensed under the MIT License

Acknowledgemnets

• Thanks to all contributors who have helped to improve SocketSherlock.

• Special thanks to the open-source community for providing the libraries and tools that made this project possible.

For more information and updates, please visit the SocketSherlock GitHub repository.