Skip to content

Itsjustme27/PathBuster

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 

Repository files navigation

PathBuster

PathBuster: A Simple Directory Bruteforcer

Overview

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.

Features

  • πŸš€ 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.

Installation

This tool requires Python 3 and the requests library. Install dependencies with:

pip install requests

Usage

Run the script with a target URL and a wordlist file:

python main.py <wordlist_file>

Example:

python main.py common.txt

Then, enter the base URL when prompted:

Enter the base URL: http://example.com

Output

  • 200 OK: Valid directory found.
  • 301/302 Redirect: Directory redirects.
  • 400 Bad Request: Invalid directory request.
  • Errors: Logged with the failed directory.

To-Do (Future Enhancements)

  • βœ… Add multi-threading for faster scans.
  • βœ… Save valid directories to a log file.
  • βœ… Support custom headers for stealth scanning.

Contributing

Feel free to fork, modify, and improve this tool. PRs are welcome!

Disclaimer

This tool is for educational and ethical purposes only. Do not use it on systems without permission.


πŸš€ Happy Hacking! πŸ› οΈ

About

A directory enumeration tool inspired by Gobuster

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%