Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
blue0x1 authored Mar 28, 2023
1 parent a8ba489 commit 5de7bf5
Showing 1 changed file with 45 additions and 6 deletions.
51 changes: 45 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,38 @@
<h1 align="center">Arescan: Advanced Directory Discovery Tool</h1>

<br>Arescan is a powerful web directory discovery tool that helps you uncover hidden directories and links on any website. By performing a breadth-first search, it efficiently scans websites and collects useful information that can be utilized for web security assessment, bug bounty hunting, or simply discovering new pages.
<br>
Arescan is a powerful web directory discovery tool that helps you uncover hidden directories and links on any website. By performing a breadth-first search, it efficiently scans websites and collects useful information that can be utilized for web security assessment, bug bounty hunting, or simply discovering new pages.

## Features

- Accelerated scanning performance
- Stealth capabilities
- Accelerated scanning performance with multi-threading
- Stealth capabilities with randomized user agents
- Comprehensive link examination
- Robust connection security
- Advanced HTML processing
- Advanced HTML processing with Beautiful Soup 4
- Customizable wordlists
- Supports pausing the search and saving progress.
- Output to a file for easy post-processing
- Python 3 optimization

## Changelog

### v1.1

- Added multi-threading support for faster scanning
- Added support for custom wordlists
- Supports the ability to pause and resume the search process.
- Fixed a bug when using a wordlist

### v1.0

- Initial release

## Requirements

- Python 3.x
- Beautiful Soup 4
- Requests



## Installation <br>
Expand Down Expand Up @@ -38,8 +60,25 @@ Replace <url> with the base URL of the website you want to scan.
``` bash
python3 Arescan.py https://example.com
```
## Advanced Options

python3 Arescan.py <url> [-w <wordlist>] [-o <output>]


``` bash

python3 Arescan.py https://example.com -w path/to/wordlist.txt -o output.txt


<url> : The base URL to search.
-w <wordlist> (optional): Path to the wordlist file.
-o <output> (optional): Path to the output file.

```

## Output <br>
Arescan will print discovered URLs with their corresponding HTTP status codes. Once the scan is complete, it will display a list of all found URLs within the target domain.<br>
Arescan will print discovered URLs with their corresponding HTTP status codes. Once the scan is complete, it will display a list of all found URLs within the target domain. If an output file is specified, the found URLs will be saved in the file.
<br>

## License <br>
Arescan is released under the MIT License. See the [LICENSE](https://github.com/blue0x1/Arescan/blob/main/LICENSE) file for details.<br>
Expand Down

0 comments on commit 5de7bf5

Please sign in to comment.