.\" Man page generated from reStructeredText.
.
.TH AIROSCRIPT-NG 1 "2011-11-17" "1.1" "net"
.SH NAME
Airoscript-ng \- User interface to aircrack-ng
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
airoscript\-ng [\-h] [\-t TERMINAL] [\-v] [\-w WIRELESS_CARD] [\-b] [\-m fakemac|realmac] [\-a] [\-n FILTER] [\-x] [\-z] [\-p PLUGIN_FILE]
.SH DESCRIPTION
.sp
Airoscript is a complete user interface for aircrack\-ng.
.sp
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.
.sp
Airoscript also provides a comprehensive way to generate CEO\-readable network
security reports, writable (by wkhtml2pdf plugin) as pdf.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h
Show this message
.TP
.BI \-t \ terminal
Specify terminal 
.TP
.B \-v
Verbose & debug mode
.TP
.BI \-w \ wireless_card
Specify wifi card
.TP
.B \-b
Writes a csv file with network data.
.TP
.BI \-m \ mac_mode
Change mac to fakemac before everything else. (mac mode can be fakemac or realmac)
.TP
.B \-a
Automatic mode
.TP
.BI \-n \ regex
Filter SSID by regex
.TP
.B \-x
Autoconfigure network after automatic crack (requires \-a)
.TP
.B \-z
Don\(aqt scan automatically at start
.UNINDENT
.SH EXAMPLES
.sp
Crack the first of all my test networks using my own mac
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
airoscript\-ng \-w wlan0 \-m realmac \-n "XayOnTest_(.*)"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Try to crack any network with faked mac. Warning, this may
conduct you to commit a crime
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
airoscript\-ng \-w wlan0 \-m fakemac \-a
.ft P
.fi
.UNINDENT
.UNINDENT
.\" The following one is a little bigger
.\" - It loads digenpy plugin (wich means that if a network can be cracked with a dictionary provided by digenpy, it will wait for only FOUR packages, then crack it with dict)
.\" - It forces to use xterm interface (wich, by the way, is the default stuff)
.\" - Uses wlan1 as interface
.\" - Writes a csv file with the network data for posterior analysis
.\" - Uses your real mac
.\" - Starts debugging mode (it just prints out more information than usual (ugly as hell, meant for dev))
.\" - Autoconfigures network after cracking. This SHOULD NOT DO ANYTHING IN THIS EXAMPLE (auto mode), as at the end of automatic mode, it already asks you to configure it.
.\" 
.\" airoscript-ng -t xterm -v -w wlan1 -b -m realmac -a -n "XayOn_" -x -pdigenpy
.
.SH DEVELOPERS
.nf
Help and feedback is greatly appreciated.
Please feel free to mail XayOn at \fI\%xayon@xayon.net\fP
.fi
.sp
.SH COMPLIANCE
.sp
In the wrong hands, airoscript and aircrack\-ng could easily violate the
government certification of your radio.
.sp
A simple example is running injection on frequencies your radio isn\(aqt
certified for in your geographic region.
.sp
You and only you are responsible for making sure that your tools \fIincluding\fP
\fIairoscript\fP are compliant with the regulations in your country and region.
.SH BUGS AND FEATURE REQUESTS
.sp
Please submit bugs in aircrack\-ng trac or aircrack\-ng oficial forum "airoscript
support" subforum.
.SH MENU USAGE
.sp
Airoscript\-ng menu is quite intuitive, and it\(aqs documented in the html docs.
.sp
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).
.SH CONFIGURATION
.sp
There are 2 configuration files, airoscript\-ng.conf and
airoscript\-ng_advanced.conf that are well explained within them.
.\" this is for the manpage, sorry for the inconvenience
.
.SH REQUIREMENTS (DEPS)
.SS Build\-deps
.sp
gettext
.SS Deps:
.nf
GNU gettext (gettext package)
ip (iproute package)
aircrack\-ng (same version as airoscript\-ng)
\fIWorking\fP injection capable driver for the interface you want to use
mrxvt|xterm|gnome\-terminal \-> Preferibly xterm
aircrack\-ng ( = airoscript\-ng_version) )
bash ( >4.0 )
iproute ( /bin/ip )
.fi
.sp
.SS Recommended
.nf
digenpy ( \fI\%http://github.com/XayOn/Digenpy\fP ) # Depends on python 2.6
macchanger
mdk
.fi
.sp
.SH PLUGIN SUPPORT
.sp
Airoscript supports plugins, shell scripts listed in enabled_plugins on
airoscript configuration (use the full path there).
.sp
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.
.sp
Currently (at 1991) the plugin list that comes out with airoscript is:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
arpspoof \-\-> Enables arp spoof menu
.IP \(bu 2
digenpy \-\-> Enables digenpy dictionary generator for cracking
.IP \(bu 2
dsniff \-\-> launches dsniff (better use it with arpspoof and sslstrip)
.IP \(bu 2
hydra \-\-> Configures network, then launches hydra to get router password
.IP \(bu 2
iptables \-\-> Configures iptables to redirect trough it (needed for arpspoof sslstrip)
.IP \(bu 2
johntheripper \-\-> Enables john the ripper to generate password lists for cracking WPA
.IP \(bu 2
mdk3 \-\-> Enables mdk3 menu
.IP \(bu 2
sslstrip \-\-> Enables sslstrip menu
.IP \(bu 2
tcpdstat \-\-> When making a report, includes tcpdstat\(aqs protocol statistics
.IP \(bu 2
wkhtmltopdf \-\-> Converts reports to pdf
.IP \(bu 2
zenity \-\-> Enables a zenity\-based graphical interface for airoscript\-ng (needs also libnotify\-bin)
.IP \(bu 2
pyrit \-\-> a raw interface for pyrit, requires pyrit knowledge
.UNINDENT
.UNINDENT
.UNINDENT
.SH CREATING A PLUGIN
.sp
For a plugin to add a menu entry, you\(aqll have to set
$plugins_menu["Title of the menu you want to use"] to an array of
the entries you want to add.
.sp
Have a look at \fI\%http://xayon.net/adding\-nessus\-support\-to\-airoscript/\fP for
a more complete tutorial.
.SH SEE ALSO
.nf
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)
.fi
.sp
.SH AUTHOR
This manual page was written by David Francos <me@davidfrancos.net>
.SH COPYRIGHT
David Francos Cuartero
.\" Generated by docutils manpage writer.
.\" 
.