Skip to content

anandvelango/SubHawk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Subhawk

image

Subhawk is a python worlist-based tool that is used for discovering subdomains associated with a target domain in a fast efficient manner by utilising asynchronous programming techniques. SubHawk enumerates subdomains by reading through a wordlist file line by line, combining each entry with the target domain and it then sends asynchronous HTTP requests to each subdomain. This assists bug bounty hunters and penetration tester

Features

  • Asynchronous (fast results and customisable)
  • Capable of using large wordlist files
  • Option for outputting the results in a .txt file

Installation

  1. Clone the repository:
git clone https://github.com/anandvelango/SubHawk.git
  1. Change directory:
cd SubHawk
  1. Install all the required modules
pip3 install -r requirements.txt

Python Version Required

SubHawk supports at least Python 3.6.x so make sure you have at least Python 3.6.x installed on your system.

Modules

  • asyncio
  • httpx
  • time
  • argparse
  • colorama

Wordlist file

You can use our current sample wordlist file wordlists/subdomains.txt from our repository but you can also use wordlists from your Kali machine or download some from internet. Use whichever you need.

Usage

Short form Long form Description
-d --domain Domain in which you want to enumerate subdomains
-w --wordlist-file Path to wordlist file
-o --output Output the results in a .txt file
-s --semaphores Adjust the semaphores (speed) if required (by default it's set to 100 but change it accordingly)
-h --help Show this help message and exit

Examples

image

  • To get help about the tool:
python3 subhawk.py -h
  • To find subdomains (always requires a wordlist file)
python3 subhawk.py -d example.com -w <path to wordlist file>
  • Save the results in a file
python3 subhawk.py -d example.com -w <path to file> -o <file>.txt
  • Adjust the semaphores (speed)
python3 subhawk.py -d example.com -w <path to file> -s <semaphores: int>

Update Plans

  • find URLs for cloud storage services like S3
  • add more smaller and larger subdomain wordlists

About

Subdomain enumerator that utilises asynchronous techniques for bug bounty hunters & penetration testers.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages