heshamm1 / jok3r

"Jok3r" by Hesham (Sh1vv) is a Python script for network reconnaissance and port scanning. It streamlines host discovery on specified subnets and efficient port scans on target IPs. With a user-friendly interface, and customizable port ranges, it's a versatile tool for network exploration, supporting saving scan results.

Never Forget GAZA!

More than 30000 martyrs have been killed in Gaza since the seventh of October 2023, 80% of the martyrs are women, children and the elderly. The occupying entity is committing a crime against humanity So, don't forget them.

---

Welcome to The Joker's World!!

Your new host discovery/scanner/enumeration tool.

Features

• Host Discovery: Quickly discover hosts in a specified subnet.
• Port Scanning: Perform stealth or aggressive port scans on specified hosts.
• Technology Detection: Identify technologies running on open ports.
• Subdomain Enumeration: Identify all subdomains according to Subfinder, assetfinder, findomain tools.
• Output Saving: Save scan results and discovered hosts to a text file.

Table of Contents

• Installation
• Usage
• Options
• Sample Usage
• Contributing
• License

Installation

Ensure you have Python 3.x installed. Use pip to install the required dependencies:

git clone https://github.com/heshamm1/Jok3r && cd Jok3r

chmod +x setup.sh && ./setup.sh

python jok3r.py -h

Usage

Host Discovery:

python3 jok3r.py -s 192.168.1.0 -m 24

Port Scanning:

python3 jok3r.py -i 192.168.1.3 -Ps -a 

python3 jok3r.py -f IPs.txt -Ps

Output Saving:

python3 jok3r.py -s 192.168.1.0 -m 24 -So output.txt

Subdomain Enumeration:

python3 jok3r.py --sub-enum

Options

• -s SUBNET: Subnet you want to discover, e.g., 192.168.1.0
• -m MASK: Subnet Mask you want to discover, e.g., 24
• -i IP: Specify target IP for port scanning
• -So FILE: Save output to a text file
• -Ps: Perform port scan
• -a: Scan all 65535 ports
• -h: Show help message
• --sub-enum: Perform Subdomain Enumeration

Sample Usage

python3 jok3r.py -s 192.168.1.0 -m 24 -i 192.168.1.2 -Ps

Contributing

Contributions are welcome! If you have suggestions, bug reports, or want to contribute code, feel free to open an issue or submit a pull request.

Please make sure to update tests as appropriate.

License

This project is licensed under the MIT License.