Skip to content

Commit 78ca86f

Browse files
committed
New README.md
1 parent aeabaef commit 78ca86f

File tree

1 file changed

+41
-30
lines changed

1 file changed

+41
-30
lines changed

README.md

Lines changed: 41 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,62 @@
1-
# FORMS HUNTER
1+
# ✨ Funter - Forms Hunter
2+
3+
Funter tool extract all forms and inputs found in a list of urls.
4+
5+
## ⭐ Features
6+
7+
## 💥 Key Benefits
8+
9+
10+
# 💻 Install
211

3-
This tool hunts all forms and inputs found in a list of urls.
412

513
## Virtual environment
614

7-
To create a python virtual environment:
815
```
916
sudo apt install python3-venv
17+
```
18+
19+
To create a python virtual environment:
20+
```
1021
python3 -m venv venv
1122
source venv/bin/activate
12-
python3 -m pip install -r setup/requirements.txt
23+
python3 -m pip install -r requirements.txt
1324
```
1425

1526
## Setup
1627

1728
Install requirements:
1829
```
19-
cd setup
20-
chmod +x setup.sh
21-
sudo bash setup.sh
30+
chmod +x setup/setup.sh
31+
sudo bash setup/setup.sh
2232
```
2333

24-
## Execution
34+
# 🎓 Usage
2535

2636
First start the docker database server:
2737
```
2838
cd setup
2939
sudo bash server.sh
3040
```
3141

32-
3342
### Example 1 - Url
3443

3544
```
36-
python3 formshunter.py -r -u https://www.google.com -o outputs/output.csv -v
45+
python3 funter.py -u https://www.google.com -o outputs/output.csv -v
3746
```
3847

39-
- -r: Reset database
40-
- -U: Search forms on url.
41-
- -o: Dump 'form' document ("table") to CSV file.
42-
- -v: Verbose.
43-
44-
45-
![Command output](/images/formhunter_url_example.png)
46-
4748
### Example 2 - File with list of urls
4849

4950
```
50-
python3 formshunter.py -r -U data/urls.txt -o outputs/output.csv -v
51+
python3 funter.py -U data/urls.txt -o outputs/output.csv -v
5152
```
5253

53-
- -r: Reset database
54-
- -U: Search forms on urls within urls.txt
55-
- -o: Dump 'form' document ("table") to CSV file.
56-
- -v: Verbose.
57-
58-
![Command output](/images/formhunter_file_example.png)
59-
6054
### Example 3 - Just reset database
6155

6256
```
63-
python3 formshunter.py -r
57+
python3 funter.py -r
6458
```
6559

66-
- -r: Reset database
67-
6860
## Tool options
6961

7062
Directory | Description
@@ -85,7 +77,26 @@ DB credentials in project `.env` file.
8577

8678
![Database data](/images/database_data.png)
8779

88-
# Social
80+
81+
# 🛠️ Configuration
82+
83+
You can change the output formats and other settings through the [config.yaml](config%2Fconfig.yaml) file.
84+
85+
86+
# 💬 Change Log
87+
88+
- **25/06/2023** - XNP v1.0.0
89+
- New tool name "Funter".
90+
- New "config.yaml" file configuration.
91+
- Refactored code.
92+
- Added a module for automatic version checking and updating. XtremeNmapParser will now check if it's running the latest version at startup and update itself if a new version is available.
93+
94+
95+
# 📜 License
96+
97+
This project is licensed under the MIT License. See [LICENSE](LICENSE) for more information.
98+
99+
# 🎉 Let's Get Social!
89100

90101
* **Website:** [https://xtormin.com](https://xtormin.com)
91102
* **Linkedin:** [https://www.linkedin.com/in/xtormin/](https://www.linkedin.com/in/xtormin/).

0 commit comments

Comments
 (0)