Parse wifi dump files and get a structured collection of access points and stations, including probes and associations (see supported dump formats). You can then import the formatted data into your application, e.g. to build a database or a map of wireless networks and clients.
Add this line to your application's Gemfile:
gem 'wifimap'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install wifimap
Require wifimap and pass the content of a dump file to the parse
method:
require 'wifimap'
dump = File.read('airodump.csv')
parsed = Wifimap.parse(dump)
# Alternative:
# parsed = Wifimap.parse_file('airodump.csv')
parsed.access_points # returns an array of AccessPoint objects
parsed.stations # returns an array of Station objects
An AccessPoint instance contains the following attributes:
access_point.bssid # ex.: '04:F0:21:13:32:29'
access_point.privacy # ex.: 'WPA2'
access_point.essid # ex.: 'Home Network'
access_point.manufacturer # ex.: 'Compex Systems Pte Ltd'
A Station instance contains the following attributes:
station.mac # ex.: 'AE:91:B5:23:87:9D'
station.associations # ex.: ['04:F0:21:13:32:29']
station.probes # ex.: ['Home Network']
station.manufacturer # ex.: 'Apple, Inc.'
- Airodump CSV (airodump-ng)
- Sniff Probes (sniff-probes)
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/gpaddis/wifimap.
The gem is available as open source under the terms of the MIT License.