Metadata-Version: 2.1
Name: probequest
Version: 0.7.2
Summary: Toolkit for Playing with Wi-Fi Probe Requests
Home-page: https://github.com/SkypLabs/probequest
Author: Paul-Emmanuel Raoul
Author-email: skyper@skyplabs.net
License: GPLv3
Download-URL: https://github.com/SkypLabs/probequest/archive/v0.7.2.zip
Keywords: wifi wireless security sniffer
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Requires-Dist: argparse (>=1.4.0)
Requires-Dist: faker-wifi-essid
Requires-Dist: netaddr (>=0.7.19)
Requires-Dist: scapy (>=2.4.3)
Requires-Dist: urwid (>=2.0.1)
Provides-Extra: docs
Requires-Dist: sphinx (>=1.4.0) ; extra == 'docs'
Requires-Dist: sphinxcontrib-seqdiag (>=0.8.5) ; extra == 'docs'
Requires-Dist: sphinx-argparse (>=0.2.2) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'

==========
ProbeQuest
==========

|PyPI Package| |PyPI Downloads| |PyPI Python Versions| |Build Status Master Branch| |Build Status Develop Branch| |Code Coverage| |LGTM Grade| |LGTM Alerts| |Documentation Status|

Toolkit allowing to sniff and display the Wi-Fi probe requests passing nearby your wireless interface.

Probe requests are sent by a station to elicit information about access points, in particular to determine if an access point is present or not in the nearby environment. Some devices (mostly smartphones and tablets) use these requests to determine if one of the networks they have previously been connected to is in range, leaking personal information.

Further details are discussed in `this
paper <https://brambonne.com/docs/bonne14sasquatch.pdf>`__.

.. image:: docs/_static/img/probequest_demo.gif
   :target: https://asciinema.org/a/205172
   :alt: ProbeQuest - Demo

Installation
============

::

    pip3 install --upgrade probequest

Documentation
=============

The project is documented `here <http://probequest.readthedocs.io/en/latest/>`__.

In the Media
============

ProbeQuest has appeared in the following media:

- `KitPloit <https://www.kitploit.com/2018/06/probequest-toolkit-for-playing-with-wi.html>`__
- `Hakin9 Magazine, VOL.13, NO. 05, "Open Source Hacking Tools" <https://skyplabs.keybase.pub/Papers/Magazines/Hakin9%20Magazine%2C%20VOL.13%2C%20NO.%2005%2C%20%22Open%20Source%20Hacking%20Tools%22.pdf>`__
- `WonderHowTo <https://null-byte.wonderhowto.com/how-to/track-wi-fi-devices-connect-them-using-probequest-0186137/>`__ (including a `YouTube video <https://www.youtube.com/watch?v=Z8RHMUSYTiA>`__)
- `ShellVoide <https://www.shellvoide.com/wifi/wifi-karma-a-brief-guid-on-probe-response-frames/>`__
- `Cyber Pi Projects <https://www.cyberpiprojects.com/student-designed-projects>`__ (`Worksheet <https://www.cyberpiprojects.com/s/Probequest-Sniffing-Student.pdf>`__)

License
=======

`GPL version 3 <https://www.gnu.org/licenses/gpl.txt>`__

.. |Build Status Master Branch| image:: https://img.shields.io/travis/SkypLabs/probequest/master.svg?label=master&logo=travis&style=flat
   :target: https://travis-ci.org/SkypLabs/probequest
   :alt: Build Status Master Branch
.. |Build Status Develop Branch| image:: https://img.shields.io/travis/SkypLabs/probequest/develop.svg?label=develop&logo=travis&style=flat
   :target: https://travis-ci.org/SkypLabs/probequest
   :alt: Build Status Develop Branch
.. |Code Coverage| image:: https://api.codacy.com/project/badge/Grade/16b9e70e51744256b37099ae8fe9132d
   :target: https://www.codacy.com/app/skyper/probequest?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=SkypLabs/probequest&amp;utm_campaign=Badge_Grade
   :alt: Code Coverage
.. |Documentation Status| image:: https://readthedocs.org/projects/probequest/badge/?version=latest
   :target: http://probequest.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status
.. |Known Vulnerabilities| image:: https://snyk.io/test/github/SkypLabs/probequest/badge.svg
   :target: https://snyk.io/test/github/SkypLabs/probequest
   :alt: Known Vulnerabilities
.. |LGTM Alerts| image:: https://img.shields.io/lgtm/alerts/g/SkypLabs/probequest.svg?logo=lgtm&logoWidth=18
   :target: https://lgtm.com/projects/g/SkypLabs/probequest/alerts/
   :alt: LGTM Alerts
.. |LGTM Grade| image:: https://img.shields.io/lgtm/grade/python/g/SkypLabs/probequest.svg?logo=lgtm&logoWidth=18
   :target: https://lgtm.com/projects/g/SkypLabs/probequest/context:python
   :alt: LGTM Grade
.. |PyPI Downloads| image:: https://img.shields.io/pypi/dm/probequest.svg?style=flat
   :target: https://pypi.org/project/probequest/
   :alt: PyPI Package Downloads Per Month
.. |PyPI Package| image:: https://img.shields.io/pypi/v/probequest.svg?style=flat
   :target: https://pypi.org/project/probequest/
   :alt: PyPI Package Latest Release
.. |PyPI Python Versions| image:: https://img.shields.io/pypi/pyversions/probequest.svg?logo=python&style=flat
   :target: https://pypi.org/project/probequest/
   :alt: PyPI Package Python Versions


