====== Aigraph-ng ======

Author: digitalpsyko, TheX1le \\
Version: 1.01 \\
Last modified on: 23/5/2010

===== Requirements =====
  * python
  * graphviz
  * make
  * aircrack-ng 1.0 (rc2 or better is recommended)
  * psyco is recommended but not mandatory

===== Installing =====

  git clone http://github.com/aircrack-ng/aircrack-ng
  cd aircrack-ng
  autoreconf -i
  ./configure
  cd scripts/airgraph-ng
  make install

===== Graph types =====

  * CAPR: Client to AP Relationship. This shows all the clients attached to a particular AP.
  * CPG: Common Probe Graph. This will show all probed SSID by clients.

===== Usage =====
==== Help screen ====

  ############################################
  #         Welcome to Airgraph-ng           #
  ############################################
  
  Usage: python airgraph-ng -i [airodumpfile.txt] -o [outputfile.png] -g [CAPR OR CPG]
  
  -i      Input File
  -o      Output File
  -g      Graph Type [CAPR (Client to AP Relationship) OR CPG (Common probe graph)]
  -a      Print the about
  -h      Print this help
==== Creating graphs ====

Now that you've got your nifty new program installed, its time to run some [[airodump-ng]] CSV files through it so you can see the graphs this program creates.
So you have airodump-ng .txt/.csv files to run through airgraph-ng goto your favorite terminal and cd into the directory where you're keeping them.

 The following creates a Client to Access point Relationship Graph
  airgraph-ng -i demo.csv -o demo.png -g CAPR

 The following creates a Client to Probe Request Graph
  airgraph-ng -i demo.csv -o demo.png -g CPG


The graph size and the time to generate it depends on the size of your CSV file. So, the more AP's and Clients you get with airodump-ng the bigger the graph it will be.

==== Combining CSV files ====

To combine your airodump-ng .txt/.csv files together simply open up a terminal and cd into the directory where you're keeping them in and then type:

  dump-join.py -i <file>.txt <file>.txt <file>.txt -o <outputfilename>.txt  

Now you can take your combined airodump-ng .txt/.csv files and run it through airgraph-ng to make a larger graph.

===== Troubleshooting =====
==== Airodump-ng doesn't create .txt files anymore ====

Starting from aircrack-ng 1.0rc3, .txt files were renamed to .csv.

==== I get 'Psyco optimizer not installed, You may want to download and install it!' ====

This is just a warning and you can safely ignore this message. However, it is recommended install [[http://psyco.sourceforge.net/|psyco]] because it speeds up execution of python code.