Skip to content

quagmire69/vulture

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vulture

WhatsApp Online Tracker


  1. About
  2. Requirements
  3. Usage
  4. Example
  5. Report

1. About

This small snippets allows you to track a users WhatsApp behavior exploiting the WhatsApp web implementation. It monitors the users online-offline activity. At the moment it is only possible to monitor one user at the same time. The collected material is stored in a CSV file on your tracking machine.

IMPORTANT NOTE

Code is still under developement and needs a lot improvement. It is meant as a personal PoC, but maybe some of will find it useful. If you have any questions, sugesstions or see bugs just let me know.

2. Requirements

  • Smartphone and phone number where WhatsApp is installed and registred
  • A browser on a Windows/Linux/Mac machine which is connected to the SmartPhone using WhatsApp web (tested on Chrome)
  • The Smartphone and tracking machine (WhatsApp web) needs to be online 24/7 to ensure that a full time monitoring of the user is achived
  • Python 3 installed on you tracking machine
  • RECOMMENDED: It is recommended to use a dedicated phone number which only uses WhatsApp for tracking purpose. If you use your private WhatsApp installation it may interfere the tracking because there are some DOM struggles I am fighting with at the moment. It does not mean that it will not work with multiple chats in WhatsApp web. It just means I tested it in an environment where only one chat is available in WhatsApp web

3. Usage

  1. Set permissions for the CGI Python 3 server: chmod a+x cgi-bin/exfil.py
  2. Start the CGI Server: python3 server.py
  3. Open WhatsApp web and select the user to track
  4. Open the web developer console
  5. Insert the JavaScript code available inside the file inject.js
  6. Wait for data added to data.csv as soon as the user is online
  7. Analyse the data collected in data.csv.

4. Example

Output on the screenshots may differ in newer versions.

Injecting JavaScript code to the developer console in WhatsApp Web. injecting JavaScript code

Saving online times to disk via Python 3 CGI script saving online times to disk

5. Report

The Python script report.py allows you to generate a simple HTML file based on the data inside the file data.csv.

  • red items - User was not online during this range
  • green items - User was online in this range - click on the item for details

Example report:

Overview example report

Red Item - User was not online example report

Green Item - Users online times example report

About

WhatsApp Online Tracker

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 74.2%
  • JavaScript 25.8%