Skip to content

Commit 9e4ce93

Browse files
authored
Update README.md
1 parent 565895a commit 9e4ce93

1 file changed

Lines changed: 24 additions & 21 deletions

File tree

README.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
![WifiSnare](https://github.com/user-attachments/assets/23dad4db-6bda-4d47-b5af-698ed5451e18)
22

3-
# WifiSnare
3+
# WiFiSnare
44
It capture 2.4GHz WiFi passwords using Evil-Twin attack.
55

66
# Key Features
77
- Simple Setup.
8-
- Set SSID easily for attack.
8+
- Select network easily for eviltwin attack.
9+
- It deauthenticates network parallelly.
910
- LED Status for Right and Wrong Passwords.
10-
- LED Status for checking that victim is connected or not.
1111
- Download captured password on the system in a `.txt` file.
1212

1313
# Supported Board
14-
- It supports NodeMCU ESP8266 Boards only.
14+
- It supports microcontroller boards which contain `ESP8266` chipset only.
1515
- It supports 2.4GHz frequency only.
16-
- If possible, use those NodeMCU ESP8266 boards which contain `CP2102` driver chipset.
16+
- If possible, use those ESP8266 microcontroller boards which contain `CP2102` driver chipset.
1717

1818
# Setup
1919
1. Download Arduino IDE from [here](https://www.arduino.cc/en/software) according to your Operating System.
@@ -22,11 +22,11 @@ It capture 2.4GHz WiFi passwords using Evil-Twin attack.
2222
4. Paste the following link :
2323

2424
```
25-
https://arduino.esp8266.com/stable/package_esp8266com_index.json
25+
https://raw.githubusercontent.com/SpacehuhnTech/arduino/main/package_spacehuhn_index.json
2626
```
2727
5. Click on `OK`.
2828
6. Go to `Tools``Board``Board Manager`.
29-
7. Wait for sometimes and search `esp8266` by `ESP8266 Community`.
29+
7. Wait for sometimes and search `deauther` by `Spacehuhn Technologies`.
3030
8. Simply install it.
3131
9. Wait for sometime and after that it is installed.
3232
10. Restart the Arduino IDE.
@@ -35,16 +35,16 @@ It capture 2.4GHz WiFi passwords using Evil-Twin attack.
3535
# Install
3636
## Via Arduino IDE
3737
1. Download or Clone the Repository.
38-
2. Open the folder and just double click on `WifiSnare.ino` file.
38+
2. Open the folder and just double click on `WiFiSnare.ino` file.
3939
3. It opens in Arduino IDE.
4040
4. Compile the code.
41-
5. Select the correct board from the `Tools``Board``ESP8266 Boards`.
42-
- It is generally `NodeMCU 1.0 (ESP-12E Module)`.
41+
5. Select the correct board from the `Tools``Board``Deauther ESP8266 Boards`.
42+
- It is `NodeMCU`.
4343
6. Select the correct port number of that board.
4444
7. Upload the code.
4545
## Via ESP8266 Flasher
4646
1. Download the NodeMCU ESP8266 Flasher from [here](https://github.com/nodemcu/nodemcu-flasher) according to your operating system.
47-
2. Download the `.bin` file from [here](https://github.com/wirebits/WifiSnare/releases/download/v1.0/WifiSnare.bin).
47+
2. Download the `.bin` file from [here]().
4848
3. Open NodeMCU ESP8266 Flasher.
4949
4. Click on `Advanced` Tab.
5050
5. Click on `Restore Default` button.
@@ -55,17 +55,20 @@ It capture 2.4GHz WiFi passwords using Evil-Twin attack.
5555
9. Click on `Operation` Tab.
5656
10. Click on `Flash(F)` button.
5757
12. Wait for sometimes and when completed, press `RST` button.
58+
5859
# Run the Script
5960
1. After uploading wait 1-2 minutes and after that an Access Point is created named `WiFiSnare` whose password is `wifisnare`.
6061
2. Connect to it.
61-
3. After few seconds, a page automatically opens where ask to enter the exact SSID name to start attack on it.
62-
4. Click on `Start Capture` button.
63-
5. After that, it disconnects the access point and as well as an open access point created with the same SSID name.
64-
6. Connect to that open WiFi.
65-
7. It show a page where it ask for password.
66-
8. Enter the password and click on `Sign Up` button.
62+
3. After few seconds, a page automatically opens where it show a table contain nearby wifi networks.
63+
4. Select the network want to attack.
64+
5. Click on `Start Deauth` button to start deauthentication attack on selected network.
65+
6. Click on `Start EvilTwin` button to start eviltwin attack on selected network.
66+
7. After that, it disconnects the access point and as well as an open access point created with the selected network SSID name.
67+
8. Connect to that open WiFi.
68+
9. It show a page where it ask for password.
69+
10. Enter the password and click on `Continue` button.
6770
- If password is wrong, then led of the board blink `2` times and back to the password page to enter password again.
68-
- If password is right, then led of the board blink `3` times and after `2` seconds it close that open access point and restart the `WiFiSnare` access point.
69-
9. Connnct again to that `WiFiSnare` access point.
70-
10. At the bottom, it shows the password of that SSID and a download button to save the password to the Phone/PC/Laptop in a `.txt` file.
71-
11. Also, to attack on some other SSID, type the exact name and click on `Start Capture` button.
71+
- If password is right, then led of the board blink `3` times and after `3` seconds it stops deauthentication attack, close that open access point and restart the `WiFiSnare` access point.
72+
11. Connnct again to that `WiFiSnare` access point.
73+
12. At the bottom, it shows the password of that SSID and a download button to save the password to the Phone/PC/Laptop in a `.txt` file.
74+
13. Also, to attack on some other SSID, just select the network want to attack and repeat steps from `5` to `12`.

0 commit comments

Comments
 (0)