Skip to content

Commit

Permalink
v3.23
Browse files Browse the repository at this point in the history
  • Loading branch information
v1s1t0r1sh3r3 committed May 1, 2016
1 parent 38ab324 commit 49290b5
Show file tree
Hide file tree
Showing 3 changed files with 299 additions and 126 deletions.
64 changes: 34 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,38 @@
#airgeddon
This is a Multi-use bash script to audit wireless networks.<br>
This is a multi-use bash script to audit wireless networks.<br>

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

#Requirements
We say a distro is a 100% compatible Linux distro if it has installed by default all the tools script needs to work.<br>
We say a distro is a 100% compatible Linux distro if it has installed by default all the essential tools script needs to work.<br><br>
Tested on these 100% compatible Linux distros:<br>
-Kali. Tested on 2.0 and 2016.1<br>
-Wifislax. Tested on 4.11.1<br>
-Backbox. Tested on 4.5.1<br>
-Parrot. Tested on 2.2.1<br>
-Blackarch 2016.01.10<br>
*-Kali. 2.0 and 2016.1*<br>
*-Wifislax. 4.11.1 and 4.12*<br>
*-Backbox. 4.5.1*<br>
*-Parrot. 2.2.1*<br>
*-Blackarch 2016.01.10*<br>
*-Cyborg Hawk 1.1*<br>
<br>
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:<br>
iwconfig airmon-ng airodump-ng aireplay-ng mdk3 awk wpaclean aircrack-ng crunch curl<br>
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.<br><br>
Essential tools: <- *the script doesn't work if you don't have installed all of them*<br>
`iwconfig awk airmon-ng airodump-ng aircrack-ng curl`<br><br>
Optional tools: <- *not necessary to work, only needed for some features*<br>
`wpaclean crunch aireplay-ng mdk3`<br>
<br>
Other (non 100% compatible) distros tested successfully after installing missing tools:<br>
-Debian 8 (Jessie)<br>
-Ubuntu 15.10 and Xubuntu 15.10<br>
*-Debian 8 (Jessie)*<br>
*-Ubuntu 15.10 and Xubuntu 15.10*<br>

#Disclaimer
This script must be used only for educational purposes and Pen testing.<br>
Expand All @@ -37,9 +41,9 @@ We are not responsible of its use.<br>
This script is under GPLv2 (or later) License.<br>

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

#Supported Languages
English, Spanish, French and Catalan.<br>
Expand All @@ -52,13 +56,13 @@ You can join the project:<br>
-Testing and feedback is needed too.<br>

#Changelog
See <a href="https://github.com/v1s1t0r1sh3r3/airgeddon/blob/master/changelog.txt">Changelog</a> file to review changes.<br>
See <a href="https://github.com/v1s1t0r1sh3r3/airgeddon/blob/master/changelog.txt" target="_blank">Changelog</a> file to review changes.<br>

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

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

0 comments on commit 49290b5

Please sign in to comment.