/BLEMonitor

Quick and dirty ble monitor

Primary LanguageJavaScriptApache License 2.0Apache-2.0

rfparty-monitor

rfparty-monitor

rfparty.xyz ( code )

sense, plan, party 🤘

Usage

rfparty-monitor is a tool for wireless situational awareness and debugging. its like a tricorder, for your wireless world.

File Paths

  • /data/rfparty/ble
  • /data/rfparty/gps
  • /data/rfparty/wifi
  • /data/rfparty/logs
  • /usr/bin/rfparty-info
  • /usr/bin/rfparty-monitor
  • /etc/systemd/system/rfparty-monitor.service

Installation

  • sudo ./scripts/install.sh

Requirements

  • Ubuntu 20.04 or debian equivalent
    • Packages: build-essential bluetooth bluez bluez-hcidump libbluetooth-dev libudev-dev gpsd gpsd-clients gpsbabel python-gps wireless-tools aircrack-ng libpcap-dev
    • sudo ./scripts/install-requirements.sh
  • nodejs LTS 16.x
  • USB GPS (optional)
  • Bluetooth dongle
    • CSR 4.x work well
    • Raspi internal works well on ubuntu 18.04 but not 20.04
  • Wifi dongle supporting promiscuous mode
    • Alfa wifi work well

Alternate GPS Source

Any smart phone our device capable of outputting GPX 1.0 is currently supported.

Follow and Support

  • Twitter
  • Donate 🤲
    • Cash.App - $datapartyllc
    • $eth - 0x430c1Bf9CbbbEA845651Ba1536d4B9795696dD5d
    • $btc(segwit) - bc1qgynk82txpsadmmzz043lc7edcxd4xl5v8qqr0z
    • $btc(legacy) - 16wW7HaKvQfoWxZkFEPQysMnyNxjn8YNLN
    • $usdt - 0xF790F8Ce7E6bcdD2aF96De59d342511734B29bB0
    • $xmr - 4BzzF8DwBc9Mik5B2rhKJLGrHB7ch3p3cQp7bCD16uRWHbiSpZUPfYEg62jgNKxkdjSuR4iqoxKa3Eb2y5uP7vZHSbdSY7AfsjeQwVLFKg

Roadmap 🗺️

  • Support PCAP 💾
    • Hidden Wifi AP
    • Wifi Clients
  • Improved error handling 🚧
  • Improve configuration 🛠️
  • Database optimization 👨🏿‍💻
    • High endurance deployments
    • Dynamic detail
    • Protocol filter
    • Running Statistics
  • Protocol Improvements 🔌
    • Bluetooth GATT logging
  • Improve location pipeline 🗺️
    • Log directly to GPX
    • Record GPX track to db
  • Realtime sharing 📡
    • Alerts
  • Wireless Intrussion Detection (WIDS) 🛡️
    • Common Wifi threats
    • BLE threats
  • Red teaming 🥷🏼
  • More frequencies, more protocols 👁️
    • LoRa
    • LoRaWAN
    • SDR tuning & capture
  • ... and much more ✨

Converting NMEA to GPX

  • cd /data/gps
  • gpsbabel -i nmea -f "track.foo.nmea" -o gpx,gpxver=1.1 -F "track-foo.gpx"

Modifying

Selecting Wifi Interface

In ./src/BLEMonitor.js

Set SCANNING_WIFI_IFACE to your desired wifi scanning interface for home detection.

Promiscuous Wifi Interface

In ./scripts/start-snif.sh change the arodump commands to correctly select your desired promiscuous wifi interface