Skip to content

Commit

Permalink
Merge pull request #3 from v1s1t0r1sh3r3/dev
Browse files Browse the repository at this point in the history
v3.41
  • Loading branch information
OscarAkaElvis authored Jun 24, 2016
2 parents 8804139 + a2dcd14 commit da213d2
Show file tree
Hide file tree
Showing 6 changed files with 860 additions and 379 deletions.
8 changes: 8 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
.idea
903 changes: 619 additions & 284 deletions LICENSE

Large diffs are not rendered by default.

142 changes: 76 additions & 66 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,85 +1,95 @@
#airgeddon
This is a multi-use bash script for Linux systems to audit wireless networks.<br>
<img src="https://raw.githubusercontent.com/v1s1t0r1sh3r3/airgeddon/master/airgeddon_banner.png" title="We'll conquer the earth!!">
This is a multi-use bash script for Linux systems to audit wireless networks.<br/>
<img src="https://raw.githubusercontent.com/v1s1t0r1sh3r3/airgeddon/master/airgeddon_banner.png" title="We'll conquer the earth!!"/>

#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, bruteforce and rule based).<br>
- Compatibility with many Linux distros (see requirements section).<br>
- Easy targeting and selection in every section.<br>
- Drag and drop files on console window for entering file paths.<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>
- Auto-update. 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, bruteforce and rule based).<br/>
- Compatibility with many Linux distros (see requirements section).<br/>
- Easy targeting and selection in every section.<br/>
- Drag and drop files on console window for entering file paths.<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/>
- Auto-update. Script checks for newer version if possible.<br/>

#Requirements
Bash version 4.0 or later needed.<br>
<br>
Tested on these compatible Linux distros:<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>
*-Debian 7 (Wheezy) and 8 (Jessie)*<br>
*-Ubuntu/Xubuntu 15.10 and 16.04*<br>
*-OpenSUSE Leap 42.1*<br>
*-CentOS 6 and 7*<br>
*-Gentoo 20160514*<br>
*-Fedora 24*<br>
*-Red Hat 7 (Maipo)*<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><br>
Essential tools: <- *the script doesn't work if you don't have installed all of them*<br>
`iwconfig iw awk airmon-ng airodump-ng aircrack-ng xterm`<br><br>
Optional tools: <- *not necessary to work, only needed for some features*<br>
`wpaclean crunch aireplay-ng mdk3 hashcat`<br><br>
Update tools: <- *not necessary to work, only used for auto-update*<br>
`curl`<br>
<br>
Impossible compatibility for Mac OSX at the moment. Some reasons:<br>
*-Bash version* <- it can be avoided upgrading to 4 or later, this is not the real problem :)<br>
*-Aircrack suite* <- this suite for OSX doesn't support airodump and aireplay<br>
*-Wireless tools* <- iwconfig doesn't exists for OSX, and airport command can't be used. It generates very different outputs<br>
Bash version 4.0 or later needed.<br/>
<br/>
Tested on these compatible Linux distros:<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/>
*-Debian 7 (Wheezy) and 8 (Jessie)*<br/>
*-Ubuntu/Xubuntu 15.10 and 16.04*<br/>
*-OpenSUSE Leap 42.1*<br/>
*-CentOS 6 and 7*<br/>
*-Gentoo 20160514*<br/>
*-Fedora 24*<br/>
*-Red Hat 7 (Maipo)*<br/>
<br/>
It's already available in some repositories like <a href="https://archstrike.org/wiki" target="_blank">ArchStrike</a> used by some distros (Arch Linux).<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/><br/>
Essential tools: <- *the script doesn't work if you don't have installed all of them*<br/>
`iwconfig iw awk airmon-ng airodump-ng aircrack-ng xterm`<br/><br/>
Optional tools: <- *not necessary to work, only needed for some features*<br/>
`wpaclean crunch aireplay-ng mdk3 hashcat`<br/><br/>
Update tools: <- *not necessary to work, only used for auto-update*<br/>
`curl`<br/>
<br/>
Impossible compatibility for Mac OSX at the moment. Some reasons:<br/>
*-Bash version* <- it can be avoided upgrading to 4 or later, this is not the real problem :)<br/>
*-Aircrack suite* <- this suite for OSX doesn't support airodump and aireplay<br/>
*-Wireless tools* <- iwconfig doesn't exists for OSX, and airport command can't be used. It generates very different outputs<br/>

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

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

#Supported Languages
English, Spanish, French and Catalan.<br>
English, Spanish, French and Catalan.<br/>

#Project Collaboration
You can join the project:<br>
-Translations to other languages are welcome.<br>
-More distros support compatibility.<br>
-New features.<br>
-Testing and feedback is needed too.<br>
<br>
For collaborating developers:<br>
Debug mode was implemented for faster development skipping intro and initial checks. Use it setting var *"debug_mode"* to 1<br>
Please, respect the code style and the UTF-8 files format only using at the end of the lines LF (not CRLF).<br>
You can join the project:<br/>
-Translations to other languages are welcome.<br/>
-More distros support compatibility.<br/>
-New features.<br/>
-Testing and feedback is needed too.<br/>
<br/>
*For collaborating translators:*<br/>
There is a `.ods` file to work with. This file extension (Open Document SpreadSheet) is like an Excel but in non propietary format. It contains all the strings to translate.<br/>
Fill or review your language strings and mark with `X` the corresponding reviewed cell each time<br/>
Respect the color style (light red for non reviewed and soft green for reviewed cells).<br/>
<br/>
*For collaborating developers:*<br/>
Debug mode was implemented for faster development skipping intro and initial checks. Use it setting var *"debug_mode"* to 1<br/>
Please, respect the code style and the UTF-8 files format only using at the end of the lines LF (not CRLF).<br/>
<br/>
*For beta testers:*<br/>
You can download the master version or the beta testing version from the development branch called `dev`

#Changelog
See <a href="https://github.com/v1s1t0r1sh3r3/airgeddon/blob/master/changelog.txt" target="_blank">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>
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/>
Loading

0 comments on commit da213d2

Please sign in to comment.