Giter VIP home page Giter VIP logo

kestrel's Introduction

Kestrel

Mapping plugin for new Kismet API

logo

Disclaimers

This is based on Leaflet.js and PruneCluster for clustering. Thanks to them for their work and making this a lot easier. Also, a huge thanks to Dragorn (@kismetwireless) for making this whole thing possible, and his help with debugging my crap!

Demo

Kestrel in Action

Purpose

The intent of this plugin is to add live mapping of networks into the Kismet UI directly.

Updates

10-6-2017: Kestrel now supports searching! Using the main search bar above the Devices list in the Kismet UI will now also filter and display markers for only those devices. Currently, it is case SENSITIVE... working on that.

Popups have been added back in. By default popups include SSID, MAC, and TYPE of device (wifi AP, Client, Bridge, or Bluetooth). Additionally, there is an option with kestrel.js to set autocenter on most recent location. This is disable by default as it makes it difficult to interact with the map as it resets the view every couple seconds. Just find the line towards the bottom and uncomment my stuff Switched map source to mapquest. Map tile sources can be switched by editing the kestrel.js and switching the URL, check the Leaflet documentation for accepted sources.

In lieu of centering on current location, I center on the most recently plotted cluster, as those should be the same thing.

A couple of notes: I have not worked out how to prevent duplicate markers, so staying in one spot can lead to a LOT of markers in one spot, depending on the refresh rate (adjustable in kestrel.js). Right now, it grabs devices from the last 20s, every 20s which seems pretty reasonable.

Refreshing the browser clears the map of all markers.

TODO

  1. Center on operator.
  2. Draw Drivepath.
  3. Cache offline map tiles.
  4. Search function

Installation

Still under heavy development, also: I don't know any javascript at all, so if you have suggestions to fix/improve, let me know.

Assuming you have the newest build of kismet installed (from the Kismet git-master development repository):

Clone this repository

$ git clone https://github.com/soliforte/kestrel

Install the plugin - plugins can be installed system-side or to your home directory only.

To install system-wide (assuming your Kismet install is in the default location):

$ cd plugin-kestrel
$ sudo make install

To install in the user directory, as the user who runs Kismet:

$ cd plugin-kestrel
$ make userinstall

Start kismet server - if Kismet was already running, you'll need to restart it.

Connect to the Kismet UI (http://localhost:2501)

Kismet should now have a new Maps tab, and your browser will ask for your location.

kestrel's People

Contributors

dragorn avatar soliforte avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Forkers

xeyler

kestrel's Issues

GPS module

Hello, do I need to have a GPS module connected to my laptop to see wifi spots?

Kismet Version: 2022-08-R1 Support?

Hi, and thank you in advance for your support!

kestrel is an amazing Kismet plugin, with massive value! Since it stopped working a couple years ago I've been looking for replacement, but noting comes close!

After seeing the #1 post I though I'd give it a try again today. After a couple hours of testing, still no luck.

Installing as root, and after editing the manafest.conf file I was seeign that kestrel was sucessfully loading, the kismet homepage was blank, only the left top nav section and bottom page credits are visible :-(

manafest.conf
changes from
js=kestrel,/plugin/kestrel/js/kestrel.js
to
js=kestrel,plugin/kestrel/js/kestrel.js

above changes eliminated this error:
ERROR: Plugin '/root/.kismet//plugins//kestrel/' invalid JS plugin module,
expected relative path but got absolute path beginning with '/'

I hope you could patch, it would be amazing to have kestrel working again!

Respectfully

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.