Injection Wizard Files

 Injection Wizard ver. 1.0
============================

*Injection Wizard* is an application for injecting traffic into WEP
protected Wi-Fi networks, like /aireplay-ng/, but it's much more easy
to use and it can work with worse conditions (for example, more
interferences, weaker transmitted/received signals, more restricted
access points, etc ). Please, read the *documentation* inside the
"injwiz.zip" file for more details (también en *español*).

This application is distributed under the terms of the *GNU General
Public License version 2* (see the /license.htm/ file for more details)
and comes *with absolutely no warranty*. The author assumes *no
responsibility* derived from the use or the distribution of this
program. The copyright of this application is owned by Fernando Pablo
Romero Navarro (May 2010). *Injection Wizard* has made use of (with
convenient modifications) the following *free software* applications:

    * *scapy* (version 2.0.1), distributed under the license: GNU GPL
      version 2. Copyright: *Philippe Biondi*, 2009
      (http://www.secdev.org/projects/scapy).
    * *python-wifi* (version 0.3.1), distributed under the license: GNU
      LGPL version 2.1. Copyright: *Róman Joost*, 2004-2008.


 Software Requirements
======================

For the client application (graphical interface):

    * Any system with a recent Java virtual machine: JRE version 1.6 or
      later.

For the server application:

    * A Linux box with a recent kernel, so it should support /Wireless
      Extensions/ version 22 or later (since kernel version 2.6.21) and
      the /mac80211/ stack for Wi-Fi interfaces (since kernel version
      2.6.24 it is supported by many Wi-Fi adapter drivers).
    * A Wi-Fi network interface driver supporting injection in monitor
      mode (sometimes it's required to patch the driver for supporting
      this feature).
    * The /iw/ system command, if it's not provided by your Linux
      distribution you can get it by installing the /aircrack-ng/
      package or by compiling the source code that can be downloaded
      from: http://wireless.kernel.org/download/iw.
    * A Python interpreter with version 2.5, later versions might also work.


 Instructions
=============

   1. Uncompress the *injwiz.zip* file.
   2. Copy the *client* directory on a system with a Java virtual
      machine accessible from the command path (for example, launch a
      shell, enter the /client/ directory, execute the command: |java
      -version| and check the command outputs the JRE version number).
   3. Copy the *server* directory on a Linux box. If the /client/ and
      /server/ directories weren't copied on the same machine, you
      should edit the *runserver.sh* script (in the /server/ directory)
      and replace the IP address: 127.0.0.1 with the IP address of the
      Linux box network interface that is attached to the same network
      that the client machine (i.e. the computer that hosts the /client/
      directory).
   4. Enter the *server* directory and run the script: *./runserver.sh*
      (the Python interpreter should be accessible from the command
      path. You can check this by running: |python -V| from the command
      line and verifying that the interpreter version is showed).
   5. On the client machine, enter the *client* directory and run either
      the script: *./runclient.sh* (for Linux or Unix-like operating
      systems providing a shell compatible with the Bourne shell and
      whose path for the executable file is: //bin/sh/) or
      *runclient.bat* (for Windows).


 Contact
========

If you have any question, suggestion or comment, you may contact the
author by means of the following e-mail address: fernpromero(at)gmail(dot)com.