AIROSCRIPT-NG(1)

NAME
Airoscript-ng - User interface to aircrack-ng

SYNOPSIS

airoscript-ng [-h] [-t TERMINAL] [-v] [-w WIRELESS_CARD] [-b] [-m fakemac|realmac] [-a] [-n FILTER] [-x] [-z] [-p PLUGIN_FILE]

DESCRIPTION

Airoscript is a complete user interface for aircrack-ng.

It gives you almost all functionality that aircrack-ng has, allowing you to save some time from writting commands. Writing commands may be good to learn how does it work, but repeatedly doing so can damage your mind and your body.

Airoscript also provides a comprehensive way to generate CEO-readable network security reports, writable (by wkhtml2pdf plugin) as pdf.

OPTIONS

-h  Show this message

-t terminal
    Specify terminal

-v  Verbose & debug mode

-w wireless_card
    Specify wifi card

-b  Writes a csv file with network data.

-m mac_mode
    Change mac to fakemac before everything else. (mac mode can be fakemac or realmac)

-a  Automatic mode

-n regex
    Filter SSID by regex

-x  Autoconfigure network after automatic crack (requires -a)

-z  Don't scan automatically at start

EXAMPLES

Crack the first of all my test networks using my own mac

airoscript-ng -w wlan0 -m realmac -n "XayOnTest_(.*)"

Try to crack any network with faked mac. Warning, this may conduct you to commit a crime

airoscript-ng -w wlan0 -m fakemac -a

DEVELOPERS
Help and feedback is greatly appreciated.
Please feel free to mail XayOn at xayon@xayon.net

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 AND FEATURE REQUESTS

Please submit bugs in aircrack-ng trac or aircrack-ng oficial forum "airoscript support" subforum.

MENU USAGE

Airoscript-ng menu is quite intuitive, and it's documented in the html docs.

Since version 1.1 is able to queue commands, that is, you can tell it to do 1 then 2 in a menu just by entering "1 2" (without the quotes).

CONFIGURATION

There are 2 configuration files, airoscript-ng.conf and airoscript-ng_advanced.conf that are well explained within them.

REQUIREMENTS (DEPS)

  Build-deps

gettext

  Deps:
GNU gettext (gettext package)
ip (iproute package)
aircrack-ng (same version as airoscript-ng)
Working injection capable driver for the interface you want to use
mrxvt|xterm|gnome-terminal -> Preferibly xterm
aircrack-ng ( = airoscript-ng_version) )
bash ( >4.0 )
grep
macchanger
iproute ( /bin/ip )

  Recommended
digenpy ( http://github.com/XayOn/Digenpy ) # Depends on python 2.6
mdk

PLUGIN SUPPORT

Airoscript supports plugins, shell scripts listed in enabled_plugins on airoscript configuration (use the full path there).

Since svn revision 1969 airoscript-ng has a plugin menu, wich will make you able to enable any plugin after airoscript has been started just by selecting it.

Currently (at 1991) the plugin list that comes out with airoscript is:

•   arpspoof --> Enables arp spoof menu

•   digenpy --> Enables digenpy dictionary generator for cracking

•   dsniff --> launches dsniff (better use it with arpspoof and sslstrip)

•   hydra --> Configures network, then launches hydra to get router password

•   iptables --> Configures iptables to redirect trough it (needed for arpspoof sslstrip)

•   johntheripper --> Enables john the ripper to generate password lists for cracking WPA

•   mdk3 --> Enables mdk3 menu

•   sslstrip --> Enables sslstrip menu

•   tcpdstat --> When making a report, includes tcpdstat's protocol statistics

•   wkhtmltopdf --> Converts reports to pdf

•   zenity --> Enables a zenity-based graphical interface for airoscript-ng (needs also libnotify-bin)

•   pyrit --> a raw interface for pyrit, requires pyrit knowledge

CREATING A PLUGIN

For a plugin to add a menu entry, you'll have to set $plugins_menu["Title of the menu you want to use"] to an array of the entries you want to add.

Have a look at http://xayon.net/adding-nessus-support-to-airoscript/ for a more complete tutorial.

SEE ALSO
airoscript.conf(1)
airdecap-ng(1)
airdriver-ng(1)
aireplay-ng(1)
airmon-ng(1)
airodump-ng(1)
airolib-ng(1)
airsev-ng(1)
airtun-ng(1)
buddy-ng(1)
easside-ng(1)
ivstools(1)
kstats(1)
makeivs-ng(1)
packetforge-ng(1)
wesside-ng(1)
aircrack-ng(1)

AUTHOR
This manual page was written by David Francos <me@davidfrancos.net>

COPYRIGHT
David Francos Cuartero