Skip to content

kotthoff/probr-core

 
 

Repository files navigation

A generic WiFi tracking system

probr-core

The probr-core project provides the core functionality for setting up devices for WiFi sniffing, managing them remotely and actually collecting and sniffing WiFi probe request packets.

Technology

The frameworks, languages, tools and technologies used and required in the probr-core project are:

Devices

The devices used for sniffing WiFi packets must fulfill the following requirements:

  • *NIX operating system or simliar (Debian, Ubuntu, OpenWRT, Mac OS X, Raspbian etc.)
  • wget installed
  • tcpdump installed
  • internet access
  • wireless interface with monitor mode capabilities

Installation

We highly recommended to use Virtualenv to manage the python environment for probr-core.

After cloning the project, create a virtual environment for probr outside the probr-core directory:

virtualenv .env_probr

Activate the virtual python environment:

source .env_probr/bin/activate

Go into the probr-core directory. Now install the python dependencies of the project:

pip install -r requirements.txt

Now, install the frontend and web dependencies using bower:

bower install

You're pretty much set to start probr-core at this moment. What is left to do is:

Create the DB tables:

python manage.py migrate

Create an admin user for the Django webproject:

python manage.py createsuperuser

Make sure the mongodb deamon is running:

mongod &

Also, the redis-server must be running before you can use probr-core

redis-server &

Start-Up

Finally, you're ready to start your probr-core server by running:

python manage.py runserver

In order for the data to be processed and entered into the database, you need to start the celery worker:

celery worker -A probr

And you can check it out by visiting http://localhost:8000.

About

generic WiFi tracking: remote device management, packet capturing, packet storage

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 41.3%
  • JavaScript 25.1%
  • HTML 15.0%
  • Shell 13.6%
  • CSS 3.9%
  • Ruby 0.7%
  • Dockerfile 0.4%