Find new subdomains of different bug bounty programs from Chaos.
git clone https://github.com/heydc7/newsubs.git
cd newsubs
pip3 install -r requirements.txt
python3 newsubs.py -h
newsubs.py [-h] {show,fetch,compare,difference,union}
Find new subdomains
positional arguments:
{show,fetch,compare,difference,union}
show Show program list from Chaos
fetch Fetch subdomains from a program
compare Compare subdomains of a program
difference List uncommon items from files
union Combine both files uniquely
options:
-h, --help show this help message and exit
"newsubs" offers several commands to assist in subdomain discovery. Here's an overview of the available commands:
newsubs.py <command> -h
The show command displays a list of all Bug Bounty programs available on Chaos. You can optionally filter the programs using the -g flag and save the output to a file using the -o flag:
newsubs.py show [-h] [-g GREP] [-o OUTPUT]
options:
-h, --help show this help message and exit
-g, --grep Filter programs using grep
-o, --output Output file name/path
For example, to find programs related to Sony, you can use:
newsubs.py show -g sony
The fetch command downloads subdomains associated with a specific Bug Bounty program from Chaos. You'll need to provide the index number of the program using the -i
flag:
newsubs.py fetch [-h] -i INDEX
options:
-h, --help show this help message and exit
-i, --index Index number of the program
This command will create a new directory for the program within the data/ folder, using the current date as the folder name. It stores the fetched subdomains in this directory.
newsubs.py fetch -i 608
The compare command helps you compare different versions of subdomain folders fetched for a program. It identifies and displays new subdomains between two versions:
newsubs.py compare [-h] -p PROGRAM -f1 FILE1 -f2 FILE2 [-o OUTPUT]
options:
-h, --help show this help message and exit
-p, --program Name of program
-f1, --file1 Old folder name/path
-f2, --file2 New folder name/path
-o, --output Output file name/path
For example, to compare archived versions of the "Sony" program fetched on different dates:
newsubs.py compare -p sony -f1 2023-09-25 -f2 2023-09-28
The difference command is used to find uncommon items (subdomains) between two files:
newsubs.py difference [-h] -f1 FILE1 -f2 FILE2 [-o OUTPUT]
options:
-h, --help show this help message and exit
-f1, --file1 Old file name/path
-f2, --file2 New file name/path
-o, --output Output file name/path
This command can be handy when performing subdomain recon to identify changes between two sets of subdomains.
newsubs.py difference -f1 amass.txt -f2 subfinder.txt
The union command combines the contents of two files into a single file, retaining unique values:
newsubs.py union [-h] -f1 FILE1 -f2 FILE2 [-o OUTPUT]
options:
-h, --help show this help message and exit
-f1, --file1 First file name/path
-f2, --file2 Second file name/path
-o, --output Output file name/path
This command is useful for merging subdomains obtained from different sources or tools.
newsubs.py union -f1 amass.txt -f2 subfinder.txt