rfparty-monitor

rfparty is a new way to see BLE

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

• Available on Google Play

Linux

• Setup
• Deploy sensor
• Retrieve Logs & Convert to GPX
• Visit rfparty.xyz
• Select monitor log
• Select GPS track
• Click 'load'
• Party! 🎉
• Support

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 libavahi-compat-libdnssd-dev
  • sudo ./scripts/install-requirements.sh
• nodejs LTS 18.x or 20.x
• npm <= 10.3.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.

• Android
  • Mendhak's GPX Logger
• iOS
  • myTracks

Follow and Support

• Twitter
• Buy it on Google Play
• Donate 🤲
  • https://ko-fi.com/dataparty

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/rfparty/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.