{"id":34131734,"url":"https://github.com/revoltsecurities/subdominator","last_synced_at":"2026-04-04T13:02:05.347Z","repository":{"id":183470615,"uuid":"670232090","full_name":"RevoltSecurities/Subdominator","owner":"RevoltSecurities","description":"SubDominator helps you discover subdomains associated with a target domain efficiently and with minimal impact for your Bug Bounty","archived":false,"fork":false,"pushed_at":"2026-01-25T05:27:05.000Z","size":1102,"stargazers_count":715,"open_issues_count":3,"forks_count":122,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-25T20:19:20.171Z","etag":null,"topics":["bugbounty","information-gathering","python","reconnaissance","subdomain-enumeration","subdomain-finder","subdomain-gathering","subdomains","subdomains-discovery","subdomains-enumeration"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RevoltSecurities.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-07-24T15:23:44.000Z","updated_at":"2026-01-24T21:38:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"925e876b-5c3b-4682-a686-fe35ba470b21","html_url":"https://github.com/RevoltSecurities/Subdominator","commit_stats":null,"previous_names":["sanjai-ak47/subdominator","revoltsecurities/subdominator"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/RevoltSecurities/Subdominator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RevoltSecurities%2FSubdominator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RevoltSecurities%2FSubdominator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RevoltSecurities%2FSubdominator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RevoltSecurities%2FSubdominator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RevoltSecurities","download_url":"https://codeload.github.com/RevoltSecurities/Subdominator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RevoltSecurities%2FSubdominator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31400460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bugbounty","information-gathering","python","reconnaissance","subdomain-enumeration","subdomain-finder","subdomain-gathering","subdomains","subdomains-discovery","subdomains-enumeration"],"created_at":"2025-12-15T00:59:06.265Z","updated_at":"2026-04-04T13:02:05.330Z","avatar_url":"https://github.com/RevoltSecurities.png","language":"Python","readme":"## Subdominator - Unleash the Power of Subdomain Enumeration\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"img/subdominator-v2.png\" alt=\"Subdominator\" width=\"450px\"\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n**lightweight , fast and more than a passive subdomain enumeration tool**\n\n\u003c/div\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/RevoltSecurities/Subdominator/tree/main#features\"\u003eFeatures\u003c/a\u003e |\n  \u003ca href=\"https://github.com/RevoltSecurities/Subdominator/tree/main#usage\"\u003eUsage\u003c/a\u003e |\n  \u003ca href=\"https://github.com/RevoltSecurities/Subdominator/tree/main#installation\"\u003eInstallation\u003c/a\u003e |\n  \u003ca href=\"https://github.com/RevoltSecurities/Subdominator/tree/main#subdominator-documentation\"\u003eDocumentation\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \n![GitHub last commit](https://img.shields.io/github/last-commit/RevoltSecurities/Subdominator) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/RevoltSecurities/Subdominator) [![GitHub license](https://img.shields.io/github/license/RevoltSecurities/Subdominator)](https://github.com/RevoltSecurities/Subdominator/blob/main/LICENSE)\n\n\u003c/div\u003e\n\n\nSubdominator is a powerful tool for passive subdomain enumeration during bug hunting and reconnaissance processes. It is designed to help researchers and cybersecurity professionals discover potential security vulnerabilities by efficiently enumerating subdomains some various free passive resources.\n\n### Features:\n---\n\n\u003ch1 align=\"center\"\u003e\n        \u003cimg src=\"https://github.com/RevoltSecurities/Subdominator/assets/119435129/2a700962-6868-4a91-a8e8-2210189a4a23\" width=\"700px\"\u003e\n        \u003cbr\u003e\n      \u003c/h1\u003e\n\n   - fast and powerfull to enumerate subdomains.\n   - 50+ passive results to enumerate subdomains.\n   - configurable API keys setup\n   - integrated notification system\n   - local Database support to store data\n   - supports multiple output format (txt|html|pdf|json)\n\n### Yaml Updates:\nWe request existing user to update their config yaml file with new resources by opening the config file in : ```$HOME/.config/Subdominator/provider-config.yaml``` and add the below resources:\n\n```yaml\nbuilwith:\n  - your-api-key1\n  - your-api-key2\n\npassivetotal:\n  - user-mail1:api-key1\n  - user-mail2:api-key2\n\ntrickest:\n  - your-api-key1\n  - your-api-key2\n```\nby these your config yaml file will get updated or else check your yaml file that matches the below mentioned resources with *, The new users will required to update in next version if any new resources added\nin Subdominator.\n\n\n### Usage:\n---\n```code\nsubdominator -h\n```\n```yaml\n              |          |                   _)                |\n  __|  |   |  __ \\    _` |   _ \\   __ `__ \\   |  __ \\    _` |  __|   _ \\    __|\n\\__ \\  |   |  |   |  (   |  (   |  |   |   |  |  |   |  (   |  |    (   |  |\n____/ \\__,_| _.__/  \\__,_| \\___/  _|  _|  _| _| _|  _| \\__,_| \\__| \\___/  _|\n\n\n                     @RevoltSecurities\n\n\n\n[DESCRIPTION]: Subdominator a passive subdomain enumeration that discovers subdomains for your targets using with passive and open source resources\n\n[USAGE]:\n\n    subdominator [flags]\n\n[FLAGS]:\n\n    [INPUT]:\n    \n        -d,   --domain                :  Target domain name for subdomain enumeration.\n        -dL,  --domain-list           :  File containing multiple domains for bulk enumeration.\n        stdin/stdout                  :  Supports input/output redirection.\n\n    [OUTPUT]:\n    \n        -o,   --output                :  Save results to a file.\n        -oD,  --output-directory      :  Directory to save results (useful when -dL is specified).\n        -json, --json                 :  Output results in JSON format.\n        \n    [MODE]:\n    \n        -shell, --shell               :  Enable interactive shell mode to work with subdominator Database,generate report and etc.\n\n    [OPTIMIZATION]:\n    \n        -t,   --timeout               :  Set timeout value for API requests (default: 30s).\n        -fw,  --filter-wildcards      :  Filter out wildcard subdomains.\n\n    [CONFIGURATION]:\n    \n        -cp,  --config-path           :  Custom config file path for API keys (default: /home/sanjai/.config/Subdominator/provider-config.yaml).\n        -cdp, --config-db-path        :  Custom database config path (default: /home/sanjai/.cache/SubdominatorDB/subdominator.db).\n        -nt,  --notify                :  Send notifications for found subdomains via Slack, Pushbullet.\n        -px,  --proxy                 :  Use an HTTP proxy for debugging requests.\n        -dork, --dork                 :  Use a custom google dork for google resource (ex: -ir google --dork 'site:target.com -www -dev intext:secrets')\n\n    [RESOURCE CONFIGURATION]:\n    \n        -ir,  --include-resources     :  Specify sources to include (comma-separated).\n        -er,  --exclude-resources     :  Specify sources to exclude (comma-separated).\n        -all, --all                   :  Use all available sources for enumeration.\n\n    [UPDATE]:\n    \n        -up,  --update                :  Update Subdominator to the latest version (manual YAML update required).\n        -duc, --disable-update-check  :  Disable automatic update checks.\n        -sup, --show-updates          :  Show the latest update details.\n\n    [DEBUGGING]:\n    \n        -h,   --help                  :  Show this help message and exit.\n        -v,   --version               :  Show the current version and check for updates.\n        -s,   --silent                :  Show only subdomains in output.\n        -ski, --show-key-info         :  Show API key errors (e.g., out of credits).\n        -sti, --show-timeout-info     :  Show timeout errors for sources.\n        -nc,  --no-color              :  Disable colorized output.\n        -ls,  --list-source           :  List available subdomain enumeration sources.\n        -V,   --verbose               :  Enable verbose output.\n```\n\n\n### Subdominator Integrations:\n---\n\n**The following API services used by subdominator**:  \n\n- **AbuseIPDB** → [abuseipdb.com](https://abuseipdb.com)  \n- **AlienVault** → [otx.alienvault.com](https://otx.alienvault.com)  \n- **Anubis** → [jldc.me/anubis](https://jldc.me/anubis)  \n- **ARP Syndicate** → [arpsyndicate.io](https://www.arpsyndicate.io/pricing.html)  \n- **BeVigil** → [bevigil.com](https://bevigil.com/login)  \n- **BinaryEdge** → [binaryedge.io](https://binaryedge.io)  \n- **BufferOver** → [tls.bufferover.run](https://tls.bufferover.run/)  \n- **BuiltWith** → [api.builtwith.com](https://api.builtwith.com/domain-api)  \n- **C99** → [subdomainfinder.c99.nl](https://subdomainfinder.c99.nl/)  \n- **Censys** → [censys.com](https://censys.com/)  \n- **CertSpotter** → [sslmate.com/certspotter](https://sslmate.com/certspotter/)  \n- **Chaos** → [chaos.projectdiscovery.io](https://chaos.projectdiscovery.io/)  \n- **CodeRog** → [rapidapi.com/coderog](https://rapidapi.com/coderog-coderog-default/api/subdomain-finder5/pricing)  \n- **CommonCrawl** → [index.commoncrawl.org](https://index.commoncrawl.org/)  \n- **crt.sh** → [crt.sh](https://crt.sh)  \n- **Cyfare** → [cyfare.net](https://cyfare.net)  \n- **Digitorus** → [digitorus.com](https://www.digitorus.com/)  \n- **DigitalYama** → [digitalyama.com](https://digitalyama.com/)  \n- **DNSDumpster** → [dnsdumpster.com](https://dnsdumpster.com/)  \n- **DNSRepo** → [dnsarchive.net](https://dnsarchive.net/)  \n- **Fofa** → [en.fofa.info](https://en.fofa.info/)  \n- **Facebook** → [developers.facebook.com](https://developers.facebook.com/)  \n- **FullHunt** → [fullhunt.io](https://fullhunt.io/)  \n- **Google** → [programmablesearchengine.google.com](https://programmablesearchengine.google.com/controlpanel/create)  \n- **HackerTarget** → [hackertarget.com](https://hackertarget.com/)  \n- **HudsonRock** → [cavalier.hudsonrock.com](https://cavalier.hudsonrock.com)  \n- **HunterMap** → [hunter.how](https://hunter.how/)  \n- **IntelX** → [intelx.io](https://intelx.io/)  \n- **LeakIX** → [leakix.net](https://leakix.net/)  \n- **MerkleMap** → [merklemap.com](https://www.merklemap.com)  \n- **MySSL** → [myssl.com](https://myssl.com)  \n- **Netlas** → [netlas.io](https://netlas.io/)  \n- **Odin** → [odin.io](https://odin.io/)  \n- **Quake** → [quake.360.cn](https://quake.360.cn/)  \n- **Racent** → [face.racent.com](https://face.racent.com)  \n- **RapidAPI** → [rapidapi.com/hub](https://rapidapi.com/hub)  \n- **RapidDNS** → [rapiddns.io](https://rapiddns.io/)  \n- **RedHuntLabs** → [devportal.redhuntlabs.com](https://devportal.redhuntlabs.com/)  \n- **RSECloud** → [rsecloud.com/search](https://rsecloud.com/search)  \n- **SecurityTrails** → [securitytrails.com](http://securitytrails.com/)  \n- **Shodan** → [shodan.io](https://shodan.io)  \n- **ShodanX** → [github.com/RevoltSecurities/Shodanx](https://github.com/RevoltSecurities/Shodanx)  \n- **ShrewdEye** → [shrewdeye.app](https://shrewdeye.app/api)  \n- **SiteDossier** → [sitedossier.com](https://sitedossier.com/)  \n- **ThreatCrowd** → [ci-www.threatcrowd.org](http://ci-www.threatcrowd.org/)  \n- **Trickest** → [trickest.io](https://trickest.io/)  \n- **URLScan** → [urlscan.io](https://urlscan.io/)  \n- **VirusTotal** → [virustotal.com](https://virustotal.com/)  \n- **WaybackArchive** → [archive.org/wayback](https://archive.org/wayback)  \n- **WhoisXML** → [whoisxmlapi.com](https://whoisxmlapi.com)  \n- **ZoomEyeAPI** → [www.zoomeye.hk](https://www.zoomeye.hk/)  \n\n\n### Installation:\n---\n\nEnsure you have **Python 3.12 or later** installed before proceeding with the installation. You can verify your Python version using:  \n\n```bash\npython3 --version\n```  \n\n#### ✅ **Install Subdominator from PyPI** (Recommended)  \nThe easiest way to install Subdominator is via PyPI:  \n\n```bash\npip install --upgrade subdominator\n```  \n\n#### ✅ **Install the Latest Version from GitHub**  \nTo install the latest development version directly from GitHub:  \n\n```bash\npip install --upgrade git+https://github.com/RevoltSecurities/Subdominator\n```  \n\n#### ✅ **Install Using PIPX** (For Isolated Environments)  \nTo avoid dependency conflicts, you can install Subdominator using `pipx`:  \n\n```bash\npipx install subdominator\n```  \n\nTo install the latest version from GitHub with `pipx`:  \n\n```bash\npipx install git+https://github.com/RevoltSecurities/Subdominator\n```  \n\n#### ✅ **Install from Git Source** (For Development)  \nFor users who want to contribute or modify the tool, clone and install directly from source:  \n\n```bash\ngit clone https://github.com/RevoltSecurities/Subdominator.git\ncd Subdominator\npip install --upgrade pip\npip install -r requirements.txt\n```  \n\nAfter installation, you can verify if Subdominator is installed correctly by running:  \n\n```bash\nsubdominator --help\n```\n### **SubDominator Documentation**  \n\nFor complete **post-installation configuration**, **shell interface tutorials**, and **detailed usage instructions**, please refer to the official SubDominator documentation:  \n\n🔗 **[SubDominator Docs](https://subdominator-docs.streamlit.app/)**  \n\n### **What You’ll Find in the Documentation:**  \n✅ **Post Installation Setup** – Configure dependencies, API keys, and environment variables.  \n✅ **Shell Interface Tutorial** – Learn how to use `subdominator -shell` for managing subdomains interactively.  \n✅ **Enumeration Techniques** – Understand how to efficiently discover subdomains.  \n✅ **Exporting \u0026 Reporting** – Generate reports in TXT, JSON, HTML, or PDF formats.  \n✅ **Advanced Features \u0026 Flags** – Explore additional functionalities to enhance subdomain enumeration.  \n\nFor the best experience, ensure you follow the latest updates in the documentation! 🚀\n\n### Security:\n---\n\nSubdominator is a promising tool that will never cause any threats to users or security researcher and its safe to use. Even without\nUsers permissions subdominator will not update itself and I welcome everyone who are intrested  contribute for Subdominator can create\ntheir issues and report it.\n\n\n\n### License:\n---\nSubdominator is built by [RevoltSecurities](https://github.com/RevoltSecurities) Team with ❤️ and your support will encourage us to improve the `subdominator` more and Community contributors are\nWelcome  to contribute for subdominator and If you love the `subdominator` support it by giving a ⭐ .\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevoltsecurities%2Fsubdominator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frevoltsecurities%2Fsubdominator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevoltsecurities%2Fsubdominator/lists"}