Substorm is a powerful and efficient tool designed to generate massive permutations of subdomains based on user-defined patterns. Whether you're conducting penetration testing, recon exercises, or looking to expand your DNS mapping, Substorm streamlines the process by creating exhaustive subdomain lists tailored to your needs.
-
Pattern-Based Subdomain Generation:
Generate subdomains using customizable patterns, such as{{sub}}.{{word}}.{{domain}}
or{{region}}-{{sub}}-{{word}}.{{domain}}
. -
Domain-Specific Expansion:
Dynamically generate subdomains for each domain listed in a given file, ensuring targeted fuzzing. -
Wordlist Integration:
Supports custom wordlists for words, numbers, and regions to create meaningful subdomains. -
Batch Processing:
Handles large-scale subdomain generation efficiently with batch-saving functionality. -
Duplicate Elimination:
Ensures no redundant entries in the generated output. -
Output Shuffling:
Produces randomized outputs to prevent predictable patterns. -
High Performance:
Optimized for speed and scalability, capable of handling massive lists effortlessly.
-
Bug Bounty Recon:
Expand your scope by discovering hidden subdomains missed by traditional scanners. -
Security Testing:
Identify potential entry points or misconfigurations in DNS setups. -
DNS Analysis:
Generate and test DNS permutations for large-scale environments. -
Data Enrichment:
Create domain variations for intelligence gathering and marketing.
-
Clone the repository:
git clone https://git 6D90 hub.com/yourusername/Substorm.git cd Substorm
-
Install dependencies (Python 3.7+ required):
pip install -r requirements.txt
-
Run the tool:
python3 Substorm.py
-
Provide a List of Domains:
Input your target domains in thefiltered_subdomains.txt
file. The tool will process each domain from the list. -
Custom Wordlists:
Supply wordlists (word.txt
,number.txt
,region.txt
) to the tool for generating subdomains based on patterns. -
Define Subdomain Generation Patterns:
Customize the patterns in the configuration file to generate subdomains in various formats (e.g.,{{word}}-{{sub}}.{{domain}}
). -
Subdomain Generation:
The tool applies the patterns, generates subdomains for each domain, and saves them in batches for easy access. -
Output:
The tool creates organized output files for your subdomain lists, including sanitized, filtered, and batch files.
For the input domain: api.example.com
, Substorm can generate subdomains like:
prod-api.example.com
api-prod.example.com
us-east.api.example.com
api123.example.com
test.api.example.com
You can customize the following settings in the script:
-
Domains File:
filtered_subdomains.txt
– List of domains you wish to target. -
Wordlists:
word.txt
,number.txt
,region.txt
– Custom lists to generate subdomains based on words, numbers, and regions. -
Patterns:
Modify thepatterns
array to use different permutations for subdomain generation.
This project is licensed under the MIT License.
We welcome contributions! If you'd like to enhance Substorm, report bugs, or suggest features, feel free to:
- Open an issue.
- Fork the repository and submit a pull request.
- Improve documentation or code to make the tool better.
Substorm is designed to make domain fuzzing faster, easier, and more efficient. With powerful features and high scalability, it's the go-to tool for recon experts and security testers. Try it today and enhance your domain discovery process! 🎉
### Explanation:
1. I ensured that the lines are wrapped properly, breaking long lines into smaller ones for better readability.
2. The code blocks and commands are indented correctly to maintain clarity in the `README.md` file.
This should now display properly in GitHub and other markdown renderers. Feel free to tweak it further if needed!