/rfparty-monitor

its like a tricorder, for your wireless world.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

rfparty-monitor stability-experimental

rfparty is a new way to see BLE

Collage of Screenshots-768

Components

rfparty-monitor

rfparty.xyz ( code )

Usage

rfparty-monitor is a tool for wireless situational awareness and debugging. It's like a tricorder for your wireless world.

Android

Linux

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 works well
    • Raspi internal works well on Ubuntu 18.04 but not 20.04
  • Wifi dongle supporting promiscuous mode
    • Alfa wifi works well

Alternate GPS Source

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

Follow and Support

  • Twitter
  • Buy it on Google Play
  • Donate 🤲
    • $eth - 0x430c1Bf9CbbbEA845651Ba1536d4B9795696dD5d
    • $btc(segwit) - bc1qgynk82txpsadmmzz043lc7edcxd4xl5v8qqr0z
    • $btc(legacy) - 16wW7HaKvQfoWxZkFEPQysMnyNxjn8YNLN
    • $usdt - 0x62E8a85670A375A3f32E01D71f42ce71d908417B

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 ✨

Troubleshooting

Converting NMEA to GPX

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

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.