Skip to content

Passive subdomain enumeration tool in Python. Collects subdomains, resolves DNS, and optionally checks HTTP/HTTPS status.

License

Notifications You must be signed in to change notification settings

pangeran-droid/subenum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

Subenum

Simple Passive Subdomain Enumerator written in Python.

               __                             
   _______  __/ /_  ___  ____  __  ______ ___ 
  / ___/ / / / __ \/ _ \/ __ \/ / / / __ `__ \
 (__  ) /_/ / /_/ /  __/ / / / /_/ / / / / / /
/____/\__,_/_.___/\___/_/ /_/\__,_/_/ /_/ /_/ 
                                              
Simple Subdomain Enumerator


usage: subenum.py [-h] -d DOMAIN [--status]

Overview

Subenum is a lightweight passive subdomain enumeration tool inspired by tools like subfinder.

It collects subdomains from public sources and optionally checks HTTP status codes.

Designed for:

  • Bug bounty recon
  • OSINT
  • Red team reconnaissance
  • Learning passive enumeration techniques

Features

  • Passive subdomain enumeration
  • Multiple data sources:
    • crt.sh
    • dns.bufferover.run
    • hackertarget
  • DNS resolution validation
  • Optional HTTP status check
  • Threaded performance
  • Clean CLI output
  • Pipe-friendly

Installation

Clone the repository:

git clone https://github.com/pangeran-droid/subenum.git
cd subenum
pip install requests

Usage

Basic usage:

python3 subenum.py -d example.com

Output:

api.example.com
dev.example.com
mail.example.com

Show HTTP status codes:

python3 subenum.py -d example.com --status

Output:

api.example.com [200]
dev.example.com [403]
mail.example.com [301]

Pipeline Example

Pipe into other tools:

python3 subenum.py -d example.com | tee subs.txt
python3 subenum.py -d example.com | httpx
python3 subenum.py -d example.com | nuclei -t templates/

Requirements

  • Python 3.8+
  • requests

Disclaimer

This tool is intended for educational purposes and authorized security testing only.

Do not use against systems without proper permission.

License

MIT License

About

Passive subdomain enumeration tool in Python. Collects subdomains, resolves DNS, and optionally checks HTTP/HTTPS status.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages