Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Linux Python application to create maps of 802.11 networks
JavaScript Python
branch: master

Updated JS to properly use OpenLayers projections.

Updated the map generator script to work for 14 wifi channels.
Changed the map layer to OSM.
latest commit 789a95fb23
@cyberpython authored

README.md

WifiScanAndMap

A simple 802.11 mapping application for Linux written in Python.

Url

Authors

License

Description

WiFiScanAndMap is a Python WiFi mapping application for Linux.

You can use it to scan areas for wireless networks, collect information about them and then generate a web page displaying these information on a map.

The application was created as an assignment for the “Wireless Networks And Mobile Communcations” course at the Computer Science Department of the Athens University Of Economics And Business, by:

  • Filia Dova
  • Georgios Migdos

The application consists of two programs, the scanner and the map generator.

The user runs the scanner on a mobile device (laptop/netbook) which collects information about the wireless networks within range. The program relies on iwlist output for the scanning process. After the user is done, they can save the collected information as an XML file.

The scanner can be run as a GTK+ application or as a command line application (with the –no-gui parameter).

This process can be repeated any number of times, resulting in a number of XML files. These XML files are used as the input of the map generator program which parses the XML files and produces an HTML web page.

The map data used is obtained from OpenStreetMap and the tiles are from Yahoo! Maps. The graph is displayed using the Bluff Javascript library.

Requirements

To run the scanner you need:

  • A Linux system with wireless tools for Linux installed
  • Wireless card supporting scanning
  • GPS receiver
  • Python 2.6.4
  • gpsd (+python bindings)
  • PyGTK+ 2.16 (if you want to use the GUI)

To display the map you need:

  • A web browser supporting CSS with Javascript enabled
  • An active internet connection

Usage

You can run the scanner (GTK+ GUI) with the command :

    python scanner/scanner.py

You can run the scanner (GTK+ GUI) with the command :

    python scanner/scanner.py –no-gui

You can run the map generator with the command:

    python mapgenerator/mapgenerator.py <longitude> <latitude> <output directory> <input XML file 1> <input XML file 2> … <input XML file n>

where:

  • <longitude> and <latitude> are the geographic coordinates of the resulting map’s original center
  • <output directory> is the directory where the result files will be saved
  • <input XML file 1> <input XML file 2><input XML file n> are the XML files generated by the scanner.
Something went wrong with that request. Please try again.