Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trident09/simple-dns-tooling
A powerful Python CLI tool for DNS record enumeration across multiple types (A, AAAA, MX, NS, TXT, and more) and for discovering subdomains using a custom list. Featuring colorful output with ASCII art, live enumeration progress animation, and easy output handling with text files for efficient domain analysis and reconnaissance.
https://github.com/trident09/simple-dns-tooling
dns enumeration network reconnaissance subdomain
Last synced: 9 days ago
JSON representation
A powerful Python CLI tool for DNS record enumeration across multiple types (A, AAAA, MX, NS, TXT, and more) and for discovering subdomains using a custom list. Featuring colorful output with ASCII art, live enumeration progress animation, and easy output handling with text files for efficient domain analysis and reconnaissance.
- Host: GitHub
- URL: https://github.com/trident09/simple-dns-tooling
- Owner: Trident09
- Created: 2024-04-17T06:47:51.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-06-07T04:13:12.000Z (5 months ago)
- Last Synced: 2024-06-07T05:26:28.813Z (5 months ago)
- Topics: dns, enumeration, network, reconnaissance, subdomain
- Language: Python
- Homepage:
- Size: 37.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DNS Enumeration and Subdomain Scanning Tool
This tool helps you perform DNS enumeration for a given domain and discover valid subdomains from a list provided in a file named `subdomains.txt`.
## Features
- DNS record enumeration for multiple types, including A, AAAA, MX, NS, TXT, and others.
- Subdomain discovery using a list from a user-provided text file.
- ASCII art and colorful CLI output for an enhanced user experience.
- Enumeration progress animation.
## Prerequisites
To run this script, you will need Python 3.x installed on your system.
It's recommended to use a virtual environment to manage the Python package dependencies and isolate them from your system's global Python environment.
To create and activate a virtual environment, follow these steps:
On macOS and Linux:
```bash
python3 -m venv venv
source venv/bin/activate
```
On Windows:
```bash
python -m venv venv
venv\Scripts\activate
```
After activating the virtual environment, install the required Python packages using the provided requirements.txt file with the following command:
```bash
pip install -r requirements.txt
```
This command will automatically install all the packages listed in `requirements.txt`, which should contain:
```
dnspython==2.1.0
colorama==0.4.4
pyfiglet==0.8.post1
```
## Usage
Run the script by passing the target domain as a command-line argument:
```bash
python3 dns_enum.py example.com
```
Make sure you have a file named `subdomains.txt` in the same directory as the script, with one subdomain per line. The script will attempt to resolve each subdomain for the A record and print the valid ones to the console, as well as save them to an output file named `_valid_subdomains.txt`.
### Options
- ``: The domain for which you want to perform DNS enumeration and subdomain scanning. It should be a valid domain formatted as `example.com`.
## Output
The script generates two types of output:
1. Console output with the DNS enumeration results and valid subdomains highlighted in green.
2. A file named `_valid_subdomains.txt` containing all valid subdomains discovered during the scan.
## Interruption
If you need to stop the script, use `Ctrl+C`. The script will handle the interrupt and exit gracefully.
## Disclaimer
This tool is for educational and ethical testing purposes only. Users are responsible for abiding by applicable laws and regulations. The creator is not liable for misuse or any illegal activities performed with the tool.
## License
[MIT License](LICENSE.md)
## Author
[Trident09](https://github.com/Trident09) - [LinkedIn](https://linkedin.com/in/codetrident)