Skip to content

Introducing SnoopR live: Real-Time Device Detection and Mapping! 🚀

Latest
Compare
Choose a tag to compare
@AlienMajik AlienMajik released this 20 Oct 04:04
· 3 commits to main since this release
2afc667

I'm excited to announce the launch of SnoopR live, the latest version of my device detection and mapping tool that now provides live updates while running alongside Kismet! 🎉

🔍 Key Features:

Real-Time Monitoring: Visualize devices, snoopers, and alerts on an interactive map with live updates.
Auto-Refreshing Map: The map auto-refreshes to display the latest data without manual intervention.
Device Movement Detection: Detect potential snoopers based on device movement thresholds.
Drone Detection: Identify known drones by SSID or MAC address prefixes.
Customizable Update Intervals: Adjust how frequently the data refreshes to suit your needs.

🌐 How It Works:

SnoopR live processes data from the Kismet SQLite database in real-time and updates an interactive Folium map that you can view in your web browser. This setup enhances situational awareness by providing a visual representation of the devices detected in your vicinity.

Usage Instructions:

  1. Install all Requirements in Virtual Environment:

          python3 -m venv env
    
    
          source env/bin/activate
    
    
          pip install -r requirements.txt
    
  2. Open 3 split terminals each running a virtual environment by typing in each one :

          python3 -m venv env
    
    
          source env/bin/activate
    
  3. Run Kismet in one terminal:

          sudo kismet
    

Ensure that Kismet is running and capturing data by enabling your data sources.

  1. Run SnoopR.py in second terminal:

        python3 SnoopR.py --db-path /path/to/your.kismet --output-map /path/to/map/SnoopR_Map.html --interval 30
    

Replace /path/to/your.kismet with the path to your Kismet database file.
Replace /path/to/map/SnoopR_Map.html with the desired output path for the map.
The --interval argument specifies how often (in seconds) the script updates the map. Adjust as needed.

  1. Start a Simple Web Server to Serve the Map in the third terminal:

In the directory containing SnoopR_Map.html, start a web server:

      python3 -m http.server 8000

This will serve files in the directory over HTTP on port 8000.

  1. View the Map:

Open your web browser and navigate to:

     http://localhost:8000/SnoopR_Map.html

The map will auto-refresh every 30 seconds (or the interval you set).
You'll see live updates as Kismet collects new data.

When your done using SnoopR live exit out of virtual environments with:

     deactivate

Final Notes:

Be mindful of system resources when running the script continuously.
Adjust the update interval to balance between real-time updates and system performance. 

Monitor the snoopr.log file for any errors or warnings during execution.

If you have any problems installing and running SnoopR live I have made a Youtube video explaining how to run it: https://youtu.be/tO6NKF-lCBI?si=o2r4eVXy_MLVttn4