deepbugs / airgeddon Goto Github PK

#airgeddon This is a multi-use bash script for Linux systems to audit wireless networks.

#Features

• Interface mode switcher (Monitor-Managed).
  
• DoS over wireless networks with different methods.
  
• Assisted Handshake file capture.
  
• Cleaning and optimizing Handshake captured files.
  
• Offline password decrypt on WPA/WPA2 captured files (dictionary and bruteforce).
  
• Compatibility with many Linux distros (see requirements section).
  
• Easy targeting and selection in every section.
  
• Controlled Exit. Cleaning tasks and temp files. Option to keep monitor mode if desired.
  
• Multilanguage support and autodetect OS language feature (see supported languages section).
  
• Help hints in every zone/menu for easy use.
  
• Autoupdate. Script checks for newer version if possible.
  

#Requirements Bash version 4 or later needed.

We say a distro is a 100% compatible Linux distro if it has installed by default all the essential tools script needs to work.

Tested on these 100% compatible Linux distros:
-Kali. 2.0 and 2016.1
-Wifislax. 4.11.1 and 4.12
-Backbox. 4.5.1
-Parrot. 2.2.1
-Blackarch 2016.01.10
-Cyborg Hawk 1.1

Anyway, can be used with any Linux distro if you have installed the tools what script needs. The script checks for them at the beginning.

Essential tools: <- the script doesn't work if you don't have installed all of them
iwconfig iw awk airmon-ng airodump-ng aircrack-ng curl

Optional tools: <- not necessary to work, only needed for some features
wpaclean crunch aireplay-ng mdk3

Other (non 100% compatible) distros tested successfully after installing missing tools:
-Debian 8 (Jessie)
-Ubuntu 15.10 and Xubuntu 15.10
-OpenSUSE Leap 42.1

Impossible compatibility for Mac OSX at the moment. Some reasons:
-Bash version <- it can be avoided upgrading to 4 or later, this is not the problem
-Aircrack suite <- this suite for OSX doesn't support airodump and aireplay
-Wireless tools <- iwconfig doesn't exists for OSX, and airport command can't be used. It generates very different outputs

#Disclaimer This script must be used only for educational purposes and Pen testing.
Use it only on your own networks.
We are not responsible of its use.
This script is under GPLv2 (or later) License.

#Use Under some distros like Kali Linux must be called only using bash (not sh). Example bash /path/airgeddon.sh
Under Wifislax and others, it can be called using bash or sh. Example sh /path/airgeddon.sh
If you call the script using sh and a "Syntax error" appears, use it with bash instead of sh.

#Supported Languages English, Spanish, French and Catalan.

#Project Collaboration You can join the project:
-Translations to other languages are welcome.
-More distros support compatibility.
-New features.
-Testing and feedback is needed too.

#Changelog See Changelog file to review changes.

#Special Thanks to Kcdtv for French translations, beta testing, suggestions about new features and support received.
El padrino for Catalan translations.
USUARIONUEVO and Wifislax staff for helping me to improve the script and for suggestions about new features.

#Donate If you enjoyed the script, feel free to give a donation. Invite me a coffee sending me a fraction of a bitcoin:
3HcTA8H91oPRcd5eu1uJf165sbknQtUSzU