Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cbfelix/wifispam
A bash script for executing Wi-Fi SSID attacks with options to use custom SSID lists or generate random SSIDs, featuring automated interface setup and cleanup.
https://github.com/cbfelix/wifispam
bash cybersecurity hacking hacking-tools network-security shell shell-script spam spamming-tool wifi wifi-hacking wifispam
Last synced: 24 days ago
JSON representation
A bash script for executing Wi-Fi SSID attacks with options to use custom SSID lists or generate random SSIDs, featuring automated interface setup and cleanup.
- Host: GitHub
- URL: https://github.com/cbfelix/wifispam
- Owner: cbFelix
- License: mit
- Created: 2024-10-07T15:26:15.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-10-21T13:11:44.000Z (28 days ago)
- Last Synced: 2024-10-21T20:52:08.912Z (28 days ago)
- Topics: bash, cybersecurity, hacking, hacking-tools, network-security, shell, shell-script, spam, spamming-tool, wifi, wifi-hacking, wifispam
- Language: Shell
- Homepage:
- Size: 13.7 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wi-Fi SSID Attack Script
A bash script for executing Wi-Fi SSID attacks with options to use custom SSID lists or generate random SSIDs, featuring automated interface setup and cleanup.
## Features
- Automates Wi-Fi SSID attacks using MDK3
- Supports custom SSID lists or random SSID generation
- Handles interface setup (monitor mode) and teardown (managed mode)
- Automatic error logging and system cleanup after execution
# Changelogs
## v1.1.0 - 09.10.2024
- Dependency Checks: Added validation for required tools (mdk3, macchanger, etc.).
- Interface Validation: Ensures selected interface is wireless and active.
- Error Handling: Improved error messages for easier troubleshooting.
- MAC Change Verification: Added check to confirm successful MAC address change.
- Cleanup: Enhanced post-attack cleanup to restore original settings.
# Disclaimer
This project is intended for educational and research purposes only. The use of this script for any illegal activities, including unauthorized access to wireless networks, is strictly prohibited. It is your responsibility to ensure that you have permission to test or attack any network you are targeting.
**Note:** In many countries, performing Wi-Fi attacks without explicit permission is illegal and can result in severe penalties, including fines and imprisonment. By using this script, you acknowledge that you understand the laws in your country regarding network security and will not use this script for any unlawful purposes.
The authors of this project will not be held responsible for any misuse or damage caused by this script. Use it at your own risk.
## Installation
1. Clone this repository:
```bash
git clone https://github.com/cbFelix/wifispam.git
cd wifispam
```
2. Install the required dependencies:
```bash
sudo apt update
sudo apt install -y mdk3 macchanger pwgen
```
## Usage
1. Navigate to the project directory:
```bash
cd wifispam
```
2. Make the script executable:
```bash
chmod +x wifispam.sh
```
3. Run the script:
```bash
sudo ./wifispam.sh
```
4. Follow the on-screen prompts to either:
- Use a predefined SSID list, or
- Generate random SSIDs for the attack.
## Dependencies
The script relies on the following utilities:
- **MDK3**: Used for conducting the SSID attacks.
- Repository: [https://github.com/wi-fi-analyzer/mdk3-master](https://github.com/wi-fi-analyzer/mdk3-master)
- **MacChanger**: For changing and restoring MAC addresses.
- Repository: [https://github.com/alobbs/macchanger](https://github.com/alobbs/macchanger)
- **Pwgen**: Used for generating random SSIDs.
- Repository: [https://github.com/tytso/pwgen](https://github.com/tytso/pwgen)
## Project Structure
```bash
wifispam.sh # Main script
wifi_test.log # Log file generated during script execution
RANDOM_wordlist.txt # Temporary file storing generated SSIDs (if applicable)