First Commit

Author: NoobieDog

README.md

@@ -0,0 +1,96 @@
+Peanuts                                    
+                                    
+========
+
+Release Date: 26/03/2017
+
+Peanuts is a free and open source wifi tracking tool. Based on the SensePosts Snoopy-NG project that is now closed.<br />
+
+Less dependencies, less overhead, less complications<br />
+
+NOTE: Im not sure how long i will supprot this project as its a slowly dying method, if i get time to work on it i will :D<br />
+
+Changelog:
+
+    # [DONE] - Add COLOR.
+    # [DONE] - Threaded
+    # [DONE] - Kill threads on Ctrl+C.
+    # [DONE] - Defaults added to Arguments.
+    # [DONE] - GPS added
+    # [DONE] - Output CSV Tidy
+
+TODO:
+
+	# Alert on known SSID or MAC
+	# Better error correction on GPS exits or false connections
+	# Add Pause/Stop/Start functions to script.
+
+**** FOR EDUCATIONAL USE! Use at your own risk. **** <br />
+
++ Tested on: Linux 3.2.6 Ubuntu/Debian (Backtrack & Kali)<br />
+
+## Installation:
+
+### Dependencies:
+
+#### Required:
+
+- Python 2.7+
+- Scapy / python-gps
+
+#### Installing from Source
+ 
+```bash
+git clone https://github.com/noobiedog/peanuts/
+cd peanuts
+pip install -r requirements.txt
+apt-get install python-gps
+```
+
+#### Installing from Download
+
+```bash
+pip install argparse datetime gps scapy logging
+apt-get install python-gps
+```
+
+#### To start GPS in kali/Ubuntu (in a separate terminal window)
+
+```bash
+service gps start
+gpsd -D 5 -N -n /dev/ttyUSB0
+```
+##  Sample commands
+
+#### Simple
+
+``` bash
+python overwatch.py -i wlan0 -l Home -o Capture1.csv
+```
+
+-i Interface (Doesnt matter if not in monitor mode, the program will do it)<br />
+-l location or OP name, whatever you want to identify this capture<br />
+-o Output file name for the CSV<br />
+
+#### Advanced
+
+``` bash
+python overwatch.py -i wlan0 -l home -a True -g True -o Capture1.csv
+```
+
+-i Interface (Doesn't matter if not in monitor mode, the program will do it)<br />
+-l location or OP name, whatever you want to identify this capture<br />
+-a Include Access Points too in the results<br />
+-g Get GPS location of your device (Not tested with Nethunter, yet. Also will need GPSD running)<br />
+-o Output file name for the CSV<br />
+
+
+## Lets See it in Action
+
+[![ASCIICinema](http://i.imgur.com/saR06iC.png)](https://asciinema.org/a/4lf58gw5psnik38wb4umud5r0)
+
+Happy Hacking
+
+NOTE: This method of WIFI tracking is slowly dying with the new IOS 10 Updates and Android updates.
+
+https://gist.github.com/computerality/3e0bc104cd216bf0f03f8d3aa8fbf081 line 176