readme

Aircrack-ng is an 802.11 WEP and WPA-PSK keys cracking program that can recover keys once enough dat

Airoscript - a companion for aircrack-ng
-------------------------------------------------------------------------------
Daouid's project page
http://daouid.googlepages.com/ --> Not updated, please, for now use the one below

XayOn's project page
http://code.google.com/p/airoscript

Airoscript OFFICIAL HOMEPAGE
http://airoscript.aircrack-ng.org/ --> Also not updated
-------------------------------------------------------------------------------

ABOUT:
Airoscript is a shell script designed to ease the use of aircrack-ng. It allows
you to scan, select and attack any detected access point. This is done by
detecting encryption type and proposing attacks accordingly. Various attacks
are available, such as chopchop, fragmentation attack, fakeauth, deauth,
dictionnary attacks and WPA cracking.

REQUIREMENTS:
- GNU gettext (Debian/Ubuntu: gettext package)
- ip (Debian/Ubuntu: iproute package)
- aircrack-ng 1.0 rc2
- WORKING injection capable driver for the interface you want to use

USAGE:
Airoscript can now get the terminal emulator from command line, you won't have to 
change it from config file every time you have to change your Terminal Emulator.

SYNTAX:
	airoscript [TERMINAL]
where terminal is one of xterm,urxvt,gnome-terminal (please, someone help me adding support for this one), and screen (some bugs are not corrected yet on screen support).

CONFIGURATION:
All config is done by the file /etc/airoscript.conf or ~/.airoscript.conf .

The most important variables are:

The TROUBLESHOOTING debug mod (1 for enable, 0 for disable)
	DEBUG="0"

The critical troubleshooting debug mode: uncomment or add this line to your conffile:
This will make every terminal command to be showed up instead of executing
	CDCMD="echo "


Your interface: wlan0, ath0 etc... (if not set airoscript will ask for one
at every launch of it)
	WIFI=""

And the paths.

Note:
If installing from sources, and you don't want to install it (you should be root
to execute aircrack, anyway), you'll need to adapt FUNCTIONS var on your config file
(you can put it on your home dir as .airoscript.conf) and make airoscript.sh executable.
( executing "chmod +x airoscript.sh" )

be sure to have root access and then you can run it by typing:
"./airoscript.sh"

COMPILATION:
A shell script doesnt need to be compiled, but it can be put into bin folder
to allow it to be run from anywhere.
There is a makefile to make this way easier:
	# make
Of course, as root. =)

Airoscript have few dependences:
Compile-time: gettext
Execute-time:   Terminal emulator (mrxvt, xterm...) -> Preferibly xterm
		Aircrack-ng > 1.0.2
		Bash
		wlandecrypter (optional)
		jazzteldecrypter (optional)
		mdk (optional)
		GNU Tools like grep awk...
		macchanger

DEVELOPERS:
Help and feedback is greatly appreciated. 
Please feel free to mail daouid at [e-mail] 
or XayOn at [e-mail] for any suggestion or correction.
I will be pleased to add you to the contributors of airoscript.

ABOUT COMPLIANCE:
In the wrong hands, airoscript and aircrack-ng could easily violate the 
government certification of your radio.  A simple example is running injection
on frequencies your radio isn't certified for in your geographic region.

you and only you are responsible for making sure that your tools -- including
airoscript -- are compliant with the regulations in your country and region.

BUGS & FEATURE REQUESTS:
Please submit bugs to [e-mail] . 
There is also forum thread in aircrack-ng official forum where you can ask 
questions, or just get updates, support etc.
You can also submit bugs to airoscript's google code page.

NEEDED HELP:
Really, help with screen support will be appreciated, it "just works" but I don't like how it works :-P.