/Directory-Brute-Forcer

A simple Python script for brute-forcing directories using a wordlist.

Primary LanguagePythonMIT LicenseMIT

Directory Brute Forcer v1.0

A simple Python tool to brute-force directories on a target website using a customizable wordlist.

This script allows penetration testers and bug bounty hunters to check for hidden or unlinked directories on a target web server.

⚙️ How to Use

  1. Clone the repository:

    git clone https://github.com/Vigil5153/Directory-Brute-Forcer.git

  2. Install the required dependencies: This script requires requests to be installed. You can install it using:

    pip install requests

    Alternatively, install all dependencies from the requirements.txt file:

    pip install -r requirements.txt

  3. Run the script: Run the script and provide the target URL and a wordlist (or use the default wordlist included in the repo):

    python brute_force.py

  4. Example Usage:

    Enter the target URL (e.g., http://example.com): http://testphp.vulnweb.com
Enter the path to your wordlist (default: wordlist.txt): wordlist2.txt - Or leave blank to use wordlist.txt

📝 Customizing the Wordlist

The tool comes with a default wordlist (wordlist.txt) which contains common directory names. You can modify this file or provide your own wordlist. Make sure each directory name is on a new line. Example entries:

admin
login
dashboard
images
etc..

Simply edit the wordlist.txt file to suit your needs or point the tool to another wordlist file.

You can find the default wordlist here.

📄 Example Output

Starting directory brute force on: http://example.com
[+] Scan complete! Found directories:
[+] http://example.com/admin
[+] http://example.com/login
[-] No directories found or directories are hidden.

🚨 Important Notes:

  • Make sure you have permission before testing any web servers.
  • Use responsibly and ethically.

🤝 Contributions and Updates

  • Pull Requests: Feel free to open a pull request if you want to contribute improvements, features, or fixes.
  • Issues: Open an issue if you find bugs or want to request new features.
  • Updates: This tool will be updated periodically. Stay tuned for new features and improvements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.