Git Product home page Git Product logo

kismapping's Introduction

Kismapping

Kismapping is a WiFi heatmapping tool which consumes Kismet output and produces a heatmap. It also serves a google maps web page with the heatmap overlaid on top.

Originally inspired by work done by Tom Liston (@tliston) on a tool named "mykismap".

Build

If you do not have stack, install stack.

Then, from the project's root directory, run stack build.

Install

Run stack install to install an executable on your system. The default installation path is $HOME/.local/bin, but stack will tell you its destination path.

Run

After building, if you want to run the executable without installing it, run stack exec kismapping -- <args>. Otherwise, see Install for installation details, and use the kismapping command.

Currently, the command line interface is not very intuitive. I'm going to rework it slightly to fix that soon, but for now just go with the example at the bottom of this section, it should help you do what you want.

If you want to use the web interface (which you almost certainly do), you will need to get a Google Maps API Key to use from https://developers.google.com/maps/documentation/javascript/get-api-key

You'll also need a gpsxml and netxml file from kismet, both in the same directory. You will need to use at least the following arguments:

  • -i - Gpsxml file
  • -e - ESSIDs
  • -k - Google API Key

For example, the following command would generate a map containing the ESSIDs FBI_VAN and The Promised LAN:

kismapping -e FBI_VAN -e 'The Promised LAN' -i Kismet-data.gpsxml -k ThisWouldBeYourGoogleApiKey

See the command help for further information.

TODO

  • Document code
  • Put version constraints on dependencies
  • Better command line interface
  • Use new kismet output format (we currently use the format from the stable release).

kismapping's People

Contributors

faithanalog avatar unknownloner avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

kismapping's Issues

Install issues

While building package kismapping-0.1.0 (scroll up to its section to see the error) using:
/home/kali/.stack/setup-exe-cache/x86_64-linux-tinfo6/Cabal-simple_SvXsv1f__1.24.2.0_ghc-8.0.2 --verbose=1 --builddir=.stack-work/dist/x86_64-linux-tinfo6/Cabal-1.24.2.0 build lib:kismapping exe:kismapping --ghc-options ""
Process exited with code: ExitFailure 1

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.