Skip to content

Commit db09a07

Browse files
authored
Update README.md
1 parent 55c6941 commit db09a07

File tree

1 file changed

+42
-1
lines changed

1 file changed

+42
-1
lines changed

README.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,42 @@
1-
# Directories-enumerator
1+
# Directories Enumerator Project
2+
## Directory Enumerator :
3+
The Directory Enumerator is a Python script that helps you discover directories or paths on a given target website. It utilizes the power of Python's `requests` library to send HTTP requests and determine if the directories exist on the target server.
4+
5+
## Features
6+
- Efficiently enumerates directories on a target URL.
7+
- Lightweight and easy to use.
8+
- Makes use of Python's `requests` library for HTTP requests.
9+
10+
## How to Use
11+
1. **Prerequisites:** Make sure you have Python 3.x installed on your system.
12+
2. **Installation:** No installation is required. Simply download the directory_enumerator.py script and you're good to go!
13+
14+
3. **Usage:**
15+
16+
- Open your terminal or command prompt.
17+
- Navigate to the directory where you saved `directory_enumerator.py`.
18+
- Execute the script using the following command:
19+
```python
20+
python directory_enumerator.py
21+
```
22+
23+
4. **Input:**
24+
- Upon running the script, you will be prompted to provide the target URL you want to enumerate directories on.
25+
- Next, you'll be asked to enter the name of the file containing the directories you wish to check.
26+
27+
5. **Output:**
28+
29+
- The script will start sending requests to the target URL combined with each directory from the specified file.
30+
- If a directory exists on the target server, it will be printed as output, indicating a successful discovery.
31+
32+
6. **Example:**
33+
34+
```Python
35+
[*] Enter Target URL: https://example.com
36+
[*] Enter Name Of The File Containing Directories: directories.txt
37+
[*] Discovered Directory At This Path: https://example.com/admin
38+
[*] Discovered Directory At This Path: https://example.com/images
39+
[*] Discovered Directory At This Path: https://example.com/js
40+
```
41+
# Disclaimer
42+
This script is intended for educational and ethical testing purposes only. Unauthorized access to systems or websites is illegal and unethical. Use this tool responsibly and with proper authorization from the target website's owner.

0 commit comments

Comments
 (0)