Skip to content

D3Ext/WEF

Repository files navigation

WEF

WiFi Exploitation Framework

Coded with 💙 by D3Ext

IntroductionAttacksFeaturesInstallationUsage


README in spanish

Introduction

This tool is designed for security researchers and penetration testers to analyze and exploit vulnerabilities in Wi-Fi networks. It provides an intuitive interface with a wide range of automated and manual attack techniques to test WPA/WPA2, WPS, and WEP security. With support for both 2.4 GHz and 5 GHz networks, detailed logging and customizable attack options, it offers flexibility for different testing scenarios. This is not a professional tool.

If you find an error, please open an issue (you can write it in english or spanish, as you want).

Supported attacks

  • DoS (optional handshake capture):
    • Deauthentication attack
    • WIDS Confusion attack
    • Authentication attack
    • Beacon Flood attack
    • TKIP attack (Michael Shutdown Exploitation)
  • WPS:
    • Pixie Dust attack
    • PIN Bruteforce attack
    • Null Pin attack
  • WEP:
    • ARP Replay attack
    • HIRTE attack
    • Caffe Latte attack
    • Fake Authentication attack
  • Handshake:
    • WPA handshake capture (without deauth)
    • PMKID attack (clientless)
    • Pwnagotchi mode
  • Rogue AP:
    • Evil Twin attack
      • BSSID spoofing
      • Karma mode
      • Enterprise WPA supported
      • Deauth supported
  • Other attacks:
    • Automatic attack mode (Auto PWN)
    • WPA3 dictionary attack

All the mentioned attacks/techniques are explained here on the Wiki

Features

This are some of the most notable features:

☑️ WPA/WPA2, WPS, WEP, Rogue-AP, and Handshake Attacks

☑️ Automatic attack mode based on the features of the AP

☑️ Automatic handshake capture

☑️ Online and offline handshake cracking

☑️ Simple login template for Evil Twin attack (different languages)

☑️ Enable/disable monitor mode and view information about the network interface (frequencies, chipset, MAC...)

☑️ 2.4 GHz and 5 GHz supported

☑️ Informative reports using HTML templates

☑️ English and spanish supported

Installation

As root

git clone https://github.com/D3Ext/WEF
cd WEF
bash wef

Take a look at the Wiki where I have more info about the installation

Uninstallation

Simply execute this:

rm -rf /usr/share/wef \
  /usr/bin/wef

Usage

Common usage of the framework (your interface may have other name)

wef -i wlan0

Help panel

 __      _____ ___
 \ \    / / __| __|
  \ \/\/ /| _|| _|
   \_/\_/ |___|_|

[WEF] WiFi Exploitation Framework 1.5

[*] Interfaces:
    wlan0
    ens33

Required parameters:
    -i, --interface)    The name of your network adapter interface in managed mode

Optional parameters:
    -h, --help)         Show this help panel
    --version)          Print the version and exit

See here for more information about how to use the tool and other related topics

Demo

TODO

  • Online cracking (WPA-SEC)
  • WPA3 dictionary attack
  • Enhanced reports using HTML
  • Modify regulatory domain to change txpower
  • More languages added as Evil Twin templates
  • Randomize MAC address automatically during launch
  • General improvement and minor fixes
  • Bugs fixed
  • Auto-exploit mode
  • APs scan now shows if WPS is enabled without wash
  • Path autocompletion supported
  • Better output logging
  • Better code readability (code optimized)
  • Add vendor logo to Evil Twin templates on the fly
  • MAC vendors have been updated and optimized using official OUI list
  • Test compatibility with others OS
  • In-depth testing of implemented features

Contributing

See CONTRIBUTING.md

Changelog

See CHANGELOG.md

Credits

Thanks to ultrazar and ErKbModifier

References

https://github.com/aircrack-ng/aircrack-ng
https://github.com/aircrack-ng/mdk4
https://github.com/v1s1t0r1sh3r3/airgeddon
https://github.com/FluxionNetwork/fluxion
https://github.com/P0cL4bs/wifipumpkin3
https://github.com/s0lst1c3/eaphammer
https://github.com/derv82/wifite2
https://github.com/wifiphisher/wifiphisher
https://github.com/ZerBea/hcxtools
https://github.com/ZerBea/hcxdumptool
https://github.com/Tylous/SniffAir
https://github.com/blunderbuss-wctf/wacker
https://github.com/evilsocket/pwnagotchi
https://github.com/koutto/pi-pwnbox-rogueap
https://github.com/koutto/pi-pwnbox-rogueap/wiki/01.-WiFi-Basics

Disclaimer

The creator has no responsibility for any kind of illegal use of the project.

License

This project is under MIT license

Copyright © 2025, D3Ext

About

Wi-Fi Exploitation Framework

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Contributors 6