Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/calc1f4r/async-dirbuster

🔒A Python script for efficiently brute-forcing directories and files on a target website using asynchronous programming with aiohttp. It supports custom headers, status code filtering, response size matching, and more.
https://github.com/calc1f4r/async-dirbuster

aiohttp asynchronous-programming directory-busting

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/calc1f4r/async-dirbuster
Owner: calc1f4r
License: apache-2.0
Created: 2023-07-13T15:45:20.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-08-04T13:44:40.000Z (over 1 year ago)
Last Synced: 2023-08-04T14:52:51.843Z (over 1 year ago)
Topics: aiohttp, asynchronous-programming, directory-busting
Language: Python
Homepage:
Size: 18.6 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: readme.md
- License: LICENSE

Awesome Lists containing this project

README

### 🔥 Asynchronous Directory Buster

#### ⚡ Description
Asynchronous Directory Buster is a Python script that allows you to efficiently perform directory and file brute-forcing on a target website. The script leverages the power of asynchronous programming with aiohttp to perform multiple HTTP requests simultaneously, making the process faster and more efficient.

https://github.com/calc1f4r/Async-DirBuster/assets/74751675/f303d142-97ce-4547-836f-56dda47879e6

##### 💣 Key Features

- Asynchronous HTTP requests for improved speed.
- Customizable User-Agent and HTTP headers.
- Ability to follow redirects.
- Filter and match HTTP status codes.
- Filter and match response sizes.
- Output results to a file.
- Custom wordlist support.

##### 🧾 Requirements

```python
pip install aiohttp beautifulsoup4 termcolor
```

##### Usage

**📌 Basic one**

```python
python directory_buster.py -u -w
```

**📌 Other examples**

_Custom Header_

```python
python directory_buster.py -u https://example.com -w wordlist.txt -H 'Authorization: Bearer token'
```

_Extensions_

```python
python directory_buster.py -u https://example.com -w wordlist.txt -x php asp
```

_Saving results to the file_

```python
python directory_buster.py -u https://example.com -w wordlist.txt -o output.txt
```

##### Supported flags

- -x : Specify a list of file extensions to append to the directories in the wordlist (e.g., -x php asp).
- -r: Follow redirects. If this flag is set, the script will follow HTTP redirects (3xx status codes).
- -H : Specify custom HTTP headers in the format 'Header1: value1' 'Header2: value2'.
- -a : Set a custom User-Agent string. The default is directorybuster/1.0.
- -ht: Hide response title in output.
- -m c : Include status codes to match, separated by space (e.g., -m c 200 404).
- -ms : Match response sizes, separated by space.
- -fc : Filter status codes, separated by space (default is filtering 404).
- -fs : Filter response sizes, separated by space.
- -o : Path to the output file to save the results

##### 🔴 Note

- Matching and Filtering Response Length together is not available at the moment. Choose one of them in the command-line arguments.
- Matching and Filtering Response Status Code together is not available at the moment. Choose one of them in the command-line arguments.

#### Contributions

Contributions are welcome! If you find a bug or have suggestions for improvements, feel free to open an issue or submit a pull request.

Happy directory busting!