📡 Bat-WiFi-Forcer

Educational WiFi Security Testing Tool - Built with Batch Scripting

⚠️ LEGAL DISCLAIMER: This tool is for educational purposes only. Unauthorized access to computer networks is illegal. Use only on networks you own or have explicit permission to test.

🌟 Overview

Bat WiFi-Forcer is a proof-of-concept WiFi security testing tool written entirely in Windows Batch script. It demonstrates how basic brute-force concepts work while emphasizing ethical hacking principles.

🚀 Features

• 🔍 Network Scanning - Discover available WiFi networks
• 🖥️ Interface Management - Select from multiple WiFi adapters
• 📋 Wordlist Support - Custom password dictionary attacks
• 🎯 Target Selection - Choose specific networks to test
• 📊 Progress Tracking - Real-time attack progress monitoring
• 📝 Logging - Detailed activity logs and results
• 🎨 Color Interface - Beautiful terminal colors and formatting

🛡️ Ethical Use

✅ Allowed Uses:

• Testing your own home networks
• Educational demonstrations
• Security research with permission
• Learning about WiFi security

❌ Prohibited Uses:

• Unauthorized network access
• Testing networks without permission
• Malicious activities
• Illegal hacking attempts

📦 Installation

# Clone the repository git clone https://github.com/voltsparx/Bat-WiFi-Forcer.git

Navigate to directory

cd batch-wifi-bruteforcer

Run the tool (as Administrator)

wififorcer.bat

🎮 Usage Examples

# Scan for available networks bruteforcer$ scan

Set custom wordlist

bruteforcer$ wordlist C:\path\to\your\wordlist.txt

Set attempt counter

bruteforcer$ counter 10

Start attack

bruteforcer$ attack

Show help

bruteforcer$ help

🛠️ Requirements

Component	Requirement
🖥️ OS	Windows 7/8/10/11
⚡ Privileges	Administrator Rights
📡 Hardware	WiFi Adapter
🔧 Tools	netsh, wmic commands

📁 File Structure

batch-wifi-bruteforcer/ ├── 📄 wififorcer.bat # Main batch script ├── 📄 wordlist.txt # Default password dictionary ├── 📄 wifi_attack.log # Activity logs ├── 📄 wifi_results.txt # Successful results ├── 📄 README.md # This documentation └── 📄 LICENSE # MIT License

⚡ Quick Start

1. Run as Administrator - Right-click → "Run as administrator"
2. Accept Terms - Read and accept the ethical use agreement
3. Scan Networks - Use scan command to find targets
4. Select Target - Choose a network from the scan results
5. Configure - Set wordlist and attempt counter if needed
6. Attack - Start testing with attack command
7. Review Results - Check logs and results files

🔧 Configuration

Custom Wordlists

Create your own wordlist file or use popular ones like:

• RockYou.txt
• Common passwords lists
• Custom dictionary files

Settings

• counter - Set connection attempt timeout
• wordlist - Specify custom password file
• interface - Select WiFi adapter

📊 Output Files

File	Description
wifi_attack.log	Detailed timestamped activity log
wifi_results.txt	Successful password findings
session_state.txt	Saved session configuration

⚠️ Limitations

This is an educational tool with several limitations:

• ⏰ Slow performance - Batch scripting is not optimized for speed
• 📶 Online attacks only - No offline password cracking
• 🔒 WPA2 only - Doesn't support WPA3 or enterprise networks
• 📱 Basic functionality - Simplified security testing
• 🛡️ No stealth - Attacks are easily detectable

🤝 Contributing

We welcome contributions! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Voltsparx

• GitHub: @voltsparx
• Email: voltsparx@gmail.com
• Website: More Projects

⭐ Support

If you find this project useful, please give it a star on GitHub!

⭐ Star on GitHub 🔱 Fork Project 🐛 Report Issues

---

Made with 💻 and ❤️ for educational purposes