Skip to content
/ zScan Public

A simple and quick subdomain scanner created with python. Supports custom subdomains file, and exporting results into a JSON file.

Notifications You must be signed in to change notification settings

tzero86/zScan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zScan - a Super simple subdomain scanner

The other day I was catching up to Joe Helle's Python 3 tools series on YouTube and got inspired to give the subdomain scanner a try. I'm not a coder so the code could be ugly, any feedback is welcome!


    ███████╗███████╗ ██████╗ █████╗ ███╗   ██╗
    ╚══███╔╝██╔════╝██╔════╝██╔══██╗████╗  ██║
      ███╔╝ ███████╗██║     ███████║██╔██╗ ██║
     ███╔╝  ╚════██║██║     ██╔══██║██║╚██╗██║
    ███████╗███████║╚██████╗██║  ██║██║ ╚████║
    ╚══════╝╚══════╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═══╝
   ─▌ A subdomain enumeration tool by Tzero86 ▐─

[*] Loading zScan a quick subdomain scanner, inspired by Joe Helle's python3 series.
[*] Starting to scan netflix.com for valid subdomains...
[!] A total of 45 subdomains will be scanned. Please be patient!
[!] You can press CRTL+C at any time to terminate the scan and save the results.
[*] Scanning: netflix.com |████████████| 45/45 [100%] in 5.0s (9.05/s)
[+] Scan Finished, showing results:
{
  "zScan": {
    "domain_scanned": "netflix.com",
    "total_subdomains_found": "9",
    "scan_start_date": "2022-02-28 17:32:14.729128",
    "scan_end_date": "2022-02-28 17:32:19.781099",
    "subdomains_found": [
      "www",
      "mail",
      "blog",
      "www2",
      "vpn",
      "secure",
      "shop",
      "static",
      "www1"
    ]
  }
}
[+] Results saved to: ./results/netflix.com_zScan_results.json

Install

pip install -r requirements.txt

usage

python zscan.py -sd google.com

See Help & options

python zscan.py -h
zScan is a Subdomain enumeration tool made by Tzero86

optional arguments:
  -h, --help            show this help message and exit
  -sd DOMAIN, --domain DOMAIN
                        Single Domain to enumerate
  -dl DOMLIST, --domlist DOMLIST
                        Custom domain file to use
  -sl SUBLIST, --sublist SUBLIST
                        Custom subdomains file to use
  -o OUTPUT, --output OUTPUT
                        Output file

Features

  • Scan for subdomains based on given domain
  • Save results to a file
  • Scan progress bar
  • Terminate Scan by pressing CRTL+C
  • Support to specify output file to save the results to

Currently working on

  • Support for custom domain and subdomain files

Things to fix or add

  • Add support to specify a file with subdomains
  • Add support to specify a file with domains
  • Add support to limit the number of subdomains to scan
  • TO FIX: When pressing CRTL+C, the scan output on the terminal gets messed up.

I'm going to add a few more features to this, like being able to specify how many subdomains to try. I'll be adding more features as I get the time to do so.

Thanks!

@tzero86

About

A simple and quick subdomain scanner created with python. Supports custom subdomains file, and exporting results into a JSON file.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages