air-ng v0.0.3

air-ng

Javascript wrapper for the aircrack-ng suite. Delegates to child process calls and parses the results.

IMPORTANT

None of the below will do what it says it will yet. air-ng is in version 0, and the first usable release, v1, is being worked towards - you can see the progress here.

The documentation below is meant to show the intention for the API's final structure.

Installation

air-ng itself can be installed the usual way:

$ npm install air-ng

However, the calls require various parts of the aircrack-ng suite to be installed and accessible from your path. The recommended environment to run any application relying on air-ng is a machine running Kali either as a natively-installed OS or a virtual machine with full access to an external network card. Kali comes pre-installed with the entire aircrack-ng suite.

Usage

Vanilla JS

var air = require('air-ng');

// airodump-ng
var airodumper = air.odump({
  channel: 1,
  bssid: '12:34:56:78:90:ab',
  prefix: 'wpa_capture',
}, 'wlan0');

airodumper.on('data', function (dumpInfo) {
  // ...
});

// aircrack-ng
var aircracker = air.crack({
  bssid: '12:34:56:78:90:ab',
  wordlist: 'wordlist.txt',
}, 'wpa_capture');

aircracker.on('data', function (crackInfo) {
  crackInfo.keysAttempted;
  // ... more output from aircrack-ng
});

aircracker.on('end', function (crackResult) {
  crackResult.success;
  crackResult.key;
  // ... more output from aircrack-ng
});

ES6

import * as air from 'air-ng';

// ...