Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@RevoltSecurities
RevoltSecurities authored Jan 13, 2024
1 parent c69cafb commit e7f69f2
Showing 1 changed file with 57 additions and 38 deletions.
95 changes: 57 additions & 38 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@ Subdominator is a powerful tool for passive subdomain enumeration during bug hun

```bash

pip install subdominator
git clone https://github.com/sanjai-AK47/Subdominator.git

pip install git+https://github.com/sanjai-AK47/Subdominator.git

subdominator -h

Expand All @@ -27,23 +29,24 @@ subdominator -h

```

### Features Of Subdominator Version1.0.5

- Subdominator resultings logic are improved

- Subdominator supports Output redirection to other tool that means supports oneliners for your Bug Bounty Reconnaissance
### Update to latest version:
```bash
pip install git+https://github.com/sanjai-AK47/Subdominator.git
```

- Any OS users of subdominator can run the subdominator anywhere in their system
### Features Of Subdominator Version1.0.6

- Easy Installation Through pip and also for easy Tools management
- Subdominator OSINT mode has been enhanced and improved which will give more results than previous versions
- Subdominator Supports stdout
- Subdominator notification results are improved


### Oneliners with Subdominator:

Subdominator new features is it supports the onliners with other tools of [projectdiscovery](https://github.com/projectdiscovery) and My other tools [Subprober](https://github.com/sanjai-AK47/Subprober) and [httprober](https://github.com/sanjai-AK47/Httprober) to improver your reconnassaince with efficiently
Subdominator new features is it supports the onliners with other tools of [projectdiscovery](https://github.com/projectdiscovery) and My tools [Subprober](https://github.com/sanjai-AK47) to improver your reconnassaince with efficiently

```bash
subdominator -d apple.com -o subdominator_subdomains.txt -cf | httprober -c 50 | subprober --verbose --title --server --application-type --word-count -c 20 -o subprober.txt --silent
subdominator -d apple.com -o subdominator_subdomains.txt -cf | httprober -c 50 | subprober --verbose --title --server --application-type --word-count -c 20 -o subprober.txt --silent -sp
```

Result Images:
Expand All @@ -67,35 +70,55 @@ subdominator -h

## Subdominator Usage:

``` bash

[DESCRIPTION]: Subdominator is a powerful tool for subdomain enumeration. You can use it with various options to customize your subdomain discovery process.

usage: subdominator.py [-h] [-d DOMAIN] [-dL DOMAINS_LIST] [-nt] [-r] [-vrs] [-cf] [-o OUTPUT]

Subdominator Unleash the Power of Subdomain Enumeration
``` yaml

Options:

[DESCRIPTION]: Subdominator is a subdomain enumeration tool that discovers subdomains by Free ! open source and API resources

-h, --help Show this help message and exit
[USAGE]:

-d DOMAIN, --domain DOMAIN Specify the target domain to find subdomains

-dL DOMAINS_LIST, --domains-list DOMAINS_LIST Provide a filename containing a list of domains to find subdomains

-nt, --notify Notification Send push notifications to your Android Phone or Desktop when Subdominator has finished its process

-r, --recursive Recursive Enumeration Enable recursive enumeration for wildcards in found subdomains

-vrs, --version Version Check for the latest version of Subdominator
subdominator [flags]

[FLAGS]:

-cf, --config Configuration Mode Find subdomains with the configured API keys

-h, --help : This flag will show this help message and exits.

-d, --domain : Specify a domain name for Subdominator to collect subdomains.

-dL, --domains-list : Specify a file name for Subdominator to collect subdomains.

-o, --output : Specify a filename to save the subdomain enumeration results.

-cf, --config : Switching config flag will initiate Subdominator's Config mode (default mode: OSINT).

-nt, --notify : Swtiching notify flag will enable the subdominator to send the results via notification.

-vrs, --version : Switching version flag will show the subdominator current vesion and exits.

-r, --recursive : Switching recursive flag will enumerate the subdomains which has wild cards.

-ske, --show-key-error : Switching this flag will show the api key errors if user didn't give keys or keys usage exhausts.

-sre, --show-req-error : Switching this flag will show the sources which are unable to reach for subdomain enumeraion.

[NOTE]:

-o OUTPUT, --output OUTPUT Specify the filename to save the output
- Subdominator resultings will be Excellent! when your's api key configuration are well

- If you didn't want to run in config mode then don't give -cf or --config flag without API key configurations

- To see the resources for API keys configuration please see here --> https://github.com/sanjai-AK47/Subdominator

- If you have any errors in installation or facing errors in subdominator please report here --> https://github.com/sanjai-AK47/Subdominator

- Hope you like the Subdominator, if you like this open source project 🔥, Then a give a ⭐ here --> https://github.com/sanjai-AK47/Subdominator

- Want to contribute some sources or connect with me? then ping me here --> https://www.linkedin.com/in/d-sanjai-kumar-109a7227b

```

[INFO]: Enabling the notification mode can help you When Subdominator do enumeration for list of domains or in recursive mode
[INFO]: Enabling the notification flag will send the subdominator results via notification


## Dont forget to configure your yaml file with api keys:
Expand All @@ -115,14 +138,14 @@ For PC

Add the extension to your PC with the Pushbullet Extension regarding to your browser

For Phone
For Android | IOS

Install the Pushbullet app on your phone.

Log in using the same email address that you used to log in to your PC !.


### New updated yaml file:
### V1.0.5 yaml file:

```yaml
Virustotal: #Unlimited keys [Note]: Users follow my instruction and syntax as same if u want add 1 or more keys for particular api services for this configuration file and Thankyou!
Expand Down Expand Up @@ -223,7 +246,7 @@ Hunter: #Unlimited keys
```


## New Changes in yaml file
## Example API keys setup:

```yaml
[Note]: Users follow my instruction and syntax as same if u want add 1 or more keys for particular api services for this configuration file and Thankyou!
Expand Down Expand Up @@ -276,10 +299,6 @@ Claim your free API keys here:
- **Netlas**: [Netlas](https://netlas.io/)
- **Leakix**: [Leakix](https://leakix.net/)
- **Redhunt**: [Redhunt](https://https://devportal.redhuntlabs.com/)
### New Api Integrations and Credits:
- **Shodan** : [Shodan](https://shodan.io)
- **HunterHow** : [Hunter](https://hunter.how/)

Expand Down

0 comments on commit e7f69f2

Please sign in to comment.