PathBuster is a Python-based directory brute-forcing tool designed to scan a target URL for common directories using a wordlist inspired by Gobuster. It logs valid directories, handles redirects, and provides real-time progress tracking.
- π Fast & Simple: Scans directories from a wordlist efficiently.
- π Handles Redirects: Detects 301/302 and reports them properly.
- π Progress Tracking: Displays scan progress dynamically.
- β³ Timeout Handling: Prevents hanging on slow responses.
- π οΈ Error Logging: Catches and logs request errors.
This tool requires Python 3 and the requests
library. Install dependencies with:
pip install requests
Run the script with a target URL and a wordlist file:
python main.py <wordlist_file>
python main.py common.txt
Then, enter the base URL when prompted:
Enter the base URL: http://example.com
- 200 OK: Valid directory found.
- 301/302 Redirect: Directory redirects.
- 400 Bad Request: Invalid directory request.
- Errors: Logged with the failed directory.
- β Add multi-threading for faster scans.
- β Save valid directories to a log file.
- β Support custom headers for stealth scanning.
Feel free to fork, modify, and improve this tool. PRs are welcome!
This tool is for educational and ethical purposes only. Do not use it on systems without permission.
π Happy Hacking! π οΈ