Skip to content

Commit

Permalink
Merge pull request #10 from v1s1t0r1sh3r3/dev
Browse files Browse the repository at this point in the history
Dev to master first Evil Twin attack
  • Loading branch information
v1s1t0r1sh3r3 authored Aug 13, 2016
2 parents 3082508 + 59fe4a7 commit dee6118
Show file tree
Hide file tree
Showing 3 changed files with 1,423 additions and 104 deletions.
63 changes: 44 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,28 @@ This is a multi-use bash script for Linux systems to audit wireless networks.<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/>
- Evil Twin attacks: Only AP to sniff with external sniffer. Coming soon with integrated sniffing, sslstrip and captive portal.<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/>
- Screen resolution detection for optimal windows viewing.<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/>
- Auto-update. Script checks for newer version if possible.

#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/>
*-Backbox 4.5.1 and 4.6*<br/>
*-Parrot 2.2.1 and 3.1.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/>
*-Ubuntu/Xubuntu 15.10, 16.04 and 16.04.1*<br/>
*-OpenSUSE Leap 42.1*<br/>
*-CentOS 6 and 7*<br/>
*-Gentoo 20160514*<br/>
Expand All @@ -42,14 +43,30 @@ Repositories versions will have auto-update feature disabled in order to avoid b
<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/>
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
xterm
```
Optional tools: <- *not necessary to work, only needed for some features*
```
wpaclean
crunch
aireplay-ng
mdk3
hashcat
hostapd
dhcpd (isc-dhcp-server / dhcp)
```
Update tools: <- *not necessary to work, only used for auto-update*<br/>
`curl`<br/>
```
curl
```

#Known incompatibilities
Impossible compatibility for Mac OSX at the moment. Some reasons:<br/>
Expand All @@ -59,21 +76,21 @@ Impossible compatibility for Mac OSX at the moment. Some reasons:<br/>

Incompatible with OpenBSD and FreeBSD. They are Unix systems but they have some differences with Linux:<br/>
*-Bash* <- They have no bash. It can be installed, this is not the real problem<br/>
*-Wireless tools* <- iwconfig doesn't exists for these systems, they use ifconfig instead and it generates very different outputs<br/>
*-Wireless tools* <- iwconfig doesn't exists for these systems, they use ifconfig instead and it generates very different outputs

#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 GPLv3 (or later) License.<br/>
This script is under GPLv3 (or later) License.

#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/>

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

#Project Collaboration
You can join the project:<br/>
Expand All @@ -90,17 +107,25 @@ Debug mode was implemented for faster development skipping intro and initial che
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`<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.

#Special Thanks to
**Kcdtv** for French translations, beta testing, suggestions about new features and support received.<br/>
Thanks to the "Spanish pen testing crew", the Wifislax staff, the seguridadwireless.net and wifi-libre.com forum people that helped me.<br/>
<br/>
**Kcdtv** for French translations, beta testing, suggestions about new features and support received since the beginning.<br/>
**USUARIONUEVO** for helping me to improve the script, suggestions about new features and for the 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/>
**Beans** for Portuguese translations.<br/>
<br/>
Thank you too to other authors who inspired me with their scripts:<br/>
*vk496 -> Linset*<br/>
*MI1 -> Airstorm*<br/>
*MatToufoutu -> Ap-fucker*<br/>
*Coeman76 -> Handshaker*

#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*
Loading

0 comments on commit dee6118

Please sign in to comment.