Skip to content
/ subfree Public

Your subdomains are free for the taking - no API key, no mistaking! ๐Ÿ•บ

License

Notifications You must be signed in to change notification settings

sl4x0/subfree

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

22 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Subfree

Subfree is a tool that allows you to fetch subdomains using free open API resources without the need for an API key. This tool is ideal for those who are just starting with subdomain enumeration and do not have access to expensive tools or resources.

Buy me a coffee

Installation

Subfree can be installed using Git. Simply run the following command:

git clone https://github.com/sl4x0/subfree.git
cd subfree
chmod +x subfree.sh

Usage

To use Subfree, simply run the following command:

./subfree.sh <domain>

Replace with the domain you want to enumerate subdomains for.

Subfree uses free open API resources to fetch subdomains. This means that there is a limit to the number of subdomains that can be fetched per day. If you encounter any issues with the tool, please try open an issue.

You can use this tool as a function inside your automation script, eg:

function subfree(){
 # Input validation
    if [ $# -ne 1 ] || ! echo "$1" | grep -E '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9])\.([a-zA-Z]{2,})$' >/dev/null; then
        echo "Usage: $0 <domain>"
        exit 1
   ....
   ....
   ....
    echo "๐ŸŽ‰ The subdomains have been saved to subfree.txt"

    # Clean up the temporary directory
    rm -r "$tmp_dir"
}

#Enumerate subdomains using Subfree
echo "๐Ÿ” Enumerating subdomains using Subfree..."
subfree "$domain"
cat subfree.txt > "$SUBDOMAINS_DIR/subfree.txt"
rm -rf subfree.txt
echo "โœ… Done with Subfree enumeration."

Keep updated

git pull

Contribution

You can contribute by suggest a new free API provider to fetch subdomains from! Just fork it.

Credits

Subfree was inspired by a variety of open-source subdomain enumeration tools, including OneForAll and Sublist3r.

To-do โœ…

  • Adding More Resources
  • Overall Improvments

About

Your subdomains are free for the taking - no API key, no mistaking! ๐Ÿ•บ

Topics

Resources

License

Stars

Watchers

Forks