/* qAircrack-ng

*
* Copyright (C) 2008 Miguel Cardenas
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/

qAircrack-ng is a graphic frontend based on Trolltech Qt4 library.

Requeriments
------------

- Linux or another *NIX system supporting

- GNU C/C++ compiler
- Trolltech Qt4 library (http://www.trolltech.com)
- libv2 library (http://www.sorcerynet.org)
- Aircrack-ng software installed and running
- Wireless network device supported by Aircrack-ng

Installation
------------

It is easy to install, just generate the Makefile by running

qmake, then build it with 'make' (or 'gmake' if it fails)
and copy to a directory within the PATH directory.

# qmake -o Makefile qaircrack-ng.pro

# make
# cp qaircrack-ng /usr/sbin

Note 1:
If for some reason you have troubles compiling libv2
or it is not supported by your operating system you can
download the libv2 sources and copy

../voodoo2/datastructure/csv.h
../voodoo2/datastructure/csv.cpp

to the qAircrack-ng directory, edit ACscan.h and change

#include <voodoo2/datastructure/csv.h>

by

#include "csv.h"
#include "csv.cpp"

and restart the installation process. This include is to read

the columns of text returned by airodump-ng
Note 2:
There is an issue with airmon-ng to put my wifi AirLink card in
monitor mode, after tracing the script I found the wlanconfig
command causes an error because the '-bssid' option, at least
my version of wlanconfig returns a message that it is deprecated
and IFACE does not return the device name so the script fails
and ath1 (new device) is created instead of ath0. If you have
an Atheros chipset with MADWIFI driver this fix worked for me,
just change the line (342 in my current version of airmon-ng):

IFACE=`wlanconfig ath create wlandev $iface wlanmode monitor -bssid | grep ath`

by this other line: (just remove the -bssid option)

IFACE=`wlanconfig ath create wlandev $iface wlanmode monitor | grep ath`

Just do it if you have problems putting your card in monitor

mode, otherwise ignore this note.

Running the program

-------------------

qAircrack-ng must be run as root, otherwise it will not work

since wireles-tools and Aircrack-ng require root access. A
simple 'su' in console may help, or try creating an icon
with the command 'kdesu -c qaircrack-ng' (for KDE).

Since there are different wifi cards supported and each one
is setup in a different way you must run by hand the airmon-ng
script.

Note that qAircrack-ng is a tool to make easier the use of

Aircrack-ng, but you MUST know how the suite works and how to
use it.

Disclaimer
----------

This program is FREE and has ANY warranty, it works for me

but can't promise it will run in every system, although it
should if you have everything installed correctly.